• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. API Reference (OBS)
  4. Operations on Objects
  5. PUT Object acl
  6. Requests

Requests

Syntax

PUT /ObjectName?acl HTTP/1.1 
 User-Agent: agent
 Host: bucketname.obs.example.com 
 Accept: */*
 Date: date 
 Authorization: authorization 
 Content-Length: length
 Expect: expect

 <AccessControlPolicy> 
 <Owner> 
 <ID>ID</ID> 
 <DisplayName>displayname</DisplayName> 
 </Owner> 
 <AccessControlList> 
 <Grant> 
 <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">grantee</Grantee> 
 <Permission>permission</Permission> 
 </Grant> 
 </AccessControlList> 
 </AccessControlPolicy>

Request Parameters

Table 1 describes the request parameter.

Table 1 Request parameter

Parameter

Description

Remarks

versionId

Indicates the version ID of an object. The ACL of the object with the version ID specified by this parameter is modified.

Type: String

Optional

Request Headers

This request uses common headers. For details about common request headers, see section Common Request Headers.

Request Elements

This request contains elements to specify the ACL. Table 2 describes the elements.

Table 2 Request elements

Element

Description

Remarks

ID

DomainId of the user.

Type: String

Optional

DisplayName

Indicates the user name.

Type: String

Optional

Permission

Indicates the permission to be granted.

Type: Enumeration

Optional