本文提供以下批量处理功能的公共元素。
Manifest
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
Location | Manifest | 对象清单的位置信息。 | Location Object | 是 |
Spec | Manifest | 描述对象清单的格式信息。如果为 CSV 文件，此元素将描述清单中包含的字段。 | Spec Object | 是 |
Location
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
ETag | Location | 指定对象清单的 etag。长度1 - 1024字节。 | String | 是 |
ObjectArn | Location | 指定对象清单的唯一资源标识符，长度为1 - 1024字节。 | String | 是 |
ObjectVersionId | Location | 指定对象清单的版本 ID，长度为1 - 1024字节。 | String | 否 |
Spec
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
Fields | Spec | 描述清单中包含的字段，当 Format 为 COSBatchOperations_CSV_V1 时，需要使用此元素指定 CSV 文件字段。 合法字段为：Ignore、Bucket、Key、VersionId | Array of Strings | 否 |
Format | Spec | 指定对象清单的格式信息。 合法字段为： COSBatchOperations_CSV_V1、 COSInventoryReport_CSV_V1 | String | 是 |
Operation
注意：
单个任务中 Operation 只能包含下列多种操作中的一个。
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
COSPutObjectCopy | Operation | 指定对清单内的对象批量复制操作的具体参数。 | COSPutObjectCopy Object | 否 |
COSInitiateRestoreObject | Operation | 指定对清单内的归档存储类型对象批量恢复操作的具体参数。 | COSInitiateRestoreObject | 否 |
COSDeleteObject | Operation | 指定对清单内的对象批量删除操作。 说明： 本节点内不需要填入任何值，指定该字段即表示发起批量删除操作 | COSDeleteObject | 否 |
COSPutObjectTagging | Operation | 指定对清单内的对象批量打标签操作的具体参数。 | COSPutObjectTagging | 否 |
COSPutObjectCopy
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
AccessControlDirective | COSPutObjectCopy | 该元素指定 ACL 的复制方式，有效值：Copy、Replaced、Add。 Copy：继承源对象ACL。 Replaced ：替换源 ACL。 Add：在源 ACL 的基础上添加新的 ACL。 | String | 否 |
AccessControlGrants | COSPutObjectCopy | 控制对象的具体访问权限。 | AccessControlGrants Object | 否 |
CannedAccessControlList | COSPutObjectCopy | 定义对象的 ACL 属性。有效值：private、public-read | String | 否 |
PrefixReplace | COSPutObjectCopy | 指定是否需要替换源对象的前缀，值为 true 时，表示替换对象前缀，需搭配 <ResourcesPrefix>和<TargetKeyPrefix>使用。默认值：false。 | Boolean | 否 |
ResourcesPrefix | COSPutObjectCopy | 当 <PrefixReplace>值为 true 时，这个字段才有效。指定需要替换的源对象前缀，替换目录请以/结尾。可以为空，最长1024字节。 | String | 否 |
TargetKeyPrefix | COSPutObjectCopy | 当 <PrefixReplace>值为 true 时，这个字段才有效。该值表示替换后的前缀，替换目录请以/结尾。可以为空，最长1024字节。例：源对象为 picture.jpg，设置 ResourcesPrefix值为 pic，TargetKeyPrefix值为 abc，则执行结果为 picture.jpg 变为 abcture.jpg。注意： ResourcesPrefix为空、TargetKeyPrefix有赋值，可实现增加前缀操作。ResourcesPrefix和TargetKeyPrefix同时有赋值，可实现替换前缀操作。若 ResourcesPrefix有赋值、TargetKeyPrefix为空，可实现删除前缀操作。 | String | 否 |
ModifiedSinceConstraint | COSPutObjectCopy | 当对象在指定时间后被修改，则执行操作，否则返回412。 | Timestamp | 否 |
UnModifiedSinceConstraint | COSPutObjectCopy | 当对象在指定时间后未被修改，则执行操作，否则返回412。 | Timestamp | 否 |
MetadataDirective | COSPutObjectCopy | 该元素指定是从源对象复制对象元数据还是替换为 <NewObjectMetadata>元素中的元数据，有效值为：Copy、Replaced、Add。Copy：继承源对象元数据。 Replaced ：替换源元数据。 Add：在源元数据的基础上添加新的元数据。 | String | 否 |
NewObjectMetadata | COSPutObjectCopy | 配置对象的元数据。 | NewObjectMetadata Object | 否 |
TaggingDirective | COSPutObjectCopy | 该元素指定是从源对象复制对象标签还是替换为 <NewObjectTagging>元素中的标签，有效值为：Copy、Replaced、Add。Copy：继承源对象标签。 Replaced ：替换源标签。 Add：在源标签的基础上添加新的标签。 | String | 否 |
NewObjectTagging | COSPutObjectCopy | 配置对象的标签，当 <TaggingDirective>值为 Replaced 或 Add 时必须指定。 | NewObjectTagging | 否 |
StorageClass | COSPutObjectCopy | 设置对象的存储级别，枚举值：STANDARD，STANDARD_IA。默认值：STANDARD | String | 否 |
TargetResource | COSPutObjectCopy | 设置 Copy 的目标存储桶。请使用 qcs 指定，例如 qcs::cos:ap-chengdu:uid/1250000000:examplebucket-1250000000 | String | 是 |
COSInitiateRestoreObject
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
ExpirationInDays | COSInitiateRestoreObject | 设置副本在多少天后自动过期删除，设置范围为1 - 365的整数。 | Integer | 是 |
JobTier | COSInitiateRestoreObject | 归档恢复模式选择，可选值：Bulk、Standard。 | String | 是 |
COSPutObjectTagging
节点 | 父节点 | 说明 | 类型 | 是否必选 |
TaggingDirective | COSPutObjectTagging | 该元素指定是从源对象替换为 <TagSet>元素中的标签，有效值为：Replaced | Add。 Replaced ：替换源标签。 Add：在源标签的基础上添加新的标签。 | String | 否 |
TagSet | COSPutObjectTagging | 包含标签的元素组。 | TagSet | 否 |
COSTag | TagSet | 包含配置的对象标签键和值。 | COSTag | 是 |
Key | COSTag | 标签键，长度为1 ~ 127。 | String | 是 |
Value | COSTag | 标签值，长度为1 ~ 255。 | String | 是 |
AccessControlGrants
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
COSGrant | AccessControlGrants | 配置一项权限控制。 | COSGrant Object | 否 |
COSGrant
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
Grantee | COSGrant | 指定将权限授予给哪个用户。 | Grantee Object | 是 |
Permission | COSGrant | 指定要授予的某项权限。枚举值：READ，WRITE，FULL_CONTROL 。 | String | 是 |
Grantee
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
DisplayName | Grantee | 用户名称。 | String | 否 |
Identifier | Grantee | qcs 格式的用户 ID（UIN）。例如： qcs::cam::uin/100000000001:uin/100000000001 | String | 是 |
TypeIdentifier | Grantee | 指定 Identifier 的类型，目前仅支持用户 ID。枚举值：ID 。 | String | 是 |
NewObjectMetadata
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
CacheControl | NewObjectMetadata | RFC 2616 中定义的缓存指令，将作为对象元数据保存。 | String | 否 |
ContentDisposition | NewObjectMetadata | RFC 2616 中定义的文件名称，将作为对象元数据保存。 | String | 否 |
ContentEncoding | NewObjectMetadata | RFC 2616 中定义的编码格式，将作为对象元数据保存。 | String | 否 |
ContentType | NewObjectMetadata | RFC 2616 中定义的内容类型，将作为对象元数据保存。 | String | 否 |
HttpExpiresDate | NewObjectMetadata | RFC 2616 中定义的缓存失效时间，将作为对象元数据保存。 | String | 否 |
SSEAlgorithm | NewObjectMetadata | 服务端加密算法，目前仅支持 AES256。 | String | 否 |
UserMetadata | NewObjectMetadata | 包括用户自定义元数据。 | Array of Key and Value | 否 |
Report
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
Bucket | Report | 任务完成报告的投递存储桶。 | String | 是 |
Enabled | Report | 是否输出任务完成报告。 | Boolean | 是 |
Format | Report | 任务完成报告格式信息。合法值： Report_CSV_V1。 | String | 是 |
Prefix | Report | 任务完成报告的前缀信息。长度0 - 256字节。 | String | 否 |
ReportScope | Report | 任务完成报告所需记录的任务信息，以确定记录所有操作执行信息还是失败操作的信息。合法值：AllTasks、FailedTasksOnly。 | String | 是 |
ProgressSummary
节点名 | 父节点 | 描述 | 类型 |
NumberOfTasksFailed | ProgressSummary | 当前失败的操作数。 | Integer |
NumberOfTasksSucceeded | ProgressSummary | 当前成功的操作数。 | Integer |
TotalNumberOfTasks | ProgressSummary | 总操作数。 | Integer |
