Compute Node - Upload Batch Service Logs
サービス ログ ファイルAzure Batch指定したコンピューティング ノードからAzure Blob Storageにアップロードします。
これは、Azure Batchエラーが発生し、Azure サポートにエスカレートする場合に、コンピューティング ノードから自動でサービス ログ ファイルを収集するためのものです。 Azure Batch サービスのログ ファイルは、Batch サービスの問題のデバッグに役立つAzure サポートと共有する必要があります。
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?timeout={timeout}&api-version=2023-11-01.18.0
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
batch
|
path | True |
string |
すべてのAzure Batchサービス要求のベース URL。 |
node
|
path | True |
string |
Azure Batch サービス ログ ファイルのアップロード元となるコンピューティング ノードの ID。 |
pool
|
path | True |
string |
コンピューティング ノードを含むプールの ID。 |
api-version
|
query | True |
string |
クライアント API のバージョン。 |
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 を直接呼び出す場合は、明示的に設定します。 |
要求本文
Media Types: "application/json; odata=minimalmetadata"
名前 | 必須 | 型 | 説明 |
---|---|---|---|
containerUrl | True |
string |
Batch Service ログ ファイルをアップロードするAzure Blob Storage内のコンテナーの URL。 |
startTime | True |
string |
Batch Service ログ ファイルをアップロードする時間範囲の開始。 |
endTime |
string |
Batch Service ログ ファイルをアップロードする時間範囲の終わり。 |
|
identityReference |
containerUrl で指定されたAzure Blob Storageにアクセスするために使用するユーザー割り当て ID への参照。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
Batch サービスへの要求が成功しました。 ヘッダー
|
|
Other Status Codes |
Batch サービスからのエラー。 |
セキュリティ
azure_auth
Microsoft Entra OAuth 2.0 認証コード フロー
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
Authorization
型:
apiKey
/:
header
例
Upload BatchService Logs
要求のサンプル
POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2023-11-01.18.0
{
"containerUrl": "https://somestorageacct.blob.core.windows.net/batch-compute-node-logs?se=2017-12-09T18%3A51%3A00Z&sp=w&sv=2016-05-31&sr=c&sig",
"startTime": "2017-11-27T00:00:00Z"
}
応答のサンプル
{
"virtualDirectoryName": "poolId/tvm-1695681911-1-20161121t182739z/0795539d-82fe-48e3-bbff-2964905b6de0",
"numberOfFilesUploaded": 8
}
定義
名前 | 説明 |
---|---|
Batch |
Azure Batch サービスから受信したエラー応答。 |
Batch |
Azure Batchエラー応答に含まれる追加情報の項目。 |
Compute |
コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。 |
Error |
Azure Batchエラー応答で受信したエラー メッセージ。 |
Upload |
Azure Batch サービス ログ ファイルは、コンピューティング ノードの構成をアップロードします。 |
Upload |
特定のコンピューティング ノードから Batch サービス ログ ファイルをアップロードした結果。 |
BatchError
Azure Batch サービスから受信したエラー応答。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。 |
message |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
|
values |
エラーに関する追加の詳細を含むキーと値のペアのコレクション。 |
BatchErrorDetail
Azure Batchエラー応答に含まれる追加情報の項目。
名前 | 型 | 説明 |
---|---|---|
key |
string |
Value プロパティの意味を指定する識別子。 |
value |
string |
エラー応答に含まれる追加情報。 |
ComputeNodeIdentityReference
コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。
名前 | 型 | 説明 |
---|---|---|
resourceId |
string |
ユーザー割り当て ID の ARM リソース ID。 |
ErrorMessage
Azure Batchエラー応答で受信したエラー メッセージ。
名前 | 型 | 説明 |
---|---|---|
lang |
string |
エラー メッセージの言語コード |
value |
string |
メッセージのテキストです。 |
UploadBatchServiceLogsConfiguration
Azure Batch サービス ログ ファイルは、コンピューティング ノードの構成をアップロードします。
名前 | 型 | 説明 |
---|---|---|
containerUrl |
string |
Batch Service ログ ファイルをアップロードするAzure Blob Storage内のコンテナーの URL。 |
endTime |
string |
Batch Service ログ ファイルをアップロードする時間範囲の終わり。 |
identityReference |
containerUrl で指定されたAzure Blob Storageにアクセスするために使用するユーザー割り当て ID への参照。 |
|
startTime |
string |
Batch Service ログ ファイルをアップロードする時間範囲の開始。 |
UploadBatchServiceLogsResult
特定のコンピューティング ノードから Batch サービス ログ ファイルをアップロードした結果。
名前 | 型 | 説明 |
---|---|---|
numberOfFilesUploaded |
integer |
アップロードされるログ ファイルの数。 |
virtualDirectoryName |
string |
Batch Service ログ ファイルがアップロードされるコンテナー内の仮想ディレクトリAzure Blob Storage。 |