Reference documentation and code samples for the Cloud Storage Client class Acl.
Google Cloud Storage uses access control lists (ACLs) to manage bucket and
object access. ACLs are the mechanism you use to share objects with other
users and allow other users to access your buckets and objects. For more
information please see the overview on
access-control.
Example:
use Google\Cloud\Storage\StorageClient;
$storage = new StorageClient();
$bucket = $storage->bucket('my-bucket');
$acl = $bucket->acl();
Namespace
Google \ Cloud \ Storage
Methods
__construct
Parameters
Name
Description
connection
Connection\ConnectionInterface
Represents a connection to
Cloud Storage. This object is created by StorageClient,
and should not be instantiated outside of this client.
type
string
The type of access control this instance applies to.
identity
array
Represents which bucket, file, or generation this
instance applies to.
[[["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-04 UTC."],[],[],null,["# Cloud Storage Client - Class Acl (1.48.3)\n\nVersion latestkeyboard_arrow_down\n\n- [1.48.3 (latest)](/php/docs/reference/cloud-storage/latest/Acl)\n- [1.48.2](/php/docs/reference/cloud-storage/1.48.2/Acl)\n- [1.47.0](/php/docs/reference/cloud-storage/1.47.0/Acl)\n- [1.46.0](/php/docs/reference/cloud-storage/1.46.0/Acl)\n- [1.45.0](/php/docs/reference/cloud-storage/1.45.0/Acl)\n- [1.44.0](/php/docs/reference/cloud-storage/1.44.0/Acl)\n- [1.43.1](/php/docs/reference/cloud-storage/1.43.1/Acl)\n- [1.42.1](/php/docs/reference/cloud-storage/1.42.1/Acl)\n- [1.41.4](/php/docs/reference/cloud-storage/1.41.4/Acl)\n- [1.37.0](/php/docs/reference/cloud-storage/1.37.0/Acl)\n- [1.36.1](/php/docs/reference/cloud-storage/1.36.1/Acl)\n- [1.35.0](/php/docs/reference/cloud-storage/1.35.0/Acl)\n- [1.34.0](/php/docs/reference/cloud-storage/1.34.0/Acl)\n- [1.33.4](/php/docs/reference/cloud-storage/1.33.4/Acl)\n- [1.32.0](/php/docs/reference/cloud-storage/1.32.0/Acl)\n- [1.31.2](/php/docs/reference/cloud-storage/1.31.2/Acl)\n- [1.30.3](/php/docs/reference/cloud-storage/1.30.3/Acl) \nReference documentation and code samples for the Cloud Storage Client class Acl.\n\nGoogle Cloud Storage uses access control lists (ACLs) to manage bucket and\nobject access. ACLs are the mechanism you use to share objects with other\nusers and allow other users to access your buckets and objects. For more\ninformation please see the overview on\n[access-control](https://cloud.google.com/storage/docs/access-control).\n\nExample: \n\n use Google\\Cloud\\Storage\\StorageClient;\n\n $storage = new StorageClient();\n\n $bucket = $storage-\u003ebucket('my-bucket');\n $acl = $bucket-\u003eacl();\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ Storage\n\nMethods\n-------\n\n### __construct\n\n### delete\n\nSee also:\n\n- [BucketAccessControls delete\n API documentation.](https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/delete)\n- [DefaultObjectAccessControls delete API documentation.](https://cloud.google.com/storage/docs/json_api/v1/defaultObjectAccessControls/delete)\n- [ObjectAccessControls delete\n API documentation.](https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/delete)\n\n### get\n\nSee also:\n\n- [BucketAccessControls get API\n documentation.](https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/get)\n- [DefaultObjectAccessControls get API documentation.](https://cloud.google.com/storage/docs/json_api/v1/defaultObjectAccessControls/get)\n- [ObjectAccessControls get API\n documentation.](https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/get)\n\n### add\n\nSee also:\n\n- [BucketAccessControls insert\n API documentation.](https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert)\n- [DefaultObjectAccessControls insert API documentation.](https://cloud.google.com/storage/docs/json_api/v1/defaultObjectAccessControls/insert)\n- [ObjectAccessControls insert\n API documentation.](https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert)\n\n### update\n\nSee also:\n\n- [BucketAccessControls patch API\n documentation.](https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/patch)\n- [DefaultObjectAccessControls patch API documentation.](https://cloud.google.com/storage/docs/json_api/v1/defaultObjectAccessControls/patch)\n- [ObjectAccessControls patch\n API documentation.](https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/patch)\n\nConstants\n---------\n\n### ROLE_READER\n\n Value: 'READER'\n\n### ROLE_WRITER\n\n Value: 'WRITER'\n\n### ROLE_OWNER\n\n Value: 'OWNER'"]]