功能说明 Get object retention获取对象的保留期限设置。 请求消息样式 plaintext GET /{Bucket}/{Key}?retention&versionIdVersionId HTTP/1.1 Host: xxx.zos.ctyun.cn AcceptEncoding: identity XAmzContentSHA256: ContentSHA256 XAmzDate: 20220412T100505Z Authorization: string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Key 参数解释： 对象名称。 String 是 versionId 参数解释： 对象的版本ID。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000008100624e501c1217bdefault Date: Thu, 07 Apr 2022 02:44:44 GMT Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息参数 参数名称 参数描述 类型 Retention 参数解释： 对象保留期限配置。 Container 表Retention 参数名称 参数描述 类型 Mode 参数解释： 对象保留期限模式。 取值范围： GOVERNANCE：监管模式 COMPLIANCE：合规性模式 String RetainUntilDate 参数解释： 对象保留期限过期日期。 Date

响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000a00624e497a5e72default ContentLength: 0 Date: Thu, 07 Apr 2022 02:16:42 GMT Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

参数名称 参数描述 类型 是否必须 LegalHold 参数解释： 指定对象依法保留配置。 Container 否

参数名称 参数描述 类型 是否必须 Key 参数解释： 标签键。 String 是 Value 参数解释： 标签值。 String 是

参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Key 参数解释： Object的名称。 String 是 VersionId 参数解释： 多版本场景下，指定对象的特定版本。不指定时，默认为最新版本的Id，如存在null版本号，并需对其操作，则需指定VersionId'null'。VersionId''等效于指定最新版本的Id。 String 否

参数名称 参数描述 类型 xamzdeletemarker 参数解释： 指明对象是否是DeleteMarker。 String xamzexpiration 参数解释： 对象的过期时间。如果配置了对象过期（请参阅 ），则响应包含此标头。它包括提供对象过期信息的过期日期和规则ID键值对。 String ContentLength 参数解释： Body的长度。 Long ETag 参数解释： 对象的Etag。 String xamzversionid 参数解释： 对象的VersionId。 String xamzwebsiteredirectlocation 参数解释： 如果开启了website配置，重定向到指定的URL。 String xamzstorageclass 参数解释： 对象的存储级别。 String xamztaggingcount 参数解释： 对象的tag数。 Long xamzobjectlockmode 参数解释： 对象的Lock模式。 String xamzobjectlockretainuntildate 参数解释： 对象Lock到期的时间。 Date xamzobjectlocklegalhold 参数解释： 对象Legal hold是否开启。 String xamzmetadata 参数解释： 用户指定的元数据信息。 String

参数名称 参数描述 类型 Status 参数解释： 是否打开对象依法保留。 取值范围： ON：打开 OFF：关闭 String

参数名称 参数描述 类型 是否必须 Key 参数解释： 删除对象的Key。 String 是 VersionId 参数解释： 删除对象的版本号。 String 否

参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Key 参数解释： Object的名称。 String 是 VersionId 参数解释： 多版本场景下，指定对象的特定版本。不指定时，默认为最新版本的Id，如存在null版本号，并需对其操作，则需指定VersionId'null'。VersionId''等效于指定最新版本的Id。 String 否

请求消息元素 参数名称 参数描述 类型 是否必须 Body 参数解释： 上传的对象数据。 Binary 否 响应消息样式 plaintext HTTP/1.1 Status Code ContentLength: 0 ETag: ETag AcceptRanges: bytes xamzversionid: VersionId xamzrequestid: Request Id Date: Date Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 除公共响应消息头之外，还可能返回如下的消息头： 参数名称 参数描述 类型 ETag 参数解释： 对象的ETag。 String xamzversionid 参数解释： 对象的版本号。 String 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

参数名称 参数描述 类型 是否必须 Grantee 参数解释： 授权主体。 Container 消息体方式下必须 Permission 参数解释： 授予的权限。 取值范围： FULLCONTROL、WRITE 、WRITEACP、READ、READACP String 消息体方式下必须

功能说明 Delete Object请求删除指定的对象。 请求消息样式 plaintext DELETE /{Bucket}/{Key}?versionIdVersionId HTTP/1.1 Host: xxx.zos.ctyun.cn XAmzContentSha256: ContentSHA256 XAmzDate: Date Authorization: Auth String Connection: keepalive 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Key 参数解释： 删除对象的Key。 String 是 versionId 参数解释： 删除对象的版本号。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id Date: Date Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是

参数名称 参数描述 参数类型 是否必须 ContentMD5 参数解释： LifecycleConfiguration对应的md5值。 String 是

错误码 请参见调用前必知错误码全局错误码。

参数名称 描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是

功能说明 List Objects Versions请求列出Bucket中的对象版本。 请求消息样式 plaintext GET /{Bucket}/?versions&delimiterDelimiter&keymarkerKeyMarker&versionidmarkerVersionIdMarker&maxkeysMaxKeys&prefixPrefix HTTP/1.1 Host: xxx.zos.ctyun.cn XAmzContentSha256: ContentSHA256 XAmzDate: Date Authorization: Auth String AcceptEncoding: Identity 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 keymarker 参数解释： 列举多版本key的起始位置， 返回的列表将是以key名按照字典序排在该参数后的对象。 String 否 versionidmarker 参数解释： 列举多版本key的版本号的起始位置， 返回的列表将是以版本号按照字典序排在该参数后的对象。 String 否 delimiter 参数解释： 对对象名称进行分组的字符。 String 否 maxkeys 参数解释： 本次返回keys的最大数目。 约束限制： 小于0时返回结果为0，大于1000时返回结果为1000。 取值范围： 01000 默认取值： 1000 Long 否 prefix 参数解释： 返回的多版本key的前缀。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id Date: Date ContentType: application/xml Connection: KeepAlive bucket prefix maxKeys false keyMarker nextKeyMarker versionIdMarker nextVersionIdMarker delimiter object1 versionId true date etag size storageClass userId displayName type ... object2 versionId true date userId displayName Normal ...

功能说明 获取指定桶的桶策略。 请求消息样式 plaintext GET /{Bucket}?policy HTTP/1.1 Host: xxx.zos.ctyun.cn XAmzContentSha256: ContentSHA256 XAmzDate: Date Authorization: Auth String 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentLength: ContentLength Date: Date Connection: KeepAlive { "Version": "20121017", "Id": "string", "Statement": [ { "Sid": "string", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam:::user/uid" }, "Action": ["s3:"], "Resource": [ "arn:aws:s3:::bucketname/", "arn:aws:s3:::bucketname" ], "Condition": { "StringEquals": { "aws:Referer": [ "xxx" ] } } } ] } 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应元素说明 参数名称 参数描述 类型 Version 参数解释： 指定桶策略的版本信息。 取值范围： 当前支持"20121017"和"20060301" 默认取值： "20121017" String Id 参数解释： 桶策略ID，桶策略的唯一标识。 String Statement 参数解释： 桶策略描述，定义完整的权限控制。 约束限制： 每条桶策略的Statement可由多条描述组成，每条描述可包含字段：Sid、Effect、Principal、Action、Resource、Condition。 Array Sid 参数解释： 本条桶策略描述的ID。 String Effect 参数解释： 桶策略的效果，即指定本条桶策略描述的权限是接受请求还是拒绝请求。 取值范围： Allow或Deny String Principal 参数解释： 被授权人，即指定本条桶策略描述所作用的用户。 约束限制： 支持通配符“”，表示所有用户和委托。 当对某个用户进行授权时，Principal格式为"AWS": "arn:aws:s3:::user/UserID" 当对某个委托进行授权时，Principal格式为"AWS": "arn:aws:s3:::role/RoleID" Object Action 参数解释： 授权操作，即指定本条桶策略描述所作用的ZOS操作。 约束限制： 以列表形式表示，可配置多条操作，以逗号间隔。支持通配符""，表示该资源能进行的所有操作。常用的Action有"s3:GetObject"，"s3:PutObject"，"s3:"等。 取值范围： 详见桶策略附录一。 Object Condition 参数解释： 条件语句，指定本条桶策略所限制的条件。可以通过Condition对ZOS资源各种策略，比如设置防盗链： "Condition": {"StringEquals":{"aws:Referer":["xxx"]}，此时如果Effect为“Allow”，则允许来自"xxx"的请求；如果为“Deny”，则拒绝。 取值范围： 详见桶策略附录二。 Object

参数名称 参数描述 类型 是否必须 xamzacl 参数解释： 为当前桶设置的ACL名称。 约束限制： 不能与其他 xamzgrant同时使用。 取值范围： private：私有，桶的所有者拥有完全控制的权限，其他任何人都没有访问权限。 publicread：公共读，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据。 publicreadwrite：公共读写，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、上传对象、删除对象、初始化段任务、上传段、合并段、拷贝段、取消多段上传任务。注意：对象存储底层禁用公共读写，设置后不可匿名上传，如需使用可提工单申请。 authenticatedread：默认情况下，上传对象至其他用户的桶中，桶拥有者没有对象的控制权限。对象拥有者为桶拥有者添加此权限控制策略后，桶所有者可以完全控制对象。 String 否 xamzgrantfullcontrol 参数解释： 被授权用户可以对桶进行read, write, read ACP, and write ACP操作。 约束限制： 格式”idxxx”或”emailAddressxxx”或者”urixxx”以及他们的组合（用逗号连接）。 String 否 xamzgrantread 参数解释： 被授权用户可以对桶进行读操作，即列举桶内对象列表。 约束限制： 格式”idxxx”或”emailAddressxxx”或者”urixxx”以及他们的组合（用逗号连接）。 String 否 xamzgrantreadacp 参数解释： 被授权用户可以读取桶的ACL。 约束限制： 格式”idxxx”或”emailAddressxxx”或者”urixxx”以及他们的组合（用逗号连接）。 String 否 xamzgrantwrite 参数解释： 被授权用户可以对桶进行写操作，创建新的对象，删除或覆盖写。 约束限制： 格式”idxxx”或”emailAddressxxx”或者”urixxx”以及他们的组合（用逗号连接）。 String 否 xamzgrantwriteacp 参数解释： 被授权用户可以修改桶的ACL。 约束限制： 格式”idxxx”或”emailAddressxxx”或者”urixxx”以及他们的组合（用逗号连接）。 String 否

参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是

参数名称 参数描述 类型 是否必须 Bucket 参数解释： 清单文件导出的目标桶。 String 是 Format 参数解释： 清单导出的格式。 约束限制： 只支持CSV格式。 String 是 Prefix 参数解释： 导出清单文件的路径。 String 否

参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 id 参数解释： 用来标识清单规则的id。 String 是

参数名称 参数描述 类型 是否必须 Tag 参数解释： 单个标签。 Container 是

功能说明 Get Bucket Inventory Configuration返回目标桶的某项桶清单配置。 请求消息样式 plaintext GET /{Bucket}?inventory&idxxx HTTP/1.1 Host: xxx.zos.ctyun.cn xamzdate: Date xamzcontentsha256: ContentSHA256 Authorization: Auth String ContentLength: ContentLength 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 id 参数解释： 用来标识清单规则的id。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: ContentType ContentLength: ContentLength Date: Date Connection: KeepAlive string string string boolean string string string string string 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该响应中将桶清单配置信息以消息元素的形式返回，元素的具体含义如下表所示 ： 参数名称 参数描述 类型 InventoryConfiguration 参数解释： 桶清单信息的根标签。 Container 表InventoryConfiguration 参数名称 参数描述 类型 Destination 参数解释： 清单导出目标的容器。 Container IsEnabled 参数解释： 是否启用清单规则。 Boolean Filter 参数解释： 包含清单过滤规则，清单仅包括符合条件的对象。 Container Id 参数解释： 用来标识清单规则的id。 String IncludedObjectVersions 参数解释： 是否列出对象的所有版本。 约束限制： 支持的字段为All和Current。 String OptionalFields 参数解释： 包含清单文件中包含的可选字段。 String Schedule 参数解释： 指定清单文件的导出周期。 String 表Destination 参数名称 参数描述 类型 S3BucketDestination 参数解释： 包含清单文件导出目标存储桶，前缀。 Container 表S3BucketDestination 参数名称 参数描述 类型 Bucket 参数解释： 清单文件导出的目标桶。 String Format 参数解释： 清单导出的格式。 约束限制： 只支持CSV格式。 String Prefix 参数解释： 导出清单文件的路径。 String 表Filter 参数名称 参数描述 类型 Prefix 参数解释： 指定源存储桶中需要进行清单导出的文件前缀。 String 表OptionalFields 参数名称 参数描述 类型 Field 参数解释： 清单文件中的可选字段。 String 表Schedule 参数名称 参数描述 类型 Frequency 参数解释： 清单文件导出周期。 约束限制： 支持Daily和Weekly，分别对应每天和每周末导出。 String

功能说明 Get Bucket Versioning可以获取某个桶的多版本配置信息。 请求消息样式 plaintext GET /{Bucket}?versioning HTTP/1.1 Host: xxx.zos.ctyun.cn AcceptEncoding: identity XAmzDate: 20220407T135856Z XAmzContentSHA256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 Authorization: string ContentLength: 0 请求消息参数 参数名称 描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000001300624d2ce65403fdefault ContentType: application/xml ContentLength: 192 Date: Wed, 06 Apr 2022 06:02:14 GMT Connection: KeepAlive Enabled Disabled 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 参数名称 参数描述 类型 VersioningConfiguration 参数解释： 桶的多版本配置信息。 Container 表VersioningConfiguration 参数名称 参数描述 类型 Status 参数解释： 桶的版本控制状态信息。假如从没设置过多版本，则没有该字段信息。 取值范围： Enabled：开启 Suspended：暂停 String MfaDelete 参数解释： 桶的多版本删除保护状态信息，展示是否启用MFA 删除。 String

参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是

参数名称 参数描述 类型 是否必须 CORSRule 参数解释： 为指定bucket配置的所有跨域规则的集合。 约束限制： 最多允许配置100条规则。 Contanier 是

参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是

参数名称 描述 类型 是否必须 LoggingEnabled 参数解释： 描述日志存储位置和日志对象前缀。 Container 否

参数名称 参数描述 类型 是否必须 Rule 参数解释： 服务端加密配置规则信息。 Container 是

参数名称 参数描述 类型 ObjectLockConfiguration 参数解释： 桶的名称。 Container

响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000200624f957a2a818nanjing3 ContentType: application/xml ContentLength: 0 Date: Fri, 08 Apr 2022 01:52:58 GMT Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。