History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
POST /jobs HTTP/1.1Host: <UIN>.cos-control.<Region>.myqcloud.comDate: GMT DateContent-Type: application/xmlContent-Length: Content LengthAuthorization: Auth Stringx-cos-appid: <APPID><?xml version="1.0" encoding="UTF-8"?><CreateJobRequest>...</CreateJobRequest>
参数 | 描述 | 是否必选 |
x-cos-appid | 用户的 APPID，长度为1 - 64字节。 | 是 |
<CreateJobRequest><ClientRequestToken>string</ClientRequestToken><ConfirmationRequired>boolean</ConfirmationRequired><Description>string</Description><Manifest><Location><ETag>string</ETag><ObjectArn>string</ObjectArn><ObjectVersionId>string</ObjectVersionId></Location><Spec><Fields><member>string</member><member>string</member></Fields><Format>string</Format></Spec></Manifest><Operation><COSInitiateRestoreObject><ExpirationInDays> integer </ExpirationInDays><JobTier> string </JobTier></COSInitiateRestoreObject><COSPutObjectCopy><AccessControlDirective>string</AccessControlDirective><AccessControlGrants><COSGrant><Grantee><Identifier>string</Identifier><TypeIdentifier>string</TypeIdentifier></Grantee><Permission>string</Permission></COSGrant><COSGrant><Grantee><Identifier>string</Identifier><TypeIdentifier>string</TypeIdentifier></Grantee><Permission>string</Permission></COSGrant></AccessControlGrants><PrefixReplace>boolean</PrefixReplace><ResourcesPrefix>string</ResourcesPrefix><TargetKeyPrefix>string</TargetKeyPrefix><CannedAccessControlList>string</CannedAccessControlList><MetadataDirective>string</MetadataDirective><ModifiedSinceConstraint>timestamp</ModifiedSinceConstraint><UnModifiedSinceConstraint>timestamp</UnModifiedSinceConstraint><MetadataDirective>string</MetadataDirective><NewObjectMetadata><CacheControl>string</CacheControl><ContentDisposition>string</ContentDisposition><ContentEncoding>string</ContentEncoding><ContentType>string</ContentType><HttpExpiresDate>timestamp</HttpExpiresDate><SSEAlgorithm>string</SSEAlgorithm><UserMetadata><member><Key>string</Key><Value>string</Value></member><member><Key>string</Key><Value>string</Value></member></UserMetadata></NewObjectMetadata><TaggingDirective>string</TaggingDirective><NewObjectTagging><COSTag><Key>string</Key><Value>string</Value></COSTag></NewObjectTagging><StorageClass>string</StorageClass><TargetResource>string</TargetResource></COSPutObjectCopy></Operation><Priority>integer</Priority><Report><Bucket>string</Bucket><Enabled>boolean</Enabled><Format>string</Format><Prefix>string</Prefix><ReportScope>string</ReportScope></Report><RoleArn>string</RoleArn></CreateJobRequest>
节点名 | 父节点 | 描述 | 类型 | 是否必选 |
ClientRequestToken | CreateJobRequest | 每个请求唯一的 token，用于避免前端重复发起同一批处理任务。长度为1 - 64字节，建议使用 uuid。 | String | 是 |
ConfirmationRequired | CreateJobRequest | 是否在执行任务前进行确认。默认值为 false。 | Boolean | 否 |
Description | CreateJobRequest | 任务描述。若您在创建任务时配置了此信息，则会返回该项内容。描述长度范围为0 - 256字节。 | String | 否 |
Manifest | CreateJobRequest | Manifest Object | 是 | |
Operation | CreateJobRequest | Operation Object | 是 | |
Priority | CreateJobRequest | 任务优先级。越高的数值代表此项任务的优先级越高。优先级数值范围为0 - 2147483647。 | Integer | 是 |
Report | CreateJobRequest | 任务完成报告。您可配置此参数以在任务完成时输出报告，方便审计任务执行状况。 | Report Object | 是 |
RoleArn | CreateJobRequest | COS 资源标识符，此处用于标识您创建的角色。您需要此资源标识符以验证您的身份。 | String | 是 |
<CreateJobResult><JobId>string</JobId></CreateJobResult>
节点名 | 父节点 | 描述 | 类型 |
JobId | CreateJobResult | 任务 ID。当您成功创建一项任务后，COS 自动返回的 ID，长度1 - 64字节。 | String |
错误代码 | 描述 | 状态码 | API |
InvalidRequest | 重复的请求 | 400 | CreateJob |
InvalidRequest | 优先级的有效范围是0 - 2147483647的整数 | 400 | CreateJob |
MalformedXML | 请求体的 XML Manifest 字段不符合 XML 语法 | 400 | CreateJob |
MalformedXML | 请求体的 XML Operation 字段不符合 XML 语法 | 400 | CreateJob |
MalformedXML | 请求体的 XML Report 字段不符合 XML 语法 | 400 | CreateJob |
ServiceUnavailable | 服务暂不可用，无法建立新的任务 | 500 | CreateJob |
TooManyJobs | 任务已达上限，服务器不可用 | 500 | CreateJob |
POST /jobs HTTP/1.1Host: 100000000001.cos-control.ap-chengdu.myqcloud.comDate: Thu, 19 Dec 2019 18:00:29 GMTx-cos-appid: 1250000000Content-Type: application/xmlContent-Length: 1056Content-MD5: hHcgq5mu8s0YP4WTGiQ+uA==Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1576778429;1576785629&q-key-time=1576778429;1576785629&q-header-list=content-length;content-md5;content-type;date;host;x-cos-appid&q-url-param-list=&q-signature=8e0db6883376b5df713819f878da5020c5b6****Connection: close<CreateJobRequest><ClientRequestToken>184ce261-18af-5e3d-3e30-253723cfd937</ClientRequestToken><ConfirmationRequired>false</ConfirmationRequired><Description>example-job</Description><Manifest><Location><ETag>"15150651828fa9cdcb8356b6d1c7638b"</ETag><ObjectArn>qcs::cos:ap-chengdu::sourcebucket-1250000000/manifests/batch-copy-manifest.csv</ObjectArn></Location><Spec><Fields><member>Bucket</member><member>Key</member></Fields><Format>COSBatchOperations_CSV_V1</Format></Spec></Manifest><Operation><COSPutObjectCopy><TargetResource>qcs::cos:ap-chengdu:uid/1250000000:destinationbucket-1250000000</TargetResource></COSPutObjectCopy></Operation><Priority>10</Priority><Report><Bucket>qcs::cos:ap-chengdu::sourcebucket-1250000000</Bucket><Enabled>true</Enabled><Format>Report_CSV_V1</Format><Prefix>job-result</Prefix><ReportScope>AllTasks</ReportScope></Report><RoleArn>qcs::cam::uin/100000000001:roleName/COS_Batch_QcsRole</RoleArn></CreateJobRequest>
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 89Connection: closeDate: Thu, 19 Dec 2019 18:00:30 GMTServer: tencent-cosx-cos-request-id: NWRmYmJhYmRfMjViMjU4NjRfNmIzYV8xMDE2****<CreateJobResult><JobId>53dc6228-c50b-46f7-8ad7-65e7159f1aae</JobId></CreateJobResult>
文档反馈