次の方法で共有


Batch Account - Get

指定した Batch アカウントに関する情報を取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2024-07-01

URI パラメーター

名前 / 必須 説明
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-zA-Z0-9]+$

Batch アカウントの名前。

resourceGroupName
path True

string

Batch アカウントを含むリソース グループの名前。

subscriptionId
path True

string

Azure サブスクリプション ID。 これは GUID 形式の文字列です (例: 000000000-0000-0000-0000-000000000000)

api-version
query True

string

HTTP 要求で使用される API バージョン。

応答

名前 説明
200 OK

BatchAccount

操作が成功しました。 応答には Batch アカウント エンティティが含まれています。

Other Status Codes

CloudError

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

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

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

スコープ

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

BatchAccountGet
PrivateBatchAccountGet

BatchAccountGet

要求のサンプル

GET https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct?api-version=2024-07-01

応答のサンプル

{
  "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

要求のサンプル

GET https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct?api-version=2024-07-01

応答のサンプル

{
  "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"
}

定義

名前 説明
AuthenticationMode

Batch アカウントの認証モード。

AutoStorageAuthenticationMode

Batch サービスが自動ストレージ アカウントの管理に使用する認証モード。

AutoStorageProperties

Batch アカウントに関連付けられている自動ストレージ アカウントに関する情報が含まれています。

BatchAccount

Azure Batch アカウントに関する情報が含まれています。

BatchAccountIdentity

Batch アカウントの ID (構成されている場合)。 これは、ユーザーが Batch アカウント暗号化構成として "Microsoft.KeyVault" を指定した場合、または自動ストレージ認証モードとして ManagedIdentity が選択されている場合に使用されます。

CloudError

Batch サービスからのエラー応答。

CloudErrorBody

Batch サービスからのエラー応答。

ComputeNodeIdentityReference

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

EncryptionProperties

Batch アカウント内で顧客データを暗号化する方法を構成します。 既定では、アカウントは Microsoft マネージド キーを使用して暗号化されます。 追加の制御のために、代わりにカスタマー マネージド キーを使用できます。

EndpointAccessDefaultAction

一致する IPRule がない場合の既定のアクション。

EndpointAccessProfile

Batch エンドポイントのネットワーク アクセス プロファイル。

IPRule

クライアント IP アドレスをフィルター処理する規則。

IPRuleAction

クライアント IP アドレスが一致したときのアクション。

KeySource

キー ソースの種類。

KeyVaultProperties

Microsoft.KeyVault の暗号化 KeySource を使用する場合の KeyVault 構成。

KeyVaultReference

Batch アカウントに関連付けられている Azure キー コンテナーを識別します。

NetworkProfile

Batch アカウントのネットワーク プロファイル。各エンドポイントのネットワーク ルール設定が含まれています。

PoolAllocationMode

Batch アカウントでプールを作成するための割り当てモード。

PrivateEndpoint

プライベート エンドポイント接続のプライベート エンドポイント。

PrivateEndpointConnection

プライベート リンク リソースに関する情報が含まれています。

PrivateEndpointConnectionProvisioningState

プライベート エンドポイント接続のプロビジョニング状態。

PrivateLinkServiceConnectionState

プライベート エンドポイント接続のプライベート リンク サービス接続状態

PrivateLinkServiceConnectionStatus

Batch プライベート エンドポイント接続の状態

ProvisioningState

リソースのプロビジョニング済み状態

PublicNetworkAccessType

Batch アカウント内のリソースで動作するためのネットワーク アクセスの種類。

ResourceIdentityType

Batch アカウントに使用される ID の種類。

UserAssignedIdentities

関連付けられているユーザー ID の一覧。

VirtualMachineFamilyCoreQuota

BATCH アカウントの VM ファミリとそれに関連付けられているコア クォータ。

AuthenticationMode

Batch アカウントの認証モード。

説明
AAD

Microsoft Entra ID を使用した認証モード。

SharedKey

共有キーを使用した認証モード。

TaskAuthenticationToken

タスク認証トークンを使用した認証モード。

AutoStorageAuthenticationMode

Batch サービスが自動ストレージ アカウントの管理に使用する認証モード。

説明
BatchAccountManagedIdentity

Batch サービスは、Batch アカウントに割り当てられたマネージド ID を使用して、自動ストレージへの要求を認証します。

StorageKeys

Batch サービスは、ストレージ アカウント キーを使用して自動ストレージへの要求を認証します。

AutoStorageProperties

Batch アカウントに関連付けられている自動ストレージ アカウントに関する情報が含まれています。

名前 規定値 説明
authenticationMode

AutoStorageAuthenticationMode

StorageKeys

Batch サービスが自動ストレージ アカウントの管理に使用する認証モード。

lastKeySync

string (date-time)

ストレージ キーが Batch アカウントと最後に同期された UTC 時刻。

nodeIdentityReference

ComputeNodeIdentityReference

自動ストレージへのアクセスにコンピューティング ノードが使用するユーザー割り当て ID への参照。
ここで参照される ID は、自動ストレージへのアクセスを必要とするコンピューティング ノードを持つプールに割り当てる必要があります。

storageAccountId

string (arm-id)

自動ストレージ アカウントに使用するストレージ アカウントのリソース ID。

BatchAccount

Azure Batch アカウントに関する情報が含まれています。

名前 規定値 説明
id

string

リソースの ID。

identity

BatchAccountIdentity

Batch アカウントの ID。

location

string

リソースの場所。

name

string

リソースの名前。

properties.accountEndpoint

string

Batch サービスとの対話に使用されるアカウント エンドポイント。

properties.activeJobAndJobScheduleQuota

integer (int32)

Batch アカウントのアクティブなジョブとジョブ スケジュールのクォータ。

properties.allowedAuthenticationModes

AuthenticationMode[]

データ プレーンでの認証に使用できる Batch アカウントで許可される認証モードの一覧。 これは、コントロール プレーンでの認証には影響しません。

properties.autoStorage

AutoStorageProperties

Batch アカウントに関連付けられている自動ストレージ アカウントのプロパティと状態。
Batch アカウントに関連付けられている自動ストレージ アカウントに関する情報が含まれています。

properties.dedicatedCoreQuota

integer (int32)

Batch アカウントの専用コア クォータ。
PoolAllocationMode が UserSubscription に設定されているアカウントの場合、クォータはサブスクリプションで管理されるため、この値は返されません。

properties.dedicatedCoreQuotaPerVMFamily

VirtualMachineFamilyCoreQuota[]

Batch アカウントの仮想マシン ファミリごとの専用コア クォータの一覧。 PoolAllocationMode が UserSubscription に設定されているアカウントの場合、クォータはサブスクリプションで管理されるため、この値は返されません。

properties.dedicatedCoreQuotaPerVMFamilyEnforced

boolean

このアカウントに対して仮想マシン ファミリごとのコア クォータが適用されるかどうかを示す値
このフラグが true の場合、専用コア クォータは、アカウントの dedicatedCoreQuotaPerVMFamily プロパティと dedicatedCoreQuota プロパティの両方を介して適用されます。 このフラグが false の場合、専用コア クォータはアカウントの dedicatedCoreQuota プロパティを介してのみ適用され、仮想マシン ファミリは考慮されません。

properties.encryption

EncryptionProperties

Batch アカウントの暗号化構成。
Batch アカウント内で顧客データを暗号化する方法を構成します。 既定では、アカウントは Microsoft マネージド キーを使用して暗号化されます。 追加の制御のために、代わりにカスタマー マネージド キーを使用できます。

properties.keyVaultReference

KeyVaultReference

Batch アカウントに関連付けられている Azure キー コンテナーへの参照。
Batch アカウントに関連付けられている Azure キー コンテナーを識別します。

properties.lowPriorityCoreQuota

integer (int32)

Batch アカウントのスポット/優先順位の低いコア クォータ。
PoolAllocationMode が UserSubscription に設定されているアカウントの場合、クォータはサブスクリプションで管理されるため、この値は返されません。

properties.networkProfile

NetworkProfile

Batch アカウントのネットワーク プロファイル。各エンドポイントのネットワーク ルール設定が含まれています。
ネットワーク プロファイルは、publicNetworkAccess が有効になっている場合にのみ有効になります。

properties.nodeManagementEndpoint

string

Batch ノード管理サービスに接続するためにコンピューティング ノードによって使用されるエンドポイント。

properties.poolAllocationMode

PoolAllocationMode

Batch アカウントでプールを作成するために使用する割り当てモード。
Batch アカウントでプールを作成するための割り当てモード。

properties.poolQuota

integer (int32)

Batch アカウントのプール クォータ。

properties.privateEndpointConnections

PrivateEndpointConnection[]

Batch アカウントに関連付けられているプライベート エンドポイント接続の一覧

properties.provisioningState

ProvisioningState

リソースのプロビジョニング済み状態

properties.publicNetworkAccess

PublicNetworkAccessType

Enabled

Azure Batch サービスと Batch アカウント操作にアクセスするためのネットワーク インターフェイスの種類。
指定しない場合、既定値は 'enabled' です。

tags

object

リソースのタグ。

type

string

リソースの種類。

BatchAccountIdentity

Batch アカウントの ID (構成されている場合)。 これは、ユーザーが Batch アカウント暗号化構成として "Microsoft.KeyVault" を指定した場合、または自動ストレージ認証モードとして ManagedIdentity が選択されている場合に使用されます。

名前 説明
principalId

string

Batch アカウントのプリンシパル ID。 このプロパティは、システム割り当て ID にのみ提供されます。

tenantId

string

Batch アカウントに関連付けられているテナント ID。 このプロパティは、システム割り当て ID にのみ提供されます。

type

ResourceIdentityType

Batch アカウントに使用される ID の種類。

userAssignedIdentities

<string,  UserAssignedIdentities>

Batch アカウントに関連付けられているユーザー ID の一覧。

CloudError

Batch サービスからのエラー応答。

名前 説明
error

CloudErrorBody

エラー応答の本文。

CloudErrorBody

Batch サービスからのエラー応答。

名前 説明
code

string

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

details

CloudErrorBody[]

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

message

string

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

target

string

特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。

ComputeNodeIdentityReference

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

名前 説明
resourceId

string

ユーザー割り当て ID の ARM リソース ID。

EncryptionProperties

Batch アカウント内で顧客データを暗号化する方法を構成します。 既定では、アカウントは Microsoft マネージド キーを使用して暗号化されます。 追加の制御のために、代わりにカスタマー マネージド キーを使用できます。

名前 説明
keySource

KeySource

キー ソースの種類。

keyVaultProperties

KeyVaultProperties

Microsoft.KeyVault を使用する場合の追加の詳細

EndpointAccessDefaultAction

一致する IPRule がない場合の既定のアクション。

説明
Allow

クライアント アクセスを許可します。

Deny

クライアント アクセスを拒否します。

EndpointAccessProfile

Batch エンドポイントのネットワーク アクセス プロファイル。

名前 説明
defaultAction

EndpointAccessDefaultAction

一致する IPRule がない場合の既定のアクション。
エンドポイント アクセスの既定のアクション。 publicNetworkAccess が有効になっている場合にのみ適用されます。

ipRules

IPRule[]

クライアント IP アドレスをフィルター処理する IP 範囲の配列。

IPRule

クライアント IP アドレスをフィルター処理する規則。

名前 説明
action

IPRuleAction

クライアント IP アドレスが一致したときのアクション。

value

string

フィルター処理する IP アドレスまたは IP アドレス範囲
IPv4 アドレス、または CIDR 形式の IPv4 アドレス範囲。

IPRuleAction

クライアント IP アドレスが一致したときのアクション。

説明
Allow

一致したクライアント IP アドレスへのアクセスを許可します。

KeySource

キー ソースの種類。

説明
Microsoft.Batch

Batch は、アカウント データの保護に使用される暗号化キーを作成および管理します。

Microsoft.KeyVault

アカウント データの保護に使用される暗号化キーは、外部キー コンテナーに格納されます。 これが設定されている場合、Batch アカウント ID を SystemAssigned に設定し、keyVaultProperties の下に有効なキー識別子も指定する必要があります。

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

EndpointAccessProfile

batchAccount エンドポイントのネットワーク アクセス プロファイル (Batch アカウント データ プレーン API)。

nodeManagementAccess

EndpointAccessProfile

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。
値のグループ ID は 1 つだけです。

properties.privateEndpoint

PrivateEndpoint

プライベート エンドポイントの ARM リソース識別子。
プライベート エンドポイント接続のプライベート エンドポイント。

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

プライベート エンドポイント接続のプライベート リンク サービス接続状態。
プライベート エンドポイント接続のプライベート リンク サービス接続状態

properties.provisioningState

PrivateEndpointConnectionProvisioningState

プライベート エンドポイント接続のプロビジョニング状態。

tags

object

リソースのタグ。

type

string

リソースの種類。

PrivateEndpointConnectionProvisioningState

プライベート エンドポイント接続のプロビジョニング状態。

説明
Cancelled

ユーザーが接続の作成を取り消しました。

Creating

接続が作成されています。

Deleting

接続が削除されています。

Failed

ユーザーが接続の更新を要求し、失敗しました。 更新操作を再試行できます。

Succeeded

接続の状態は最終的であり、状態が承認されている場合は使用できる状態です。

Updating

ユーザーは接続の状態を更新することを要求しましたが、更新操作はまだ完了していません。 Batch アカウントを接続するときに接続を参照することはできません。

PrivateLinkServiceConnectionState

プライベート エンドポイント接続のプライベート リンク サービス接続状態

名前 説明
actionsRequired

string

プライベート接続状態で必要なアクション

description

string

プライベート接続状態の説明

status

PrivateLinkServiceConnectionStatus

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 が関連付けされません。 更新アカウントで None を設定すると、既存の 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

仮想マシン ファミリ名。