github.com/pmcatominey/terraform@v0.7.0-rc2.0.20160708105029-1401a52a5cc5/website/source/docs/providers/google/r/storage_bucket_acl.html.markdown (about)

     1  ---
     2  layout: "google"
     3  page_title: "Google: google_storage_bucket_acl"
     4  sidebar_current: "docs-google-storage-bucket-acl"
     5  description: |-
     6    Creates a new bucket ACL in Google Cloud Storage.
     7  ---
     8  
     9  # google\_storage\_bucket\_acl
    10  
    11  Creates a new bucket ACL in Google cloud storage service(GCS).
    12  
    13  ## Example Usage
    14  
    15  Example creating an ACL on a bucket with one owner, and one reader.
    16  
    17  ```js
    18  resource "google_storage_bucket" "image-store" {
    19    name     = "image-store-bucket"
    20    location = "EU"
    21  }
    22  
    23  resource "google_storage_bucket_acl" "image-store-acl" {
    24    bucket = "${google_storage_bucket.image_store.name}"
    25  
    26    role_entity = [
    27      "OWNER:user-my.email@gmail.com",
    28      "READER:group-mygroup",
    29    ]
    30  }
    31  ```
    32  
    33  ## Argument Reference
    34  
    35  * `bucket` - (Required) The name of the bucket it applies to.
    36  
    37  - - -
    38  
    39  * `default_acl` - (Optional) The [canned GCS ACL](https://cloud.google.com/storage/docs/access-control#predefined-acl) to apply to future buckets. Must be set both `role_entity` and `predefined_acl` are not.
    40  
    41  * `predefined_acl` - (Optional) The [canned GCS ACL](https://cloud.google.com/storage/docs/access-control#predefined-acl) to apply. Must be set if both `role_entity` and `default_acl` are not.
    42  
    43  * `role_entity` - (Optional) List of role/entity pairs in the form `ROLE:entity`. See [GCS Bucket ACL documentation](https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls)  for more details. Must be set if both `predefined_acl` and `default_acl` are not.
    44  
    45  ## Attributes Reference
    46  
    47  Only the arguments listed above are exposed as attributes.