Task - Get

Service:

Batch Service

API Version:

2023-11-01.18.0

指定した Task に関する情報を取得します。
複数インスタンスのタスクの場合、affinityId、executionInfo、nodeInfo などの情報は、プライマリ タスクを参照します。 サブタスクの一覧 API を使用して、サブタスクに関する情報を取得します。

GET {batchUrl}/jobs/{jobId}/tasks/{taskId}?api-version=2023-11-01.18.0

With optional parameters:

GET {batchUrl}/jobs/{jobId}/tasks/{taskId}?$select={$select}&$expand={$expand}&timeout={timeout}&api-version=2023-11-01.18.0

URI パラメーター

名前	/	必須	型	説明
batchUrl	path	True	string	すべてのAzure Batchサービス要求のベース URL。
jobId	path	True	string	タスクを含むジョブの ID。
taskId	path	True	string	情報を取得するタスクの ID。
api-version	query	True	string	クライアント API のバージョン。
$expand	query		string	OData $expand 句。
$select	query		string	OData $select 句。
timeout	query		integer int32	サーバーが要求の処理に費やすことができる最大時間 (秒単位)。 既定値は 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 を直接呼び出す場合は、明示的に設定します。
If-Match		string	クライアントに認識されているリソースのバージョンに関連付けられている ETag 値。 操作は、サービス上のリソースの現在の ETag がクライアントによって指定された値と正確に一致する場合にのみ実行されます。
If-None-Match		string	クライアントに認識されているリソースのバージョンに関連付けられている ETag 値。 この操作は、サービス上のリソースの現在の ETag がクライアントによって指定された値と一致しない場合にのみ実行されます。
If-Modified-Since		string date-time-rfc1123	クライアントに認識されているリソースの最終変更時刻を示すタイムスタンプ。 この操作は、サービス上のリソースが指定された時刻以降に変更された場合にのみ実行されます。
If-Unmodified-Since		string date-time-rfc1123	クライアントに認識されているリソースの最終変更時刻を示すタイムスタンプ。 この操作は、指定された時刻以降にサービス上のリソースが変更されていない場合にのみ実行されます。

応答

名前	型	説明
200 OK	CloudTask	Task を含む応答。 Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Batch サービスからのエラー。

セキュリティ

azure_auth

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

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名前	説明
user_impersonation	ユーザー アカウントの借用

Authorization

Type: apiKey
In: header

例

Task get

Sample Request

HTTP

GET account.region.batch.azure.com/jobs/jobId/tasks/taskId?api-version=2023-11-01.18.0

Sample Response

Status code:

200

{
  "id": "testTask",
  "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId",
  "eTag": "0x8D3D62350711C55",
  "creationTime": "2016-09-06T06:59:15.1161429Z",
  "lastModified": "2016-09-06T06:59:15.1161429Z",
  "state": "active",
  "stateTransitionTime": "2016-09-06T06:59:15.1161429Z",
  "commandLine": "cmd /c hostname",
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  },
  "multiInstanceSettings": {
    "numberOfInstances": 3,
    "coordinationCommandLine": "cmd /c echo coordinating"
  },
  "constraints": {
    "maxWallClockTime": "P10675199DT2H48M5.4775807S",
    "retentionTime": "P10675199DT2H48M5.4775807S",
    "maxTaskRetryCount": 0
  },
  "requiredSlots": 2,
  "executionInfo": {
    "retryCount": 0,
    "requeueCount": 0
  }
}

定義

名前	説明
AccessScope	トークンがアクセスを許可する Batch リソース。
AffinityInformation	Batch サービスがタスクを開始するコンピューティング ノードを選択するために使用できるローカリティ ヒント。
ApplicationPackageReference	コンピューティング ノードにデプロイするパッケージへの参照。
AuthenticationTokenSettings	Batch サービス操作の実行にタスクが使用できる認証トークンの設定。
AutoUserScope	自動ユーザーのスコープ
AutoUserSpecification	Batch サービスでタスクを実行する自動ユーザーのパラメーターを指定します。
BatchError	Azure Batch サービスから受信したエラー応答。
BatchErrorDetail	Azure Batchエラー応答に含まれる追加情報の項目。
CloudTask	Azure Batch タスク。
ComputeNodeIdentityReference	コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。
ComputeNodeInformation	タスクが実行されたコンピューティング ノードに関する情報。
ContainerRegistry	プライベート コンテナー レジストリ。
ContainerWorkingDirectory	コンテナー Task 作業ディレクトリの場所。
DependencyAction	このタスクに依存するタスクに対して Batch サービスが実行するアクション。
ElevationLevel	ユーザーの昇格レベル。
EnvironmentSetting	タスク プロセスで設定する環境変数。
ErrorCategory	エラーのカテゴリ。
ErrorMessage	Azure Batch エラー応答で受信したエラー メッセージ。
ExitCodeMapping	タスクが特定の終了コードで終了した場合の Batch サービスの応答方法。
ExitCodeRangeMapping	終了コードの範囲と、その範囲内の終了コードに対する Batch サービスの応答方法。
ExitConditions	タスクの完了時に Batch サービスがどのように応答するかを指定します。
ExitOptions	Batch サービスが特定の終了条件にどのように応答するかを指定します。
HttpHeader	HTTP ヘッダーの名前と値のペア
JobAction	指定された終了条件でタスクが完了し、ジョブの onTaskFailed プロパティが 'performExitOptionsJobAction' の場合に、タスクを含むジョブに対して実行するアクション。
MultiInstanceSettings	複数インスタンスのタスクを実行する方法を指定する設定。
NameValuePair	名前と値のペアを表します。
OutputFile	Batch サービスがタスク プロセスの実行を完了した後に、Azure Batchコンピューティング ノードから別の場所にファイルをアップロードするための仕様。
OutputFileBlobContainerDestination	Azure BLOB ストレージ コンテナー内のファイルのアップロード先を指定します。
OutputFileDestination	ファイルのアップロード先。
OutputFileUploadCondition	タスク出力ファイルまたは一連のファイルをアップロードする条件。
OutputFileUploadOptions	アップロードを実行する条件など、出力ファイルのアップロード操作に関する詳細。
ResourceFile	コンピューティング ノードにダウンロードする 1 つのファイルまたは複数のファイル。
TaskConstraints	タスクに適用する実行制約。
TaskContainerExecutionInformation	タスクが実行しているコンテナーに関する情報が含まれます。
TaskContainerSettings	タスクのコンテナー設定。
TaskDependencies	タスクの依存関係を指定します。 依存関係の範囲内または明示的に指定されたタスクは、依存するタスクをスケジュールする前に完了する必要があります。
TaskExecutionInformation	タスクの実行に関する情報。
TaskExecutionResult	タスクの実行結果。
TaskFailureInformation	タスクエラーに関する情報。
TaskIdRange	タスクが依存できるタスク ID の範囲。 範囲内の ID を持つすべてのタスクは、依存するタスクをスケジュールする前に正常に完了する必要があります。
TaskState	Task の状態。
TaskStatistics	タスクのリソース使用状況の統計情報。
UserIdentity	タスクを実行するユーザー ID の定義。

AccessScope

トークンがアクセスを許可する Batch リソース。

名前	型	説明
job	string	タスクを含むジョブに対するすべての操作を実行するためのアクセス権を付与します。

AffinityInformation

Batch サービスがタスクを開始するコンピューティング ノードを選択するために使用できるローカリティ ヒント。

名前	型	説明
affinityId	string	コンピューティング ノードまたは以前に実行したタスクの場所を表す不透明な文字列。 Node の affinityId を渡して、このタスクをそのコンピューティング ノードで実行する必要があることを示すことができます。 これは単なるソフト アフィニティであることに注意してください。 タスクがスケジュールされている時点でターゲットのコンピューティング ノードがビジー状態であるか使用できない場合、タスクは他の場所でスケジュールされます。

ApplicationPackageReference

コンピューティング ノードにデプロイするパッケージへの参照。

名前	型	説明
applicationId	string	デプロイするアプリケーションの ID。 プールを作成する場合、パッケージのアプリケーション ID は完全修飾 (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}) である必要があります。
version	string	デプロイするアプリケーションのバージョン。 省略すると、既定のバージョンがデプロイされます。 プールでこれを省略し、このアプリケーションに既定のバージョンが指定されていない場合、要求はエラー コード InvalidApplicationPackageReferences と HTTP 状態コード 409 で失敗します。 Task でこれを省略し、このアプリケーションに既定のバージョンが指定されていない場合、タスクは前処理エラーで失敗します。

AuthenticationTokenSettings

Batch サービス操作の実行にタスクが使用できる認証トークンの設定。

名前	型	説明
access	AccessScope[]	トークンがアクセスを許可する Batch リソース。 認証トークンは、限られた一連の Batch サービス操作へのアクセスを許可します。 現在、access プロパティでサポートされている値は 'job' のみです。これにより、Task を含む Job に関連するすべての操作へのアクセスが許可されます。

AutoUserScope

自動ユーザーのスコープ

名前	型	説明
pool	string	タスクが、プール内のすべてのコンピューティング ノードで作成される共通の自動ユーザー アカウントとして実行されるように指定します。
task	string	サービスがタスクの新しいユーザーを作成することを指定します。

AutoUserSpecification

Batch サービスでタスクを実行する自動ユーザーのパラメーターを指定します。

名前	型	説明
elevationLevel	ElevationLevel	自動ユーザーの昇格レベル。 既定値は nonAdmin です。
scope	AutoUserScope	自動ユーザーのスコープ 既定値は pool です。 プールで Windows が実行されている場合は、タスク間のより厳密な分離が必要な場合は、Task の値を指定する必要があります。 たとえば、タスクが他のタスクに影響を与える可能性のある方法でレジストリを変更する場合や、通常のタスクではアクセスできないが StartTasks からアクセスできる証明書がプールで指定されている場合などです。

BatchError

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

名前	型	説明
code	string	エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。
message	ErrorMessage	ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。
values	BatchErrorDetail[]	エラーに関する追加の詳細を含むキーと値のペアのコレクション。

BatchErrorDetail

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

名前	型	説明
key	string	Value プロパティの意味を指定する識別子。
value	string	エラー応答に含まれる追加情報。

CloudTask

Azure Batch タスク。

名前	型	説明
affinityInfo	AffinityInformation	Batch サービスが新しいタスクを開始するコンピューティング ノードを選択するために使用できるローカリティ ヒント。
applicationPackageReferences	ApplicationPackageReference[]	コマンド ラインを実行する前に Batch サービスがコンピューティング ノードにデプロイするパッケージの一覧。 アプリケーション パッケージは、タスク作業ディレクトリではなく、共有ディレクトリにダウンロードおよびデプロイされます。 したがって、参照されているパッケージが既に Node 上にあり、最新の状態である場合、再ダウンロードされません。コンピューティング ノード上の既存のコピーが使用されます。 参照先のパッケージをインストールできない場合 (たとえば、パッケージが削除されたか、ダウンロードに失敗したため)、タスクは失敗します。
authenticationTokenSettings	AuthenticationTokenSettings	Batch サービス操作の実行にタスクが使用できる認証トークンの設定。 このプロパティが設定されている場合、Batch サービスは、アカウント アクセス キーを必要とせずに Batch サービス操作を認証するために使用できる認証トークンを Task に提供します。 トークンは、AZ_BATCH_AUTHENTICATION_TOKEN環境変数を介して提供されます。 タスクがトークンを使用して実行できる操作は、設定によって異なります。 たとえば、タスクは、他のタスクをジョブに追加したり、ジョブまたはジョブの下の他のタスクの状態をチェックしたりするために、ジョブのアクセス許可を要求できます。
commandLine	string	タスクのコマンド ライン。 複数インスタンスのタスクの場合、プライマリ タスクとすべてのサブタスクが調整コマンド ラインの実行を完了した後、コマンド ラインがプライマリ タスクとして実行されます。 コマンド ラインはシェルでは実行されないため、環境変数の拡張などのシェル機能を利用することはできません。 このような機能を利用する場合は、コマンド ラインでシェルを呼び出す必要があります。たとえば、Windows では "cmd /c MyCommand" を使用し、Linux では "/bin/sh -c MyCommand" を使用します。 コマンド ラインがファイル パスを参照している場合は、相対パス (Task 作業ディレクトリに対する相対パス) を使用するか、Batch 指定の環境変数 (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) を使用する必要があります。
constraints	TaskConstraints	このタスクに適用される実行制約。
containerSettings	TaskContainerSettings	タスクを実行するコンテナーの設定。 このタスクを実行するプールに containerConfiguration が設定されている場合は、これも設定する必要があります。 このタスクを実行するプールに containerConfiguration が設定されていない場合は、これを設定しないでください。 これを指定すると、AZ_BATCH_NODE_ROOT_DIRの下にあるすべてのディレクトリ (ノード上のAzure Batchディレクトリのルート) がコンテナーに再帰的にマップされ、すべての Task 環境変数がコンテナーにマップされ、Task コマンド ラインがコンテナーで実行されます。 AZ_BATCH_NODE_ROOT_DIR外のコンテナーで生成されたファイルはホスト ディスクに反映されない可能性があります。つまり、Batch ファイル API はそれらのファイルにアクセスできません。
creationTime	string	タスクの作成時刻。
dependsOn	TaskDependencies	このタスクが依存するタスク。 このタスクは、依存するすべてのタスクが正常に完了するまでスケジュールされません。 これらのタスクのいずれかが失敗し、再試行回数を使い果たした場合、このタスクはスケジュールされません。
displayName	string	タスクの表示名。 表示名は一意である必要はありません。最大長 1024 までの Unicode 文字を含めることができます。
eTag	string	タスクの ETag。 これは不透明な文字列です。 これを使用して、タスクが要求間で変更されたかどうかを検出できます。 特に、タスクを更新するときに ETag を渡して、その間に他のユーザーがタスクを変更していない場合にのみ変更を有効にするように指定できます。
environmentSettings	EnvironmentSetting[]	タスクの環境変数設定の一覧。
executionInfo	TaskExecutionInformation	タスクの実行に関する情報。
exitConditions	ExitConditions	タスクの完了時に Batch サービスがどのように応答するかを指定します。 タスクが完了したときに Batch サービスが応答する方法。
id	string	ジョブ内のタスクを一意に識別する文字列。 ID には、ハイフンとアンダースコアを含む英数字の任意の組み合わせを含めることができます。また、64 文字を超えることはできません。
lastModified	string	タスクの最終変更時刻。
multiInstanceSettings	MultiInstanceSettings	Task がマルチインスタンス タスクであることを示し、マルチインスタンス タスクの実行方法に関する情報を含む オブジェクト。 マルチインスタンス タスクは、MPI タスクをサポートするために一般的に使用されます。 MPI の場合、サブタスクのいずれかが失敗した場合 (たとえば、0 以外の終了コードで終了した場合)、マルチインスタンス タスク全体が失敗します。 その後、複数インスタンスのタスクが終了し、再試行の上限まで再試行されます。
nodeInfo	ComputeNodeInformation	タスクが実行されたコンピューティング ノードに関する情報。
outputFiles	OutputFile[]	コマンド ラインの実行後に Batch サービスがコンピューティング ノードからアップロードするファイルの一覧。 複数インスタンスのタスクの場合、ファイルは、プライマリ タスクが実行されるコンピューティング ノードからのみアップロードされます。
previousState	TaskState	タスクの以前の状態。 Task が初期アクティブ状態の場合、このプロパティは設定されません。
previousStateTransitionTime	string	タスクが以前の状態になった時刻。 Task が初期アクティブ状態の場合、このプロパティは設定されません。
requiredSlots	integer	タスクの実行に必要なスケジュール スロットの数。 既定値は 1 です。 タスクは、ノードに十分な空きスケジュール スロットがある場合にのみ、コンピューティング ノードで実行するようにスケジュールできます。 複数インスタンスのタスクの場合、これは 1 である必要があります。
resourceFiles	ResourceFile[]	コマンド ラインを実行する前に Batch サービスがコンピューティング ノードにダウンロードするファイルの一覧。 複数インスタンスのタスクの場合、リソース ファイルは、プライマリ タスクが実行されるコンピューティング ノードにのみダウンロードされます。 リソース ファイルの一覧には最大サイズがあります。 最大サイズを超えると、要求は失敗し、応答エラー コードは RequestEntityTooLarge になります。 この場合、ResourceFiles のコレクションのサイズを小さくする必要があります。 これは、.zip ファイル、アプリケーション パッケージ、または Docker コンテナーを使用して実現できます。
state	TaskState	タスクの現在の状態。
stateTransitionTime	string	タスクが現在の状態になった時刻。
stats	TaskStatistics	タスクのリソース使用状況の統計情報。
url	string	タスクの URL。
userIdentity	UserIdentity	タスクを実行するユーザー ID。 省略すると、Task は Task に固有の管理ユーザー以外のユーザーとして実行されます。

ComputeNodeIdentityReference

コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。

名前	型	説明
resourceId	string	ユーザー割り当て ID の ARM リソース ID。

ComputeNodeInformation

タスクが実行されたコンピューティング ノードに関する情報。

名前	型	説明
affinityId	string	タスクが実行されたノードの識別子。このコンピューティング ノードでタスクをスケジュールするように要求するタスクを追加するときに渡すことができます。
nodeId	string	タスクが実行されたコンピューティング ノードの ID。
nodeUrl	string	タスクが実行されたコンピューティング ノードの URL。
poolId	string	タスクが実行されたプールの ID。
taskRootDirectory	string	コンピューティング ノード上のタスクのルート ディレクトリ。
taskRootDirectoryUrl	string	コンピューティング ノード上のタスクのルート ディレクトリへの URL。

ContainerRegistry

プライベート コンテナー レジストリ。

名前	型	説明
identityReference	ComputeNodeIdentityReference	ユーザー名とパスワードではなく、Azure Container Registryへのアクセスに使用するユーザー割り当て ID への参照。 コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。
password	string	レジストリ サーバーにログインするためのパスワード。
registryServer	string	レジストリ URL。 省略すると、既定値は "docker.io" になります。
username	string	レジストリ サーバーにログインするユーザー名。

ContainerWorkingDirectory

コンテナー Task 作業ディレクトリの場所。

名前	型	説明
containerImageDefault	string	コンテナー Image で定義されている作業ディレクトリを使用します。 このディレクトリには、Batch によってダウンロードされたリソース ファイルが含まれていないことに注意してください。
taskWorkingDirectory	string	標準の Batch サービス Task 作業ディレクトリを使用します。このディレクトリには、Batch によって設定されたタスク リソース ファイルが含まれます。

DependencyAction

このタスクに依存するタスクに対して Batch サービスが実行するアクション。

名前	型	説明
block	string	このタスクを待機しているタスクをブロックし、スケジュールされないようにします。
satisfy	string	このタスクを待機しているタスクを満たす。すべての依存関係が満たされると、タスクの実行がスケジュールされます。

ElevationLevel

ユーザーの昇格レベル。

名前	型	説明
admin	string	ユーザーは管理者特権のアクセス権を持つユーザーであり、完全な管理者アクセス許可で動作します。
nonadmin	string	ユーザーは、昇格されたアクセス権を持たない標準ユーザーです。

EnvironmentSetting

タスク プロセスで設定する環境変数。

名前	型	説明
name	string	環境変数の名前。
value	string	環境変数の値。

ErrorCategory

エラーのカテゴリ。

名前	型	説明
servererror	string	エラーは、内部サーバーの問題が原因です。
usererror	string	このエラーは、構成の誤りなど、ユーザーの問題が原因です。

ErrorMessage

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

名前	型	説明
lang	string	エラー メッセージの言語コード
value	string	メッセージのテキストです。

ExitCodeMapping

タスクが特定の終了コードで終了した場合の Batch サービスの応答方法。

名前	型	説明
code	integer	プロセス終了コード。
exitOptions	ExitOptions	この終了コードを使用してタスクが終了した場合の Batch サービスの応答方法。

ExitCodeRangeMapping

終了コードの範囲と、その範囲内の終了コードに対する Batch サービスの応答方法。

名前	型	説明
end	integer	範囲内の最後の終了コード。
exitOptions	ExitOptions	タスクが終了し、終了コードが範囲の開始から終了 (両端を含む) で終了した場合の Batch サービスの応答方法。
start	integer	範囲内の最初の終了コード。

ExitConditions

タスクの完了時に Batch サービスがどのように応答するかを指定します。

名前	型	説明
default	ExitOptions	他のどのプロパティにも含まれていない終了条件でタスクが失敗した場合の Batch サービスの応答方法。 この値は、task が exitCodes または exitCodeRanges コレクションにリストされていない 0 以外の終了コードで終了する場合、preProcessingError プロパティが存在しない場合は前処理エラー、fileUploadError プロパティが存在しない場合はファイル アップロード エラーで終了する場合に使用されます。 終了コード 0 で既定以外の動作を行う場合は、exitCodes コレクションまたは exitCodeRanges コレクションを使用して明示的に一覧表示する必要があります。
exitCodeRanges	ExitCodeRangeMapping[]	タスク終了コードの範囲と、Batch サービスがそれらに応答する方法の一覧。
exitCodes	ExitCodeMapping[]	個々のタスク終了コードの一覧と、Batch サービスがそれらに応答する方法。
fileUploadError	ExitOptions	ファイルのアップロード エラーが発生した場合の Batch サービスの応答方法。 exitCodes または exitCodeRanges を使用して指定された終了コードでタスクが終了し、ファイル アップロード エラーが発生した場合、終了コードで指定されたアクションが優先されます。
preProcessingError	ExitOptions	エラーが原因でタスクの開始に失敗した場合の Batch サービスの応答方法。

ExitOptions

Batch サービスが特定の終了条件にどのように応答するかを指定します。

名前	型	説明
dependencyAction	DependencyAction	このタスクに依存するタスクに対して Batch サービスが実行するアクション。 指定できる値は、'satisfy' (依存タスクの進行を許可) と 'block' (依存タスクは待機し続ける) です。 Batch では、依存タスクの取り消しはまだサポートされていません。
jobAction	JobAction	Task が特定の終了条件で完了し、ジョブの onTaskFailed プロパティが 'performExitOptionsJobAction' の場合に、タスクを含むジョブに対して実行するアクション。 デフォルトは、終了コード 0 の場合は none で、他のすべての終了条件では終了します。 Job の onTaskFailed プロパティが noaction の場合、このプロパティを指定するとエラーが返され、タスクの追加要求が無効なプロパティ値エラーで失敗します。REST API を直接呼び出す場合、HTTP 状態コードは 400 (無効な要求) です。

HttpHeader

HTTP ヘッダーの名前と値のペア

名前	型	説明
name	string	出力ファイルのアップロード時に使用するヘッダーの大文字と小文字を区別しない名前
value	string	出力ファイルのアップロード中に使用するヘッダーの値

JobAction

指定された終了条件でタスクが完了し、ジョブの onTaskFailed プロパティが 'performExitOptionsJobAction' の場合に、タスクを含むジョブに対して実行するアクション。

名前	型	説明
disable	string	ジョブを無効にします。 これは、disableTasks 値が requeue の disable Job API を呼び出すのと同じです。
none	string	アクションを実行しません。
terminate	string	ジョブを終了します。 ジョブの executionInfo の terminateReason が "TaskFailed" に設定されています。

MultiInstanceSettings

複数インスタンスのタスクを実行する方法を指定する設定。

名前	型	説明
commonResourceFiles	ResourceFile[]	調整コマンド ラインを実行する前に Batch サービスがダウンロードするファイルの一覧。 共通リソース ファイルとタスク リソース ファイルの違いは、プライマリを含むすべてのサブタスクに共通のリソース ファイルがダウンロードされるのに対し、タスク リソース ファイルはプライマリにのみダウンロードされる点です。 また、これらのリソース ファイルは Task 作業ディレクトリにダウンロードされず、タスク ルート ディレクトリ (作業ディレクトリの上の 1 つのディレクトリ) にダウンロードされることにも注意してください。 リソース ファイルの一覧には最大サイズがあります。 最大サイズを超えると、要求は失敗し、応答エラー コードは RequestEntityTooLarge になります。 この場合、ResourceFiles のコレクションのサイズを小さくする必要があります。 これは、.zip ファイル、アプリケーション パッケージ、または Docker コンテナーを使用して実現できます。
coordinationCommandLine	string	プライマリが メイン タスク コマンドを実行するときにそれらを調整できるようにするために、すべてのコンピューティング ノードで実行するコマンド ライン。 一般的な調整コマンド ラインは、バックグラウンド サービスを起動し、サービスがノード間メッセージを処理する準備ができていることを確認します。
numberOfInstances	integer	タスクに必要なコンピューティング ノードの数。 省略した場合、既定値は 1 です。

NameValuePair

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

名前	型	説明
name	string	名前と値のペアの名前。
value	string	名前と値のペアの値。

OutputFile

Batch サービスがタスク プロセスの実行を完了した後に、Azure Batchコンピューティング ノードから別の場所にファイルをアップロードするための仕様。

名前	型	説明
destination	OutputFileDestination	出力ファイルの出力先。
filePattern	string	アップロードするファイルを示すパターン。 相対パスと絶対パスの両方がサポートされています。 相対パスは、タスク作業ディレクトリに対する相対パスです。 次のワイルドカードがサポートされています。 * は 0 個以上の文字に一致します (たとえば、パターン abc* は abc または abcdef と一致します)、 ** は任意のディレクトリに一致します。? は任意の 1 文字に一致し、[abc] は角かっこ内の 1 文字に一致し、[a-c] は範囲内の 1 文字と一致します。 角かっこには、指定されていない任意の文字に一致する否定を含めることができます (例: [!abc] は、a、b、または c 以外の任意の文字と一致します)。 ファイル名が "." で始まる場合、既定では無視されますが、明示的に指定することで一致する場合があります (たとえば 、.gif は .a.gif と一致しませんが、.gif はになります)。 簡単な例: ***.txt は、'.' で始まらないすべてのファイルと一致し、Task 作業ディレクトリまたは任意のサブディレクトリの .txt で終わります。 ファイル名にワイルドカード文字が含まれている場合は、角かっこを使用してエスケープできます (たとえば、abc[] は abc という名前のファイルと一致します)。 \ と / の両方が Windows ではディレクトリ区切り記号として扱われますが、Linux では / のみであることに注意してください。 環境変数 (Windows では %var%、Linux では$var) は、パターンが適用される前に展開されます。
uploadOptions	OutputFileUploadOptions	アップロード操作の追加オプション (アップロードを実行する条件を含む)。

OutputFileBlobContainerDestination

Azure BLOB ストレージ コンテナー内のファイルのアップロード先を指定します。

名前	型	説明
containerUrl	string	ファイルをアップロードするAzure Blob Storage内のコンテナーの URL。 マネージド ID を使用しない場合、URL にはコンテナーへの書き込みアクセス許可を付与する Shared Access Signature (SAS) を含める必要があります。
identityReference	ComputeNodeIdentityReference	containerUrl で指定されたAzure Blob Storageにアクセスするために使用するユーザー割り当て ID への参照 ID には、Azure Blob Storage コンテナーへの書き込みアクセス権が必要です
path	string	Azure Storage コンテナー内の宛先 BLOB または仮想ディレクトリ。 filePattern が特定のファイルを参照している場合 (つまり、ワイルドカードが含まれない場合)、path はそのファイルをアップロードする BLOB の名前です。 filePattern に 1 つ以上のワイルドカードが含まれている場合 (したがって、複数のファイルと一致する可能性があります)、path は、ファイルをアップロードする BLOB 仮想ディレクトリの名前 (各 BLOB 名の前に付加されます) です。 省略すると、ファイル名と一致する BLOB 名を使用して、コンテナーのルートにファイルがアップロードされます。
uploadHeaders	HttpHeader[]	出力ファイルのアップロードに使用するヘッダーの名前と値のペアの一覧 これらのヘッダーは、Azure Storage にファイルをアップロードするときに指定されます。 BLOB のアップロード時に許可されるヘッダーに関する公式ドキュメント: https://docs.microsoft.com/en-us/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

ファイルのアップロード先。

名前	型	説明
container	OutputFileBlobContainerDestination	ファイルがアップロードされる Azure BLOB ストレージ内の場所。

OutputFileUploadCondition

タスク出力ファイルまたは一連のファイルをアップロードする条件。

名前	型	説明
taskcompletion	string	終了コードが何であったかにかかわらず、タスク プロセスが終了した後にファイルをアップロードします。
taskfailure	string	タスク プロセスが 0 以外の終了コードで終了した後にのみ、ファイルをアップロードします。
tasksuccess	string	タスク プロセスが終了コード 0 で終了した後にのみ、ファイルをアップロードします。

OutputFileUploadOptions

アップロードを実行する条件など、出力ファイルのアップロード操作に関する詳細。

名前	型	説明
uploadCondition	OutputFileUploadCondition	タスク出力ファイルまたは一連のファイルをアップロードする条件。 既定値は taskcompletion です。

ResourceFile

コンピューティング ノードにダウンロードする 1 つのファイルまたは複数のファイル。

名前	型	説明
autoStorageContainerName	string	自動ストレージ アカウント内のストレージ コンテナー名。 autoStorageContainerName、storageContainerUrl、および httpUrl プロパティは相互に排他的であり、そのうちの 1 つを指定する必要があります。
blobPrefix	string	Azure Storage コンテナーから BLOB をダウンロードするときに使用する BLOB プレフィックス。 指定したプレフィックスで始まる名前の BLOB のみがダウンロードされます。 このプロパティは、autoStorageContainerName または storageContainerUrl が使用されている場合にのみ有効です。 このプレフィックスには、部分的なファイル名またはサブディレクトリを指定できます。 プレフィックスを指定しない場合、コンテナー内のすべてのファイルがダウンロードされます。
fileMode	string	ファイルアクセス許可モード属性 (8 進数形式)。 このプロパティは、Linux コンピューティング ノードにダウンロードされるファイルにのみ適用されます。 これは、Windows コンピューティング ノードにダウンロードされる resourceFile に指定されている場合は無視されます。 Linux コンピューティング ノードにこのプロパティが指定されていない場合、既定値の 0770 がファイルに適用されます。
filePath	string	タスクの作業ディレクトリを基準にして、ファイルをダウンロードするコンピューティング ノード上の場所。 httpUrl プロパティを指定した場合、filePath は必須であり、ファイル名を含むファイルのダウンロード先のパスを記述します。 それ以外の場合、autoStorageContainerName または storageContainerUrl プロパティが指定されている場合、filePath は省略可能であり、ファイルをダウンロードするディレクトリです。 filePath をディレクトリとして使用する場合、入力データに既に関連付けられているディレクトリ構造は完全に保持され、指定された filePath ディレクトリに追加されます。 指定した相対パスは、タスクの作業ディレクトリから抜け出すことはできません (たとえば、'..' を使用)。
httpUrl	string	ダウンロードするファイルの URL。 autoStorageContainerName、storageContainerUrl、および httpUrl プロパティは相互に排他的であり、そのうちの 1 つを指定する必要があります。 URL が Azure Blob Storageを指している場合は、コンピューティング ノードから読み取り可能である必要があります。 Azure Storage で BLOB のこのような URL を取得するには、3 つの方法があります。BLOB に対する読み取りアクセス許可を付与する Shared Access Signature (SAS) を含めるか、読み取りアクセス許可を持つマネージド ID を使用するか、BLOB またはそのコンテナーの ACL を設定してパブリック アクセスを許可します。
identityReference	ComputeNodeIdentityReference	storageContainerUrl または httpUrl で指定されたAzure Blob Storageにアクセスするために使用するユーザー割り当て ID への参照 コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。
storageContainerUrl	string	Azure Blob Storage内の BLOB コンテナーの URL。 autoStorageContainerName、storageContainerUrl、および httpUrl プロパティは相互に排他的であり、そのうちの 1 つを指定する必要があります。 この URL は、コンピューティング ノードから読み取り可能でリスト可能である必要があります。 Azure Storage 内のコンテナーのこのような URL を取得するには、3 つの方法があります。コンテナーに対する読み取りとリストのアクセス許可を付与する Shared Access Signature (SAS) を含めるか、読み取りと一覧表示のアクセス許可を持つマネージド ID を使用するか、コンテナーの ACL を設定してパブリック アクセスを許可します。

TaskConstraints

タスクに適用する実行制約。

名前	型	説明
maxTaskRetryCount	integer	タスクを再試行できる最大回数。 終了コードが 0 以外の場合、Batch サービスは Task を再試行します。 この値は、0 以外の終了コードが原因で Task 実行可能ファイルの再試行回数を特に制御します。 Batch サービスはタスクを 1 回試し、この制限まで再試行できます。 たとえば、最大再試行回数が 3 の場合、Batch はタスクを最大 4 回試行します (最初の再試行が 1 回、再試行回数が 3 回)。 最大再試行回数が 0 の場合、Batch サービスは最初の試行後にタスクを再試行しません。 最大再試行回数が -1 の場合、Batch サービスは制限なくタスクを再試行しますが、開始タスクやタスクには推奨されません。 既定値は 0 (再試行なし) です。
maxWallClockTime	string	タスクが実行できる最大経過時間。タスクの開始時間から測定されます。 タスクが制限時間内に完了しない場合は、Batch サービスによって終了されます。 これを指定しない場合、タスクの実行時間に制限はありません。
retentionTime	string	実行が完了してから実行されたコンピューティング ノード上の Task ディレクトリを保持する最小時間。 この時間が経過すると、Batch サービスによって Task ディレクトリとそのすべての内容が削除される可能性があります。 既定値は 7 日間です。つまり、コンピューティング ノードが削除されるか、ジョブが削除されない限り、タスク ディレクトリは 7 日間保持されます。

TaskContainerExecutionInformation

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

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

TaskContainerSettings

タスクのコンテナー設定。

名前	型	説明
containerRunOptions	string	コンテナー作成コマンドの追加オプション。 これらの追加オプションは、Batch Service によって制御されるオプションに加えて、"docker create" コマンドの引数として提供されます。
imageName	string	タスクを実行するコンテナーの作成に使用するイメージ。 これは、"docker pull" に指定される完全なイメージ参照です。 イメージ名の一部としてタグが指定されていない場合は、タグ ":latest" が既定として使用されます。
registry	ContainerRegistry	コンテナー イメージを含むプライベート レジストリ。 この設定は、プールの作成時に既に指定されている場合は省略できます。
workingDirectory	ContainerWorkingDirectory	コンテナー Task 作業ディレクトリの場所。 既定値は 'taskWorkingDirectory' です。

TaskDependencies

タスクの依存関係を指定します。 依存関係の範囲内または明示的に指定されたタスクは、依存するタスクをスケジュールする前に完了する必要があります。

名前	型	説明
taskIdRanges	TaskIdRange[]	このタスクが依存するタスク ID 範囲の一覧。 依存するタスクをスケジュールするには、すべての範囲のすべてのタスクが正常に完了している必要があります。
taskIds	string[]	このタスクが依存するタスク ID の一覧。 依存タスクをスケジュールするには、この一覧のすべてのタスクが正常に完了している必要があります。 taskIds コレクションは、合計 6,4000 文字 (つまり、すべてのタスク ID の合計長) に制限されます。 taskIds コレクションが最大長を超えると、タスクの追加要求はエラー コード TaskDependencyListTooLong で失敗します。 この場合は、代わりにタスク ID の範囲を使用することを検討してください。

TaskExecutionInformation

タスクの実行に関する情報。

名前	型	説明
containerInfo	TaskContainerExecutionInformation	タスクが実行されているコンテナーに関する情報。 このプロパティは、Task がコンテナー コンテキストで実行されている場合にのみ設定されます。
endTime	string	タスクが完了した時刻。 このプロパティは、Task が Completed 状態の場合にのみ設定されます。
exitCode	integer	タスク コマンド ラインで指定されたプログラムの終了コード。 このプロパティは、Task が完了状態の場合にのみ設定されます。 一般に、プロセスの終了コードには、そのプロセスに対してアプリケーション開発者によって実装された特定の規則が反映されます。 終了コード値を使用してコードで決定を行う場合は、アプリケーション プロセスで使用される終了コード規則がわかっていることを確認してください。 ただし、Batch サービスがタスクを終了した場合 (タイムアウト、または API を介したユーザー終了が原因)、オペレーティング システムで定義された終了コードが表示されることがあります。
failureInfo	TaskFailureInformation	タスクの失敗を説明する情報 (存在する場合)。 このプロパティは、Task が完了状態でエラーが発生した場合にのみ設定されます。
lastRequeueTime	string	ユーザー要求の結果として Batch サービスによってタスクが再キューされた最新の時刻。 このプロパティは、requeueCount が 0 以外の場合にのみ設定されます。
lastRetryTime	string	タスクの再試行が実行を開始した最新の時刻。 この要素は、Task が再試行された場合にのみ存在します (つまり、retryCount は 0 以外です)。 存在する場合、これは通常 startTime と同じですが、再試行以外の理由でタスクが再起動された場合は異なる場合があります。たとえば、コンピューティング ノードが再試行中に再起動された場合、startTime は更新されますが、lastRetryTime は更新されません。
requeueCount	integer	ユーザー要求の結果として Batch サービスによってタスクが再キューされた回数。 ユーザーがプールからコンピューティング ノードを削除するとき (プールのサイズ変更または縮小によって) またはジョブが無効になっている場合、ユーザーはコンピューティング ノードで実行中のタスクを実行のために再キューに入れるかどうかを指定できます。 この数は、これらの理由からタスクが再キューされた回数を追跡します。
result	TaskExecutionResult	タスク実行の結果。 値が 'failed' の場合は、failureInfo プロパティでエラーの詳細を確認できます。
retryCount	integer	Batch サービスによってタスクが再試行された回数。 タスク アプリケーションのエラー (0 以外の終了コード) が再試行され、前処理エラー (タスクを実行できませんでした) とファイルのアップロード エラーは再試行されません。 Batch サービスは、制約で指定された制限までタスクを再試行します。
startTime	string	タスクの実行を開始した時刻。 '実行中' は実行中の状態に対応しているため、タスクでリソース ファイルまたはパッケージが指定されている場合、開始時刻には、タスクがこれらをダウンロードまたはデプロイし始めた時刻が反映されます。 タスクが再起動または再試行された場合、これはタスクの実行を開始した最新の時刻です。 このプロパティは、実行中または完了状態のタスクにのみ存在します。

TaskExecutionResult

タスクの実行結果。

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

TaskFailureInformation

タスクエラーに関する情報。

名前	型	説明
category	ErrorCategory	タスク エラーのカテゴリ。
code	string	タスク エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。
details	NameValuePair[]	エラーに関連する追加の詳細の一覧。
message	string	ユーザー インターフェイスでの表示に適したタスク エラーを説明するメッセージ。

TaskIdRange

タスクが依存できるタスク ID の範囲。 範囲内の ID を持つすべてのタスクは、依存するタスクをスケジュールする前に正常に完了する必要があります。

名前	型	説明
end	integer	範囲内の最後のタスク ID。
start	integer	範囲内の最初のタスク ID。

TaskState

Task の状態。

名前	型	説明
active	string	タスクはキューに登録され、実行できますが、現在コンピューティング ノードには割り当てられません。 タスクは、タスクの作成時、無効化後に有効になったとき、または失敗した実行後に再試行を待機しているときに、この状態になります。
completed	string	通常、タスクが正常に終了したか、タスクが正常に終了して再試行制限を使い果たしたため、タスクは実行できません。 タスクの起動中にエラーが発生した場合、またはタスクが終了した場合も、タスクは完了としてマークされます。
preparing	string	タスクはコンピューティング ノードに割り当てられますが、コンピューティング ノードで必要なジョブ準備タスクが完了するまで待機しています。 ジョブ準備タスクが成功すると、タスクは実行中に移動します。 ジョブ準備タスクが失敗した場合、タスクはアクティブに戻り、別のコンピューティング ノードに割り当てられる資格があります。
running	string	タスクはコンピューティング ノードで実行されています。 これには、リソース ファイルのダウンロードや、タスクで指定されたパッケージのデプロイなどのタスク レベルの準備が含まれます。これは、必ずしも Task コマンド ラインの実行が開始されたことを意味するとは限りません。

TaskStatistics

タスクのリソース使用状況の統計情報。

名前	型	説明
kernelCPUTime	string	タスクによって消費されるカーネル モードの CPU 時間の合計 (すべてのコアとすべてのコンピューティング ノードで合計)。
lastUpdateTime	string	統計が最後に更新された時刻。 すべての統計は、startTime と lastUpdateTime の間の範囲に制限されます。
readIOGiB	number	タスクによってディスクから読み取られた合計ギビバイト数。
readIOps	integer	タスクによって行われたディスク読み取り操作の合計数。
startTime	string	統計の対象となる時間範囲の開始時刻。
url	string	統計の URL。
userCPUTime	string	タスクによって消費される合計ユーザー モード CPU 時間 (すべてのコアとすべてのコンピューティング ノードで合計)。
waitTime	string	タスクの合計待機時間。 タスクの待機時間は、タスクの作成からタスク実行の開始までの経過時間として定義されます。 (エラーが原因でタスクが再試行された場合、待機時間は最新のタスク実行までの時間です)。
wallClockTime	string	タスクの壁掛け時計の合計時間。 ウォール クロック時間は、タスクがコンピューティング ノードで実行を開始してから完了するまでの経過時間です (それまでにタスクが完了していない場合は統計が最後に更新された時刻まで)。 タスクが再試行された場合、これにはすべてのタスク再試行のウォール クロック時間が含まれます。
writeIOGiB	number	タスクによってディスクに書き込まれた合計ギビバイト数。
writeIOps	integer	タスクによって行われたディスク書き込み操作の合計数。

UserIdentity

タスクを実行するユーザー ID の定義。

名前	型	説明
autoUser	AutoUserSpecification	タスクを実行する自動ユーザー。 userName プロパティと autoUser プロパティは相互に排他的です。1 つを指定する必要がありますが、両方を指定する必要はありません。
username	string	タスクを実行するユーザー ID の名前。 userName プロパティと autoUser プロパティは相互に排他的です。1 つを指定する必要がありますが、両方を指定する必要はありません。