すべてのプロダクト
Search

このプロダクト

    Object Storage Service:UpdateJobStatus

    ドキュメントセンター

    Object Storage Service:UpdateJobStatus

    最終更新日:Nov 09, 2025

    UpdateJobStatus 操作を呼び出して、指定されたバッチ操作ジョブのステータスを更新できます。

    権限

    Alibaba Cloud アカウントは、デフォルトですべての権限を持っています。ただし、Resource Access Management (RAM) ユーザーと RAM ロールには、デフォルトでは権限がありません。Alibaba Cloud アカウントまたは管理者は、RAM ポリシーまたはバケットポリシーを使用して、この操作の権限を付与する必要があります。

    API

    アクション

    説明

    UpdateJobStatus

    oss:UpdateJobStatus

    バッチ操作ジョブのステータスを更新します。

    リクエスト構文

    POST /?batchJobStatus&batchJobId=xx&requestedJobStatus=RequestedJobStatus&statusUpdateReason=StatusUpdateReason HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

    リクエストパラメーター

    名前

    タイプ

    必須

    例

    説明

    batchJobId

    string

    はい

    MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=

    バッチ操作ジョブの ID。ID は長さ 44 文字で、小文字 (a-z)、大文字 (A-Z)、数字 (0-9) を含めることができます。ID にハイフン (-) またはアンダースコア (_) を含めることはできません。

    親ノード: なし

    子ノード: なし

    requestedJobStatus

    string

    はい

    Cancelled

    ジョブを更新するステータス。ステータスの更新は、ジョブの実行フローに影響します。有効な値: Cancelled および Ready。ジョブの現在のステータスが `Cancelled`、`Cancelling`、`Complete`、`Completing`、`Failed`、または `Failing` の場合、このパラメーターを `Cancelled` に設定することはできません。このパラメーターを `Ready` に設定できるのは、ジョブの現在のステータスが `Suspended` または `Preparing` の場合のみです。

    親ノード: なし

    子ノード: なし

    statusUpdateReason

    string

    オプション

    User requested cancellation

    ステータス更新の理由。このパラメーターは、requestedJobStatus が Ready に設定されている場合はオプションです。理由は、長さが 1～256 文字である必要があります。

    親ノード: なし

    子ノード: なし

    リクエストヘッダー

    この操作では、共通リクエストヘッダーのみを使用します。詳細については、「共通リクエストヘッダー」をご参照ください。

    レスポンス要素

    名前

    タイプ

    例

    説明

    UpdateJobStatusResult

    コンテナー

    なし

    応答のルートノード。

    親ノード: なし

    子ノード: JobId、Status、および StatusUpdateReason

    JobId

    string

    MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=

    ジョブ ID。

    親ノード: UpdateJobStatusResult

    子ノード: なし

    Status

    string

    Cancelling

    ジョブの更新されたステータス。

    親ノード: UpdateJobStatusResult

    子ノード: なし

    StatusUpdateReason

    string

    User requested cancellation

    ステータス更新の理由。

    親ノード: UpdateJobStatusResult

    子ノード: なし

    レスポンスヘッダー

    この操作では、共通レスポンスヘッダーのみを使用します。詳細については、「共通レスポンスヘッダー」をご参照ください。

    例

    • リクエストの例

      POST /?batchJobStatus&batchJobId=MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=&requestedJobStatus=Cancelled&statusUpdateReason=User%20requested%20cancellation HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS LTAI4Fw2Nb3o4f5a3a1f****:2s98lj9n796c9kdc6b5f4l5b****

    • レスポンスの例

      HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<UpdateJobStatusResult>
   <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId>
   <Status>Cancelling</Status>
   <StatusUpdateReason>User requested cancellation</StatusUpdateReason>
</UpdateJobStatusResult>