CreateJob

注意事项

• 作业状态为Complete并不代表每个条目都执行成功，最终每个条目的执行状况需以报告为准。比如lifecycle依赖批量作业来打tagging过滤进行回收的，要以最终报告为准。

• PutObjectTagging会覆盖既有的tagging。

• AddObjectTagging会先取Tagging、再更新，非原子性，但是如果有并发操作，则仍然可能会有覆盖行为。

• 如果有多个作业并发操作同一批Object，批量操作的执行顺序可能与提交顺序会不同，建议不要并发操作同一批Object。

• Complete状态，仅代表Job完成，但不代表全部Object执行成功；同理Cancelled、Paused、Suspended、Failed状态，可能有部分Object执行成功。

• 处于Suspended状态超过14天用户未确认的Job将会转成失败状态。

• 设置Job状态为Cancelled时，Job不会马上取消，会有一段时间处于Cancelling状态。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy概述或Bucket Policy授予操作权限。

请求语法

POST /?batchJob HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateJobRequest>
  <ConfirmationRequired>boolean</ConfirmationRequired>
  <Operation>
    <PutObjectTagging>
      <TagSet>
        <Tag>
          <Key>string</Key>
          <Value>string</Value>
        </Tag>
      </TagSet>
    </PutObjectTagging>
    <DeleteObjectTagging>
    </DeleteObjectTagging>
    <PutObjectAcl>
      <ObjectAcl>string</ObjectAcl>
    </PutObjectAcl>
    <RestoreObject>
      <Days>integer</Days>
      <Tier>string</Tier>
    </RestoreObject>
  </Operation>
  <Report>
    <Bucket>string</Bucket>
    <Enabled>boolean</Enabled>
    <Prefix>string</Prefix>
    <ReportScope>string</ReportScope>
  </Report>
  <ClientRequestToken>string</ClientRequestToken>
  <Manifest>
    <Location>
      <ETag>string</ETag>
      <Bucket>string</Bucket>
      <Object>string</Object>
      <VersionId>string</VersionId>
    </Location>
    <Spec>
      <Fields>string</Fields>
      <Format>string</Format>
    </Spec>
  </Manifest>
  <Description>string</Description>
  <Priority>integer</Priority>
  <RoleArn>string</RoleArn>
</CreateJobRequest>

请求头

此接口除支持公共请求头外，无特有请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求元素

响应元素

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

• 请求示例

  POST /?batchJob HTTP/1.1
  Host: oss-cn-hangzhou.aliyuncs.com
  Authorization: SignatureValue
  <?xml version="1.0" encoding="UTF-8"?>
  <CreateJobRequest>
    <ConfirmationRequired>false</ConfirmationRequired>
    <Operation>
      <PutObjectTagging>
        <TagSet>
          <Tag>
            <Key>Environment</Key>
            <Value>Production</Value>
          </Tag>
        </TagSet>
      </PutObjectTagging>
    </Operation>
    <Report>
      <Bucket>report-bucket</Bucket>
      <Enabled>true</Enabled>
      <Prefix>batch-reports/</Prefix>
      <ReportScope>AllTasks</ReportScope>
    </Report>
    <ClientRequestToken>unique-token-123</ClientRequestToken>
    <Manifest>
      <Location>
        <ETag>d41d8cd98f00b204e9800998ecf8427e</ETag>
        <Bucket>manifest-bucket</Bucket>
        <Object>manifest.csv</Object>
      </Location>
      <Spec>
        <Fields>Bucket,Key</Fields>
        <Format>OSS_BatchOperations_CSV_20250611</Format>
      </Spec>
    </Manifest>
    <Description>批量设置对象标签任务</Description>
    <Priority>10</Priority>
    <RoleArn>arn:acs:ram::uid:role/BatchOperationRole</RoleArn>
  </CreateJobRequest>

• 返回示例

  HTTP/1.1 200 OK
  <?xml version="1.0" encoding="UTF-8"?>
  <CreateJobResult>
     <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId>
  </CreateJobResult>

命令行工具ossutil

CreateJob接口所对应的ossutil命令，请参见create-job。