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

参数名称 参数描述 类型 ApplyServerSideEncryptionByDefault 参数解释： 指定默认的服务端加密配置，若上传对象时请求中未指定任何加密信息，则会使用该加密配置。 Container

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

参数名称 参数描述 参数类型 是否必须 LifecycleConfiguration 参数解释： 生命周期规则的容器，最多容纳1000条规则。 Container 是 Rule 参数解释： 生命周期规则。 Container 是 Expiration 参数解释： 用日期或天数指定对象的过期时间。 Container 否 Date 参数解释： 标识对象的过期日期。 取值范围： 日期为ISO8601格式，必须为UTC午夜0时。 Date Date与Days二选一 Days 参数解释： 标识对象受规则约束的天数。 Long Date与Days二选一 ID 参数解释： 标识唯一的规则。 String 否，建议指定，如不指定，自动生成ID Filter 参数解释： 过滤应用规则的对象。 Container 否 Prefix 参数解释： 标识应用规则的对象前缀。 String 是 Tag 参数解释： 应用规则到拥有指定标签的对象。 Container 否 Key 参数解释： 标签的名称。 String 否 Value 参数解释： 标签的值。 String 否 Status 参数解释： 标识是否应用规则 。 取值范围： Enabled Disabled String 是 Transtions 参数解释： 标识对象何时转存到指定的Storage Class。 Container 否 StorageClass 参数解释： 标识要转存储到哪种存储类别。 取值范围： STANDARDIA（低频存储） GLACIER（归档存储） String 如设置转存储规则，该字段必选 NoncurrentVersionTransitions 参数解释： 标识历史版本的转存储规则。 Container 否 NoncurrentDays 参数解释： 标识对象的历史版本受规则约束的天数。 Long 否 NoncurrentVersionExpiration 参数解释： 标识历史版本的过期规则。 Container 否 AbortIncompleteMultipartUpload 参数解释： 标识未完成的分段上传的过期属性。 Container 否 DaysAfterInitiation 参数解释： 标识为完成的分段的过期时间。 Long 否 ExpiredObjectDeleteMarker 参数解释： 标记多版本桶，是否要删除DeleteMarker。 取值范围： true 约束限制： 不可设置为false Boolen 否

参数名称 参数描述 类型 是否必须 ID 参数解释： 桶所有者的uid。 String 消息体方式下必须

参数名称 参数描述 类型 是否必须 Mode 参数解释： 对象保留期限模式。 取值范围： GOVERNANCE：监管模式 COMPLIANCE：合规性模式 String 否 RetainUntilDate 参数解释： 对象保留期限过期日期。 Date 否

参数名称 描述 类型 是否必须 DisplayName 参数解释： 展示名字。 String 否 EmailAddress 参数解释： 邮件地址。 String 否 ID 参数解释： 授权用户 ID。 String 否 Type 参数解释： 授权类型。 取值范围： CanonicalUser：普通用户 AmazonCustomerByEmail：邮箱用户 String 否

响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

功能说明 GetBucketPolicy接口用于获取指定桶的桶策略。 请求消息样式 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

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

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

响应消息元素 参数名称 参数描述 类型 AccessControlPolicy 参数解释： 授权信息的根标签。 Container 表AccessControlPolicy 参数名称 参数描述 类型 Owner 参数解释： 桶的所有者。 Container AccessControlList 参数解释： 授权列表。 Container 表Owner 参数名称 参数描述 类型 ID 参数解释： 桶所有者的uid。 String DisplayName 参数解释： 桶所有者的展示名称。 String 表AccessControlList 参数名称 参数描述 类型 Grant 参数解释： 授权信息。 Container 表Grant 参数名称 参数描述 类型 Grantee 参数解释： 授权主体。 Container Permission 参数解释： 授予的权限。 取值范围： FULLCONTROL、WRITE、WRITEACP、READ、READACP String 表Grantee 参数名称 参数描述 类型 ID 参数解释： 被授权用户的UID。 String xsi:type 参数解释： 被授权用户类型。 String URI 参数解释： 被授权组URI。 String 错误码 请参见调用前必知错误码全局错误码。

功能说明 PutBucketEncryption请求设置存储桶默认加密功能。 注意事项 若使用KMS加密算法，需要资源池对接KMS服务，支持的线上资源池参考产品能力地图。 请求消息样式 plaintext PUT /{Bucket}?encryption HTTP/1.1 Host: xxxx.zos.ctyun.cn AcceptEncoding: Identity xamzcontentsha256: ContentSHA256 xamzdate: Date ContentLength: ContentLength ContentMD5: ContentMD5 Authorization: Auth String string string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 参数名称 参数描述 类型 是否必须 ServerSideEncryptionConfiguration 参数解释： 指定默认的服务端加密配置。 Container 是 表ServerSideEncryptionConfiguration 参数名称 参数描述 类型 是否必须 Rule 参数解释： 服务端加密配置规则信息。 Container 是 表Rule 参数名称 参数描述 类型 是否必须 ApplyServerSideEncryptionByDefault 参数解释： 指定默认的服务端加密配置，若上传对象时请求中未指定任何加密信息，则会使用该加密配置。 Container 否 表ApplyServerSideEncryptionByDefault 参数名称 参数描述 类型 是否必须 SSEAlgorithm 参数解释： 加密算法。 取值范围： 仅支持AES256和aws:kms。 String 是 KMSMasterKeyID 参数解释： 加密密钥。 约束限制： 若加密算法选用的是aws:kms，则此项必填，参数格式为"{密钥管理服务处的密钥ID}::::{userID}"，其中userId是用户的ctyun账号id。 若加密算法选用的是AES256，则此项可不填，若填，则字符长度需为32。 String 否

参数名称 参数描述 类型 InventoryConfiguration 参数解释： 桶清单信息的根标签。 Container

参数名称 参数描述 类型 AccessControlPolicy 参数解释： 授权信息的根标签 Container

功能说明 GetSymlink获取软链接，得到版本号和链接所指向的对象名。如果软链接的当前版本为删除标记，服务端会返回404 Not Found。 请求消息样式 plaintext GET /{Bucket}/{Object}?symlink&versionIdxxx HTTP/1.1 Host: xxx.zos.ctyun.cn xzossymlinktarget: xxx xzosforbidoverwrite:xxx AcceptEncoding: identity xamzcontentsha256: ContentSHA256 xamzdate: 20250107T025728Z ContentLength: 0 Authorization: string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Object 参数解释： Object的名称。 String 是 versionId 参数解释： Object的指定版本。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000400677c98181f09bbdefault ContentLength: 0 Date: Tue, 07 Jan 2025 02:57:28 GMT Connection: KeepAlive xzossymlinktarget: xxx 响应消息头 参数描述 参数描述 类型 xzossymlinktarget 参数解释： 软链接指向的目标文件。 String xamzversionid 参数解释： 指定对象的版本id。 String 响应消息元素 该请求的响应中不带有响应元素。

参数名称 参数描述 类型 是否必须 ID 参数解释： 对象所有者的uid。 String 消息体方式下必须

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

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

参数名称 参数描述 类型 是否必须 Tagging 参数解释： 根标签。 Container 是

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

参数名称 参数描述 参数类型 DaysAfterInitiation 参数解释： 标识为完成的分段的过期时间。 Long

功能说明 GetObjectLegalHold请求获取指定对象的当前依法保留状态。 请求消息样式 plaintext GET /{Bucket}/{Key}?legalhold&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: tx00000000000000000000d00624e4bc55e72default ContentType: application/xml ContentLength: 80 Date: Thu, 07 Apr 2022 02:26:29 GMT Connection: KeepAlive string 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 参数名称 参数描述 类型 LegalHold 参数解释： 指定对象依法保留配置。 Container 表LegalHold 参数名称 参数描述 类型 Status 参数解释： 是否打开对象依法保留。 取值范围： ON：打开 OFF：关闭 String

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

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

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

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

功能说明 GetBucketObjectLock请求获取存储桶的对象锁定配置。对象锁定功能将会应用到每一个新放入到存储桶中的对象。 请求消息样式 plaintext GET /{Bucket}?objectlock HTTP/1.1 Host: xxxx.zos.ctyun.cn AcceptEncoding: identity xamzcontentsha256: ContentSHA256 xamzdate: 20220407T022928Z Authorization: string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000f00624e4c895e72default ContentType: application/xml ContentLength: 222 Date: Thu, 07 Apr 2022 02:29:45 GMT Connection: KeepAlive string integer string integer 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 参数名称 参数描述 类型 ObjectLockConfiguration 参数解释： 桶的名称。 Container 表ObjectLockConfiguration 参数名称 参数描述 类型 ObjectLockEnabled 参数解释： 指定桶的对象锁定功能是否生效。 String Rule 参数解释： 对象锁定规则。 Container 表Rule 参数名称 参数描述 类型 DefaultRetention 参数解释： 对象锁定规则中指定的默认配置。 Container 表DefaultRetention 参数名称 参数描述 类型 Mode 参数解释： 对象锁定规则中指定的默认保留期限模式。 取值范围： GOVERNANCE：监管模式 COMPLIANCE：合规性模式 String Days 参数解释： 保留期限日期，单位：天。与Years设置只能二选一。 Long Years 参数解释： 保留期限日期，单位：年。与Days设置只能二选一。 Long

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

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

Region Region ID 外网Endpoint 内网Endpoint 上海7 a17034a4794111eaaa590242ac110002 重庆2 a10d954c70f411eab3650242ac110002 成都4 2cdd393e876f11ea98880242ac110002 拉萨3 07323cf87fa811ea977e0242ac110002 九江 9859b8964d5d11eaba270242ac110002 内蒙6 6019b5007a0b11eab5db0242ac110002 西安5 dc3aceb4412211ecb8e70242ac110002 合肥2 45d9efdad66f11ec9aab0242ac110002 海口2 705213b6876e11eaa5740242ac110002 昆明2 415089caaea711eab0790242ac110002 广州6 995b39bae63811ec8c4b0242ac110002 杭州2 21c52b2a876e11ea9f6a0242ac110002 北京5 b6bb383e876c11ea8a5e0242ac110002 南京5 52c69bbc042411ec8dac0242ac110002 晋中 49829300a71211ea95240242ac110002 武汉4 8062c840876e11ea9d060242ac110002 辽阳1 200000001681 郴州2 9833d24065a211eaa6070242ac110002 贵州3 aaf589124d5d11eaa04d0242ac110002 西宁2 ee554404876e11eaab640242ac110002 福州25 200000001627 厦门3 57548b92758811ebb16c0242ac110002 兰州2 dff35c48876e11eaadc90242ac110002 乌鲁木齐27 200000001788 石家庄20 200000001747 中卫5 200000001748 杭州7 200000003329

响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentType: ContentType ContentLength: ContentLength Date: Date Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。