Reference documentation and code samples for the Storage Transfer Service V1 API module Google::Cloud::StorageTransfer::V1::MetadataOptions::Acl.
Options for handling Cloud Storage object ACLs.
Constants
ACL_UNSPECIFIED
value: 0 ACL behavior is unspecified.
ACL_DESTINATION_BUCKET_DEFAULT
value: 1 Use the destination bucket's default object ACLS, if applicable.
ACL_PRESERVE
value: 2 Preserve the object's original ACLs. This requires the service account
to have storage.objects.getIamPolicy permission for the source object.
Uniform bucket-level
access
must not be enabled on either the source or destination buckets.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[],[],null,["# Storage Transfer Service V1 API - Module Google::Cloud::StorageTransfer::V1::MetadataOptions::Acl (v1.6.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.6.0 (latest)](/ruby/docs/reference/google-cloud-storage_transfer-v1/latest/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [1.5.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/1.5.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [1.4.1](/ruby/docs/reference/google-cloud-storage_transfer-v1/1.4.1/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [1.3.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/1.3.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [1.2.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/1.2.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [1.1.1](/ruby/docs/reference/google-cloud-storage_transfer-v1/1.1.1/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [1.0.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/1.0.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [0.10.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/0.10.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [0.9.2](/ruby/docs/reference/google-cloud-storage_transfer-v1/0.9.2/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [0.8.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/0.8.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [0.7.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/0.7.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [0.6.1](/ruby/docs/reference/google-cloud-storage_transfer-v1/0.6.1/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [0.5.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/0.5.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [0.4.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/0.4.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [0.3.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/0.3.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [0.2.0](/ruby/docs/reference/google-cloud-storage_transfer-v1/0.2.0/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl)\n- [0.1.2](/ruby/docs/reference/google-cloud-storage_transfer-v1/0.1.2/Google-Cloud-StorageTransfer-V1-MetadataOptions-Acl) \nReference documentation and code samples for the Storage Transfer Service V1 API module Google::Cloud::StorageTransfer::V1::MetadataOptions::Acl.\n\nOptions for handling Cloud Storage object ACLs.\n\nConstants\n---------\n\n### ACL_UNSPECIFIED\n\n**value:** 0 \nACL behavior is unspecified.\n\n### ACL_DESTINATION_BUCKET_DEFAULT\n\n**value:** 1 \nUse the destination bucket's default object ACLS, if applicable.\n\n### ACL_PRESERVE\n\n**value:** 2 \nPreserve the object's original ACLs. This requires the service account\nto have `storage.objects.getIamPolicy` permission for the source object.\n[Uniform bucket-level\naccess](https://cloud.google.com/storage/docs/uniform-bucket-level-access)\nmust not be enabled on either the source or destination buckets."]]