Batch Account - Get
指定した Batch アカウントに関する情報を取得します。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2024-07-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-zA-Z0-9]+$ |
Batch アカウントの名前。 |
resource
|
path | True |
string |
Batch アカウントを含むリソース グループの名前。 |
subscription
|
path | True |
string |
Azure サブスクリプション ID。 これは GUID 形式の文字列です (例: 000000000-0000-0000-0000-000000000000) |
api-version
|
query | True |
string |
HTTP 要求で使用される API バージョン。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
操作が成功しました。 応答には Batch アカウント エンティティが含まれています。 |
|
Other Status Codes |
操作が失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Microsoft Entra OAuth 2.0 認証コード フロー
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントを偽装する |
例
Batch |
Private |
BatchAccountGet
要求のサンプル
応答のサンプル
{
"name": "sampleacct",
"location": "japaneast",
"properties": {
"accountEndpoint": "sampleacct.japaneast.batch.azure.com",
"provisioningState": "Succeeded",
"poolAllocationMode": "BatchService",
"dedicatedCoreQuota": 20,
"lowPriorityCoreQuota": 20,
"poolQuota": 20,
"activeJobAndJobScheduleQuota": 20,
"autoStorage": {
"storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage",
"lastKeySync": "2016-03-10T23:48:38.9878479Z"
},
"publicNetworkAccess": "Enabled"
},
"identity": {
"type": "None"
},
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"type": "Microsoft.Batch/batchAccounts"
}
PrivateBatchAccountGet
要求のサンプル
応答のサンプル
{
"name": "sampleacct",
"location": "japaneast",
"properties": {
"accountEndpoint": "sampleacct.japaneast.batch.azure.com",
"provisioningState": "Succeeded",
"poolAllocationMode": "BatchService",
"dedicatedCoreQuota": 20,
"lowPriorityCoreQuota": 20,
"poolQuota": 20,
"activeJobAndJobScheduleQuota": 20,
"autoStorage": {
"storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage",
"lastKeySync": "2016-03-10T23:48:38.9878479Z"
},
"publicNetworkAccess": "Disabled",
"privateEndpointConnections": [
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/privateEndpointConnections/testprivateEndpointConnection.24d6b4b5-e65c-4330-bbe9-3a290d62f8e0",
"name": "testprivateEndpointConnection.24d6b4b5-e65c-4330-bbe9-3a290d62f8e0",
"type": "Microsoft.Batch/batchAccounts/privateEndpointConnections",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Network/privateEndpoints/testprivateEndpoint"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "Approved by xyz.abc@company.com"
}
}
}
]
},
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"type": "Microsoft.Batch/batchAccounts"
}
定義
名前 | 説明 |
---|---|
Authentication |
Batch アカウントの認証モード。 |
Auto |
Batch サービスが自動ストレージ アカウントの管理に使用する認証モード。 |
Auto |
Batch アカウントに関連付けられている自動ストレージ アカウントに関する情報が含まれています。 |
Batch |
Azure Batch アカウントに関する情報が含まれています。 |
Batch |
Batch アカウントの ID (構成されている場合)。 これは、ユーザーが Batch アカウント暗号化構成として "Microsoft.KeyVault" を指定した場合、または自動ストレージ認証モードとして |
Cloud |
Batch サービスからのエラー応答。 |
Cloud |
Batch サービスからのエラー応答。 |
Compute |
コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。 |
Encryption |
Batch アカウント内で顧客データを暗号化する方法を構成します。 既定では、アカウントは Microsoft マネージド キーを使用して暗号化されます。 追加の制御のために、代わりにカスタマー マネージド キーを使用できます。 |
Endpoint |
一致する IPRule がない場合の既定のアクション。 |
Endpoint |
Batch エンドポイントのネットワーク アクセス プロファイル。 |
IPRule |
クライアント IP アドレスをフィルター処理する規則。 |
IPRule |
クライアント IP アドレスが一致したときのアクション。 |
Key |
キー ソースの種類。 |
Key |
Microsoft.KeyVault の暗号化 KeySource を使用する場合の KeyVault 構成。 |
Key |
Batch アカウントに関連付けられている Azure キー コンテナーを識別します。 |
Network |
Batch アカウントのネットワーク プロファイル。各エンドポイントのネットワーク ルール設定が含まれています。 |
Pool |
Batch アカウントでプールを作成するための割り当てモード。 |
Private |
プライベート エンドポイント接続のプライベート エンドポイント。 |
Private |
プライベート リンク リソースに関する情報が含まれています。 |
Private |
プライベート エンドポイント接続のプロビジョニング状態。 |
Private |
プライベート エンドポイント接続のプライベート リンク サービス接続状態 |
Private |
Batch プライベート エンドポイント接続の状態 |
Provisioning |
リソースのプロビジョニング済み状態 |
Public |
Batch アカウント内のリソースで動作するためのネットワーク アクセスの種類。 |
Resource |
Batch アカウントに使用される ID の種類。 |
User |
関連付けられているユーザー ID の一覧。 |
Virtual |
BATCH アカウントの VM ファミリとそれに関連付けられているコア クォータ。 |
AuthenticationMode
Batch アカウントの認証モード。
値 | 説明 |
---|---|
AAD |
Microsoft Entra ID を使用した認証モード。 |
SharedKey |
共有キーを使用した認証モード。 |
TaskAuthenticationToken |
タスク認証トークンを使用した認証モード。 |
AutoStorageAuthenticationMode
Batch サービスが自動ストレージ アカウントの管理に使用する認証モード。
値 | 説明 |
---|---|
BatchAccountManagedIdentity |
Batch サービスは、Batch アカウントに割り当てられたマネージド ID を使用して、自動ストレージへの要求を認証します。 |
StorageKeys |
Batch サービスは、ストレージ アカウント キーを使用して自動ストレージへの要求を認証します。 |
AutoStorageProperties
Batch アカウントに関連付けられている自動ストレージ アカウントに関する情報が含まれています。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
authenticationMode | StorageKeys |
Batch サービスが自動ストレージ アカウントの管理に使用する認証モード。 |
|
lastKeySync |
string (date-time) |
ストレージ キーが Batch アカウントと最後に同期された UTC 時刻。 |
|
nodeIdentityReference |
自動ストレージへのアクセスにコンピューティング ノードが使用するユーザー割り当て ID への参照。 |
||
storageAccountId |
string (arm-id) |
自動ストレージ アカウントに使用するストレージ アカウントのリソース ID。 |
BatchAccount
Azure Batch アカウントに関する情報が含まれています。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
id |
string |
リソースの ID。 |
|
identity |
Batch アカウントの ID。 |
||
location |
string |
リソースの場所。 |
|
name |
string |
リソースの名前。 |
|
properties.accountEndpoint |
string |
Batch サービスとの対話に使用されるアカウント エンドポイント。 |
|
properties.activeJobAndJobScheduleQuota |
integer (int32) |
Batch アカウントのアクティブなジョブとジョブ スケジュールのクォータ。 |
|
properties.allowedAuthenticationModes |
データ プレーンでの認証に使用できる Batch アカウントで許可される認証モードの一覧。 これは、コントロール プレーンでの認証には影響しません。 |
||
properties.autoStorage |
Batch アカウントに関連付けられている自動ストレージ アカウントのプロパティと状態。 |
||
properties.dedicatedCoreQuota |
integer (int32) |
Batch アカウントの専用コア クォータ。 |
|
properties.dedicatedCoreQuotaPerVMFamily |
Batch アカウントの仮想マシン ファミリごとの専用コア クォータの一覧。 PoolAllocationMode が UserSubscription に設定されているアカウントの場合、クォータはサブスクリプションで管理されるため、この値は返されません。 |
||
properties.dedicatedCoreQuotaPerVMFamilyEnforced |
boolean |
このアカウントに対して仮想マシン ファミリごとのコア クォータが適用されるかどうかを示す値 |
|
properties.encryption |
Batch アカウントの暗号化構成。 |
||
properties.keyVaultReference |
Batch アカウントに関連付けられている Azure キー コンテナーへの参照。 |
||
properties.lowPriorityCoreQuota |
integer (int32) |
Batch アカウントのスポット/優先順位の低いコア クォータ。 |
|
properties.networkProfile |
Batch アカウントのネットワーク プロファイル。各エンドポイントのネットワーク ルール設定が含まれています。 |
||
properties.nodeManagementEndpoint |
string |
Batch ノード管理サービスに接続するためにコンピューティング ノードによって使用されるエンドポイント。 |
|
properties.poolAllocationMode |
Batch アカウントでプールを作成するために使用する割り当てモード。 |
||
properties.poolQuota |
integer (int32) |
Batch アカウントのプール クォータ。 |
|
properties.privateEndpointConnections |
Batch アカウントに関連付けられているプライベート エンドポイント接続の一覧 |
||
properties.provisioningState |
リソースのプロビジョニング済み状態 |
||
properties.publicNetworkAccess | Enabled |
Azure Batch サービスと Batch アカウント操作にアクセスするためのネットワーク インターフェイスの種類。 |
|
tags |
object |
リソースのタグ。 |
|
type |
string |
リソースの種類。 |
BatchAccountIdentity
Batch アカウントの ID (構成されている場合)。 これは、ユーザーが Batch アカウント暗号化構成として "Microsoft.KeyVault" を指定した場合、または自動ストレージ認証モードとして ManagedIdentity
が選択されている場合に使用されます。
名前 | 型 | 説明 |
---|---|---|
principalId |
string |
Batch アカウントのプリンシパル ID。 このプロパティは、システム割り当て ID にのみ提供されます。 |
tenantId |
string |
Batch アカウントに関連付けられているテナント ID。 このプロパティは、システム割り当て ID にのみ提供されます。 |
type |
Batch アカウントに使用される ID の種類。 |
|
userAssignedIdentities |
<string,
User |
Batch アカウントに関連付けられているユーザー ID の一覧。 |
CloudError
Batch サービスからのエラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
エラー応答の本文。 |
CloudErrorBody
Batch サービスからのエラー応答。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。 |
details |
エラーに関する追加の詳細の一覧。 |
|
message |
string |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
target |
string |
特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。 |
ComputeNodeIdentityReference
コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。
名前 | 型 | 説明 |
---|---|---|
resourceId |
string |
ユーザー割り当て ID の ARM リソース ID。 |
EncryptionProperties
Batch アカウント内で顧客データを暗号化する方法を構成します。 既定では、アカウントは Microsoft マネージド キーを使用して暗号化されます。 追加の制御のために、代わりにカスタマー マネージド キーを使用できます。
名前 | 型 | 説明 |
---|---|---|
keySource |
キー ソースの種類。 |
|
keyVaultProperties |
Microsoft.KeyVault を使用する場合の追加の詳細 |
EndpointAccessDefaultAction
一致する IPRule がない場合の既定のアクション。
値 | 説明 |
---|---|
Allow |
クライアント アクセスを許可します。 |
Deny |
クライアント アクセスを拒否します。 |
EndpointAccessProfile
Batch エンドポイントのネットワーク アクセス プロファイル。
名前 | 型 | 説明 |
---|---|---|
defaultAction |
一致する IPRule がない場合の既定のアクション。 |
|
ipRules |
IPRule[] |
クライアント IP アドレスをフィルター処理する IP 範囲の配列。 |
IPRule
クライアント IP アドレスをフィルター処理する規則。
名前 | 型 | 説明 |
---|---|---|
action |
クライアント IP アドレスが一致したときのアクション。 |
|
value |
string |
フィルター処理する IP アドレスまたは IP アドレス範囲 |
IPRuleAction
クライアント IP アドレスが一致したときのアクション。
値 | 説明 |
---|---|
Allow |
一致したクライアント IP アドレスへのアクセスを許可します。 |
KeySource
キー ソースの種類。
値 | 説明 |
---|---|
Microsoft.Batch |
Batch は、アカウント データの保護に使用される暗号化キーを作成および管理します。 |
Microsoft.KeyVault |
アカウント データの保護に使用される暗号化キーは、外部キー コンテナーに格納されます。 これが設定されている場合、Batch アカウント ID を |
KeyVaultProperties
Microsoft.KeyVault の暗号化 KeySource を使用する場合の KeyVault 構成。
名前 | 型 | 説明 |
---|---|---|
keyIdentifier |
string |
バージョンの有無に関係なくシークレットへの完全パス。 https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053の例 または https://mykeyvault.vault.azure.net/keys/testkey. 使用できるようにするには、次の前提条件を満たす必要があります。 Batch アカウントにシステム割り当て ID があります。アカウント ID には、キー/取得、キー/ラップ解除、キー/ラップのアクセス許可が付与されています。KeyVault には論理的な削除と消去の保護が有効になっています |
KeyVaultReference
Batch アカウントに関連付けられている Azure キー コンテナーを識別します。
名前 | 型 | 説明 |
---|---|---|
id |
string (arm-id) |
Batch アカウントに関連付けられている Azure キー コンテナーのリソース ID。 |
url |
string |
Batch アカウントに関連付けられている Azure キー コンテナーの URL。 |
NetworkProfile
Batch アカウントのネットワーク プロファイル。各エンドポイントのネットワーク ルール設定が含まれています。
名前 | 型 | 説明 |
---|---|---|
accountAccess |
batchAccount エンドポイントのネットワーク アクセス プロファイル (Batch アカウント データ プレーン API)。 |
|
nodeManagementAccess |
nodeManagement エンドポイントのネットワーク アクセス プロファイル (Batch プールのコンピューティング ノードを管理する Batch サービス)。 |
PoolAllocationMode
Batch アカウントでプールを作成するための割り当てモード。
値 | 説明 |
---|---|
BatchService |
プールは、Batch サービスが所有するサブスクリプションに割り当てられます。 |
UserSubscription |
プールは、ユーザーが所有するサブスクリプションに割り当てられます。 |
PrivateEndpoint
プライベート エンドポイント接続のプライベート エンドポイント。
名前 | 型 | 説明 |
---|---|---|
id |
string |
プライベート エンドポイントの ARM リソース識別子。 これは、/subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint} という形式です。 |
PrivateEndpointConnection
プライベート リンク リソースに関する情報が含まれています。
名前 | 型 | 説明 |
---|---|---|
etag |
string |
コンカレンシー ステートメントに使用されるリソースの ETag。 |
id |
string |
リソースの ID。 |
name |
string |
リソースの名前。 |
properties.groupIds |
string[] |
プライベート エンドポイント接続のグループ ID。 |
properties.privateEndpoint |
プライベート エンドポイントの ARM リソース識別子。 |
|
properties.privateLinkServiceConnectionState |
プライベート エンドポイント接続のプライベート リンク サービス接続状態。 |
|
properties.provisioningState |
プライベート エンドポイント接続のプロビジョニング状態。 |
|
tags |
object |
リソースのタグ。 |
type |
string |
リソースの種類。 |
PrivateEndpointConnectionProvisioningState
プライベート エンドポイント接続のプロビジョニング状態。
値 | 説明 |
---|---|
Cancelled |
ユーザーが接続の作成を取り消しました。 |
Creating |
接続が作成されています。 |
Deleting |
接続が削除されています。 |
Failed |
ユーザーが接続の更新を要求し、失敗しました。 更新操作を再試行できます。 |
Succeeded |
接続の状態は最終的であり、状態が承認されている場合は使用できる状態です。 |
Updating |
ユーザーは接続の状態を更新することを要求しましたが、更新操作はまだ完了していません。 Batch アカウントを接続するときに接続を参照することはできません。 |
PrivateLinkServiceConnectionState
プライベート エンドポイント接続のプライベート リンク サービス接続状態
名前 | 型 | 説明 |
---|---|---|
actionsRequired |
string |
プライベート接続状態で必要なアクション |
description |
string |
プライベート接続状態の説明 |
status |
Batch アカウントのプライベート エンドポイント接続の状態 |
PrivateLinkServiceConnectionStatus
Batch プライベート エンドポイント接続の状態
値 | 説明 |
---|---|
Approved |
プライベート エンドポイント接続が承認され、Batch アカウントへのアクセスに使用できます |
Disconnected |
プライベート エンドポイント接続が切断され、Batch アカウントにアクセスするために使用できない |
Pending |
プライベート エンドポイント接続が保留中であり、Batch アカウントへのアクセスに使用できない |
Rejected |
プライベート エンドポイント接続が拒否され、Batch アカウントへのアクセスに使用できない |
ProvisioningState
リソースのプロビジョニング済み状態
値 | 説明 |
---|---|
Cancelled |
アカウントの最後の操作は取り消されます。 |
Creating |
アカウントが作成されています。 |
Deleting |
アカウントが削除されています。 |
Failed |
アカウントの最後の操作が失敗しました。 |
Invalid |
アカウントが無効な状態です。 |
Succeeded |
アカウントが作成され、使用する準備ができました。 |
PublicNetworkAccessType
Batch アカウント内のリソースで動作するためのネットワーク アクセスの種類。
値 | 説明 |
---|---|
Disabled |
パブリック接続を無効にし、プライベート エンドポイント リソースを介した Azure Batch Service へのプライベート接続を有効にします。 |
Enabled |
パブリック DNS を介した Azure Batch への接続を有効にします。 |
SecuredByPerimeter |
NSP 構成を使用して Azure Batch への接続をセキュリティで保護します。 |
ResourceIdentityType
Batch アカウントに使用される ID の種類。
値 | 説明 |
---|---|
None |
Batch アカウントには ID が関連付けされません。 更新アカウントで |
SystemAssigned |
Batch アカウントには、システム割り当て ID があります。 |
UserAssigned |
Batch アカウントには、ユーザー割り当て ID があります。 |
UserAssignedIdentities
関連付けられているユーザー ID の一覧。
名前 | 型 | 説明 |
---|---|---|
clientId |
string |
ユーザー割り当て ID のクライアント ID。 |
principalId |
string |
ユーザー割り当て ID のプリンシパル ID。 |
VirtualMachineFamilyCoreQuota
BATCH アカウントの VM ファミリとそれに関連付けられているコア クォータ。
名前 | 型 | 説明 |
---|---|---|
coreQuota |
integer (int32) |
Batch アカウントの VM ファミリのコア クォータ。 |
name |
string |
仮想マシン ファミリ名。 |