github.com/koding/terraform@v0.6.4-0.20170608090606-5d7e0339779d/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). For more information see 
    12  [the official documentation](https://cloud.google.com/storage/docs/access-control/lists) 
    13  and 
    14  [API](https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls).
    15  
    16  ## Example Usage
    17  
    18  Example creating an ACL on a bucket with one owner, and one reader.
    19  
    20  ```hcl
    21  resource "google_storage_bucket" "image-store" {
    22    name     = "image-store-bucket"
    23    location = "EU"
    24  }
    25  
    26  resource "google_storage_bucket_acl" "image-store-acl" {
    27    bucket = "${google_storage_bucket.image-store.name}"
    28  
    29    role_entity = [
    30      "OWNER:user-my.email@gmail.com",
    31      "READER:group-mygroup",
    32    ]
    33  }
    34  ```
    35  
    36  ## Argument Reference
    37  
    38  * `bucket` - (Required) The name of the bucket it applies to.
    39  
    40  - - -
    41  
    42  * `predefined_acl` - (Optional) The [canned GCS ACL](https://cloud.google.com/storage/docs/access-control/lists#predefined-acl) to apply. Must be set if `role_entity` is not.
    43  
    44  * `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 `predefined_acl` is not.
    45  
    46  ## Attributes Reference
    47  
    48  Only the arguments listed above are exposed as attributes.