参数名称 参数描述 类型 是否必须 Prefix 参数解释： 指定源存储桶中需要进行清单导出的文件前缀。 String 否

请求消息元素 参数名称 参数描述 类型 是否必须 AccessControlPolicy 参数解释： 授权信息的根标签。 Container 消息体方式下必须 表AccessControlPolicy 参数名称 参数描述 类型 是否必须 Owner 参数解释： 桶的所有者。 Container 消息体方式下必须 AccessControlList 参数解释： 授权列表。 Container 消息体方式下必须 表Owner 参数名称 参数描述 类型 是否必须 ID 参数解释： 桶所有者的uid。 String 消息体方式下必须 表AccessControlList 参数名称 参数描述 类型 是否必须 Grant 参数解释： 授权信息。 Container 消息体方式下必须 表Grant 参数名称 参数描述 类型 是否必须 Grantee 参数解释： 授权主体。 Container 消息体方式下必须 Permission 参数解释： 授予的权限。 取值范围： FULLCONTROL、WRITE 、WRITEACP、READ、READACP String 消息体方式下必须 表Grantee 参数名称 参数描述 类型 是否必须 ID 参数解释： 被授权用户的UID。 String CanonicalUser类型下必须 xsi:type 参数解释： 被授权用户类型。 取值范围： CanonicalUser 、Group String 消息体方式下必须 URI 参数解释： 被授权组URI。 取值范围： 所有用户： 所有认证用户： String Group类型下必须

请求发出后，您会收到服务端的响应，其中包含状态码、响应消息头和响应消息体。 状态码 状态码是一组数字代码，其中包含1xx、2xx、3xx、4xx和5xx五种类型，它可以表示请求响应的状态。 1xx（信息性状态码）：请求已被接收，继续处理（如100 Continue）。 2xx（成功状态码）：请求已成功处理（如200 OK、204 No Content）。 3xx（重定向状态码）：需进一步操作以完成请求（如301 永久重定向、302 临时重定向）。 4xx（客户端错误）：请求包含错误或无法完成（如400 参数错误、403 无权限）。 5xx（服务器错误）：服务器处理请求时失败（如500 服务器内部错误、502 网关错误）。 响应消息头 响应消息头是服务器在返回数据时附加的元信息，用于描述响应的各项属性，ZOS的公共响应头字段如下表所示。 名称 描述 类型 ContentLength 回复中Body的长度，以字节为单位 String Connection 指定服务器连接打开或关闭，有效值keepalive｜close Enum Date 响应的时间和日期，格式如：Sun, 05 Sep 2021 23:00:00 GMT String xamzrequestid xamzrequestid是由ZOS创建，并唯一标识一个请求。可用于ZOS快速定位问题 String 响应消息体 响应消息体存储实际返回的数据（如 JSON/XML 格式），其类型由响应头的ContentType定义，用于传递消息头无法容纳的具体内容。

错误响应消息格式 当服务端处理请求发生错误时，会返回包含错误信息的响应，其结构如下： 响应头部信息 ContentType: application/xml（指明响应体为XML格式） 状态码：4xx（客户端错误）或5xx（服务端错误） 响应体示例 plaintext InvalidArgument tx0000000000000000000020068491d6f5004d5default 5004d5defaultdefault 其中响应消息体里的各元素的具体含义如下表所示： 元素名称 描述 Error 错误响应的根节点，包含所有错误相关信息 Code 错误代码，标识具体的错误类型（如InvalidArgument） RequestId 本次请求的唯一标识符，用于服务端日志追踪和问题定位 HostId 处理请求的服务端实例标识，在多节点部署时可用于定位具体出错的服务器 全局错误码 请求可能会返回相关错误，具体错误码编号及信息请参考下表。同一个错误码可能对应不同的错误码描述，具体由接口来决定。 状态码 错误码 错误信息 400 InvalidArgument 请求参数错误 400 InvalidRequest 请求无效 400 InvalidDigest 内容摘要无效 400 BadDigest 错误摘要 400 InvalidLocationConstraint 区域限制无效 400 ZonegroupDefaultPlacementMisconfiguration 默认放置策略配置错误 400 InvalidTargetBucketForLogging 日志目标桶无效 400 InvalidBucketName 桶名无效 400 InvalidObjectName 对象名无效 400 UnresolvableGrantByEmailAddress 无法通过邮箱解析授权 400 InvalidPart 无效的分片 400 InvalidPartOrder 分片顺序无效 400 RequestTimeout 请求超时 400 EntityTooLarge 实体过大 400 EntityTooSmall 实体过小 400 TooManyBuckets 桶数量过多 400 MalformedXML 错误的 XML 400 XAmzContentSHA256Mismatch SHA256 校验失败 400 MalformedPolicyDocument 错误的策略文档 400 InvalidTag 标签无效 400 MalformedACLError 错误的 ACL 400 InvalidEncryptionAlgorithmError 加密算法无效 400 InvalidPrefix 前缀无效 400 InvalidRetentionPeriod 保留期无效 400 InvalidBackToSourceOrigin 回源设置无效 400 InvalidLCConfiguration 生命周期配置错误 400 MissingContentLength 缺失内容长度 400 InvalidSecretKey 无效的 Secret Key 400 InvalidKeyType 密钥类型无效 400 InvalidCapability 权限能力值无效 400 InvalidTenantName 租户名无效 400 InvalidKMSEncryptionKeyId KMS 密钥 ID 无效 400 InvalidRenameAlgorithm 重命名算法无效 400 InvalidHashAlgorithm 哈希算法无效 400 CallBackRequestFailed 回调请求失败 400 NotSymlink 不是符号链接 400 InvalidTargetType 目标类型无效 400 ExtzoneSyncUnreachable 跨区同步不可达 400 NotMainSubRelation 非主子账号关系 400 InvalidStorageClass 存储类别无效 400 AccessMonitorDisableNotAllowed 不允许禁用访问监控 403 AccessDenied 拒绝访问 403 ObjectLocked 对象处于合规保留状态 403 SignatureDoesNotMatch 签名不匹配 403 InvalidAccessKeyId Access Key 无效 403 UserSuspended 用户已暂停 403 RequestTimeTooSkewed 请求时间与服务器偏差过大 403 QuotaExceeded 超出配额 404 NoSuchKey 对象不存在 404 NoSuchBucket 桶不存在 404 NoIvtDestBucket 目标桶不存在 404 NoSuchWebsiteConfiguration 网站配置不存在 404 NoSuchUpload 上传任务不存在 404 Not Found 找不到资源 404 NoSuchLifecycleConfiguration 生命周期配置不存在 404 NoSuchBucketInventory 桶清单不存在 404 NoSuchUnzipTask 解压任务不存在 404 InvalidUnzipTaskState 解压任务状态无效 404 NoSuchBucketPolicy 桶策略不存在 404 NoSuchUser 用户不存在 404 NoSuchEntity 实体不存在 404 NoSuchCORSConfiguration CORS 配置不存在 404 ObjectLockConfigurationNotFoundError 对象锁配置不存在 404 NoSuchSubUser 子用户不存在 404 NoSuchTagSetError 标签集合不存在 404 NoSuchEncryptionSetError 加密配置不存在 404 SymlinkTargetNotExist 符号链接目标不存在 404 MainUserNotExist 主账号不存在 404 NoSuchSubaccount 子账户不存在 405 MethodNotAllowed 方法不被允许 409 EntityAlreadyExists 实体已存在 409 BucketAlreadyExists 桶已存在 409 UserAlreadyExists 用户已存在 409 EmailExists 邮箱已存在 409 KeyExists 密钥已存在 409 PartExists 分片已存在 409 OperationAborted 操作中止 409 PositionNotEqualToLength 上传位置与长度不符 409 ObjectNotAppendable 对象不可追加写入 409 InvalidBucketState 桶状态无效 409 InvalidObjectState 对象状态无效 409 RestoreAlreadyInProgress 正在恢复中 409 GlacierObjectNotRestore Glacier 对象尚未恢复 409 NotGlacierObject 非 Glacier 对象 409 GlacierObjectNotExtzoneSync Glacier 对象未进行跨区同步 409 ObjectAlreadyExists 对象已存在 409 BucketNotEmpty 桶非空 409 SubaccountAlreadyExists 子账户已存在 409 InvalidBucketVersions 桶版本不匹配 412 PreconditionFailed 前提条件失败 416 InvalidRange 范围请求无效 422 UnprocessableEntity 实体无法处理 423 Locked 资源被锁定 500 InternalError 内部错误 500 InvalidStoragePool 存储池无效 501 NotImplemented 功能未实现 503 ServiceUnavailable 服务不可用 503 SlowDown 请求过于频繁，请稍后重试

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

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

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

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

功能说明 DeleteBucketPolicy接口用于删除指定桶的策略。 消息样式 plaintext DELETE /{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 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 delimiter 参数解释： 对key名称进行分组的字符。 String 否 marker 参数解释： 列举key的起始位置，返回的列表将是以key名按照字典序排在该参数后的对象。 String 否 maxkeys 参数解释： 本次返回keys的最大数目。 约束限制： 小于0时返回结果为0，大于1000时返回结果为1000。 取值范围： 01000 默认取值： 1000 Int 否 prefix 参数解释： 返回的key的前缀。 String 否

参数名称 参数描述 类型 ID 参数解释： 被授权用户的UID。 String xsi:type 参数解释： 被授权用户类型。 String URI 参数解释： 被授权组URI。 String

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

功能说明 GetBucketInventory返回目标桶的某项桶清单配置。 请求消息样式 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

参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 Object 参数解释： 对象的名称。 String 是 versionId 参数解释： 多版本场景下，指定对象的特定版本。 String 否

请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 Object 参数解释： 对象的名称。 String 是 versionId 参数解释： 多版本场景下，指定对象的特定版本。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。但可以带附加消息头，附加请求消息头如下表所示。 参数名称 参数描述 类型 是否必须 xamzacl 参数解释： 为当前对象设置的ACL名称 约束限制： 不能与其他 xamzgrant同时使用 取值范围： private：私有。 publicread：公共读。 publicreadwrite：公共读写。注意：由于安全限制，对象存储底层禁用公共读写，设置后不可匿名写，如需使用可提工单申请。 authenticatedread：所有经过认证的用户都可以获取该对象。 String 否 xamzgrantfullcontrol 参数解释： 被授权用户可以对当前对象进行read, read ACP, write ACP操作 约束限制： 格式”idxxx”或”emailAddressxxx”或者”urixxx”以及他们的组合（用逗号连接） String 否 xamzgrantread 参数解释： 被授权用户可以对当前对象进行读操作，即下载该对象 约束限制： 格式”idxxx”或”emailAddressxxx”或者”urixxx”以及他们的组合（用逗号连接） String 否 xamzgrantreadacp 参数解释： 被授权用户可以读取当前对象的ACL 约束限制： 格式”idxxx”或”emailAddressxxx”或者”urixxx”以及他们的组合（用逗号连接） String 否 xamzgrantwriteacp 参数解释： 被授权用户可以修改当前对象的ACL 约束限制： 格式”idxxx”或”emailAddressxxx”或者”urixxx”以及他们的组合（用逗号连接） String 否

参数名称 参数描述 类型 Tagging 参数解释： 标签集容器。 Container

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

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

参数名称 参数描述 类型 ListInventoryConfigurationsResult 参数解释： 存储桶清单配置的列表结果根标签。 Container

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

参数名称 描述 类型 是否必须 BucketLoggingStatus 参数解释： 日志状态信息。若此参数置为空，则表示关闭日志转存功能。 Container 是

参数名称 参数描述 类型 IsTruncated 参数解释： 列表结果是否被截断。 Boolean Version 参数解释： 单个多版本对象信息的容器。 Container DeleteMarker 参数解释： 单个多版本对象的deletemaker信息的容器。 Container KeyMarker 参数解释： 列举多版本key的起始位置。 String NextKeyMarker 参数解释： 若结果被截断，则给出分页所需的KeyMarker。 String VersionIdMarker 参数解释： 列举多版本key的版本号的起始位置。 String NextVersionIdMarker 参数解释： 若结果被截断，则给出分页所需的VersionIdMarker。 String Name 参数解释： Bucket的名称。 String Prefix 参数解释： 列出请求时指定的前缀。 String Delimiter 参数解释： 列出请求时指定的路径分隔符。 String MaxKeys 参数解释： 列出请求时指定的最大记录数。 Long

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

参数名称 参数描述 类型 Status 参数解释： 桶的版本控制状态信息。假如从没设置过多版本，则没有该字段信息。 取值范围： Enabled：开启 Suspended：暂停 String MfaDelete 参数解释： 桶的多版本删除保护状态信息，展示是否启用MFA 删除。 String

功能说明 DeleteBucketTagging接口用于删除Bucket上的标签。该操作需要s3:PutBucketTagging权限，桶的拥有者默认具有该权限。 注意事项 通过API设置桶标签和通过控制台设置桶标签是完全不同的两套标签功能，二者不互通，故通过API删除桶标签只能删除通过API或SDK设置的桶标签，无法删除通过控制台设置的桶标签。 请求消息样式 plaintext DELETE /{Bucket}?tagging HTTP/1.1 Host: xxxx.zos.ctyun.cn ContentLength: 0 xamzcontentsha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 xamzdate: 20220408T030447Z Authorization: string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000500624fa64f2a818nanjing3 ContentType: application/xml ContentLength: 0 Date: Fri, 08 Apr 2022 03:04:47 GMT Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。

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

参数名称 参数描述 类型 是否必须 ID 参数解释： 跨域规则的ID。 约束限制： 最长长度为255个字符。 String 否 AllowedHeader 参数解释： 允许浏览器发送CORS请求时携带的自定义HTTP请求头部。 约束限制： 不区分英文大小写，单条CORSRule可以配置多个AllowedHeader。 String 否 AllowedMethod 参数解释： 允许该源执行的HTTP方法列表。 约束限制： 只能填入GET、PUT、HEAD、POST和DELETE，单条规则可以配置多个方法。 String 是 AllowedOrigin 参数解释： 允许能够访问该bucket的一个或多个源,支持 通配符，表示所有域名都允许访问，不推荐。 约束限制： 一条CORSRule可以配置多个AllowedOrigin。 String 是 ExposeHeader 参数解释： 允许浏览器获取的CORS请求响应中的头部。 约束限制： 不区分英文大小写，单条CORSRule可以配置多个 ExposeHeader。 String 否 MaxAgeSeconds 参数解释： 跨域资源共享配置的有效时间，单位为秒，对应CORS请求响应中的AccessControlMaxAge头部。 约束限制： 单条CORSRule只能配置一个MaxAgeSeconds。 Integer 否

参数名称 参数描述 类型 是否必须 Body 参数解释： 对象内容。 Binary 否

参数名称 描述 类型 Key 参数解释： 该分段的对象名。 String UploadId 参数解释： 该分段的 UploadId。 String Initiator 参数解释： 创建该分段上传的用户信息。 Container Owner 参数解释： 该分段所属用户。 Container StorageClass 参数解释： 该分段的存储级别。 String Initiated 参数解释： 该分段创建时间 String

请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code TransferEncoding: chunked xamzrequestid: tx00000000000000000004700624d4f505403fdefault ContentType: application/xml Date: Wed, 06 Apr 2022 08:29:04 GMT Connection: KeepAlive bkmultipart key 2~DixxGkXNw6F79q2AcwMQH41XMMkUr STANDARD 0 2 100 false 20220406T08:26:45.233Z 1 "5f363e0e58a95f06cbe9bbc662c5dfb6" 5242880 20220406T09:01:41.181Z 2 "af5df3928dffe923b1756663188295a7" 124 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 参数名称 参数描述 类型 ListPartsResult 参数解释： 本次列举分段数据返回的结果。 Container 表ListPartsResult 参数名称 参数描述 类型 Bucket 参数解释： 分段上传的Bucket名称 String Key 参数解释： 用户分段上传的对象名。 String UploadId 参数解释： 分段上传的ID。 String PartNumberMarker 参数解释： 本次请求的起始分段号。 Long NextPartNumberMarker 参数解释： 下一次请求的起始分段号，当分段信息过多是，该请求可以多次发送。 Long MaxParts 参数解释： 最多返回的分段数。 Long IsTruncated 参数解释： 是否截断返回，当该对象的分段数大于MaxParts时，该值为true。 Boolean Owner 参数解释： 对象所有者信息。 Container Part 参数解释： 各个分段信息。 Container 表Owner 参数名称 参数描述 类型 DisplayName 参数解释： 所有者名称。 String ID 参数解释： 所有者ID。 String 表Part 参数名称 参数描述 类型 LastModified 参数解释： 该分段的最新更新时间。 Date PartNumber 参数解释： 分段号。 Long Etag 参数解释： 该分段的Etag。 String Size 参数解释： 该分段大小，单位为bytes。 Long

参数名称 参数描述 类型 CompleteMultipartUploadResult 参数解释： 接口返回的结果信息 Container

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