tencent cloud

对象存储

动态与公告
产品动态
产品公告
产品简介
产品概述
功能概览
应用场景
产品优势
基本概念
地域和访问域名
规格与限制
产品计费
计费概述
计费方式
计费项
免费额度
计费示例
查看和下载账单
欠费说明
常见问题
快速入门
控制台快速入门
COSBrowser 快速入门
用户指南
创建请求
存储桶
对象
数据管理
批量处理
全球加速
监控与告警
运维中心
数据处理
内容审核
智能工具箱
数据工作流
应用集成
工具指南
工具概览
环境安装与配置
COSBrowser 工具
COSCLI 工具
COSCMD 工具
COS Migration 工具
FTP Server 工具
Hadoop 工具
COSDistCp 工具
HDFS TO COS 工具
GooseFS-Lite 工具
在线辅助工具
自助诊断工具
实践教程
概览
访问控制与权限管理
性能优化
使用 AWS S3 SDK 访问 COS
数据容灾备份
域名管理实践
图片处理实践
COS 音视频播放器实践
工作流实践
数据直传
内容审核实践
数据安全
数据校验
大数据实践
COS 成本优化解决方案
在第三方应用中使用 COS
迁移指南
本地数据迁移至 COS
第三方云存储数据迁移至 COS
以 URL 作为源地址的数据迁移至 COS
COS 之间数据迁移
Hadoop 文件系统与 COS 之间的数据迁移
数据湖存储
云原生数据湖
元数据加速
数据加速器 GooseFS
数据处理
数据处理概述
图片处理
媒体处理
内容审核
文件处理
文档处理
故障处理
获取 RequestId 操作指引
通过外网上传文件至 COS 缓慢
访问 COS 时返回403错误码
资源访问异常
POST Object 常见异常
API 文档
简介
公共请求头部
公共响应头部
错误码
请求签名
操作列表
Service 接口
Bucket 接口
Object 接口
批量处理接口
数据处理接口
任务与工作流
内容审核接口
云查毒接口
SDK 文档
SDK 概览
准备工作
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
小程序 SDK
错误码
鸿蒙(Harmony) SDK
终端 SDK 质量优化
安全与合规
数据容灾
数据安全
访问管理
常见问题
热门问题
一般性问题
计费计量问题
域名合规问题
存储桶配置问题
域名和 CDN 问题
文件操作问题
日志监控问题
权限管理问题
数据处理问题
数据安全问题
预签名 URL 问题
SDK 类问题
工具类问题
API 类问题
服务协议
Service Level Agreement
隐私政策
数据处理和安全协议
联系我们
词汇表
文档对象存储API 文档批量处理接口 公共元素

公共元素

PDF
聚焦模式
字号
最后更新时间： 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有赋值，可实现增加前缀操作；
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
是

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

上一篇: UpdateJobStatus下一篇: 错误响应

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈