Microsoft.CognitiveServices accounts 2016-02-01-preview

Bicep resource definition

The accounts 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 resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.CognitiveServices/accounts@2016-02-01-preview' = {
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: any(...)
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Property Values

CognitiveServicesAccountCreateParametersTags

Name Description Value

Microsoft.CognitiveServices/accounts

Name Description Value
kind Required. Indicates the type of cognitive service account. 'Academic'
'Bing.Autosuggest'
'Bing.Search'
'Bing.Speech'
'Bing.SpellCheck'
'ComputerVision'
'ContentModerator'
'Emotion'
'Face'
'LUIS'
'Recommendations'
'SpeakerRecognition'
'Speech'
'SpeechTranslation'
'TextAnalytics'
'TextTranslation'
'WebLM' (required)
location Required. Gets or sets the location of the resource. This will be one of the supported and registered Azure Geo Regions (e.g. West US, East US, Southeast Asia, etc.). The geo region of a resource cannot be changed once it is created, but if an identical geo region is specified on update the request will succeed. string (required)
name The resource name string

Constraints:
Min length = 3
Max length = 24
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (required)
properties Must exist in the request. Must not be null. any (required)
sku The SKU of the cognitive services account. Sku (required)
tags Resource tags Dictionary of tag names and values. See Tags in templates

Sku

Name Description Value
name Gets or sets the sku name. Required for account creation, optional for update. 'F0'
'P0'
'P1'
'P2'
'S0'
'S1'
'S2'
'S3'
'S4'
'S5'
'S6' (required)

Usage Examples

Azure Verified Modules

The following Azure Verified Modules can be used to deploy this resource type.

Module Description
Azure AI Services (Cognitive Services) AVM Resource Module for Azure AI Services (Cognitive Services)

Azure Quickstart Samples

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

Bicep File Description
Azure AI Studio basic setup This set of templates demonstrates how to set up Azure AI Studio with the basic setup, meaning with public internet access enabled, Microsoft-managed keys for encryption and Microsoft-managed identity configuration for the AI resource.
Azure AI Studio basic setup This set of templates demonstrates how to set up Azure AI Studio with the basic setup, meaning with public internet access enabled, Microsoft-managed keys for encryption and Microsoft-managed identity configuration for the AI resource.
Azure AI Studio basic setup This set of templates demonstrates how to set up Azure AI Studio with the basic setup, meaning with public internet access enabled, Microsoft-managed keys for encryption and Microsoft-managed identity configuration for the AI resource.
Azure AI Studio Network Restricted This set of templates demonstrates how to set up Azure AI Studio with private link and egress disabled, using Microsoft-managed keys for encryption and Microsoft-managed identity configuration for the AI resource.
Azure AI Studio Network Restricted This set of templates demonstrates how to set up Azure AI Studio with private link and egress disabled, using Microsoft-managed keys for encryption and Microsoft-managed identity configuration for the AI resource.
Azure AI Studio with Microsoft Entra ID Authentication This set of templates demonstrates how to set up Azure AI Studio with Microsoft Entra ID authentication for dependent resources, such as Azure AI Services and Azure Storage.
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 an Azure AI services multi-service resource This template deploys an Azure AI services resource to bring AI within reach of every developer without requiring machine learning expertise. All it takes is an API call to embed the ability to see, hear, speak, search, understand, and accelerate decision-making into your apps.
Deploy an Azure AI Translator resource This template deploys an Azure AI Translator resource to bring AI within reach of every developer without requiring machine learning expertise.
Deploy an Azure AI Vision resource This template deploys an Azure AI Vision resource to bring AI within reach of every developer without requiring machine learning expertise.
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 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 resource, add the following JSON to your template.

{
  "type": "Microsoft.CognitiveServices/accounts",
  "apiVersion": "2016-02-01-preview",
  "name": "string",
  "kind": "string",
  "location": "string",
  "properties": {},
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property Values

CognitiveServicesAccountCreateParametersTags

Name Description Value

Microsoft.CognitiveServices/accounts

Name Description Value
apiVersion The api version '2016-02-01-preview'
kind Required. Indicates the type of cognitive service account. 'Academic'
'Bing.Autosuggest'
'Bing.Search'
'Bing.Speech'
'Bing.SpellCheck'
'ComputerVision'
'ContentModerator'
'Emotion'
'Face'
'LUIS'
'Recommendations'
'SpeakerRecognition'
'Speech'
'SpeechTranslation'
'TextAnalytics'
'TextTranslation'
'WebLM' (required)
location Required. Gets or sets the location of the resource. This will be one of the supported and registered Azure Geo Regions (e.g. West US, East US, Southeast Asia, etc.). The geo region of a resource cannot be changed once it is created, but if an identical geo region is specified on update the request will succeed. string (required)
name The resource name string

Constraints:
Min length = 3
Max length = 24
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (required)
properties Must exist in the request. Must not be null. any (required)
sku The SKU of the cognitive services account. Sku (required)
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.CognitiveServices/accounts'

Sku

Name Description Value
name Gets or sets the sku name. Required for account creation, optional for update. 'F0'
'P0'
'P1'
'P2'
'S0'
'S1'
'S2'
'S3'
'S4'
'S5'
'S6' (required)

Usage Examples

Azure Quickstart Templates

The following Azure Quickstart templates deploy this resource type.

Template Description
Azure AI Studio basic setup

Deploy to Azure
This set of templates demonstrates how to set up Azure AI Studio with the basic setup, meaning with public internet access enabled, Microsoft-managed keys for encryption and Microsoft-managed identity configuration for the AI resource.
Azure AI Studio basic setup

Deploy to Azure
This set of templates demonstrates how to set up Azure AI Studio with the basic setup, meaning with public internet access enabled, Microsoft-managed keys for encryption and Microsoft-managed identity configuration for the AI resource.
Azure AI Studio basic setup

Deploy to Azure
This set of templates demonstrates how to set up Azure AI Studio with the basic setup, meaning with public internet access enabled, Microsoft-managed keys for encryption and Microsoft-managed identity configuration for the AI resource.
Azure AI Studio Network Restricted

Deploy to Azure
This set of templates demonstrates how to set up Azure AI Studio with private link and egress disabled, using Microsoft-managed keys for encryption and Microsoft-managed identity configuration for the AI resource.
Azure AI Studio Network Restricted

Deploy to Azure
This set of templates demonstrates how to set up Azure AI Studio with private link and egress disabled, using Microsoft-managed keys for encryption and Microsoft-managed identity configuration for the AI resource.
Azure AI Studio with Microsoft Entra ID Authentication

Deploy to Azure
This set of templates demonstrates how to set up Azure AI Studio with Microsoft Entra ID authentication for dependent resources, such as Azure AI Services and Azure Storage.
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 an Azure AI services multi-service resource

Deploy to Azure
This template deploys an Azure AI services resource to bring AI within reach of every developer without requiring machine learning expertise. All it takes is an API call to embed the ability to see, hear, speak, search, understand, and accelerate decision-making into your apps.
Deploy an Azure AI Translator resource

Deploy to Azure
This template deploys an Azure AI Translator resource to bring AI within reach of every developer without requiring machine learning expertise.
Deploy an Azure AI Vision resource

Deploy to Azure
This template deploys an Azure AI Vision resource to bring AI within reach of every developer without requiring machine learning expertise.
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 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 resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts@2016-02-01-preview"
  name = "string"
  kind = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = ?
  })
}

Property Values

CognitiveServicesAccountCreateParametersTags

Name Description Value

Microsoft.CognitiveServices/accounts

Name Description Value
kind Required. Indicates the type of cognitive service account. 'Academic'
'Bing.Autosuggest'
'Bing.Search'
'Bing.Speech'
'Bing.SpellCheck'
'ComputerVision'
'ContentModerator'
'Emotion'
'Face'
'LUIS'
'Recommendations'
'SpeakerRecognition'
'Speech'
'SpeechTranslation'
'TextAnalytics'
'TextTranslation'
'WebLM' (required)
location Required. Gets or sets the location of the resource. This will be one of the supported and registered Azure Geo Regions (e.g. West US, East US, Southeast Asia, etc.). The geo region of a resource cannot be changed once it is created, but if an identical geo region is specified on update the request will succeed. string (required)
name The resource name string

Constraints:
Min length = 3
Max length = 24
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (required)
properties Must exist in the request. Must not be null. any (required)
sku The SKU of the cognitive services account. Sku (required)
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.CognitiveServices/accounts@2016-02-01-preview"

Sku

Name Description Value
name Gets or sets the sku name. Required for account creation, optional for update. 'F0'
'P0'
'P1'
'P2'
'S0'
'S1'
'S2'
'S3'
'S4'
'S5'
'S6' (required)

Usage Examples

Azure Verified Modules

The following Azure Verified Modules can be used to deploy this resource type.

Module Description
Cognitive Service AVM Resource Module for Cognitive Services account ( Open AI)