Skip to main content

PutBucketACL

Description

PutBucketACL interface is used to modify bucket access rights.

Request Method

POST

Request Path

/apsara/route/OneRouter/PutBucketACL

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
x-oss-aclBODYstringYesprivatespecifies the access ACL of the bucket. the PutBucketAcl interface sets access rights through x-oss-acl request header in the Put request. if there is no request header, the access rights setting will not take effect. values: public-read-write, public-read, private. public-read-write (public read-write): all users have read and write permissions on files in the bucket. Please use this access carefully. public-read: the owner and authorized user of the bucket have read and write permissions to the files in the bucket, and other users only have read permissions to the files in the bucket. Please use this access carefully. private: the owner and authorized user of the bucket have read and write permissions to the files in the bucket, and other users have no permission to operate the files in the bucket.
regionIdBODYstringYesNo sample value for this parameter.region id
versionBODYstringNo2016-01-01version of api

Return data

NameTypeSample valueDescription
RequestIDstring1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DCRequest id

Example

Successful Response example

{
"RequestID":"1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}