tencent cloud

文档反馈

公共元素

最后更新时间:2023-12-21 17:44:20
    本文提供以下批量处理功能的公共元素。

    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
    指定对清单内的对象批量复制操作的具体参数。
    COSPutObjectCopyObject
    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有赋值,可实现增加前缀操作;
    ResourcesPrefixTargetKeyPrefix同时有赋值,可实现替换前缀操作;
    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

    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