次の方法で共有

Job - List Preparation And Release Task Status

  • リファレンス
サービス:
Batch Service
API バージョン:
2024-07-01.20.0

ジョブが実行されているコンピューティング ノード全体で、指定されたジョブのジョブ準備タスクとジョブ解放タスクの実行状態を一覧表示します。
この API は、ジョブ準備タスクまたはジョブ解放タスクを実行したすべてのコンピューティング ノードのジョブ準備タスクとジョブ解放タスクの状態を返します。 これには、プールから削除されたコンピューティング ノードが含まれます。 ジョブ準備タスクまたはジョブ解放タスクがないジョブでこの API が呼び出された場合、Batch サービスは HTTP 状態コード 409 (競合) を JobPreparationTaskNotSpecified のエラー コードと共に返します。

GET {batchUrl}/jobs/{jobId}/jobpreparationandreleasetaskstatus?api-version=2024-07-01.20.0
省略可能なパラメーターを含む: 
GET {batchUrl}/jobs/{jobId}/jobpreparationandreleasetaskstatus?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

URI パラメーター

名前 / 必須 型 説明
batchUrl
 path True

string

すべての Azure Batch サービス要求のベース URL。
jobId
 path True

string

ジョブの ID。
api-version
 query True

string

クライアント API のバージョン。
$filter
 query

string

OData $filter 句。 このフィルターの構築の詳細については、https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-job-preparation-and-release-statusを参照してください。
$select
 query

string

OData $select 句。
maxresults
 query

integer

int32

応答で返される項目の最大数。 最大 1,000 個のタスクを返すことができます。
timeout
 query

integer

int32

サーバーが要求の処理に費やすことができる最大時間 (秒単位)。 既定値は 30 秒です。 値が 30 より大きい場合は、代わりに既定値が使用されます。

要求ヘッダー

Media Types: "application/json; odata=minimalmetadata"

名前 必須 型 説明
client-request-id

string

uuid

呼び出し元によって生成された要求 ID。中かっこなどの装飾のない GUID の形式 (例: 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0)。
return-client-request-id

boolean

サーバーが応答で client-request-id を返す必要があるかどうか。
ocp-date

string

date-time-rfc1123

要求が発行された時刻。 通常、クライアント ライブラリはこれを現在のシステム クロック時間に設定します。REST API を直接呼び出す場合は、明示的に設定します。

応答

名前 型 説明
200 OK

CloudJobListPreparationAndReleaseTaskStatusResult

ジョブの準備タスクとジョブ解放タスクの状態の一覧を含む応答。

ヘッダー

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
Other Status Codes

BatchError

Batch サービスからのエラー。 ジョブ準備タスクまたはジョブ解放タスクがないジョブでこの API が呼び出された場合、Batch サービスは HTTP 状態コード 409 を返します。

セキュリティ

azure_auth

Microsoft Entra OAuth 2.0 認証コード フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

Authorization

型: apiKey
/: header

例

Job list preparation and release task status

要求のサンプル

GET account.region.batch.azure.com/jobs/jobId/jobpreparationandreleasetaskstatus?api-version=2024-07-01.20.0

応答のサンプル

状態コード:
200 
{
  "value": [
    {
      "poolId": "poolId",
      "nodeId": "tvm-2167304207_1-20140905t174658z",
      "nodeUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_1-20140905t174658z",
      "jobPreparationTaskExecutionInfo": {
        "state": "completed",
        "startTime": "2015-05-01T10:20:31Z",
        "endTime": "2015-05-02T20:12:42Z",
        "taskRootDirectory": "tasks/myjob/job-1/myjobpreptask",
        "taskRootDirectoryUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_1-20140905t174658z/files/tasks/myjob/job-1/myjobpreptask",
        "exitCode": 0,
        "retryCount": 0
      },
      "jobReleaseTaskExecutionInfo": {
        "state": "completed",
        "startTime": "2015-05-01T10:20:31Z",
        "endTime": "2015-05-02T20:12:42Z",
        "taskRootDirectory": "tasks/myjob/job-1/myjobreleasetask",
        "taskRootDirectoryUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_1-20140905t174658z/files/tasks/myjob/job-1/myjobreleasetask",
        "exitCode": 0
      }
    }
  ],
  "odata.nextLink": "https://account.region.batch.azure.com/jobs/myjob/jobpreparationandreleasestatus?$skipToken=tvm-2167304207_1-20140905t174658z&api-version=2024-07-01.20.0"
}

定義

名前 説明
BatchError

Azure Batch サービスから受信したエラー応答。
BatchErrorDetail

Azure Batch エラー応答に含まれる追加情報の項目。
CloudJobListPreparationAndReleaseTaskStatusResult

ジョブのジョブ準備タスクとジョブ解放タスクの状態を一覧表示した結果。
ErrorCategory

エラーのカテゴリ。
ErrorMessage

Azure Batch エラー応答で受信したエラー メッセージ。
JobPreparationAndReleaseTaskExecutionInformation

コンピューティング ノードのジョブ準備タスクとジョブ 解放タスクの状態。
JobPreparationTaskExecutionInformation

コンピューティング ノードでのジョブ準備タスクの実行に関する情報が含まれます。
JobPreparationTaskState

コンピューティング ノード上のジョブ準備タスクの現在の状態。
JobReleaseTaskExecutionInformation

コンピューティング ノードでのジョブ リリース タスクの実行に関する情報が含まれます。
JobReleaseTaskState

コンピューティング ノード上のジョブ解放タスクの現在の状態。
NameValuePair

名前と値のペアを表します。
TaskContainerExecutionInformation

タスクが実行されているコンテナーに関する情報を格納します。
TaskExecutionResult

タスクの実行結果。
TaskFailureInformation

タスクの失敗に関する情報。

BatchError

Azure Batch サービスから受信したエラー応答。

名前 型 説明
code

string

エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。
message

ErrorMessage

ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。
values

BatchErrorDetail[]

エラーに関する追加の詳細を含むキーと値のペアのコレクション。

BatchErrorDetail

Azure Batch エラー応答に含まれる追加情報の項目。

名前 型 説明
key

string

Value プロパティの意味を指定する識別子。
value

string

エラー応答に含まれる追加情報。

CloudJobListPreparationAndReleaseTaskStatusResult

ジョブのジョブ準備タスクとジョブ解放タスクの状態を一覧表示した結果。

名前 型 説明
odata.nextLink

string

次の結果セットを取得する URL。
value

JobPreparationAndReleaseTaskExecutionInformation[]

ジョブの準備とジョブ解放タスクの実行情報の一覧。

ErrorCategory

エラーのカテゴリ。

名前 型 説明
servererror

string

エラーは、内部サーバーの問題が原因です。
usererror

string

このエラーは、構成の誤りなど、ユーザーの問題が原因です。

ErrorMessage

Azure Batch エラー応答で受信したエラー メッセージ。

名前 型 説明
lang

string

エラー メッセージの言語コード
value

string

メッセージのテキスト。

JobPreparationAndReleaseTaskExecutionInformation

コンピューティング ノードのジョブ準備タスクとジョブ 解放タスクの状態。

名前 型 説明
jobPreparationTaskExecutionInfo

JobPreparationTaskExecutionInformation

このコンピューティング ノードのジョブ準備タスクの実行状態に関する情報。
jobReleaseTaskExecutionInfo

JobReleaseTaskExecutionInformation

このコンピューティング ノードのジョブ解放タスクの実行状態に関する情報。
このプロパティは、ジョブ解放タスクがコンピューティング ノードで実行されている場合にのみ設定されます。
nodeId

string

このエントリが参照するコンピューティング ノードの ID。
nodeUrl

string

このエントリが参照するコンピューティング ノードの URL。
poolId

string

このエントリが参照するコンピューティング ノードを含むプールの ID。

JobPreparationTaskExecutionInformation

コンピューティング ノードでのジョブ準備タスクの実行に関する情報が含まれます。

名前 型 説明
containerInfo

TaskContainerExecutionInformation

タスクが実行されているコンテナーに関する情報。
このプロパティは、タスクがコンテナー コンテキストで実行される場合にのみ設定されます。
endTime

string

ジョブ準備タスクが完了した時刻。
このプロパティは、Task が Completed 状態の場合にのみ設定されます。
exitCode

integer

タスク コマンド ラインで指定されたプログラムの終了コード。
このパラメーターは、Task が完了状態の場合にのみ返されます。 プロセスの終了コードには、そのプロセスに対してアプリケーション開発者によって実装された特定の規則が反映されています。 終了コード値を使用してコード内で決定を行う場合は、アプリケーション プロセスで使用される終了コード規則がわかっていることを確認してください。 終了コードは、プロセスが強制的に終了された場合など、コンピューティング ノード オペレーティング システムによって生成される場合もあります。
failureInfo

TaskFailureInformation

タスクの失敗を説明する情報 (存在する場合)。
このプロパティは、Task が完了状態でエラーが発生した場合にのみ設定されます。
lastRetryTime

string

ジョブ準備タスクの再試行が実行を開始した最新の時刻。
このプロパティは、タスクが再試行された場合にのみ設定されます (つまり、retryCount は 0 以外です)。 存在する場合、これは通常、startTime と同じですが、再試行以外の理由でタスクが再起動された場合は異なる場合があります。たとえば、再試行中にコンピューティング ノードが再起動された場合、startTime は更新されますが、lastRetryTime は更新されません。
result

TaskExecutionResult

タスク実行の結果。
値が 'failed' の場合は、failureInfo プロパティでエラーの詳細を確認できます。
retryCount

integer

Batch サービスによってタスクが再試行された回数。 タスク アプリケーションエラー (0 以外の終了コード) が再試行され、前処理エラー (タスクを実行できませんでした)、ファイルアップロードエラーは再試行されません。 Batch サービスは、制約で指定された制限までタスクを再試行します。
タスク アプリケーションエラー (0 以外の終了コード) が再試行され、前処理エラー (タスクを実行できませんでした)、ファイルアップロードエラーは再試行されません。 Batch サービスは、制約で指定された制限までタスクを再試行します。
startTime

string

タスクの実行を開始した時刻。
タスクが再起動または再試行された場合、これはタスクの実行を開始した最新の時刻です。
state

JobPreparationTaskState

コンピューティング ノード上のジョブ準備タスクの現在の状態。
taskRootDirectory

string

コンピューティング ノード上のジョブ準備タスクのルート ディレクトリ。 このパスを使用して、ログ ファイルなど、タスクによって作成されたファイルを取得できます。
taskRootDirectoryUrl

string

コンピューティング ノード上のジョブ準備タスクのルート ディレクトリへの URL。

JobPreparationTaskState

コンピューティング ノード上のジョブ準備タスクの現在の状態。

名前 型 説明
completed

string

タスクが終了コード 0 で終了したか、タスクの再試行制限が不足しているか、タスク準備エラー (リソース ファイルのダウンロードエラーなど) により Batch サービスがタスクを開始できませんでした。
running

string

タスクは現在実行中です (再試行を含む)。

JobReleaseTaskExecutionInformation

コンピューティング ノードでのジョブ リリース タスクの実行に関する情報が含まれます。

名前 型 説明
containerInfo

TaskContainerExecutionInformation

タスクが実行されているコンテナーに関する情報。
このプロパティは、タスクがコンテナー コンテキストで実行される場合にのみ設定されます。
endTime

string

ジョブ解放タスクが完了した時刻。
このプロパティは、Task が Completed 状態の場合にのみ設定されます。
exitCode

integer

タスク コマンド ラインで指定されたプログラムの終了コード。
このパラメーターは、Task が完了状態の場合にのみ返されます。 プロセスの終了コードには、そのプロセスに対してアプリケーション開発者によって実装された特定の規則が反映されています。 終了コード値を使用してコード内で決定を行う場合は、アプリケーション プロセスで使用される終了コード規則がわかっていることを確認してください。 終了コードは、プロセスが強制的に終了された場合など、コンピューティング ノード オペレーティング システムによって生成される場合もあります。
failureInfo

TaskFailureInformation

タスクの失敗を説明する情報 (存在する場合)。
このプロパティは、Task が完了状態でエラーが発生した場合にのみ設定されます。
result

TaskExecutionResult

タスク実行の結果。
値が 'failed' の場合は、failureInfo プロパティでエラーの詳細を確認できます。
startTime

string

タスクの実行を開始した時刻。
タスクが再起動または再試行された場合、これはタスクの実行を開始した最新の時刻です。
state

JobReleaseTaskState

コンピューティング ノード上のジョブ解放タスクの現在の状態。
taskRootDirectory

string

コンピューティング ノード上のジョブ解放タスクのルート ディレクトリ。 このパスを使用して、ログ ファイルなど、タスクによって作成されたファイルを取得できます。
taskRootDirectoryUrl

string

コンピューティング ノード上のジョブ リリース タスクのルート ディレクトリへの URL。

JobReleaseTaskState

コンピューティング ノード上のジョブ解放タスクの現在の状態。

名前 型 説明
completed

string

タスクが終了コード 0 で終了したか、タスクの再試行制限が不足しているか、タスク準備エラー (リソース ファイルのダウンロードエラーなど) により Batch サービスがタスクを開始できませんでした。
running

string

タスクは現在実行中です (再試行を含む)。

NameValuePair

名前と値のペアを表します。

名前 型 説明
name

string

名前と値のペアの名前。
value

string

名前と値のペアの値。

TaskContainerExecutionInformation

タスクが実行されているコンテナーに関する情報を格納します。

名前 型 説明
containerId

string

コンテナーの ID。
error

string

コンテナーに関する詳細なエラー情報。
これは、Docker サービスからの詳細なエラー文字列 (使用可能な場合) です。 これは、"docker inspect" によって返されるエラー フィールドと同じです。
state

string

コンテナーの状態。
これは、Docker サービスに従ったコンテナーの状態です。 これは、"docker inspect" によって返される状態フィールドと同じです。

TaskExecutionResult

タスクの実行結果。

名前 型 説明
failure

string

タスクの処理中にエラーが発生しました。 タスク プロセスが起動される前、タスク プロセスの実行中、またはタスク プロセスが終了した後に、エラーが発生した可能性があります。
success

string

タスクは正常に実行されました。

TaskFailureInformation

タスクの失敗に関する情報。

名前 型 説明
category

ErrorCategory

タスク エラーのカテゴリ。
code

string

タスク エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。
details

NameValuePair[]

エラーに関連する追加の詳細の一覧。
message

string

ユーザー インターフェイスでの表示に適したタスク エラーを説明するメッセージ。