本文提供以下批量处理功能的公共元素。
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 |
否 |
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>值为 Replace 或 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 |
是 |
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 |
是 |
| 节点名 |
父节点 |
描述 |
类型 |
是否必选 |
| 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 |
|
|
|
|
是
否
本页内容是否解决了您的问题？