Microsoft.CognitiveServices/contas 2023-05-01 - Bicep, ARM template & Terraform AzAPI reference

Definição de recursos do bíceps

O tipo de recurso de contas pode ser implantado com operações que visam:

Grupos de recursos - Consulte comandos de implantação de grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.CognitiveServices/accounts, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.CognitiveServices/accounts@2023-05-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    allowedFqdnList: [
      'string'
    ]
    apiProperties: {
      aadClientId: 'string'
      aadTenantId: 'string'
      eventHubConnectionString: 'string'
      qnaAzureSearchEndpointId: 'string'
      qnaAzureSearchEndpointKey: 'string'
      qnaRuntimeEndpoint: 'string'
      statisticsEnabled: bool
      storageAccountConnectionString: 'string'
      superUser: 'string'
      websiteName: 'string'
    }
    customSubDomainName: 'string'
    disableLocalAuth: bool
    dynamicThrottlingEnabled: bool
    encryption: {
      keySource: 'string'
      keyVaultProperties: {
        identityClientId: 'string'
        keyName: 'string'
        keyVaultUri: 'string'
        keyVersion: 'string'
      }
    }
    locations: {
      regions: [
        {
          customsubdomain: 'string'
          name: 'string'
          value: int
        }
      ]
      routingMethod: 'string'
    }
    migrationToken: 'string'
    networkAcls: {
      defaultAction: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
      virtualNetworkRules: [
        {
          id: 'string'
          ignoreMissingVnetServiceEndpoint: bool
          state: 'string'
        }
      ]
    }
    publicNetworkAccess: 'string'
    restore: bool
    restrictOutboundNetworkAccess: bool
    userOwnedStorage: [
      {
        identityClientId: 'string'
        resourceId: 'string'
      }
    ]
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Propriedades da Conta

Designação	Descrição	Valor
allowedFqdnList		string[]
apiPropriedades	As propriedades da api para APIs especiais.	ApiProperties
customSubDomainName	Nome de subdomínio opcional usado para autenticação baseada em token.	string
disableLocalAuth		Bool
dynamicThrottlingEnabled	O sinalizador para habilitar a limitação dinâmica.	Bool
encriptação	As propriedades de criptografia para este recurso.	de criptografia
Locais	As configurações de várias regiões da conta de Serviços Cognitivos.	MultiRegionSettings
migrationToken	Token de migração de recursos.	string
networkAcls	Um conjunto de regras que regem a acessibilidade a partir de locais de rede específicos.	NetworkRuleSet
publicNetworkAccess	Se o acesso público ao ponto de extremidade é permitido ou não para essa conta.	'Desativado' 'Habilitado'
restaurar		Bool
restrictOutboundNetworkAccess		Bool
userOwnedStorage	O armazenamento é responsável por esse recurso.	UserOwnedStorage[]

AccountTags

Designação	Descrição	Valor

ApiProperties

Designação	Descrição	Valor
aadClientId	(Somente Consultor de Métricas) A ID do Cliente do Azure AD (ID do Aplicativo).	string Restrições: Comprimento máximo =
aadTenantId	(Somente Consultor de Métricas) A ID do locatário do Azure AD.	string Restrições: Comprimento máximo =
eventHubConnectionString	(Apenas personalização) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	string Restrições: Comprimento máximo = Padrão = `^( )Endpoint=sb://(.);( )SharedAccessKeyName=(.);( )SharedAccessKey=(.)$`
qnaAzureSearchEndpointId	(Apenas QnAMaker) A ID do ponto de extremidade do Azure Search do QnAMaker.	string
qnaAzureSearchEndpointKey	(Apenas QnAMaker) A chave do ponto de extremidade do Azure Search do QnAMaker.	string
qnaRuntimeEndpoint	(Apenas QnAMaker) O ponto de extremidade de tempo de execução do QnAMaker.	string
estatísticasAtivado	(Somente Pesquisa do Bing) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	Bool
storageAccountConnectionString	(Apenas personalização) A cadeia de conexão da conta de armazenamento.	string Restrições: Comprimento máximo = Padrão = `^(( )DefaultEndpointsProtocol=(http\|https)( );( ))?AccountName=(.)AccountKey=(.)EndpointSuffix=(.)$`
superusuário	(Somente Consultor de Métricas) O super usuário do Metrics Advisor.	string Restrições: Comprimento máximo =
Nome do site	(Somente Consultor de Métricas) O nome do site do Metrics Advisor.	string Restrições: Comprimento máximo =

Encriptação

Designação	Descrição	Valor
fonte-chave	Enumera o valor possível de keySource for Encryption	'Microsoft.CognitiveServices' 'Microsoft.KeyVault'
keyVaultPropriedades	Propriedades de KeyVault	KeyVaultProperties

Identidade

Designação	Descrição	Valor
tipo	O tipo de identidade.	'Nenhuma' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	A lista de identidades atribuídas pelo usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Designação	Descrição	Valor

IpRule

Designação	Descrição	Valor
valor	Um intervalo de endereços IPv4 na notação CIDR, como '124.56.78.91' (endereço IP simples) ou '124.56.78.0/24' (todos os endereços que começam com 124.56.78).	string (obrigatório)

KeyVaultProperties

Designação	Descrição	Valor
identityClientId		string
Nome da chave	Nome da chave do KeyVault	string
keyVaultUri	Uri do KeyVault	string
keyVersion [en]	Versão da chave do KeyVault	string

Microsoft.CognitiveServices/contas

Designação	Descrição	Valor
identidade	Identidade do recurso.	Identidade
tipo	O tipo do recurso.	string
Localização	A geolocalização onde o recurso vive	string
Designação	O nome do recurso	string Restrições: Comprimento mínimo = 2 Comprimento máximo = 2 Padrão = `^[a-zA-Z0-9][a-zA-Z0-9_.-]*$` (obrigatório)
propriedades	Propriedades da conta de Serviços Cognitivos.	AccountProperties
SKU	A definição do modelo de recursos que representa a SKU	Sku
Etiquetas	Tags de recursos	Dicionário de nomes e valores de tags. Consulte Tags em modelos

MultiRegionSettings

Designação	Descrição	Valor
Regiões		RegiãoConfiguração[]
Método de roteamento	Métodos de roteamento multirregião.	'Desempenho' 'Prioridade' 'Ponderado'

NetworkRuleSet

Designação	Descrição	Valor
defaultAction	A ação padrão quando nenhuma regra de ipRules e de virtualNetworkRules corresponder. Isso só é usado depois que a propriedade bypass foi avaliada.	'Permitir' 'Negar'
ipRegras	A lista de regras de endereço IP.	IpRule[]
virtualNetworkRules	A lista de regras de rede virtual.	VirtualNetworkRule []

RegiãoConfiguração

Designação	Descrição	Valor
subdomínio personalizado	Mapeia a região para o subdomínio personalizado regional.	string
Designação	Nome da região.	string
valor	Um valor para métodos de roteamento ponderados ou de prioridade.	Int

Referência

Designação	Descrição	Valor
capacidade	Se a SKU suportar scaleout/in, o inteiro de capacidade deve ser incluído. Se a expansão/entrada não for possível para o recurso, isso poderá ser omitido.	Int
Família	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.	string
Designação	O nome do SKU. Ex - P3. Normalmente, é um código de letra + número	string (obrigatório)
tamanho	O tamanho do SKU. Quando o campo de nome é a combinação de camada e algum outro valor, este seria o código autônomo.	string
nível	Este campo deve ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não é obrigatório em um PUT.	'Básico' 'Empresa' 'Grátis' 'Premium' 'Padrão'

UserAssignedIdentity

Designação	Descrição	Valor

UserOwnedStorage

Designação	Descrição	Valor
identityClientId		string
resourceId	ID de recurso completo de um recurso Microsoft.Storage.	string

VirtualNetworkRule

Designação	Descrição	Valor
ID	ID de recurso completo de uma sub-rede vnet, como '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'.	string (obrigatório)
ignoreMissingVnetServiceEndpoint	Ignore o ponto de extremidade do serviço vnet ausente ou não.	Bool
Estado	Obtém o estado da regra de rede virtual.	string

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep	Descrição
de configuração básica do Azure AI Studio	Este conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com o acesso público à Internet habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
de configuração básica do Azure AI Studio	Este conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com o acesso público à Internet habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
de configuração básica do Azure AI Studio	Este conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com o acesso público à Internet habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
Rede Restrita do Azure AI Studio	Este conjunto de modelos demonstra como configurar o Azure AI Studio com link privado e saída desabilitados, usando chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
Rede Restrita do Azure AI Studio	Este conjunto de modelos demonstra como configurar o Azure AI Studio com link privado e saída desabilitados, usando chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
Azure AI Studio com o Microsoft Entra ID Authentication	Este conjunto de modelos demonstra como configurar o Azure AI Studio com a autenticação de ID do Microsoft Entra para recursos dependentes, como os Serviços de IA do Azure e o Armazenamento do Azure.
Implantar um de recursos multisserviço de serviços de IA do Azure	Este modelo implanta um recurso de serviços de IA do Azure para colocar a IA ao alcance de todos os desenvolvedores sem exigir experiência em aprendizado de máquina. Tudo o que é preciso é uma chamada de API para incorporar a capacidade de ver, ouvir, falar, pesquisar, entender e acelerar a tomada de decisões em seus aplicativos.
Implantar um recurso do Azure AI Translator	Este modelo implanta um recurso do Azure AI Translator para colocar a IA ao alcance de todos os desenvolvedores sem exigir experiência em aprendizado de máquina.
Implantar um recurso do Azure AI Vision	Este modelo implanta um recurso do Azure AI Vision para colocar a IA ao alcance de todos os desenvolvedores sem exigir experiência em aprendizado de máquina.
Implantar o Secure Azure AI Studio com uma rede virtual gerenciada	Este modelo cria um ambiente seguro do Azure AI Studio com restrições robustas de segurança de rede e identidade.

Definição de recurso de modelo ARM

O tipo de recurso de contas pode ser implantado com operações que visam:

Grupos de recursos - Consulte comandos de implantação de grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.CognitiveServices/accounts, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.CognitiveServices/accounts",
  "apiVersion": "2023-05-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "allowedFqdnList": [ "string" ],
    "apiProperties": {
      "aadClientId": "string",
      "aadTenantId": "string",
      "eventHubConnectionString": "string",
      "qnaAzureSearchEndpointId": "string",
      "qnaAzureSearchEndpointKey": "string",
      "qnaRuntimeEndpoint": "string",
      "statisticsEnabled": "bool",
      "storageAccountConnectionString": "string",
      "superUser": "string",
      "websiteName": "string"
    },
    "customSubDomainName": "string",
    "disableLocalAuth": "bool",
    "dynamicThrottlingEnabled": "bool",
    "encryption": {
      "keySource": "string",
      "keyVaultProperties": {
        "identityClientId": "string",
        "keyName": "string",
        "keyVaultUri": "string",
        "keyVersion": "string"
      }
    },
    "locations": {
      "regions": [
        {
          "customsubdomain": "string",
          "name": "string",
          "value": "int"
        }
      ],
      "routingMethod": "string"
    },
    "migrationToken": "string",
    "networkAcls": {
      "defaultAction": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ],
      "virtualNetworkRules": [
        {
          "id": "string",
          "ignoreMissingVnetServiceEndpoint": "bool",
          "state": "string"
        }
      ]
    },
    "publicNetworkAccess": "string",
    "restore": "bool",
    "restrictOutboundNetworkAccess": "bool",
    "userOwnedStorage": [
      {
        "identityClientId": "string",
        "resourceId": "string"
      }
    ]
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Propriedades da Conta

Designação	Descrição	Valor
allowedFqdnList		string[]
apiPropriedades	As propriedades da api para APIs especiais.	ApiProperties
customSubDomainName	Nome de subdomínio opcional usado para autenticação baseada em token.	string
disableLocalAuth		Bool
dynamicThrottlingEnabled	O sinalizador para habilitar a limitação dinâmica.	Bool
encriptação	As propriedades de criptografia para este recurso.	de criptografia
Locais	As configurações de várias regiões da conta de Serviços Cognitivos.	MultiRegionSettings
migrationToken	Token de migração de recursos.	string
networkAcls	Um conjunto de regras que regem a acessibilidade a partir de locais de rede específicos.	NetworkRuleSet
publicNetworkAccess	Se o acesso público ao ponto de extremidade é permitido ou não para essa conta.	'Desativado' 'Habilitado'
restaurar		Bool
restrictOutboundNetworkAccess		Bool
userOwnedStorage	O armazenamento é responsável por esse recurso.	UserOwnedStorage[]

AccountTags

Designação	Descrição	Valor

ApiProperties

Designação	Descrição	Valor
aadClientId	(Somente Consultor de Métricas) A ID do Cliente do Azure AD (ID do Aplicativo).	string Restrições: Comprimento máximo =
aadTenantId	(Somente Consultor de Métricas) A ID do locatário do Azure AD.	string Restrições: Comprimento máximo =
eventHubConnectionString	(Apenas personalização) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	string Restrições: Comprimento máximo = Padrão = `^( )Endpoint=sb://(.);( )SharedAccessKeyName=(.);( )SharedAccessKey=(.)$`
qnaAzureSearchEndpointId	(Apenas QnAMaker) A ID do ponto de extremidade do Azure Search do QnAMaker.	string
qnaAzureSearchEndpointKey	(Apenas QnAMaker) A chave do ponto de extremidade do Azure Search do QnAMaker.	string
qnaRuntimeEndpoint	(Apenas QnAMaker) O ponto de extremidade de tempo de execução do QnAMaker.	string
estatísticasAtivado	(Somente Pesquisa do Bing) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	Bool
storageAccountConnectionString	(Apenas personalização) A cadeia de conexão da conta de armazenamento.	string Restrições: Comprimento máximo = Padrão = `^(( )DefaultEndpointsProtocol=(http\|https)( );( ))?AccountName=(.)AccountKey=(.)EndpointSuffix=(.)$`
superusuário	(Somente Consultor de Métricas) O super usuário do Metrics Advisor.	string Restrições: Comprimento máximo =
Nome do site	(Somente Consultor de Métricas) O nome do site do Metrics Advisor.	string Restrições: Comprimento máximo =

Encriptação

Designação	Descrição	Valor
fonte-chave	Enumera o valor possível de keySource for Encryption	'Microsoft.CognitiveServices' 'Microsoft.KeyVault'
keyVaultPropriedades	Propriedades de KeyVault	KeyVaultProperties

Identidade

Designação	Descrição	Valor
tipo	O tipo de identidade.	'Nenhuma' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	A lista de identidades atribuídas pelo usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Designação	Descrição	Valor

IpRule

Designação	Descrição	Valor
valor	Um intervalo de endereços IPv4 na notação CIDR, como '124.56.78.91' (endereço IP simples) ou '124.56.78.0/24' (todos os endereços que começam com 124.56.78).	string (obrigatório)

KeyVaultProperties

Designação	Descrição	Valor
identityClientId		string
Nome da chave	Nome da chave do KeyVault	string
keyVaultUri	Uri do KeyVault	string
keyVersion [en]	Versão da chave do KeyVault	string

Microsoft.CognitiveServices/contas

Designação	Descrição	Valor
apiVersion	A versão api	'2023-05-01'
identidade	Identidade do recurso.	Identidade
tipo	O tipo do recurso.	string
Localização	A geolocalização onde o recurso vive	string
Designação	O nome do recurso	string Restrições: Comprimento mínimo = 2 Comprimento máximo = 2 Padrão = `^[a-zA-Z0-9][a-zA-Z0-9_.-]*$` (obrigatório)
propriedades	Propriedades da conta de Serviços Cognitivos.	AccountProperties
SKU	A definição do modelo de recursos que representa a SKU	Sku
Etiquetas	Tags de recursos	Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo	O tipo de recurso	'Microsoft.CognitiveServices/contas'

MultiRegionSettings

Designação	Descrição	Valor
Regiões		RegiãoConfiguração[]
Método de roteamento	Métodos de roteamento multirregião.	'Desempenho' 'Prioridade' 'Ponderado'

NetworkRuleSet

Designação	Descrição	Valor
defaultAction	A ação padrão quando nenhuma regra de ipRules e de virtualNetworkRules corresponder. Isso só é usado depois que a propriedade bypass foi avaliada.	'Permitir' 'Negar'
ipRegras	A lista de regras de endereço IP.	IpRule[]
virtualNetworkRules	A lista de regras de rede virtual.	VirtualNetworkRule []

RegiãoConfiguração

Designação	Descrição	Valor
subdomínio personalizado	Mapeia a região para o subdomínio personalizado regional.	string
Designação	Nome da região.	string
valor	Um valor para métodos de roteamento ponderados ou de prioridade.	Int

Referência

Designação	Descrição	Valor
capacidade	Se a SKU suportar scaleout/in, o inteiro de capacidade deve ser incluído. Se a expansão/entrada não for possível para o recurso, isso poderá ser omitido.	Int
Família	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.	string
Designação	O nome do SKU. Ex - P3. Normalmente, é um código de letra + número	string (obrigatório)
tamanho	O tamanho do SKU. Quando o campo de nome é a combinação de camada e algum outro valor, este seria o código autônomo.	string
nível	Este campo deve ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não é obrigatório em um PUT.	'Básico' 'Empresa' 'Grátis' 'Premium' 'Padrão'

UserAssignedIdentity

Designação	Descrição	Valor

UserOwnedStorage

Designação	Descrição	Valor
identityClientId		string
resourceId	ID de recurso completo de um recurso Microsoft.Storage.	string

VirtualNetworkRule

Designação	Descrição	Valor
ID	ID de recurso completo de uma sub-rede vnet, como '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'.	string (obrigatório)
ignoreMissingVnetServiceEndpoint	Ignore o ponto de extremidade do serviço vnet ausente ou não.	Bool
Estado	Obtém o estado da regra de rede virtual.	string

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo	Descrição
de configuração básica do Azure AI Studio	Este conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com o acesso público à Internet habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
de configuração básica do Azure AI Studio	Este conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com o acesso público à Internet habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
de configuração básica do Azure AI Studio	Este conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com o acesso público à Internet habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
Rede Restrita do Azure AI Studio	Este conjunto de modelos demonstra como configurar o Azure AI Studio com link privado e saída desabilitados, usando chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
Rede Restrita do Azure AI Studio	Este conjunto de modelos demonstra como configurar o Azure AI Studio com link privado e saída desabilitados, usando chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
Azure AI Studio com o Microsoft Entra ID Authentication	Este conjunto de modelos demonstra como configurar o Azure AI Studio com a autenticação de ID do Microsoft Entra para recursos dependentes, como os Serviços de IA do Azure e o Armazenamento do Azure.
Implantar um de recursos multisserviço de serviços de IA do Azure	Este modelo implanta um recurso de serviços de IA do Azure para colocar a IA ao alcance de todos os desenvolvedores sem exigir experiência em aprendizado de máquina. Tudo o que é preciso é uma chamada de API para incorporar a capacidade de ver, ouvir, falar, pesquisar, entender e acelerar a tomada de decisões em seus aplicativos.
Implantar um recurso do Azure AI Translator	Este modelo implanta um recurso do Azure AI Translator para colocar a IA ao alcance de todos os desenvolvedores sem exigir experiência em aprendizado de máquina.
Implantar um recurso do Azure AI Vision	Este modelo implanta um recurso do Azure AI Vision para colocar a IA ao alcance de todos os desenvolvedores sem exigir experiência em aprendizado de máquina.
Implantar o Secure Azure AI Studio com uma rede virtual gerenciada	Este modelo cria um ambiente seguro do Azure AI Studio com restrições robustas de segurança de rede e identidade.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso de contas pode ser implantado com operações que visam:

Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.CognitiveServices/accounts, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts@2023-05-01"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  kind = "string"
  location = "string"
  sku = {
    capacity = int
    family = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      allowedFqdnList = [
        "string"
      ]
      apiProperties = {
        aadClientId = "string"
        aadTenantId = "string"
        eventHubConnectionString = "string"
        qnaAzureSearchEndpointId = "string"
        qnaAzureSearchEndpointKey = "string"
        qnaRuntimeEndpoint = "string"
        statisticsEnabled = bool
        storageAccountConnectionString = "string"
        superUser = "string"
        websiteName = "string"
      }
      customSubDomainName = "string"
      disableLocalAuth = bool
      dynamicThrottlingEnabled = bool
      encryption = {
        keySource = "string"
        keyVaultProperties = {
          identityClientId = "string"
          keyName = "string"
          keyVaultUri = "string"
          keyVersion = "string"
        }
      }
      locations = {
        regions = [
          {
            customsubdomain = "string"
            name = "string"
            value = int
          }
        ]
        routingMethod = "string"
      }
      migrationToken = "string"
      networkAcls = {
        defaultAction = "string"
        ipRules = [
          {
            value = "string"
          }
        ]
        virtualNetworkRules = [
          {
            id = "string"
            ignoreMissingVnetServiceEndpoint = bool
            state = "string"
          }
        ]
      }
      publicNetworkAccess = "string"
      restore = bool
      restrictOutboundNetworkAccess = bool
      userOwnedStorage = [
        {
          identityClientId = "string"
          resourceId = "string"
        }
      ]
    }
  })
}

Valores de propriedade

Propriedades da Conta

Designação	Descrição	Valor
allowedFqdnList		string[]
apiPropriedades	As propriedades da api para APIs especiais.	ApiProperties
customSubDomainName	Nome de subdomínio opcional usado para autenticação baseada em token.	string
disableLocalAuth		Bool
dynamicThrottlingEnabled	O sinalizador para habilitar a limitação dinâmica.	Bool
encriptação	As propriedades de criptografia para este recurso.	de criptografia
Locais	As configurações de várias regiões da conta de Serviços Cognitivos.	MultiRegionSettings
migrationToken	Token de migração de recursos.	string
networkAcls	Um conjunto de regras que regem a acessibilidade a partir de locais de rede específicos.	NetworkRuleSet
publicNetworkAccess	Se o acesso público ao ponto de extremidade é permitido ou não para essa conta.	'Desativado' 'Habilitado'
restaurar		Bool
restrictOutboundNetworkAccess		Bool
userOwnedStorage	O armazenamento é responsável por esse recurso.	UserOwnedStorage[]

AccountTags

Designação	Descrição	Valor

ApiProperties

Designação	Descrição	Valor
aadClientId	(Somente Consultor de Métricas) A ID do Cliente do Azure AD (ID do Aplicativo).	string Restrições: Comprimento máximo =
aadTenantId	(Somente Consultor de Métricas) A ID do locatário do Azure AD.	string Restrições: Comprimento máximo =
eventHubConnectionString	(Apenas personalização) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	string Restrições: Comprimento máximo = Padrão = `^( )Endpoint=sb://(.);( )SharedAccessKeyName=(.);( )SharedAccessKey=(.)$`
qnaAzureSearchEndpointId	(Apenas QnAMaker) A ID do ponto de extremidade do Azure Search do QnAMaker.	string
qnaAzureSearchEndpointKey	(Apenas QnAMaker) A chave do ponto de extremidade do Azure Search do QnAMaker.	string
qnaRuntimeEndpoint	(Apenas QnAMaker) O ponto de extremidade de tempo de execução do QnAMaker.	string
estatísticasAtivado	(Somente Pesquisa do Bing) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	Bool
storageAccountConnectionString	(Apenas personalização) A cadeia de conexão da conta de armazenamento.	string Restrições: Comprimento máximo = Padrão = `^(( )DefaultEndpointsProtocol=(http\|https)( );( ))?AccountName=(.)AccountKey=(.)EndpointSuffix=(.)$`
superusuário	(Somente Consultor de Métricas) O super usuário do Metrics Advisor.	string Restrições: Comprimento máximo =
Nome do site	(Somente Consultor de Métricas) O nome do site do Metrics Advisor.	string Restrições: Comprimento máximo =

Encriptação

Designação	Descrição	Valor
fonte-chave	Enumera o valor possível de keySource for Encryption	'Microsoft.CognitiveServices' 'Microsoft.KeyVault'
keyVaultPropriedades	Propriedades de KeyVault	KeyVaultProperties

Identidade

Designação	Descrição	Valor
tipo	O tipo de identidade.	'Nenhuma' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	A lista de identidades atribuídas pelo usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Designação	Descrição	Valor

IpRule

Designação	Descrição	Valor
valor	Um intervalo de endereços IPv4 na notação CIDR, como '124.56.78.91' (endereço IP simples) ou '124.56.78.0/24' (todos os endereços que começam com 124.56.78).	string (obrigatório)

KeyVaultProperties

Designação	Descrição	Valor
identityClientId		string
Nome da chave	Nome da chave do KeyVault	string
keyVaultUri	Uri do KeyVault	string
keyVersion [en]	Versão da chave do KeyVault	string

Microsoft.CognitiveServices/contas

Designação	Descrição	Valor
identidade	Identidade do recurso.	Identidade
tipo	O tipo do recurso.	string
Localização	A geolocalização onde o recurso vive	string
Designação	O nome do recurso	string Restrições: Comprimento mínimo = 2 Comprimento máximo = 2 Padrão = `^[a-zA-Z0-9][a-zA-Z0-9_.-]*$` (obrigatório)
propriedades	Propriedades da conta de Serviços Cognitivos.	AccountProperties
SKU	A definição do modelo de recursos que representa a SKU	Sku
Etiquetas	Tags de recursos	Dicionário de nomes e valores de tags.
tipo	O tipo de recurso	"Microsoft.CognitiveServices/accounts@2023-05-01"

MultiRegionSettings

Designação	Descrição	Valor
Regiões		RegiãoConfiguração[]
Método de roteamento	Métodos de roteamento multirregião.	'Desempenho' 'Prioridade' 'Ponderado'

NetworkRuleSet

Designação	Descrição	Valor
defaultAction	A ação padrão quando nenhuma regra de ipRules e de virtualNetworkRules corresponder. Isso só é usado depois que a propriedade bypass foi avaliada.	'Permitir' 'Negar'
ipRegras	A lista de regras de endereço IP.	IpRule[]
virtualNetworkRules	A lista de regras de rede virtual.	VirtualNetworkRule []

RegiãoConfiguração

Designação	Descrição	Valor
subdomínio personalizado	Mapeia a região para o subdomínio personalizado regional.	string
Designação	Nome da região.	string
valor	Um valor para métodos de roteamento ponderados ou de prioridade.	Int

Referência

Designação	Descrição	Valor
capacidade	Se a SKU suportar scaleout/in, o inteiro de capacidade deve ser incluído. Se a expansão/entrada não for possível para o recurso, isso poderá ser omitido.	Int
Família	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.	string
Designação	O nome do SKU. Ex - P3. Normalmente, é um código de letra + número	string (obrigatório)
tamanho	O tamanho do SKU. Quando o campo de nome é a combinação de camada e algum outro valor, este seria o código autônomo.	string
nível	Este campo deve ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não é obrigatório em um PUT.	'Básico' 'Empresa' 'Grátis' 'Premium' 'Padrão'

UserAssignedIdentity

Designação	Descrição	Valor

UserOwnedStorage

Designação	Descrição	Valor
identityClientId		string
resourceId	ID de recurso completo de um recurso Microsoft.Storage.	string

VirtualNetworkRule

Designação	Descrição	Valor
ID	ID de recurso completo de uma sub-rede vnet, como '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'.	string (obrigatório)
ignoreMissingVnetServiceEndpoint	Ignore o ponto de extremidade do serviço vnet ausente ou não.	Bool
Estado	Obtém o estado da regra de rede virtual.	string

Partilhar via

Contas Microsoft.CognitiveServices 2023-05-01

Definição de recursos do bíceps

Formato do recurso

Valores de propriedade

Propriedades da Conta

AccountTags

ApiProperties

Encriptação

Identidade

IdentityUserAssignedIdentities

IpRule

KeyVaultProperties

Microsoft.CognitiveServices/contas

MultiRegionSettings

NetworkRuleSet

RegiãoConfiguração

Referência

UserAssignedIdentity

UserOwnedStorage

VirtualNetworkRule

Exemplos de início rápido

Definição de recurso de modelo ARM

Formato do recurso

Valores de propriedade

Propriedades da Conta

AccountTags

ApiProperties

Encriptação

Identidade

IdentityUserAssignedIdentities

IpRule

KeyVaultProperties

Microsoft.CognitiveServices/contas

MultiRegionSettings

NetworkRuleSet

RegiãoConfiguração

Referência

UserAssignedIdentity

UserOwnedStorage

VirtualNetworkRule

Modelos de início rápido

Definição de recursos Terraform (provedor AzAPI)

Formato do recurso

Valores de propriedade

Propriedades da Conta

AccountTags

ApiProperties

Encriptação

Identidade

IdentityUserAssignedIdentities

IpRule

KeyVaultProperties

Microsoft.CognitiveServices/contas

MultiRegionSettings

NetworkRuleSet

RegiãoConfiguração

Referência

UserAssignedIdentity

UserOwnedStorage

VirtualNetworkRule

Comentários

Recursos adicionais