terraform-provider-google/website/docs/r/storage_default_object_acl.html.markdown
The Magician 30fc9ec3f9 Generate DefaultObjectAccessControl in Terraform (#2358)
<!-- This change is generated by MagicModules. -->
/cc @rileykarson
2018-12-20 17:22:22 -08:00

1.7 KiB

layout page_title sidebar_current description
google Google: google_storage_default_object_acl docs-google-storage-default-object-acl Authoritatively manages the default object ACLs for a Google Cloud Storage bucket

google_storage_default_object_acl

Authoritatively manages the default object ACLs for a Google Cloud Storage bucket without managing the bucket itself.

-> Note that for each object, its creator will have the "OWNER" role in addition to the default ACL that has been defined.

For more information see the official documentation and API.

-> Want fine-grained control over default object ACLs? Use google_storage_default_object_access_control to control individual role entity pairs.

Example Usage

Example creating a default object ACL on a bucket with one owner, and one reader.

resource "google_storage_bucket" "image-store" {
  name     = "image-store-bucket"
  location = "EU"
}

resource "google_storage_default_object_acl" "image-store-default-acl" {
  bucket = "${google_storage_bucket.image-store.name}"
  role_entity = [
    "OWNER:user-my.email@gmail.com",
    "READER:group-mygroup",
  ]
}

Argument Reference

  • bucket - (Required) The name of the bucket it applies to.

  • role_entity - (Optional) List of role/entity pairs in the form ROLE:entity. See GCS Object ACL documentation for more details. Omitting the field is the same as providing an empty list.

Attributes Reference

Only the arguments listed above are exposed as attributes.