次の方法で共有


Microsoft.Batch バッチアカウント

Bicep リソース定義

batchAccounts リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Batch/batchAccounts リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Batch/batchAccounts@2024-07-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    allowedAuthenticationModes: [
      'string'
    ]
    autoStorage: {
      authenticationMode: 'string'
      nodeIdentityReference: {
        resourceId: 'string'
      }
      storageAccountId: 'string'
    }
    encryption: {
      keySource: 'string'
      keyVaultProperties: {
        keyIdentifier: 'string'
      }
    }
    keyVaultReference: {
      id: 'string'
      url: 'string'
    }
    networkProfile: {
      accountAccess: {
        defaultAction: 'string'
        ipRules: [
          {
            action: 'Allow'
            value: 'string'
          }
        ]
      }
      nodeManagementAccess: {
        defaultAction: 'string'
        ipRules: [
          {
            action: 'Allow'
            value: 'string'
          }
        ]
      }
    }
    poolAllocationMode: 'string'
    publicNetworkAccess: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.Batch/バッチアカウント

名前 形容 価値
ID Batch アカウントの ID。 BatchAccountIdentity の
位置 アカウントを作成するリージョン。 string (必須)
名前 リソース名

制約:
最小長 = 3
最大長 = 24
パターン = ^[a-zA-Z0-9]+$ (必須)
プロパティ Batch アカウントのプロパティ。 BatchAccountCreatePropertiesOrBatchAccountProperties の
スコープ デプロイ スコープとは異なるスコープでリソースを作成するときに使用します。 このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください

AutoStorageBasePropertiesまたはAutoStorageProperties

名前 形容 価値
認証モード Batch サービスが自動ストレージ アカウントの管理に使用する認証モード。 'BatchAccountManagedIdentity'
「ストレージキー」
ノードアイデンティティ参照 ここで参照される ID は、自動ストレージへのアクセスを必要とするコンピューティング ノードを持つプールに割り当てる必要があります。 ComputeNodeIdentityReference (英語)
ストレージアカウントID 自動ストレージ アカウントに使用するストレージ アカウントのリソース ID。 string (必須)

BatchAccountCreateParametersタグ

名前 形容 価値

BatchAccountCreatePropertiesまたはBatchAccountProperties

名前 形容 価値
allowedAuthenticationModes(認証モード) データ プレーンでの認証に使用できる Batch アカウントで許可される認証モードの一覧。 これは、コントロール プレーンでの認証には影響しません。 次のいずれかを含む文字列配列:
「AAD」
'SharedKey'
'タスク認証トークン'
自動ストレージ 自動ストレージ アカウントに関連するプロパティ。 AutoStorageBasePropertiesOrAutoStorageProperties の
暗号化 Batch アカウント内で顧客データを暗号化する方法を構成します。 既定では、アカウントは Microsoft マネージド キーを使用して暗号化されます。 追加の制御のために、代わりにカスタマー マネージド キーを使用できます。 EncryptionProperties (暗号化プロパティ)
keyVaultリファレンス Batch アカウントに関連付けられている Azure キー コンテナーへの参照。 KeyVaultリファレンス
ネットワークプロファイル ネットワーク プロファイルは、publicNetworkAccess が有効になっている場合にのみ有効になります。 ネットワークプロファイル
poolAllocationMode プール割り当てモードは、クライアントが Batch Service API に対して認証する方法にも影響します。 モードが BatchService の場合、クライアントはアクセス キーまたは Microsoft Entra ID を使用して認証できます。 モードが UserSubscription の場合、クライアントは Microsoft Entra ID を使用する必要があります。 既定値は BatchService です。 「バッチサービス」
'UserSubscription'
publicNetworkAccess (パブリックネットワークアクセス) Batch アカウント内のリソースで動作するためのネットワーク アクセスの種類。 「無効」
「有効」
「SecuredByPerimeter」

バッチアカウントアイデンティティ

名前 形容 価値
Batch アカウントに使用される ID の種類。 「なし」
'システム割り当て'
'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ) Batch アカウントに関連付けられているユーザー ID の一覧。 BatchAccountIdentityUserAssignedIdentities の

BatchAccountIdentityUserAssignedIdentities (英語)

名前 形容 価値

ComputeNodeIdentityReference (英語)

名前 形容 価値
リソースID ユーザー割り当て ID の ARM リソース ID。 文字列

EncryptionProperties (暗号化プロパティ)

名前 形容 価値
キーソース キー ソースの種類。 'Microsoft.Batch'
'Microsoft.KeyVault'
keyVaultプロパティ Microsoft.KeyVault を使用する場合の追加の詳細 KeyVaultProperties の

エンドポイントアクセスプロファイル

名前 形容 価値
デフォルトアクション エンドポイント アクセスの既定のアクション。 publicNetworkAccess が有効になっている場合にのみ適用されます。 「許可する」
'Deny' (必須)
ipルール クライアント IP アドレスをフィルター処理する IP 範囲の配列。 IPRule[]

IPRuleの

名前 形容 価値
アクション クライアント IP アドレスが一致したときのアクション。 'Allow' (必須)
価値 IPv4 アドレス、または CIDR 形式の IPv4 アドレス範囲。 string (必須)

KeyVaultプロパティ

名前 形容 価値
キー識別子 バージョンの有無に関係なくシークレットへの完全パス。 例: https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053。 または https://mykeyvault.vault.azure.net/keys/testkey. 使用できるようにするには、次の前提条件を満たす必要があります。

Batch アカウントにシステム割り当て ID がある
アカウント ID には、キー/取得、キー/ラップ解除、キー/ラップのアクセス許可が付与されています
KeyVault で論理的な削除と消去の保護が有効になっている
文字列

KeyVaultリファレンス

名前 形容 価値
身分証明書 Batch アカウントに関連付けられている Azure キー コンテナーのリソース ID。 string (必須)
URL Batch アカウントに関連付けられている Azure キー コンテナーの URL。 string (必須)

ネットワークプロファイル

名前 形容 価値
アカウントアクセス batchAccount エンドポイントのネットワーク アクセス プロファイル (Batch アカウント データ プレーン API)。 EndpointAccessProfile の
ノード管理アクセス nodeManagement エンドポイントのネットワーク アクセス プロファイル (Batch プールのコンピューティング ノードを管理する Batch サービス)。 EndpointAccessProfile の

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前 形容 価値

使用例

Azure 検証済みモジュール

次の Azure 検証済みモジュール を使用して、このリソースの種類をデプロイできます。

モジュール 形容
Batch アカウント Batch アカウントの AVM リソース モジュール

Azure クイック スタートのサンプル

Azure クイック スタート テンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル 形容
パブリック IP アドレスを せずに Azure Batch プールを する このテンプレートでは、パブリック IP アドレスのない Azure Batch の簡略化されたノード通信プールが作成されます。
テンプレート を使用して Batch アカウントを作成する このテンプレートでは、Batch アカウントとストレージ アカウントが作成されます。

ARM テンプレート リソース定義

batchAccounts リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Batch/batchAccounts リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.Batch/batchAccounts",
  "apiVersion": "2024-07-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "allowedAuthenticationModes": [ "string" ],
    "autoStorage": {
      "authenticationMode": "string",
      "nodeIdentityReference": {
        "resourceId": "string"
      },
      "storageAccountId": "string"
    },
    "encryption": {
      "keySource": "string",
      "keyVaultProperties": {
        "keyIdentifier": "string"
      }
    },
    "keyVaultReference": {
      "id": "string",
      "url": "string"
    },
    "networkProfile": {
      "accountAccess": {
        "defaultAction": "string",
        "ipRules": [
          {
            "action": "Allow",
            "value": "string"
          }
        ]
      },
      "nodeManagementAccess": {
        "defaultAction": "string",
        "ipRules": [
          {
            "action": "Allow",
            "value": "string"
          }
        ]
      }
    },
    "poolAllocationMode": "string",
    "publicNetworkAccess": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.Batch/バッチアカウント

名前 形容 価値
apiVersion (英語) API のバージョン '2024-07-01'
ID Batch アカウントの ID。 BatchAccountIdentity の
位置 アカウントを作成するリージョン。 string (必須)
名前 リソース名

制約:
最小長 = 3
最大長 = 24
パターン = ^[a-zA-Z0-9]+$ (必須)
プロパティ Batch アカウントのプロパティ。 BatchAccountCreatePropertiesOrBatchAccountProperties の
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください
リソースの種類 'Microsoft.Batch/batchAccounts'

AutoStorageBasePropertiesまたはAutoStorageProperties

名前 形容 価値
認証モード Batch サービスが自動ストレージ アカウントの管理に使用する認証モード。 'BatchAccountManagedIdentity'
「ストレージキー」
ノードアイデンティティ参照 ここで参照される ID は、自動ストレージへのアクセスを必要とするコンピューティング ノードを持つプールに割り当てる必要があります。 ComputeNodeIdentityReference (英語)
ストレージアカウントID 自動ストレージ アカウントに使用するストレージ アカウントのリソース ID。 string (必須)

BatchAccountCreateParametersタグ

名前 形容 価値

BatchAccountCreatePropertiesまたはBatchAccountProperties

名前 形容 価値
allowedAuthenticationModes(認証モード) データ プレーンでの認証に使用できる Batch アカウントで許可される認証モードの一覧。 これは、コントロール プレーンでの認証には影響しません。 次のいずれかを含む文字列配列:
「AAD」
'SharedKey'
'タスク認証トークン'
自動ストレージ 自動ストレージ アカウントに関連するプロパティ。 AutoStorageBasePropertiesOrAutoStorageProperties の
暗号化 Batch アカウント内で顧客データを暗号化する方法を構成します。 既定では、アカウントは Microsoft マネージド キーを使用して暗号化されます。 追加の制御のために、代わりにカスタマー マネージド キーを使用できます。 EncryptionProperties (暗号化プロパティ)
keyVaultリファレンス Batch アカウントに関連付けられている Azure キー コンテナーへの参照。 KeyVaultリファレンス
ネットワークプロファイル ネットワーク プロファイルは、publicNetworkAccess が有効になっている場合にのみ有効になります。 ネットワークプロファイル
poolAllocationMode プール割り当てモードは、クライアントが Batch Service API に対して認証する方法にも影響します。 モードが BatchService の場合、クライアントはアクセス キーまたは Microsoft Entra ID を使用して認証できます。 モードが UserSubscription の場合、クライアントは Microsoft Entra ID を使用する必要があります。 既定値は BatchService です。 「バッチサービス」
'UserSubscription'
publicNetworkAccess (パブリックネットワークアクセス) Batch アカウント内のリソースで動作するためのネットワーク アクセスの種類。 「無効」
「有効」
「SecuredByPerimeter」

バッチアカウントアイデンティティ

名前 形容 価値
Batch アカウントに使用される ID の種類。 「なし」
'システム割り当て'
'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ) Batch アカウントに関連付けられているユーザー ID の一覧。 BatchAccountIdentityUserAssignedIdentities の

BatchAccountIdentityUserAssignedIdentities (英語)

名前 形容 価値

ComputeNodeIdentityReference (英語)

名前 形容 価値
リソースID ユーザー割り当て ID の ARM リソース ID。 文字列

EncryptionProperties (暗号化プロパティ)

名前 形容 価値
キーソース キー ソースの種類。 'Microsoft.Batch'
'Microsoft.KeyVault'
keyVaultプロパティ Microsoft.KeyVault を使用する場合の追加の詳細 KeyVaultProperties の

エンドポイントアクセスプロファイル

名前 形容 価値
デフォルトアクション エンドポイント アクセスの既定のアクション。 publicNetworkAccess が有効になっている場合にのみ適用されます。 「許可する」
'Deny' (必須)
ipルール クライアント IP アドレスをフィルター処理する IP 範囲の配列。 IPRule[]

IPRuleの

名前 形容 価値
アクション クライアント IP アドレスが一致したときのアクション。 'Allow' (必須)
価値 IPv4 アドレス、または CIDR 形式の IPv4 アドレス範囲。 string (必須)

KeyVaultプロパティ

名前 形容 価値
キー識別子 バージョンの有無に関係なくシークレットへの完全パス。 例: https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053。 または https://mykeyvault.vault.azure.net/keys/testkey. 使用できるようにするには、次の前提条件を満たす必要があります。

Batch アカウントにシステム割り当て ID がある
アカウント ID には、キー/取得、キー/ラップ解除、キー/ラップのアクセス許可が付与されています
KeyVault で論理的な削除と消去の保護が有効になっている
文字列

KeyVaultリファレンス

名前 形容 価値
身分証明書 Batch アカウントに関連付けられている Azure キー コンテナーのリソース ID。 string (必須)
URL Batch アカウントに関連付けられている Azure キー コンテナーの URL。 string (必須)

ネットワークプロファイル

名前 形容 価値
アカウントアクセス batchAccount エンドポイントのネットワーク アクセス プロファイル (Batch アカウント データ プレーン API)。 EndpointAccessProfile の
ノード管理アクセス nodeManagement エンドポイントのネットワーク アクセス プロファイル (Batch プールのコンピューティング ノードを管理する Batch サービス)。 EndpointAccessProfile の

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前 形容 価値

使用例

Azure のクイック スタート テンプレート

このリソースの種類 デプロイする Azure クイック スタート テンプレート 次に示します。

テンプレート 形容
パブリック IP アドレスを せずに Azure Batch プールを する

Azure
にデプロイする
このテンプレートでは、パブリック IP アドレスのない Azure Batch の簡略化されたノード通信プールが作成されます。
テンプレート を使用して Batch アカウントを作成する

Azure
にデプロイする
このテンプレートでは、Batch アカウントとストレージ アカウントが作成されます。

Terraform (AzAPI プロバイダー) リソース定義

batchAccounts リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Batch/batchAccounts リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts@2024-07-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      allowedAuthenticationModes = [
        "string"
      ]
      autoStorage = {
        authenticationMode = "string"
        nodeIdentityReference = {
          resourceId = "string"
        }
        storageAccountId = "string"
      }
      encryption = {
        keySource = "string"
        keyVaultProperties = {
          keyIdentifier = "string"
        }
      }
      keyVaultReference = {
        id = "string"
        url = "string"
      }
      networkProfile = {
        accountAccess = {
          defaultAction = "string"
          ipRules = [
            {
              action = "Allow"
              value = "string"
            }
          ]
        }
        nodeManagementAccess = {
          defaultAction = "string"
          ipRules = [
            {
              action = "Allow"
              value = "string"
            }
          ]
        }
      }
      poolAllocationMode = "string"
      publicNetworkAccess = "string"
    }
  }
}

プロパティ値

Microsoft.Batch/バッチアカウント

名前 形容 価値
ID Batch アカウントの ID。 BatchAccountIdentity の
位置 アカウントを作成するリージョン。 string (必須)
名前 リソース名

制約:
最小長 = 3
最大長 = 24
パターン = ^[a-zA-Z0-9]+$ (必須)
parent_id この拡張リソースを適用するリソースの ID。 string (必須)
プロパティ Batch アカウントのプロパティ。 BatchAccountCreatePropertiesOrBatchAccountProperties の
タグ リソース タグ タグ名と値のディクショナリ。
リソースの種類 "Microsoft.Batch/batchAccounts@2024-07-01"

AutoStorageBasePropertiesまたはAutoStorageProperties

名前 形容 価値
認証モード Batch サービスが自動ストレージ アカウントの管理に使用する認証モード。 'BatchAccountManagedIdentity'
「ストレージキー」
ノードアイデンティティ参照 ここで参照される ID は、自動ストレージへのアクセスを必要とするコンピューティング ノードを持つプールに割り当てる必要があります。 ComputeNodeIdentityReference (英語)
ストレージアカウントID 自動ストレージ アカウントに使用するストレージ アカウントのリソース ID。 string (必須)

BatchAccountCreateParametersタグ

名前 形容 価値

BatchAccountCreatePropertiesまたはBatchAccountProperties

名前 形容 価値
allowedAuthenticationModes(認証モード) データ プレーンでの認証に使用できる Batch アカウントで許可される認証モードの一覧。 これは、コントロール プレーンでの認証には影響しません。 次のいずれかを含む文字列配列:
「AAD」
'SharedKey'
'タスク認証トークン'
自動ストレージ 自動ストレージ アカウントに関連するプロパティ。 AutoStorageBasePropertiesOrAutoStorageProperties の
暗号化 Batch アカウント内で顧客データを暗号化する方法を構成します。 既定では、アカウントは Microsoft マネージド キーを使用して暗号化されます。 追加の制御のために、代わりにカスタマー マネージド キーを使用できます。 EncryptionProperties (暗号化プロパティ)
keyVaultリファレンス Batch アカウントに関連付けられている Azure キー コンテナーへの参照。 KeyVaultリファレンス
ネットワークプロファイル ネットワーク プロファイルは、publicNetworkAccess が有効になっている場合にのみ有効になります。 ネットワークプロファイル
poolAllocationMode プール割り当てモードは、クライアントが Batch Service API に対して認証する方法にも影響します。 モードが BatchService の場合、クライアントはアクセス キーまたは Microsoft Entra ID を使用して認証できます。 モードが UserSubscription の場合、クライアントは Microsoft Entra ID を使用する必要があります。 既定値は BatchService です。 「バッチサービス」
'UserSubscription'
publicNetworkAccess (パブリックネットワークアクセス) Batch アカウント内のリソースで動作するためのネットワーク アクセスの種類。 「無効」
「有効」
「SecuredByPerimeter」

バッチアカウントアイデンティティ

名前 形容 価値
Batch アカウントに使用される ID の種類。 「なし」
'システム割り当て'
'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ) Batch アカウントに関連付けられているユーザー ID の一覧。 BatchAccountIdentityUserAssignedIdentities の

BatchAccountIdentityUserAssignedIdentities (英語)

名前 形容 価値

ComputeNodeIdentityReference (英語)

名前 形容 価値
リソースID ユーザー割り当て ID の ARM リソース ID。 文字列

EncryptionProperties (暗号化プロパティ)

名前 形容 価値
キーソース キー ソースの種類。 'Microsoft.Batch'
'Microsoft.KeyVault'
keyVaultプロパティ Microsoft.KeyVault を使用する場合の追加の詳細 KeyVaultProperties の

エンドポイントアクセスプロファイル

名前 形容 価値
デフォルトアクション エンドポイント アクセスの既定のアクション。 publicNetworkAccess が有効になっている場合にのみ適用されます。 「許可する」
'Deny' (必須)
ipルール クライアント IP アドレスをフィルター処理する IP 範囲の配列。 IPRule[]

IPRuleの

名前 形容 価値
アクション クライアント IP アドレスが一致したときのアクション。 'Allow' (必須)
価値 IPv4 アドレス、または CIDR 形式の IPv4 アドレス範囲。 string (必須)

KeyVaultプロパティ

名前 形容 価値
キー識別子 バージョンの有無に関係なくシークレットへの完全パス。 例: https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053。 または https://mykeyvault.vault.azure.net/keys/testkey. 使用できるようにするには、次の前提条件を満たす必要があります。

Batch アカウントにシステム割り当て ID がある
アカウント ID には、キー/取得、キー/ラップ解除、キー/ラップのアクセス許可が付与されています
KeyVault で論理的な削除と消去の保護が有効になっている
文字列

KeyVaultリファレンス

名前 形容 価値
身分証明書 Batch アカウントに関連付けられている Azure キー コンテナーのリソース ID。 string (必須)
URL Batch アカウントに関連付けられている Azure キー コンテナーの URL。 string (必須)

ネットワークプロファイル

名前 形容 価値
アカウントアクセス batchAccount エンドポイントのネットワーク アクセス プロファイル (Batch アカウント データ プレーン API)。 EndpointAccessProfile の
ノード管理アクセス nodeManagement エンドポイントのネットワーク アクセス プロファイル (Batch プールのコンピューティング ノードを管理する Batch サービス)。 EndpointAccessProfile の

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前 形容 価値

使用例

Terraformサンプル

Azure Batch アカウントをデプロイする基本的な例。

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "batchAccount" {
  type      = "Microsoft.Batch/batchAccounts@2022-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      encryption = {
        keySource = "Microsoft.Batch"
      }
      poolAllocationMode  = "BatchService"
      publicNetworkAccess = "Enabled"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Azure 検証済みモジュール

次の Azure 検証済みモジュール を使用して、このリソースの種類をデプロイできます。

モジュール 形容
Batch アカウント Batch アカウントの AVM リソース モジュール