Microsoft.CognitiveServices アカウント/デプロイ

2025-07-08

Bicep リソース定義

アカウント/デプロイリソースの種類は、次をターゲットとする操作でデプロイできます。

リソースグループの - リソースグループのデプロイコマンド参照

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

リソースの形式

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

resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2025-06-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    capacitySettings: {
      designatedCapacity: int
      priority: int
    }
    currentCapacity: int
    model: {
      format: 'string'
      name: 'string'
      publisher: 'string'
      source: 'string'
      sourceAccount: 'string'
      version: 'string'
    }
    parentDeploymentName: 'string'
    raiPolicyName: 'string'
    scaleSettings: {
      capacity: int
      scaleType: 'string'
    }
    spilloverDeploymentName: 'string'
    versionUpgradeOption: 'string'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.CognitiveServices/アカウント/デプロイ

名前	説明	価値
名前	リソース名	string (必須)
親	Bicep では、子リソースの親リソースを指定できます。このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。詳細については、「親リソースの外部子リソース」を参照してください。	種類のリソースのシンボリック名: アカウント
プロパティ	Cognitive Services アカウントのデプロイのプロパティ。	DeploymentProperties (デプロイメントプロパティ)
エスケーユー	SKU を表すリソースモデル定義	SKU
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください

DeploymentCapacitySettings (デプロイメントキャパシティ設定)

名前	説明	価値
指定容量	指定された容量。	int 制約：最小値 = 0
優先権	この容量設定の優先順位。	int 制約：最小値 = 0

デプロイメントモデル

名前	説明	価値
フォーマット	デプロイモデルの形式。	文字列
名前	デプロイモデル名。	文字列
パブリッシャ	デプロイモデルの発行元。	文字列
ソース	任意。デプロイモデルのソース ARM リソース ID。	文字列
ソースアカウント	任意。モデルのソース。別の Microsoft.CognitiveServices アカウント ARM リソース ID。	文字列
バージョン	任意。デプロイモデルのバージョン。バージョンが指定されていない場合は、既定のバージョンが割り当てられます。既定のバージョンは、モデルごとに異なり、モデルで使用できる新しいバージョンがある場合に変更される可能性があります。モデルの既定のバージョンは、リストモデル API から見つけることができます。	文字列

DeploymentProperties (デプロイメントプロパティ)

名前	説明	価値
capacitySettings (容量設定)	内部使用のみ。	DeploymentCapacitySettings (デプロイメントキャパシティ設定)
現在の容量	現在の容量。	整数 (int)
モデル	Cognitive Services アカウントデプロイモデルのプロパティ。	デプロイメントモデル
parentDeploymentName (親デプロイメント名)	親デプロイの名前。	文字列
raiPolicyName (ライポリシー名)	RAI ポリシーの名前。	文字列
scale設定	Cognitive Services アカウントデプロイモデルのプロパティ。 (非推奨、代わりに Deployment.sku を使用してください)。)	DeploymentScaleSettings (英語)
スピルオーバーデプロイメント名	現在のデプロイのスループット制限に達したために要求が調整された場合に要求を処理するデプロイ名を指定します。	文字列
バージョンアップグレードオプション	デプロイモデルバージョンのアップグレードオプション。	「NoAutoUpgrade」 'OnceCurrentVersionExpired' (現在のバージョンの有効期限が切れました) 'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings (英語)

名前	説明	価値
キャパシティ	デプロイ容量。	整数 (int)
スケールタイプ	デプロイスケールの種類。	「マニュアル」「スタンダード」

デプロイメントタグ

名前	説明	価値

SKU

名前	説明	価値
キャパシティ	SKU でスケールアウト/インがサポートされている場合は、容量の整数を含める必要があります。リソースに対してスケールアウト/インができない場合は、これを省略できます。	整数 (int)
家族	同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。	文字列
名前	SKU の名前。例 - P3。通常は文字 + 数字のコードです	string (必須)
サイズ	SKU サイズ。名前フィールドが層と他の値の組み合わせである場合、これはスタンドアロンコードになります。	文字列
レベル	このフィールドは、サービスに複数のレベルがあるが PUT では必要ない場合に、リソースプロバイダーによって実装される必要があります。	「ベーシック」「エンタープライズ」「無料」「プレミアム」「スタンダード」

使用例

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

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

Bicep ファイル	説明
基本的なエージェントセットアップ API キーの	この一連のテンプレートでは、AI サービス/AOAI 接続の API キー認証を使用して、基本的なセットアップで Azure AI エージェントサービスを設定する方法を示します。エージェントは、Microsoft が完全に管理するマルチテナント検索リソースとストレージリソースを使用します。これらの基になる Azure リソースを表示または制御することはできません。
基本的なエージェントセットアップ ID の	この一連のテンプレートは、AI サービス/AOAI 接続のマネージド ID 認証を使用して、基本的なセットアップで Azure AI エージェントサービスを設定する方法を示しています。エージェントは、Microsoft が完全に管理するマルチテナント検索リソースとストレージリソースを使用します。これらの基になる Azure リソースを表示または制御することはできません。
Secure AI Foundry をマネージド仮想ネットワークでデプロイ	このテンプレートは、堅牢なネットワークと ID のセキュリティ制限を備えた安全な Azure AI Foundry 環境を作成します。
ユーザーマネージド ID を使用してネットワークセキュリティで保護されたエージェントをする	この一連のテンプレートでは、AI サービス/AOAI 接続用のユーザーマネージド ID 認証とプライベートネットワークリンクを使用して仮想ネットワーク分離を使用して Azure AI エージェントサービスを設定し、エージェントをセキュリティで保護されたデータに接続する方法を示します。
Standard エージェントのセットアップ	この一連のテンプレートは、標準セットアップで Azure AI Agent Service を設定する方法を示しています。つまり、プロジェクト/ハブ接続のマネージド ID 認証とパブリックインターネットアクセスが有効になっています。エージェントは、顧客所有のシングルテナント検索およびストレージリソースを使用します。このセットアップでは、これらのリソースを完全に制御して表示できますが、使用量に基づいてコストが発生します。

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

アカウント/デプロイリソースの種類は、次をターゲットとする操作でデプロイできます。

リソースグループの - リソースグループのデプロイコマンド参照

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

リソースの形式

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

{
  "type": "Microsoft.CognitiveServices/accounts/deployments",
  "apiVersion": "2025-06-01",
  "name": "string",
  "properties": {
    "capacitySettings": {
      "designatedCapacity": "int",
      "priority": "int"
    },
    "currentCapacity": "int",
    "model": {
      "format": "string",
      "name": "string",
      "publisher": "string",
      "source": "string",
      "sourceAccount": "string",
      "version": "string"
    },
    "parentDeploymentName": "string",
    "raiPolicyName": "string",
    "scaleSettings": {
      "capacity": "int",
      "scaleType": "string"
    },
    "spilloverDeploymentName": "string",
    "versionUpgradeOption": "string"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.CognitiveServices/アカウント/デプロイ

名前	説明	価値
apiVersion (英語)	API のバージョン	'2025-06-01'
名前	リソース名	string (必須)
プロパティ	Cognitive Services アカウントのデプロイのプロパティ。	DeploymentProperties (デプロイメントプロパティ)
エスケーユー	SKU を表すリソースモデル定義	SKU
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください
型	リソースの種類	'Microsoft.CognitiveServices/アカウント/deployments'

DeploymentCapacitySettings (デプロイメントキャパシティ設定)

名前	説明	価値
指定容量	指定された容量。	int 制約：最小値 = 0
優先権	この容量設定の優先順位。	int 制約：最小値 = 0

デプロイメントモデル

名前	説明	価値
フォーマット	デプロイモデルの形式。	文字列
名前	デプロイモデル名。	文字列
パブリッシャ	デプロイモデルの発行元。	文字列
ソース	任意。デプロイモデルのソース ARM リソース ID。	文字列
ソースアカウント	任意。モデルのソース。別の Microsoft.CognitiveServices アカウント ARM リソース ID。	文字列
バージョン	任意。デプロイモデルのバージョン。バージョンが指定されていない場合は、既定のバージョンが割り当てられます。既定のバージョンは、モデルごとに異なり、モデルで使用できる新しいバージョンがある場合に変更される可能性があります。モデルの既定のバージョンは、リストモデル API から見つけることができます。	文字列

DeploymentProperties (デプロイメントプロパティ)

名前	説明	価値
capacitySettings (容量設定)	内部使用のみ。	DeploymentCapacitySettings (デプロイメントキャパシティ設定)
現在の容量	現在の容量。	整数 (int)
モデル	Cognitive Services アカウントデプロイモデルのプロパティ。	デプロイメントモデル
parentDeploymentName (親デプロイメント名)	親デプロイの名前。	文字列
raiPolicyName (ライポリシー名)	RAI ポリシーの名前。	文字列
scale設定	Cognitive Services アカウントデプロイモデルのプロパティ。 (非推奨、代わりに Deployment.sku を使用してください)。)	DeploymentScaleSettings (英語)
スピルオーバーデプロイメント名	現在のデプロイのスループット制限に達したために要求が調整された場合に要求を処理するデプロイ名を指定します。	文字列
バージョンアップグレードオプション	デプロイモデルバージョンのアップグレードオプション。	「NoAutoUpgrade」 'OnceCurrentVersionExpired' (現在のバージョンの有効期限が切れました) 'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings (英語)

名前	説明	価値
キャパシティ	デプロイ容量。	整数 (int)
スケールタイプ	デプロイスケールの種類。	「マニュアル」「スタンダード」

デプロイメントタグ

名前	説明	価値

SKU

名前	説明	価値
キャパシティ	SKU でスケールアウト/インがサポートされている場合は、容量の整数を含める必要があります。リソースに対してスケールアウト/インができない場合は、これを省略できます。	整数 (int)
家族	同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。	文字列
名前	SKU の名前。例 - P3。通常は文字 + 数字のコードです	string (必須)
サイズ	SKU サイズ。名前フィールドが層と他の値の組み合わせである場合、これはスタンドアロンコードになります。	文字列
レベル	このフィールドは、サービスに複数のレベルがあるが PUT では必要ない場合に、リソースプロバイダーによって実装される必要があります。	「ベーシック」「エンタープライズ」「無料」「プレミアム」「スタンダード」

使用例

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

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

テンプレート	説明
基本的なエージェントセットアップ API キーの	この一連のテンプレートでは、AI サービス/AOAI 接続の API キー認証を使用して、基本的なセットアップで Azure AI エージェントサービスを設定する方法を示します。エージェントは、Microsoft が完全に管理するマルチテナント検索リソースとストレージリソースを使用します。これらの基になる Azure リソースを表示または制御することはできません。
基本的なエージェントセットアップ ID の	この一連のテンプレートは、AI サービス/AOAI 接続のマネージド ID 認証を使用して、基本的なセットアップで Azure AI エージェントサービスを設定する方法を示しています。エージェントは、Microsoft が完全に管理するマルチテナント検索リソースとストレージリソースを使用します。これらの基になる Azure リソースを表示または制御することはできません。
Secure AI Foundry をマネージド仮想ネットワークでデプロイ	このテンプレートは、堅牢なネットワークと ID のセキュリティ制限を備えた安全な Azure AI Foundry 環境を作成します。
ユーザーマネージド ID を使用してネットワークセキュリティで保護されたエージェントをする	この一連のテンプレートでは、AI サービス/AOAI 接続用のユーザーマネージド ID 認証とプライベートネットワークリンクを使用して仮想ネットワーク分離を使用して Azure AI エージェントサービスを設定し、エージェントをセキュリティで保護されたデータに接続する方法を示します。
Standard エージェントのセットアップ	この一連のテンプレートは、標準セットアップで Azure AI Agent Service を設定する方法を示しています。つまり、プロジェクト/ハブ接続のマネージド ID 認証とパブリックインターネットアクセスが有効になっています。エージェントは、顧客所有のシングルテナント検索およびストレージリソースを使用します。このセットアップでは、これらのリソースを完全に制御して表示できますが、使用量に基づいてコストが発生します。

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

アカウント/デプロイリソースの種類は、次をターゲットとする操作でデプロイできます。

リソースグループ

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

リソースの形式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts/deployments@2025-06-01"
  name = "string"
  parent_id = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      capacitySettings = {
        designatedCapacity = int
        priority = int
      }
      currentCapacity = int
      model = {
        format = "string"
        name = "string"
        publisher = "string"
        source = "string"
        sourceAccount = "string"
        version = "string"
      }
      parentDeploymentName = "string"
      raiPolicyName = "string"
      scaleSettings = {
        capacity = int
        scaleType = "string"
      }
      spilloverDeploymentName = "string"
      versionUpgradeOption = "string"
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

プロパティ値

Microsoft.CognitiveServices/アカウント/デプロイ

名前	説明	価値
名前	リソース名	string (必須)
parent_id	このリソースの親であるリソースの ID。	種類のリソースの ID: アカウント
プロパティ	Cognitive Services アカウントのデプロイのプロパティ。	DeploymentProperties (デプロイメントプロパティ)
エスケーユー	SKU を表すリソースモデル定義	SKU
タグ	リソースタグ	タグ名と値のディクショナリ。
型	リソースの種類	"Microsoft.CognitiveServices/アカウント/deployments@2025-06-01"

DeploymentCapacitySettings (デプロイメントキャパシティ設定)

名前	説明	価値
指定容量	指定された容量。	int 制約：最小値 = 0
優先権	この容量設定の優先順位。	int 制約：最小値 = 0

デプロイメントモデル

名前	説明	価値
フォーマット	デプロイモデルの形式。	文字列
名前	デプロイモデル名。	文字列
パブリッシャ	デプロイモデルの発行元。	文字列
ソース	任意。デプロイモデルのソース ARM リソース ID。	文字列
ソースアカウント	任意。モデルのソース。別の Microsoft.CognitiveServices アカウント ARM リソース ID。	文字列
バージョン	任意。デプロイモデルのバージョン。バージョンが指定されていない場合は、既定のバージョンが割り当てられます。既定のバージョンは、モデルごとに異なり、モデルで使用できる新しいバージョンがある場合に変更される可能性があります。モデルの既定のバージョンは、リストモデル API から見つけることができます。	文字列

DeploymentProperties (デプロイメントプロパティ)

名前	説明	価値
capacitySettings (容量設定)	内部使用のみ。	DeploymentCapacitySettings (デプロイメントキャパシティ設定)
現在の容量	現在の容量。	整数 (int)
モデル	Cognitive Services アカウントデプロイモデルのプロパティ。	デプロイメントモデル
parentDeploymentName (親デプロイメント名)	親デプロイの名前。	文字列
raiPolicyName (ライポリシー名)	RAI ポリシーの名前。	文字列
scale設定	Cognitive Services アカウントデプロイモデルのプロパティ。 (非推奨、代わりに Deployment.sku を使用してください)。)	DeploymentScaleSettings (英語)
スピルオーバーデプロイメント名	現在のデプロイのスループット制限に達したために要求が調整された場合に要求を処理するデプロイ名を指定します。	文字列
バージョンアップグレードオプション	デプロイモデルバージョンのアップグレードオプション。	「NoAutoUpgrade」 'OnceCurrentVersionExpired' (現在のバージョンの有効期限が切れました) 'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings (英語)

名前	説明	価値
キャパシティ	デプロイ容量。	整数 (int)
スケールタイプ	デプロイスケールの種類。	「マニュアル」「スタンダード」

デプロイメントタグ

名前	説明	価値

SKU

名前	説明	価値
キャパシティ	SKU でスケールアウト/インがサポートされている場合は、容量の整数を含める必要があります。リソースに対してスケールアウト/インができない場合は、これを省略できます。	整数 (int)
家族	同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。	文字列
名前	SKU の名前。例 - P3。通常は文字 + 数字のコードです	string (必須)
サイズ	SKU サイズ。名前フィールドが層と他の値の組み合わせである場合、これはスタンドアロンコードになります。	文字列
レベル	このフィールドは、サービスに複数のレベルがあるが PUT では必要ない場合に、リソースプロバイダーによって実装される必要があります。	「ベーシック」「エンタープライズ」「無料」「プレミアム」「スタンダード」

次の方法で共有

Microsoft.CognitiveServices アカウント/デプロイ

Bicep リソース定義

リソースの形式

プロパティ値

Microsoft.CognitiveServices/アカウント/デプロイ

DeploymentCapacitySettings (デプロイメントキャパシティ設定)

デプロイメントモデル

DeploymentProperties (デプロイメントプロパティ)

DeploymentScaleSettings (英語)

デプロイメントタグ

SKU

使用例

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

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

リソースの形式

プロパティ値

Microsoft.CognitiveServices/アカウント/デプロイ

DeploymentCapacitySettings (デプロイメントキャパシティ設定)

デプロイメントモデル

DeploymentProperties (デプロイメントプロパティ)

DeploymentScaleSettings (英語)

デプロイメントタグ

SKU

使用例

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

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

リソースの形式

プロパティ値

Microsoft.CognitiveServices/アカウント/デプロイ

DeploymentCapacitySettings (デプロイメントキャパシティ設定)

デプロイメントモデル

DeploymentProperties (デプロイメントプロパティ)

DeploymentScaleSettings (英語)

デプロイメントタグ

SKU

フィードバック

その他のリソース

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

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

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