PUT Bucket acl
API Description
You can use this API to set the ACL for a bucket.
Method Definition
1. ObsClient->setBucketAcl(array $parameter) 2. ObsClient->setBucketAclAsync(array $parameter, callable $callback)
Request Parameter
Field |
Type |
Optional or Mandatory |
Description |
||
---|---|---|---|---|---|
Bucket |
string |
Mandatory |
Bucket name |
||
ACL |
string |
Optional |
|||
Owner |
associative array |
Optional |
Bucket owner |
||
ID |
string |
Mandatory |
ID of the domain to which the bucket owner belongs |
||
DisplayName |
string |
Optional |
Name of the bucket owner |
||
Grants |
indexed array |
Optional |
List of grantees' permission information |
||
Grantee |
associative array |
Mandatory |
Grantee |
||
Type |
string |
Mandatory |
|||
ID |
string |
Mandatory when Type is CanonicalUser. In other cases, leave it null. |
ID of the domain to which the grantee belongs |
||
URI |
string |
Mandatory when Type is Group. In other cases, leave it null. |
|||
Permission |
string |
Mandatory |
|||
Delivered |
boolean |
Optional |
Whether an object inherits the ACL of its residing bucket |
![](https://support.huaweicloud.com/eu/api-obs_php_sdk_api_en/public_sys-resources/note_3.0-en-us.png)
- Owner and Grants must be used together and they cannot be used with ACL.
- You must set either the two fields or ACL.
Returned Result
Field |
Type |
Description |
---|---|---|
HttpStatusCode |
integer |
HTTP status code |
Reason |
string |
Reason description |
RequestId |
string |
Request ID returned by the OBS server |
Sample Code
try{ $resp = $obsClient -> setBucketAcl([ 'Bucket' => 'bucketname', 'Owner' => ['ID' => 'ownerid', 'DisplayName' => 'ownername'], 'Grants' => [ ['Grantee' => ['Type' => 'CanonicalUser', 'ID' => 'userid'], 'Permission' => ObsClient::PermissionRead], ['Grantee' => ['Type' => 'CanonicalUser', 'ID' => 'userid'], 'Permission' => ObsClient::PermissionWrite], ['Grantee' => ['Type' => 'Group', 'URI' => ObsClient::GroupLogDelivery], 'Permission' => ObsClient::PermissionWrite], ['Grantee' => ['Type' => 'Group', 'URI' => ObsClient::GroupLogDelivery], 'Permission' => ObsClient::PermissionReadAcp], ] ]); printf("RequestId:%s\n", $resp['RequestId']); }catch (Obs\Common\ObsException $obsException){ printf("ExceptionCode:%s\n", $obsException->getExceptionCode()); printf("ExceptionMessage:%s\n", $obsException->getExceptionMessage()); }
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.