Microsoft.CognitiveServices accounts/deployments 2022-03-01

Bicep resource definition

The accounts/deployments resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.CognitiveServices/accounts/deployments resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2022-03-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    model: {
      format: 'string'
      name: 'string'
      version: 'string'
    }
    scaleSettings: {
      capacity: int
      scaleType: 'string'
    }
  }
}

Property Values

DeploymentModel

Name Description Value
format Deployment model format. string
name Deployment model name. string
version Deployment model version. string

DeploymentProperties

Name Description Value
model Properties of Cognitive Services account deployment model. DeploymentModel
scaleSettings Properties of Cognitive Services account deployment model. DeploymentScaleSettings

DeploymentScaleSettings

Name Description Value
capacity Deployment capacity. int
scaleType Deployment scale type. 'Manual'
'Standard'

Microsoft.CognitiveServices/accounts/deployments

Name Description Value
name The resource name string (required)
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.
Symbolic name for resource of type: accounts
properties Properties of Cognitive Services account deployment. DeploymentProperties

Usage Examples

Azure Quickstart Samples

The following Azure Quickstart templates contain Bicep samples for deploying this resource type.

Bicep File Description
Basic Agent Setup API Keys This set of templates demonstrates how to set up Azure AI Agent Service with the basic setup using API keys authetication for the AI Service/AOAI connection. Agents use multi-tenant search and storage resources fully managed by Microsoft. You won’t have visibility or control over these underlying Azure resources.
Basic Agent Setup Identity This set of templates demonstrates how to set up Azure AI Agent Service with the basic setup using managed identity authetication for the AI Service/AOAI connection. Agents use multi-tenant search and storage resources fully managed by Microsoft. You won’t have visibility or control over these underlying Azure resources.
Deploy Secure Azure AI Studio with a managed virtual network This template creates a secure Azure AI Studio environment with robust network and identity security restrictions.
Network Secured Agent with User Managed Identity This set of templates demonstrates how to set up Azure AI Agent Service with virtual network isolation using User Managed Identity authetication for the AI Service/AOAI connection and private network links to connect the agent to your secure data.
Standard Agent Setup This set of templates demonstrates how to set up Azure AI Agent Service with the standard setup, meaning with managed identity authentication for project/hub connections and public internet access enabled. Agents use customer-owned, single-tenant search and storage resources. With this setup, you have full control and visibility over these resources, but you will incur costs based on your usage.

ARM template resource definition

The accounts/deployments resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.CognitiveServices/accounts/deployments resource, add the following JSON to your template.

{
  "type": "Microsoft.CognitiveServices/accounts/deployments",
  "apiVersion": "2022-03-01",
  "name": "string",
  "properties": {
    "model": {
      "format": "string",
      "name": "string",
      "version": "string"
    },
    "scaleSettings": {
      "capacity": "int",
      "scaleType": "string"
    }
  }
}

Property Values

DeploymentModel

Name Description Value
format Deployment model format. string
name Deployment model name. string
version Deployment model version. string

DeploymentProperties

Name Description Value
model Properties of Cognitive Services account deployment model. DeploymentModel
scaleSettings Properties of Cognitive Services account deployment model. DeploymentScaleSettings

DeploymentScaleSettings

Name Description Value
capacity Deployment capacity. int
scaleType Deployment scale type. 'Manual'
'Standard'

Microsoft.CognitiveServices/accounts/deployments

Name Description Value
apiVersion The api version '2022-03-01'
name The resource name string (required)
properties Properties of Cognitive Services account deployment. DeploymentProperties
type The resource type 'Microsoft.CognitiveServices/accounts/deployments'

Usage Examples

Azure Quickstart Templates

The following Azure Quickstart templates deploy this resource type.

Template Description
Basic Agent Setup API Keys

Deploy to Azure
This set of templates demonstrates how to set up Azure AI Agent Service with the basic setup using API keys authetication for the AI Service/AOAI connection. Agents use multi-tenant search and storage resources fully managed by Microsoft. You won’t have visibility or control over these underlying Azure resources.
Basic Agent Setup Identity

Deploy to Azure
This set of templates demonstrates how to set up Azure AI Agent Service with the basic setup using managed identity authetication for the AI Service/AOAI connection. Agents use multi-tenant search and storage resources fully managed by Microsoft. You won’t have visibility or control over these underlying Azure resources.
Deploy Secure Azure AI Studio with a managed virtual network

Deploy to Azure
This template creates a secure Azure AI Studio environment with robust network and identity security restrictions.
Network Secured Agent with User Managed Identity

Deploy to Azure
This set of templates demonstrates how to set up Azure AI Agent Service with virtual network isolation using User Managed Identity authetication for the AI Service/AOAI connection and private network links to connect the agent to your secure data.
Standard Agent Setup

Deploy to Azure
This set of templates demonstrates how to set up Azure AI Agent Service with the standard setup, meaning with managed identity authentication for project/hub connections and public internet access enabled. Agents use customer-owned, single-tenant search and storage resources. With this setup, you have full control and visibility over these resources, but you will incur costs based on your usage.

Terraform (AzAPI provider) resource definition

The accounts/deployments resource type can be deployed with operations that target:

  • Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.CognitiveServices/accounts/deployments resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts/deployments@2022-03-01"
  name = "string"
  body = jsonencode({
    properties = {
      model = {
        format = "string"
        name = "string"
        version = "string"
      }
      scaleSettings = {
        capacity = int
        scaleType = "string"
      }
    }
  })
}

Property Values

DeploymentModel

Name Description Value
format Deployment model format. string
name Deployment model name. string
version Deployment model version. string

DeploymentProperties

Name Description Value
model Properties of Cognitive Services account deployment model. DeploymentModel
scaleSettings Properties of Cognitive Services account deployment model. DeploymentScaleSettings

DeploymentScaleSettings

Name Description Value
capacity Deployment capacity. int
scaleType Deployment scale type. 'Manual'
'Standard'

Microsoft.CognitiveServices/accounts/deployments

Name Description Value
name The resource name string (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: accounts
properties Properties of Cognitive Services account deployment. DeploymentProperties
type The resource type "Microsoft.CognitiveServices/accounts/deployments@2022-03-01"