Contas do Microsoft.CognitiveServices 2017-04-18

• última
• 2024-10-01
• 2024-06-01-preview
• 2024-04-01-preview
• 2023-10-01-preview
• 2023-05-01
• 2022-12-01
• 2022-10-01
• 2022-03-01
• 2021-10-01
• 2021-04-30
• 2017-04-18
• 2016-02-01-preview

Definição de recurso do Bicep

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

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

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

Formato de recurso

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

resource symbolicname 'Microsoft.CognitiveServices/accounts@2017-04-18' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    apiProperties: {
      aadClientId: 'string'
      aadTenantId: 'string'
      eventHubConnectionString: 'string'
      qnaAzureSearchEndpointId: 'string'
      qnaAzureSearchEndpointKey: 'string'
      qnaRuntimeEndpoint: 'string'
      statisticsEnabled: bool
      storageAccountConnectionString: 'string'
      superUser: 'string'
      websiteName: 'string'
    }
    customSubDomainName: 'string'
    encryption: {
      keySource: 'string'
      keyVaultProperties: {
        keyName: 'string'
        keyVaultUri: 'string'
        keyVersion: 'string'
      }
    }
    networkAcls: {
      defaultAction: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
      virtualNetworkRules: [
        {
          id: 'string'
          ignoreMissingVnetServiceEndpoint: bool
          state: 'string'
        }
      ]
    }
    privateEndpointConnections: [
      {
        location: 'string'
        properties: {
          groupIds: [
            'string'
          ]
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
        }
      }
    ]
    publicNetworkAccess: 'string'
    userOwnedStorage: [
      {
        resourceId: 'string'
      }
    ]
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

CognitiveServicesAccountApiProperties

Nome	Descrição	Valor
aadClientId	(Somente Assistente de Métricas) A ID do cliente do Azure AD (ID do aplicativo).	corda Restrições: Comprimento máximo =
aadTenantId	(Somente Assistente de Métricas) A ID do locatário do Azure AD.	corda Restrições: Comprimento máximo =
eventHubConnectionString	(Somente personalização) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	corda Restrições: Comprimento máximo = Padrão = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$
qnaAzureSearchEndpointId	(Somente QnAMaker) A ID do ponto de extremidade do Azure Search do QnAMaker.	corda
qnaAzureSearchEndpointKey	(Somente QnAMaker) A chave de ponto de extremidade do Azure Search do QnAMaker.	corda
qnaRuntimeEndpoint	(Somente QnAMaker) O ponto de extremidade de runtime do QnAMaker.	corda
statisticsEnabled	(Somente pesquisa do Bing) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	Bool
storageAccountConnectionString	(Somente personalização) A cadeia de conexão da conta de armazenamento.	corda Restrições: Comprimento máximo = Padrão = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$
Superusuário	(Somente Assistente de Métricas) O superusuário do Assistente de Métricas.	corda Restrições: Comprimento máximo =
websiteName	(Somente Assistente de Métricas) O nome do site do Assistente de Métricas.	corda Restrições: Comprimento máximo =

CognitiveServicesAccountProperties

Nome	Descrição	Valor
apiProperties	As propriedades da API para APIs especiais.	CognitiveServicesAccountApiProperties
customSubDomainName	Nome de subdomínio opcional usado para autenticação baseada em token.	corda
encriptação	As propriedades de criptografia para esse recurso.	Encryption
networkAcls	Uma coleção de regras que regem a acessibilidade de locais de rede específicos.	NetworkRuleSet
privateEndpointConnections	A conexão de ponto de extremidade privado associada à conta dos Serviços Cognitivos.	PrivateEndpointConnection []
publicNetworkAccess	Se o acesso ao ponto de extremidade público é permitido ou não para essa conta. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'	'Desabilitado' 'Habilitado'
userOwnedStorage	As contas de armazenamento para esse recurso.	UserOwnedStorage []

CognitiveServicesAccountTags

Nome	Descrição	Valor

Encriptação

Nome	Descrição	Valor
keySource	Enumera o valor possível de keySource for Encryption	'Microsoft.CognitiveServices' 'Microsoft.KeyVault'
keyVaultProperties	Propriedades do KeyVault	KeyVaultProperties

Identidade

Nome	Descrição	Valor
tipo	Tipo de identidade de serviço gerenciado.	'None' 'SystemAssigned' '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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nome	Descrição	Valor

IpRule

Nome	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).	cadeia de caracteres (obrigatório)

KeyVaultProperties

Nome	Descrição	Valor
keyName	Nome da chave do KeyVault	corda
keyVaultUri	Uri de KeyVault	corda
keyVersion	Versão da chave do KeyVault	corda

Microsoft.CognitiveServices/accounts

Nome	Descrição	Valor
identidade	A identidade da conta dos Serviços Cognitivos.	Identity
tipo	O tipo do recurso.	corda
localização	O local do recurso	corda
nome	O nome do recurso	corda 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 dos Serviços Cognitivos.	CognitiveServicesAccountProperties
Sku	A conta do SKU dos Serviços Cognitivos.	de SKU
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos

NetworkRuleSet

Nome	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 é avaliada.	'Permitir' 'Negar'
ipRules	A lista de regras de endereço IP.	IpRule[]
virtualNetworkRules	A lista de regras de rede virtual.	VirtualNetworkRule[]

PrivateEndpoint

Nome	Descrição	Valor

PrivateEndpointConnection

Nome	Descrição	Valor
localização	O local da conexão de ponto de extremidade privado	corda
Propriedades	Propriedades do recurso.	PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nome	Descrição	Valor
groupIds	As IDs do grupo de recursos de link privado.	string[]
privateEndpoint	O recurso do ponto de extremidade privado.	PrivateEndpoint
privateLinkServiceConnectionState	Uma coleção de informações sobre o estado da conexão entre o consumidor de serviço e o provedor.	PrivateLinkServiceConnectionState (obrigatório)

PrivateLinkServiceConnectionState

Nome	Descrição	Valor
actionsRequired	Uma mensagem que indica se as alterações no provedor de serviços exigem atualizações no consumidor.	corda
descrição	O motivo da aprovação/rejeição da conexão.	corda
estado	Indica se a conexão foi aprovada/rejeitada/removida pelo proprietário do serviço.	'Aprovado' 'Desconectado' 'Pendente' 'Rejeitado'

Sku

Nome	Descrição	Valor
nome	Obtém ou define o nome do sku. Necessário para a criação da conta, opcional para atualização.	cadeia de caracteres (obrigatório)

UserAssignedIdentity

Nome	Descrição	Valor
clientId	ID do aplicativo cliente associada a essa identidade.	corda
principalId	ID da entidade de segurança do Azure Active Directory associada a essa Identidade.	corda

UserOwnedStorage

Nome	Descrição	Valor
resourceId	ID de recurso completa de um recurso Microsoft.Storage.	corda

VirtualNetworkRule

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

Exemplos de início rápido

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

Arquivo Bicep	Descrição
configuração básica do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com acesso à Internet público habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
configuração básica do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com acesso à Internet público habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
configuração básica do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com acesso à Internet público habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
restrito de rede do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com o link privado e a saída desabilitados, usando chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
restrito de rede do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com o link privado e a 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	Esse 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 recurso de vários serviços de IA do Azure	Esse modelo implanta um recurso de serviços de IA do Azure para colocar a IA ao alcance de todos os desenvolvedores sem a necessidade de experiência em machine learning. Basta uma chamada à API para inserir a capacidade de ver, ouvir, falar, pesquisar, entender e acelerar a tomada de decisões em seus aplicativos.
implantar um recurso do Tradutor de IA do Azure	Esse modelo implanta um recurso do Tradutor de IA do Azure para colocar a IA ao alcance de todos os desenvolvedores sem a necessidade de experiência em machine learning.
implantar um recurso da Visão de IA do Azure	Esse modelo implanta um recurso da Visão de IA do Azure para colocar a IA ao alcance de todos os desenvolvedores sem a necessidade de experiência em machine learning.
implantar o Azure AI Studio seguro com uma rede virtual gerenciada	Esse modelo cria um ambiente seguro do Azure AI Studio com restrições robustas de segurança de identidade e de rede.

Definição de recurso de modelo do ARM

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

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

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

Formato de recurso

Para criar um recurso Microsoft.CognitiveServices/accounts, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.CognitiveServices/accounts",
  "apiVersion": "2017-04-18",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "apiProperties": {
      "aadClientId": "string",
      "aadTenantId": "string",
      "eventHubConnectionString": "string",
      "qnaAzureSearchEndpointId": "string",
      "qnaAzureSearchEndpointKey": "string",
      "qnaRuntimeEndpoint": "string",
      "statisticsEnabled": "bool",
      "storageAccountConnectionString": "string",
      "superUser": "string",
      "websiteName": "string"
    },
    "customSubDomainName": "string",
    "encryption": {
      "keySource": "string",
      "keyVaultProperties": {
        "keyName": "string",
        "keyVaultUri": "string",
        "keyVersion": "string"
      }
    },
    "networkAcls": {
      "defaultAction": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ],
      "virtualNetworkRules": [
        {
          "id": "string",
          "ignoreMissingVnetServiceEndpoint": "bool",
          "state": "string"
        }
      ]
    },
    "privateEndpointConnections": [
      {
        "location": "string",
        "properties": {
          "groupIds": [ "string" ],
          "privateEndpoint": {
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          }
        }
      }
    ],
    "publicNetworkAccess": "string",
    "userOwnedStorage": [
      {
        "resourceId": "string"
      }
    ]
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

CognitiveServicesAccountApiProperties

Nome	Descrição	Valor
aadClientId	(Somente Assistente de Métricas) A ID do cliente do Azure AD (ID do aplicativo).	corda Restrições: Comprimento máximo =
aadTenantId	(Somente Assistente de Métricas) A ID do locatário do Azure AD.	corda Restrições: Comprimento máximo =
eventHubConnectionString	(Somente personalização) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	corda Restrições: Comprimento máximo = Padrão = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$
qnaAzureSearchEndpointId	(Somente QnAMaker) A ID do ponto de extremidade do Azure Search do QnAMaker.	corda
qnaAzureSearchEndpointKey	(Somente QnAMaker) A chave de ponto de extremidade do Azure Search do QnAMaker.	corda
qnaRuntimeEndpoint	(Somente QnAMaker) O ponto de extremidade de runtime do QnAMaker.	corda
statisticsEnabled	(Somente pesquisa do Bing) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	Bool
storageAccountConnectionString	(Somente personalização) A cadeia de conexão da conta de armazenamento.	corda Restrições: Comprimento máximo = Padrão = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$
Superusuário	(Somente Assistente de Métricas) O superusuário do Assistente de Métricas.	corda Restrições: Comprimento máximo =
websiteName	(Somente Assistente de Métricas) O nome do site do Assistente de Métricas.	corda Restrições: Comprimento máximo =

CognitiveServicesAccountProperties

Nome	Descrição	Valor
apiProperties	As propriedades da API para APIs especiais.	CognitiveServicesAccountApiProperties
customSubDomainName	Nome de subdomínio opcional usado para autenticação baseada em token.	corda
encriptação	As propriedades de criptografia para esse recurso.	Encryption
networkAcls	Uma coleção de regras que regem a acessibilidade de locais de rede específicos.	NetworkRuleSet
privateEndpointConnections	A conexão de ponto de extremidade privado associada à conta dos Serviços Cognitivos.	PrivateEndpointConnection []
publicNetworkAccess	Se o acesso ao ponto de extremidade público é permitido ou não para essa conta. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'	'Desabilitado' 'Habilitado'
userOwnedStorage	As contas de armazenamento para esse recurso.	UserOwnedStorage []

CognitiveServicesAccountTags

Nome	Descrição	Valor

Encriptação

Nome	Descrição	Valor
keySource	Enumera o valor possível de keySource for Encryption	'Microsoft.CognitiveServices' 'Microsoft.KeyVault'
keyVaultProperties	Propriedades do KeyVault	KeyVaultProperties

Identidade

Nome	Descrição	Valor
tipo	Tipo de identidade de serviço gerenciado.	'None' 'SystemAssigned' '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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nome	Descrição	Valor

IpRule

Nome	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).	cadeia de caracteres (obrigatório)

KeyVaultProperties

Nome	Descrição	Valor
keyName	Nome da chave do KeyVault	corda
keyVaultUri	Uri de KeyVault	corda
keyVersion	Versão da chave do KeyVault	corda

Microsoft.CognitiveServices/accounts

Nome	Descrição	Valor
apiVersion	A versão da API	'2017-04-18'
identidade	A identidade da conta dos Serviços Cognitivos.	Identity
tipo	O tipo do recurso.	corda
localização	O local do recurso	corda
nome	O nome do recurso	corda 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 dos Serviços Cognitivos.	CognitiveServicesAccountProperties
Sku	A conta do SKU dos Serviços Cognitivos.	de SKU
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo	O tipo de recurso	'Microsoft.CognitiveServices/accounts'

NetworkRuleSet

Nome	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 é avaliada.	'Permitir' 'Negar'
ipRules	A lista de regras de endereço IP.	IpRule[]
virtualNetworkRules	A lista de regras de rede virtual.	VirtualNetworkRule[]

PrivateEndpoint

Nome	Descrição	Valor

PrivateEndpointConnection

Nome	Descrição	Valor
localização	O local da conexão de ponto de extremidade privado	corda
Propriedades	Propriedades do recurso.	PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nome	Descrição	Valor
groupIds	As IDs do grupo de recursos de link privado.	string[]
privateEndpoint	O recurso do ponto de extremidade privado.	PrivateEndpoint
privateLinkServiceConnectionState	Uma coleção de informações sobre o estado da conexão entre o consumidor de serviço e o provedor.	PrivateLinkServiceConnectionState (obrigatório)

PrivateLinkServiceConnectionState

Nome	Descrição	Valor
actionsRequired	Uma mensagem que indica se as alterações no provedor de serviços exigem atualizações no consumidor.	corda
descrição	O motivo da aprovação/rejeição da conexão.	corda
estado	Indica se a conexão foi aprovada/rejeitada/removida pelo proprietário do serviço.	'Aprovado' 'Desconectado' 'Pendente' 'Rejeitado'

Sku

Nome	Descrição	Valor
nome	Obtém ou define o nome do sku. Necessário para a criação da conta, opcional para atualização.	cadeia de caracteres (obrigatório)

UserAssignedIdentity

Nome	Descrição	Valor
clientId	ID do aplicativo cliente associada a essa identidade.	corda
principalId	ID da entidade de segurança do Azure Active Directory associada a essa Identidade.	corda

UserOwnedStorage

Nome	Descrição	Valor
resourceId	ID de recurso completa de um recurso Microsoft.Storage.	corda

VirtualNetworkRule

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

Modelos de início rápido

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

Modelo	Descrição
configuração básica do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com acesso à Internet público habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
configuração básica do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com acesso à Internet público habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
configuração básica do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com acesso à Internet público habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
restrito de rede do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com o link privado e a saída desabilitados, usando chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
restrito de rede do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com o link privado e a 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	Esse 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 recurso de vários serviços de IA do Azure	Esse modelo implanta um recurso de serviços de IA do Azure para colocar a IA ao alcance de todos os desenvolvedores sem a necessidade de experiência em machine learning. Basta uma chamada à API para inserir a capacidade de ver, ouvir, falar, pesquisar, entender e acelerar a tomada de decisões em seus aplicativos.
implantar um recurso do Tradutor de IA do Azure	Esse modelo implanta um recurso do Tradutor de IA do Azure para colocar a IA ao alcance de todos os desenvolvedores sem a necessidade de experiência em machine learning.
implantar um recurso da Visão de IA do Azure	Esse modelo implanta um recurso da Visão de IA do Azure para colocar a IA ao alcance de todos os desenvolvedores sem a necessidade de experiência em machine learning.
implantar o Azure AI Studio seguro com uma rede virtual gerenciada	Esse modelo cria um ambiente seguro do Azure AI Studio com restrições robustas de segurança de identidade e de rede.

Definição de recurso do Terraform (provedor de AzAPI)

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

• grupos de recursos

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

Formato de recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts@2017-04-18"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  kind = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      apiProperties = {
        aadClientId = "string"
        aadTenantId = "string"
        eventHubConnectionString = "string"
        qnaAzureSearchEndpointId = "string"
        qnaAzureSearchEndpointKey = "string"
        qnaRuntimeEndpoint = "string"
        statisticsEnabled = bool
        storageAccountConnectionString = "string"
        superUser = "string"
        websiteName = "string"
      }
      customSubDomainName = "string"
      encryption = {
        keySource = "string"
        keyVaultProperties = {
          keyName = "string"
          keyVaultUri = "string"
          keyVersion = "string"
        }
      }
      networkAcls = {
        defaultAction = "string"
        ipRules = [
          {
            value = "string"
          }
        ]
        virtualNetworkRules = [
          {
            id = "string"
            ignoreMissingVnetServiceEndpoint = bool
            state = "string"
          }
        ]
      }
      privateEndpointConnections = [
        {
          location = "string"
          properties = {
            groupIds = [
              "string"
            ]
            privateEndpoint = {
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
          }
        }
      ]
      publicNetworkAccess = "string"
      userOwnedStorage = [
        {
          resourceId = "string"
        }
      ]
    }
  })
}

Valores de propriedade

CognitiveServicesAccountApiProperties

Nome	Descrição	Valor
aadClientId	(Somente Assistente de Métricas) A ID do cliente do Azure AD (ID do aplicativo).	corda Restrições: Comprimento máximo =
aadTenantId	(Somente Assistente de Métricas) A ID do locatário do Azure AD.	corda Restrições: Comprimento máximo =
eventHubConnectionString	(Somente personalização) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	corda Restrições: Comprimento máximo = Padrão = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$
qnaAzureSearchEndpointId	(Somente QnAMaker) A ID do ponto de extremidade do Azure Search do QnAMaker.	corda
qnaAzureSearchEndpointKey	(Somente QnAMaker) A chave de ponto de extremidade do Azure Search do QnAMaker.	corda
qnaRuntimeEndpoint	(Somente QnAMaker) O ponto de extremidade de runtime do QnAMaker.	corda
statisticsEnabled	(Somente pesquisa do Bing) O sinalizador para habilitar estatísticas da Pesquisa do Bing.	Bool
storageAccountConnectionString	(Somente personalização) A cadeia de conexão da conta de armazenamento.	corda Restrições: Comprimento máximo = Padrão = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$
Superusuário	(Somente Assistente de Métricas) O superusuário do Assistente de Métricas.	corda Restrições: Comprimento máximo =
websiteName	(Somente Assistente de Métricas) O nome do site do Assistente de Métricas.	corda Restrições: Comprimento máximo =

CognitiveServicesAccountProperties

Nome	Descrição	Valor
apiProperties	As propriedades da API para APIs especiais.	CognitiveServicesAccountApiProperties
customSubDomainName	Nome de subdomínio opcional usado para autenticação baseada em token.	corda
encriptação	As propriedades de criptografia para esse recurso.	Encryption
networkAcls	Uma coleção de regras que regem a acessibilidade de locais de rede específicos.	NetworkRuleSet
privateEndpointConnections	A conexão de ponto de extremidade privado associada à conta dos Serviços Cognitivos.	PrivateEndpointConnection []
publicNetworkAccess	Se o acesso ao ponto de extremidade público é permitido ou não para essa conta. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'	'Desabilitado' 'Habilitado'
userOwnedStorage	As contas de armazenamento para esse recurso.	UserOwnedStorage []

CognitiveServicesAccountTags

Nome	Descrição	Valor

Encriptação

Nome	Descrição	Valor
keySource	Enumera o valor possível de keySource for Encryption	'Microsoft.CognitiveServices' 'Microsoft.KeyVault'
keyVaultProperties	Propriedades do KeyVault	KeyVaultProperties

Identidade

Nome	Descrição	Valor
tipo	Tipo de identidade de serviço gerenciado.	'None' 'SystemAssigned' '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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nome	Descrição	Valor

IpRule

Nome	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).	cadeia de caracteres (obrigatório)

KeyVaultProperties

Nome	Descrição	Valor
keyName	Nome da chave do KeyVault	corda
keyVaultUri	Uri de KeyVault	corda
keyVersion	Versão da chave do KeyVault	corda

Microsoft.CognitiveServices/accounts

Nome	Descrição	Valor
identidade	A identidade da conta dos Serviços Cognitivos.	Identity
tipo	O tipo do recurso.	corda
localização	O local do recurso	corda
nome	O nome do recurso	corda 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 dos Serviços Cognitivos.	CognitiveServicesAccountProperties
Sku	A conta do SKU dos Serviços Cognitivos.	de SKU
Tags	Marcas de recurso	Dicionário de nomes e valores de marca.
tipo	O tipo de recurso	"Microsoft.CognitiveServices/accounts@2017-04-18"

NetworkRuleSet

Nome	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 é avaliada.	'Permitir' 'Negar'
ipRules	A lista de regras de endereço IP.	IpRule[]
virtualNetworkRules	A lista de regras de rede virtual.	VirtualNetworkRule[]

PrivateEndpoint

Nome	Descrição	Valor

PrivateEndpointConnection

Nome	Descrição	Valor
localização	O local da conexão de ponto de extremidade privado	corda
Propriedades	Propriedades do recurso.	PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nome	Descrição	Valor
groupIds	As IDs do grupo de recursos de link privado.	string[]
privateEndpoint	O recurso do ponto de extremidade privado.	PrivateEndpoint
privateLinkServiceConnectionState	Uma coleção de informações sobre o estado da conexão entre o consumidor de serviço e o provedor.	PrivateLinkServiceConnectionState (obrigatório)

PrivateLinkServiceConnectionState

Nome	Descrição	Valor
actionsRequired	Uma mensagem que indica se as alterações no provedor de serviços exigem atualizações no consumidor.	corda
descrição	O motivo da aprovação/rejeição da conexão.	corda
estado	Indica se a conexão foi aprovada/rejeitada/removida pelo proprietário do serviço.	'Aprovado' 'Desconectado' 'Pendente' 'Rejeitado'

Sku

Nome	Descrição	Valor
nome	Obtém ou define o nome do sku. Necessário para a criação da conta, opcional para atualização.	cadeia de caracteres (obrigatório)

UserAssignedIdentity

Nome	Descrição	Valor
clientId	ID do aplicativo cliente associada a essa identidade.	corda
principalId	ID da entidade de segurança do Azure Active Directory associada a essa Identidade.	corda

UserOwnedStorage

Nome	Descrição	Valor
resourceId	ID de recurso completa de um recurso Microsoft.Storage.	corda

VirtualNetworkRule

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