本文提供以下批量处理功能的公共元素。
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 |
|
|
|
|
本页内容是否解决了您的问题?