Compute Node - Get

Service:

Batch Service

API Version:

2023-11-01.18.0

指定したコンピューティング ノードに関する情報を取得します。

GET {batchUrl}/pools/{poolId}/nodes/{nodeId}?api-version=2023-11-01.18.0

With optional parameters:

GET {batchUrl}/pools/{poolId}/nodes/{nodeId}?$select={$select}&timeout={timeout}&api-version=2023-11-01.18.0

URI パラメーター

名前	/	必須	型	説明
batchUrl	path	True	string	すべてのAzure Batchサービス要求のベース URL。
nodeId	path	True	string	情報を取得するコンピューティング ノードの ID。
poolId	path	True	string	コンピューティング ノードを含むプールの ID。
api-version	query	True	string	クライアント API のバージョン。
$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 を直接呼び出す場合は、明示的に設定します。

応答

名前	型	説明
200 OK	ComputeNode	コンピューティング ノードを含む応答。 Headers client-request-id: string request-id: string ETag: string Last-Modified: 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

例

Node get

Sample Request

HTTP

GET account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z?api-version=2023-11-01.18.0

Sample Response

Status code:

200

{
  "id": "tvm-1695681911_2-20161122t193202z",
  "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
  "state": "idle",
  "schedulingState": "enabled",
  "stateTransitionTime": "2016-11-22T19:37:31.4285526Z",
  "lastBootTime": "2016-11-22T19:37:28.623369Z",
  "allocationTime": "2016-11-22T19:32:02.8155319Z",
  "ipAddress": "1.1.1.1",
  "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
  "vmSize": "small",
  "totalTasksRun": 0,
  "totalTasksSucceeded": 0,
  "runningTasksCount": 0,
  "isDedicated": true,
  "startTask": {
    "commandLine": "cmd /c echo hello",
    "userIdentity": {
      "autoUser": {
        "scope": "task",
        "elevationLevel": "nonadmin"
      }
    },
    "maxTaskRetryCount": 0,
    "waitForSuccess": false
  },
  "startTaskInfo": {
    "state": "completed",
    "startTime": "2016-11-22T19:37:31.4285526Z",
    "endTime": "2016-11-22T19:37:31.838028Z",
    "exitCode": 0,
    "retryCount": 0
  },
  "nodeAgentInfo": {
    "version": "1.2.0.0",
    "lastUpdateTime": "2016-11-22T19:37:28.623369Z"
  }
}

定義

名前	説明
AutoUserScope	自動ユーザーのスコープ
AutoUserSpecification	Batch サービスで Task を実行する自動ユーザーのパラメーターを指定します。
BatchError	Azure Batch サービスから受信したエラー応答。
BatchErrorDetail	Azure Batchエラー応答に含まれる追加情報の項目。
CertificateReference	プール内のコンピューティング ノードにインストールされる証明書への参照。
CertificateStoreLocation	証明書をインストールするコンピューティング ノード上の証明書ストアの場所。
CertificateVisibility	証明書のプライベート データにアクセスできるコンピューティング ノード上のユーザー アカウント。
ComputeNode	Batch サービスのコンピューティング ノード。
ComputeNodeEndpointConfiguration	コンピューティング ノードのエンドポイント構成。
ComputeNodeError	コンピューティング ノードで発生したエラー。
ComputeNodeIdentityReference	コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。
ComputeNodeState	コンピューティング ノードの現在の状態。
ContainerRegistry	プライベート コンテナー レジストリ。
ContainerWorkingDirectory	コンテナー Task 作業ディレクトリの場所。
ElevationLevel	ユーザーの昇格レベル。
EnvironmentSetting	タスク プロセスで設定する環境変数。
ErrorCategory	エラーのカテゴリ。
ErrorMessage	Azure Batch エラー応答で受信したエラー メッセージ。
ImageReference	Azure Virtual Machines Marketplace イメージまたは Azure Compute Gallery イメージへの参照。 Azure Batchによって検証されたすべてのAzure Marketplaceイメージ参照の一覧を取得するには、「サポートされているイメージの一覧表示」操作を参照してください。
InboundEndpoint	コンピューティング ノード上の受信エンドポイント。
InboundEndpointProtocol	エンドポイントのプロトコル。
NameValuePair	名前と値のペアを表します。
NodeAgentInformation	コンピューティング ノード エージェントに関する情報。
ResourceFile	コンピューティング ノードにダウンロードする 1 つのファイルまたは複数のファイル。
SchedulingState	コンピューティング ノードがタスク スケジュールに使用できるかどうか。
StartTask	ノードがAzure Batch サービスのプールに参加するとき、またはコンピューティング ノードが再起動または再イメージ化されたときに実行されるタスク。
StartTaskInformation	コンピューティング ノードで実行されている StartTask に関する情報。
StartTaskState	コンピューティング ノード上の StartTask の状態。
TaskContainerExecutionInformation	Task が実行しているコンテナーに関する情報が含まれます。
TaskContainerSettings	タスクのコンテナー設定。
TaskExecutionInformation	タスクの実行に関する情報。
TaskExecutionResult	タスクの実行結果。
TaskFailureInformation	タスクエラーに関する情報。
TaskInformation	コンピューティング ノードで実行されているタスクに関する情報。
TaskState	Task の状態。
UserIdentity	タスクを実行するユーザー ID の定義。
VirtualMachineInfo	仮想マシンの現在の状態に関する情報。

AutoUserScope

自動ユーザーのスコープ

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

AutoUserSpecification

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

名前	型	説明
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	エラー応答に含まれる追加情報。

CertificateReference

プール内のコンピューティング ノードにインストールされる証明書への参照。

名前	型	説明
storeLocation	CertificateStoreLocation	証明書をインストールするコンピューティング ノード上の証明書ストアの場所。 既定値は currentuser です。 このプロパティは、Windows コンピューティング ノード (cloudServiceConfiguration を使用して作成されたプール、または Windows イメージ参照を使用して virtualMachineConfiguration を使用して作成されたプール) にのみ適用されます。 Linux コンピューティング ノードの場合、証明書は Task 作業ディレクトリ内のディレクトリに格納され、この場所を照会するためにタスクにAZ_BATCH_CERTIFICATES_DIR環境変数が提供されます。 'remoteUser' の可視性を持つ証明書の場合、ユーザーのホーム ディレクトリ (/home/{user-name}/certs など) に 'certs' ディレクトリが作成され、そのディレクトリに証明書が配置されます。
storeName	string	証明書をインストールするコンピューティング ノード上の証明書ストアの名前。 このプロパティは、Windows コンピューティング ノード (cloudServiceConfiguration を使用して作成されたプール、または Windows イメージ参照を使用して virtualMachineConfiguration を使用して作成されたプール) にのみ適用されます。 一般的なストア名には、My、Root、CA、Trust、Disallowed、TrustedPeople、TrustedPublisher、AuthRoot、AddressBook などがありますが、任意のカスタム ストア名も使用できます。 既定値は、My です。
thumbprint	string	証明書の拇印。
thumbprintAlgorithm	string	拇印が関連付けられているアルゴリズム。 これは sha1 である必要があります。
visibility	CertificateVisibility[]	証明書のプライベート データにアクセスできるコンピューティング ノード上のユーザー アカウント。 このコレクションでは、複数の可視性を指定できます。 既定値はすべてのアカウントです。

CertificateStoreLocation

証明書をインストールするコンピューティング ノード上の証明書ストアの場所。

名前	型	説明
currentuser	string	証明書は CurrentUser 証明書ストアにインストールする必要があります。
localmachine	string	証明書は LocalMachine 証明書ストアにインストールする必要があります。

CertificateVisibility

証明書のプライベート データにアクセスできるコンピューティング ノード上のユーザー アカウント。

名前	型	説明
remoteuser	string	証明書は、ユーザーがコンピューティング ノードにリモートでアクセスするユーザー アカウントに表示されます。
starttask	string	証明書は、StartTask が実行されているユーザー アカウントに表示されます。 AutoUser スコープが StartTask と Task の両方のプールである場合、この証明書はタスクにも表示されることに注意してください。
task	string	[証明書] は、ジョブ タスクが実行されているユーザー アカウントに表示されます。

ComputeNode

Batch サービスのコンピューティング ノード。

名前	型	説明
affinityId	string	このコンピューティング ノードでタスクをスケジュールするよう要求するタスクを追加するときに渡すことができる識別子。 これは単なるソフト アフィニティであることに注意してください。 タスクがスケジュールされている時点でターゲットのコンピューティング ノードがビジー状態であるか使用できない場合、タスクは他の場所でスケジュールされます。
allocationTime	string	このコンピューティング ノードがプールに割り当てられた時刻。 これは、コンピューティング ノードが最初に割り当てられ、設定後に変更されない時刻です。 コンピューティング ノードがサービスの修復または割り込み時に更新されません。
certificateReferences	CertificateReference[]	コンピューティング ノードにインストールされている証明書の一覧。 Windows ノードの場合、Batch サービスは、指定された証明書ストアと場所に証明書をインストールします。 Linux コンピューティング ノードの場合、証明書は Task 作業ディレクトリ内のディレクトリに格納され、この場所を照会するためにタスクにAZ_BATCH_CERTIFICATES_DIR環境変数が提供されます。 'remoteUser' の可視性を持つ証明書の場合、ユーザーのホーム ディレクトリ (/home/{user-name}/certs など) に 'certs' ディレクトリが作成され、そのディレクトリに証明書が配置されます。 警告: このプロパティは非推奨であり、2024 年 2 月以降に削除されます。 代わりに Azure KeyVault 拡張機能 を使用してください。
endpointConfiguration	ComputeNodeEndpointConfiguration	コンピューティング ノードのエンドポイント構成。
errors	ComputeNodeError[]	コンピューティング ノードで現在発生しているエラーの一覧。
id	string	コンピューティング ノードの ID。 プールに追加されるすべてのコンピューティング ノードには、一意の ID が割り当てられます。 コンピューティング ノードがプールから削除されるたびに、すべてのローカル ファイルが削除され、ID が再利用され、新しいコンピューティング ノードに再利用できます。
ipAddress	string	他のノードがこのコンピューティング ノードとの通信に使用できる IP アドレス。 プールに追加されるすべてのコンピューティング ノードには、一意の IP アドレスが割り当てられます。 コンピューティング ノードがプールから削除されるたびに、すべてのローカル ファイルが削除され、IP アドレスが再利用され、新しいコンピューティング ノードに再利用できます。
isDedicated	boolean	このコンピューティング ノードが専用のコンピューティング ノードであるかどうか。 false の場合、コンピューティング ノードはスポット/低優先度のコンピューティング ノードです。
lastBootTime	string	コンピューティング ノードが最後に開始された時刻。 コンピューティング ノードの状態が使用できない場合は、このプロパティが存在しない可能性があります。
nodeAgentInfo	NodeAgentInformation	コンピューティング ノード エージェントのバージョンと、コンピューティング ノードが新しいバージョンにアップグレードされた時刻に関する情報。 Batch コンピューティング ノード エージェントは、プール内の各コンピューティング ノードで実行され、コンピューティング ノードで Batch 機能を提供するプログラムです。
recentTasks	TaskInformation[]	状態が最近変更されたタスクの一覧。 このプロパティは、プールに割り当てられた後、このコンピューティング ノードで少なくとも 1 つのタスクが実行されている場合にのみ存在します。
runningTaskSlotsCount	integer	コンピューティング ノードで現在ジョブ タスクを実行することによって使用されるスケジュール スロットの合計数。 これには、ジョブ マネージャー タスクと通常のタスクが含まれますが、ジョブの準備、ジョブの解放、または開始タスクは含まれません。
runningTasksCount	integer	コンピューティング ノードで現在実行中のジョブ タスクの合計数。 これには、ジョブ マネージャー タスクと通常のタスクが含まれますが、ジョブの準備、ジョブの解放、または開始タスクは含まれません。
schedulingState	SchedulingState	コンピューティング ノードがタスク スケジュールに使用できるかどうか。
startTask	StartTask	プールに参加するコンピューティング ノードで実行するように指定されたタスク。 Batch は、ノードで回復操作がトリガーされたときにタスクを再試行します。 復旧操作の例としては、異常なノードが再起動されたときや、ホスト障害が原因でコンピューティング ノードが消失した場合などです (ただし、これらに限定されません)。 回復操作による再試行は とは無関係であり、maxTaskRetryCount に対してカウントされません。 maxTaskRetryCount が 0 の場合でも、回復操作による内部再試行が発生する可能性があります。 このため、すべてのタスクはべき等である必要があります。 つまり、タスクは、破損や重複するデータを発生させることなく、中断および再起動されることを許容する必要があります。 実行時間の長いタスクのベスト プラクティスは、何らかの形式のチェックポイント処理を使用することです。 場合によっては、コンピューティング ノードが再起動されなかった場合でも、StartTask が再実行されることがあります。 StartTask は StartTask の再実行をブロックするため、StartTask を使用して中断プロセスを作成したり、StartTask 作業ディレクトリからサービスをインストール/起動したりしないように注意する必要があります。
startTaskInfo	StartTaskInformation	コンピューティング ノードでの StartTask の実行に関するランタイム情報。
state	ComputeNodeState	コンピューティング ノードの現在の状態。 スポット/低優先度のコンピューティング ノードが割り込まれた。 割り込まれたときにコンピューティング ノードで実行されていたタスクは、別のコンピューティング ノードが使用可能になったときに再スケジュールされます。
stateTransitionTime	string	コンピューティング ノードが現在の状態に入った時刻。
totalTasksRun	integer	コンピューティング ノードで完了したジョブ タスクの合計数。 これには、ジョブ マネージャー タスクと通常のタスクが含まれますが、ジョブの準備、ジョブの解放、または開始タスクは含まれません。
totalTasksSucceeded	integer	コンピューティング ノードで (exitCode 0 を使用して) 正常に完了したジョブ タスクの合計数。 これには、ジョブ マネージャー タスクと通常のタスクが含まれますが、ジョブの準備、ジョブの解放、または開始タスクは含まれません。
url	string	コンピューティング ノードの URL。
virtualMachineInfo	VirtualMachineInfo	仮想マシンの現在の状態に関する情報。
vmSize	string	コンピューティング ノードをホストする仮想マシンのサイズ。 プールで使用可能な仮想マシンのサイズについては、「Azure Batch プール内のコンピューティング ノードの VM サイズの選択 ()」https://docs.microsoft.com/azure/batch/batch-pool-vm-sizesを参照してください。

ComputeNodeEndpointConfiguration

コンピューティング ノードのエンドポイント構成。

名前	型	説明
inboundEndpoints	InboundEndpoint[]	コンピューティング ノードでアクセスできる受信エンドポイントの一覧。

ComputeNodeError

コンピューティング ノードで発生したエラー。

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

ComputeNodeIdentityReference

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

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

ComputeNodeState

コンピューティング ノードの現在の状態。

名前	型	説明
creating	string	Batch サービスは、基になる仮想マシンを Azure Compute から取得しましたが、プールへの参加はまだ開始されていません。
idle	string	コンピューティング ノードは現在タスクを実行していません。
leavingpool	string	コンピューティング ノードは、ユーザーがプールを明示的に削除したか、プールのサイズを変更または自動スケールダウンしているために、プールを離れることになります。
offline	string	コンピューティング ノードは現在タスクを実行していないため、コンピューティング ノードへの新しいタスクのスケジュール設定は無効になっています。
preempted	string	スポット/低優先度のコンピューティング ノードが割り込まれた。 割り込まれたときにコンピューティング ノードで実行されていたタスクは、別のコンピューティング ノードが使用可能になったときに再スケジュールされます。
rebooting	string	コンピューティング ノードが再起動中です。
reimaging	string	コンピューティング ノードが再イメージ化されています。
running	string	コンピューティング ノードは、1 つ以上のタスク (StartTask 以外) を実行しています。
starting	string	Batch サービスは、基になる仮想マシンで開始されています。
starttaskfailed	string	StartTask がコンピューティング ノードで失敗し (すべての再試行が使い果たされました)、waitForSuccess が設定されています。 コンピューティング ノードは、タスクの実行には使用できません。
unknown	string	Batch サービスはコンピューティング ノードとの接触を失い、その真の状態を認識していません。
unusable	string	コンピューティング ノードは、エラーが原因でタスクの実行に使用できません。
waitingforstarttask	string	StartTask はコンピューティング ノードで実行を開始しましたが、waitForSuccess が設定され、StartTask がまだ完了していません。

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 によって設定されたタスク リソース ファイルが含まれる標準の Batch サービスタスク作業ディレクトリを使用します。

ElevationLevel

ユーザーの昇格レベル。

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

EnvironmentSetting

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

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

ErrorCategory

エラーのカテゴリ。

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

ErrorMessage

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

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

ImageReference

Azure Virtual Machines Marketplace イメージまたは Azure Compute Gallery イメージへの参照。 Azure Batchによって検証されたすべてのAzure Marketplaceイメージ参照の一覧を取得するには、「サポートされているイメージの一覧表示」操作を参照してください。

名前	型	説明
exactVersion	string	ノードの作成に使用されるプラットフォーム イメージまたはマーケットプレース イメージの特定のバージョン。 この読み取り専用フィールドは、プールの作成時に 'version' に指定された値が 'latest' の場合にのみ、'version' と異なります。
offer	string	Azure Virtual Machines Marketplace イメージのオファーの種類。 たとえば、UbuntuServer や WindowsServer などです。
publisher	string	Azure Virtual Machines Marketplace イメージの発行元。 たとえば、Canonical や MicrosoftWindowsServer などです。
sku	string	Azure Virtual Machines Marketplace イメージの SKU。 たとえば、18.04-LTS や 2019-Datacenter などです。
version	string	Azure Virtual Machines Marketplace イメージのバージョン。 'latest' の値を指定して、最新バージョンの Image を選択できます。 省略した場合、既定値は 'latest' です。
virtualMachineImageId	string	Azure Compute Gallery イメージの ARM リソース識別子。 プール内のコンピューティング ノードは、このイメージ ID を使用して作成されます。これは、常に最新のイメージ バージョンに既定値を設定するための /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleryName}/images/{imageDefinitionName}/versions/{VersionId} または /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallery/galleryName}/images/{imageDefinitionName} の形式です。 このプロパティは、他の ImageReference プロパティと相互に排他的です。 Azure Compute Gallery イメージは、同じリージョンにレプリカを持ち、Azure Batch アカウントと同じサブスクリプションに存在する必要があります。 imageId でイメージ バージョンが指定されていない場合は、最新バージョンが使用されます。 Batch サービスと通信する Batch コンピューティング ノード エージェントのファイアウォール設定の詳細については、「」を参照してください https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration。

InboundEndpoint

コンピューティング ノード上の受信エンドポイント。

名前	型	説明
backendPort	integer	エンドポイントのバックエンド ポート番号。
frontendPort	integer	エンドポイントのパブリック ポート番号。
name	string	エンドポイントの名前。
protocol	InboundEndpointProtocol	エンドポイントのプロトコル。
publicFQDN	string	コンピューティング ノードのパブリック完全修飾ドメイン名。
publicIPAddress	string	コンピューティング ノードのパブリック IP アドレス。

InboundEndpointProtocol

エンドポイントのプロトコル。

名前	型	説明
tcp	string	エンドポイントには TCP を使用します。
udp	string	エンドポイントには UDP を使用します。

NameValuePair

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

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

NodeAgentInformation

コンピューティング ノード エージェントに関する情報。

名前	型	説明
lastUpdateTime	string	コンピューティング ノードでコンピューティング ノード エージェントが更新された時刻。 これは、コンピューティング ノード エージェントが新しいバージョンに更新された最新の時刻です。
version	string	コンピューティング ノードで実行されている Batch コンピューティング ノード エージェントのバージョン。 このバージョン番号は、 にあるコンピューティング ノード エージェントのリリース ノートに https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md対して確認できます。

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 を設定してパブリック アクセスを許可します。

SchedulingState

コンピューティング ノードがタスク スケジュールに使用できるかどうか。

名前	型	説明
disabled	string	コンピューティング ノードで新しいタスクはスケジュールされません。 コンピューティング ノードで既に実行されているタスクは、完了まで引き続き実行される可能性があります。 すべてのコンピューティング ノードは、スケジュールが有効な状態で開始されます。
enabled	string	タスクは、コンピューティング ノードでスケジュールできます。

StartTask

ノードがAzure Batch サービスのプールに参加するとき、またはコンピューティング ノードが再起動または再イメージ化されたときに実行されるタスク。

名前	型	説明
commandLine	string	StartTask のコマンド ライン。 コマンド ラインはシェルでは実行されないため、環境変数の拡張などのシェル機能を利用することはできません。 このような機能を利用する場合は、コマンド ラインでシェルを呼び出す必要があります。たとえば、Windows では "cmd /c MyCommand" を使用し、Linux では "/bin/sh -c MyCommand" を使用します。 コマンド ラインがファイル パスを参照している場合は、相対パス (タスク作業ディレクトリに対する相対パス) を使用するか、Batch で指定された環境変数 (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) を使用する必要があります。
containerSettings	TaskContainerSettings	StartTask を実行するコンテナーの設定。 これを指定すると、AZ_BATCH_NODE_ROOT_DIRの下にあるすべてのディレクトリ (ノード上のAzure Batchディレクトリのルート) がコンテナーにマップされ、すべての Task 環境変数がコンテナーにマップされ、Task コマンド ラインがコンテナーで実行されます。 AZ_BATCH_NODE_ROOT_DIRの外部のコンテナーで生成されたファイルはホスト ディスクに反映されない可能性があります。つまり、Batch ファイル API はそれらのファイルにアクセスできません。
environmentSettings	EnvironmentSetting[]	StartTask の環境変数設定の一覧。
maxTaskRetryCount	integer	タスクを再試行できる最大回数。 終了コードが 0 以外の場合、Batch サービスは Task を再試行します。 この値によって再試行の回数が限定されますのでご注意ください。 Batch サービスはタスクを 1 回試し、この制限まで再試行できます。 たとえば、最大再試行回数が 3 の場合、Batch はタスクを最大 4 回試行します (最初の再試行が 1 回、再試行回数が 3 回)。 最大再試行回数が 0 の場合、Batch サービスはタスクを再試行しません。 最大再試行回数が -1 の場合、Batch サービスは制限なくタスクを再試行しますが、開始タスクやタスクには推奨されません。 既定値は 0 (再試行なし) です。
resourceFiles	ResourceFile[]	コマンド ラインを実行する前に Batch サービスがコンピューティング ノードにダウンロードするファイルの一覧。 リソース ファイルの一覧には最大サイズがあります。 最大サイズを超えると、要求は失敗し、応答エラー コードは RequestEntityTooLarge になります。 この場合、ResourceFiles のコレクションのサイズを小さくする必要があります。 これは、.zip ファイル、アプリケーション パッケージ、または Docker コンテナーを使用して実現できます。 この要素の下に一覧表示されるファイルは、タスクの作業ディレクトリにあります。
userIdentity	UserIdentity	StartTask を実行するユーザー ID。 省略すると、Task は Task に固有の非管理ユーザーとして実行されます。
waitForSuccess	boolean	コンピューティング ノードでタスクをスケジュールする前に、Batch サービスが StartTask が正常に完了するまで待機する必要があるかどうか (つまり、終了コード 0 で終了する)。 True で Node で StartTask が失敗した場合、Batch サービスは StartTask を最大再試行回数 (maxTaskRetryCount) まで再試行します。 すべての再試行の後もタスクが正常に完了していない場合、Batch サービスはノードを使用不可としてマークし、タスクをスケジュールしません。 この条件は、コンピューティング ノードの状態とエラー情報の詳細を使用して検出できます。 false の場合、Batch サービスは StartTask の完了を待機しません。 この場合、StartTask がまだ実行されている間に、他のタスクがコンピューティング ノードで実行を開始できます。StartTask が失敗した場合でも、新しいタスクは引き続きコンピューティング ノードでスケジュールされます。 既定値は true です。

StartTaskInformation

コンピューティング ノードで実行されている StartTask に関する情報。

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

StartTaskState

コンピューティング ノード上の StartTask の状態。

名前	型	説明
completed	string	StartTask が終了コード 0 で終了したか、StartTask が失敗して再試行の制限に達したか、タスク準備エラー (リソース ファイルのダウンロードエラーなど) が原因で StartTask プロセスが実行されませんでした。
running	string	StartTask は現在実行中です。

TaskContainerExecutionInformation

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

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

TaskContainerSettings

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

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

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	ユーザー インターフェイスでの表示に適したタスク エラーを説明するメッセージ。

TaskInformation

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

名前	型	説明
executionInfo	TaskExecutionInformation	タスクの実行に関する情報。
jobId	string	タスクが属するジョブの ID。
subtaskId	integer	タスクが複数インスタンスのタスクの場合のサブタスクの ID。
taskId	string	タスクの ID。
taskState	TaskState	タスクの現在の状態。
taskUrl	string	タスクの URL。

TaskState

Task の状態。

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

UserIdentity

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

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

VirtualMachineInfo

仮想マシンの現在の状態に関する情報。

名前	型	説明
imageReference	ImageReference	Azure 仮想マシンの Marketplace イメージへの参照。
scaleSetVmResourceId	string	コンピューティング ノードの現在の仮想マシン スケール セット VM のリソース ID。 batch アカウントが poolAllocationMode プロパティを 'UserSubscription' に設定して作成された場合にのみ定義されます。