Cuentas de Microsoft.CognitiveServices

Artículo
02/21/2025

Definición de recursos de Bicep

El tipo de recurso accounts se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.CognitiveServices/accounts, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.CognitiveServices/accounts@2024-10-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    allowedFqdnList: [
      'string'
    ]
    amlWorkspace: {
      identityClientId: 'string'
      resourceId: '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: {
      bypass: 'string'
      defaultAction: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
      virtualNetworkRules: [
        {
          id: 'string'
          ignoreMissingVnetServiceEndpoint: bool
          state: 'string'
        }
      ]
    }
    publicNetworkAccess: 'string'
    raiMonitorConfig: {
      adxStorageResourceId: 'string'
      identityClientId: '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 propiedad

AccountProperties

Nombre	Descripción	Valor
allowedFqdnList		string[]
amlWorkspace	Propiedades del área de trabajo de AML propiedad del usuario.	UserOwnedAmlWorkspace
apiProperties	Las propiedades de api de las API especiales.	ApiProperties
customSubDomainName	Nombre de subdominio opcional usado para la autenticación basada en tokens.	cuerda
disableLocalAuth		Bool
dynamicThrottlingEnabled	Marca para habilitar la limitación dinámica.	Bool
encriptación	Propiedades de cifrado para este recurso.	de cifrado
Ubicaciones	Configuración de varias regiones de la cuenta de Cognitive Services.	MultiRegionSettings
migrationToken	Token de migración de recursos.	cuerda
networkAcls	Colección de reglas que rigen la accesibilidad desde ubicaciones de red específicas.	NetworkRuleSet
publicNetworkAccess	Indica si se permite o no el acceso al punto de conexión público para esta cuenta.	'Deshabilitado' 'Habilitado'
raiMonitorConfig	Configuración de Cognitive Services Rai Monitor.	RaiMonitorConfig
restaurar		Bool
restrictOutboundNetworkAccess		Bool
userOwnedStorage	Las cuentas de almacenamiento de este recurso.	UserOwnedStorage []

AccountTags

Nombre	Descripción	Valor

ApiProperties

Nombre	Descripción	Valor
aadClientId	(Solo Metrics Advisor) Identificador de cliente de Azure AD (id. de aplicación).	cuerda Restricciones: Longitud máxima = 500
aadTenantId	(Solo Metrics Advisor) Identificador de inquilino de Azure AD.	cuerda Restricciones: Longitud máxima = 500
eventHubConnectionString	(Solo personalización) Marca para habilitar las estadísticas de Bing Search.	cuerda Restricciones: Longitud máxima = 1000 Patrón = `^( )Endpoint=sb://(.);( )SharedAccessKeyName=(.);( )SharedAccessKey=(.)$`
qnaAzureSearchEndpointId	(Solo QnAMaker) Identificador del punto de conexión de Azure Search de QnAMaker.	cuerda
qnaAzureSearchEndpointKey	(Solo QnAMaker) Clave de punto de conexión de Azure Search de QnAMaker.	cuerda
qnaRuntimeEndpoint	(Solo QnAMaker) Punto de conexión en tiempo de ejecución de QnAMaker.	cuerda
statisticsEnabled	(Solo Bing Search) Marca para habilitar las estadísticas de Bing Search.	Bool
storageAccountConnectionString	(Solo personalización) Cadena de conexión de la cuenta de almacenamiento.	cuerda Restricciones: Longitud máxima = 1000 Patrón = `^(( )DefaultEndpointsProtocol=(http\|https)( );( ))?AccountName=(.)AccountKey=(.)EndpointSuffix=(.)$`
superusuario	(Solo Metrics Advisor) Superusuario de Metrics Advisor.	cuerda Restricciones: Longitud máxima = 500
websiteName	(Solo Metrics Advisor) Nombre del sitio web de Metrics Advisor.	cuerda Restricciones: Longitud máxima = 500

Encriptación

Nombre	Descripción	Valor
keySource	Enumera el valor posible de keySource para el cifrado.	"Microsoft.CognitiveServices" "Microsoft.KeyVault"
keyVaultProperties	Propiedades de KeyVault	KeyVaultProperties

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Lista de identidades asignadas por el usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recurso de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre	Descripción	Valor

IpRule

Nombre	Descripción	Valor
valor	Intervalo de direcciones IPv4 en notación CIDR, como "124.56.78.91" (dirección IP simple) o "124.56.78.0/24" (todas las direcciones que comienzan por 124.56.78).	string (obligatorio)

KeyVaultProperties

Nombre	Descripción	Valor
identityClientId		cuerda
keyName	Nombre de la clave de KeyVault	cuerda
keyVaultUri	Uri de KeyVault	cuerda
keyVersion	Versión de la clave de KeyVault	cuerda

Microsoft.CognitiveServices/accounts

Nombre	Descripción	Valor
identidad	Identidad del recurso.	Identity
amable	El tipo del recurso.	cuerda
ubicación	Ubicación geográfica donde reside el recurso	cuerda
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 2 Longitud máxima = 64 Patrón = `^[a-zA-Z0-9][a-zA-Z0-9_.-]*$` (obligatorio)
Propiedades	Propiedades de la cuenta de Cognitive Services.	AccountProperties
Sku	Definición del modelo de recursos que representa la SKU	Sku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

MultiRegionSettings

Nombre	Descripción	Valor
Regiones		RegionSetting[]
routingMethod	Métodos de enrutamiento de varias regiones.	"Rendimiento" 'Prioridad' 'Ponderado'

NetworkRuleSet

Nombre	Descripción	Valor
puentear	Configuración de servicios de confianza.	"AzureServices" 'Ninguno'
defaultAction	Acción predeterminada cuando no hay ninguna regla de ipRules y de virtualNetworkRules coinciden. Esto solo se usa después de evaluar la propiedad bypass.	'Permitir' 'Denegar'
ipRules	Lista de reglas de direcciones IP.	ipRule[]
virtualNetworkRules	Lista de reglas de red virtual.	virtualNetworkRule[]

RaiMonitorConfig

Nombre	Descripción	Valor
adxStorageResourceId	Identificador del recurso de almacenamiento.	cuerda
identityClientId	Identificador de cliente de identidad para acceder al almacenamiento.	cuerda

RegionSetting

Nombre	Descripción	Valor
customsubdomain	Asigna la región al subdominio personalizado regional.	cuerda
nombre	Nombre de la región.	cuerda
valor	Valor de los métodos de enrutamiento prioritarios o ponderados.	Int

Sku

Nombre	Descripción	Valor
capacidad	Si la SKU admite el escalado horizontal o horizontal, se debe incluir el entero de capacidad. Si no es posible escalar horizontalmente o reducir horizontalmente el recurso, se puede omitir.	Int
familia	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.	cuerda
nombre	Nombre de la SKU. Por ejemplo, P3. Normalmente es un código de letra y número	string (obligatorio)
tamaño	Tamaño de la SKU. Cuando el campo de nombre es la combinación de nivel y otro valor, este sería el código independiente.	cuerda
nivel	El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put.	"Básico" "Enterprise" "Gratis" 'Premium' 'Estándar'

UserAssignedIdentity

Nombre	Descripción	Valor

UserOwnedAmlWorkspace

Nombre	Descripción	Valor
identityClientId	Identificador de cliente de identidad de un recurso de área de trabajo de AML.	cuerda
resourceId	Identificador de recurso completo de un recurso de área de trabajo de AML.	cuerda

UserOwnedStorage

Nombre	Descripción	Valor
identityClientId		cuerda
resourceId	Identificador de recurso completo de un recurso de Microsoft.Storage.	cuerda

VirtualNetworkRule

Nombre	Descripción	Valor
identificación	Identificador de recurso completo de una subred de red virtual, como "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1".	string (obligatorio)
ignoreMissingVnetServiceEndpoint	Omita el punto de conexión de servicio de red virtual que falta o no.	Bool
estado	Obtiene el estado de la regla de red virtual.	cuerda

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo	Descripción
azure AI Services (Cognitive Services)	Módulo de recursos de AVM para Azure AI Services (Cognitive Services)

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep	Descripción
configuración básica de Azure AI Studio	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
configuración básica de Azure AI Studio	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
configuración básica de Azure AI Studio	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
red restringida de Azure AI Studio Network	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con vínculo privado y salida deshabilitados, mediante claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
red restringida de Azure AI Studio Network	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con vínculo privado y salida deshabilitados, mediante claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
Azure AI Studio con la autenticación de id. de Entra de Microsoft	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la autenticación de id. de Entra de Microsoft para recursos dependientes, como Azure AI Services y Azure Storage.
claves de API de configuración básica del agente	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con la configuración básica mediante la autenticación de claves de API para la conexión del servicio de IA o AOAI. Los agentes usan recursos de almacenamiento y búsqueda multiinquilino totalmente administrados por Microsoft. No tendrá visibilidad ni control sobre estos recursos subyacentes de Azure.
de identidad de configuración básica del agente	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con la configuración básica mediante autenticación de identidad administrada para la conexión del servicio de IA/AOAI. Los agentes usan recursos de almacenamiento y búsqueda multiinquilino totalmente administrados por Microsoft. No tendrá visibilidad ni control sobre estos recursos subyacentes de Azure.
Implementación de un de recursos multiservicio de servicios de Azure AI	Esta plantilla implementa un recurso de servicios de Azure AI para que la inteligencia artificial llegue a todos los desarrolladores sin necesidad de experiencia en el aprendizaje automático. Todo lo que se necesita es una llamada API para insertar la capacidad de ver, escuchar, hablar, buscar, comprender y acelerar la toma de decisiones en las aplicaciones.
Implementación de un recurso de Azure AI Translator	Esta plantilla implementa un recurso de Azure AI Translator para que la inteligencia artificial llegue a todos los desarrolladores sin necesidad de experiencia en el aprendizaje automático.
Implementación de un recurso de Azure AI Vision	Esta plantilla implementa un recurso de Azure AI Vision para que la inteligencia artificial llegue a todos los desarrolladores sin necesidad de experiencia en el aprendizaje automático.
Implementación segura de Azure AI Studio con una red virtual administrada	Esta plantilla crea un entorno seguro de Azure AI Studio con restricciones sólidas de seguridad de red e identidad.
Agente protegido por red con identidad administrada de usuario	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con aislamiento de red virtual mediante autenticación de identidad administrada de usuario para la conexión del servicio de IA/AOAI y vínculos de red privada para conectar el agente a los datos seguros.
de configuración del agente estándar	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con la configuración estándar, lo que significa que con la autenticación de identidad administrada para conexiones de proyecto/centro y acceso a Internet público habilitado. Los agentes usan recursos de almacenamiento y búsqueda de un solo inquilino propiedad del cliente. Con esta configuración, tiene control total y visibilidad sobre estos recursos, pero incurrirá en costos en función del uso.

Definición de recursos de plantilla de ARM

El tipo de recurso accounts se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.CognitiveServices/accounts, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.CognitiveServices/accounts",
  "apiVersion": "2024-10-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "allowedFqdnList": [ "string" ],
    "amlWorkspace": {
      "identityClientId": "string",
      "resourceId": "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": {
      "bypass": "string",
      "defaultAction": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ],
      "virtualNetworkRules": [
        {
          "id": "string",
          "ignoreMissingVnetServiceEndpoint": "bool",
          "state": "string"
        }
      ]
    },
    "publicNetworkAccess": "string",
    "raiMonitorConfig": {
      "adxStorageResourceId": "string",
      "identityClientId": "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 propiedad

AccountProperties

Nombre	Descripción	Valor
allowedFqdnList		string[]
amlWorkspace	Propiedades del área de trabajo de AML propiedad del usuario.	UserOwnedAmlWorkspace
apiProperties	Las propiedades de api de las API especiales.	ApiProperties
customSubDomainName	Nombre de subdominio opcional usado para la autenticación basada en tokens.	cuerda
disableLocalAuth		Bool
dynamicThrottlingEnabled	Marca para habilitar la limitación dinámica.	Bool
encriptación	Propiedades de cifrado para este recurso.	de cifrado
Ubicaciones	Configuración de varias regiones de la cuenta de Cognitive Services.	MultiRegionSettings
migrationToken	Token de migración de recursos.	cuerda
networkAcls	Colección de reglas que rigen la accesibilidad desde ubicaciones de red específicas.	NetworkRuleSet
publicNetworkAccess	Indica si se permite o no el acceso al punto de conexión público para esta cuenta.	'Deshabilitado' 'Habilitado'
raiMonitorConfig	Configuración de Cognitive Services Rai Monitor.	RaiMonitorConfig
restaurar		Bool
restrictOutboundNetworkAccess		Bool
userOwnedStorage	Las cuentas de almacenamiento de este recurso.	UserOwnedStorage []

AccountTags

Nombre	Descripción	Valor

ApiProperties

Nombre	Descripción	Valor
aadClientId	(Solo Metrics Advisor) Identificador de cliente de Azure AD (id. de aplicación).	cuerda Restricciones: Longitud máxima = 500
aadTenantId	(Solo Metrics Advisor) Identificador de inquilino de Azure AD.	cuerda Restricciones: Longitud máxima = 500
eventHubConnectionString	(Solo personalización) Marca para habilitar las estadísticas de Bing Search.	cuerda Restricciones: Longitud máxima = 1000 Patrón = `^( )Endpoint=sb://(.);( )SharedAccessKeyName=(.);( )SharedAccessKey=(.)$`
qnaAzureSearchEndpointId	(Solo QnAMaker) Identificador del punto de conexión de Azure Search de QnAMaker.	cuerda
qnaAzureSearchEndpointKey	(Solo QnAMaker) Clave de punto de conexión de Azure Search de QnAMaker.	cuerda
qnaRuntimeEndpoint	(Solo QnAMaker) Punto de conexión en tiempo de ejecución de QnAMaker.	cuerda
statisticsEnabled	(Solo Bing Search) Marca para habilitar las estadísticas de Bing Search.	Bool
storageAccountConnectionString	(Solo personalización) Cadena de conexión de la cuenta de almacenamiento.	cuerda Restricciones: Longitud máxima = 1000 Patrón = `^(( )DefaultEndpointsProtocol=(http\|https)( );( ))?AccountName=(.)AccountKey=(.)EndpointSuffix=(.)$`
superusuario	(Solo Metrics Advisor) Superusuario de Metrics Advisor.	cuerda Restricciones: Longitud máxima = 500
websiteName	(Solo Metrics Advisor) Nombre del sitio web de Metrics Advisor.	cuerda Restricciones: Longitud máxima = 500

Encriptación

Nombre	Descripción	Valor
keySource	Enumera el valor posible de keySource para el cifrado.	"Microsoft.CognitiveServices" "Microsoft.KeyVault"
keyVaultProperties	Propiedades de KeyVault	KeyVaultProperties

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Lista de identidades asignadas por el usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recurso de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre	Descripción	Valor

IpRule

Nombre	Descripción	Valor
valor	Intervalo de direcciones IPv4 en notación CIDR, como "124.56.78.91" (dirección IP simple) o "124.56.78.0/24" (todas las direcciones que comienzan por 124.56.78).	string (obligatorio)

KeyVaultProperties

Nombre	Descripción	Valor
identityClientId		cuerda
keyName	Nombre de la clave de KeyVault	cuerda
keyVaultUri	Uri de KeyVault	cuerda
keyVersion	Versión de la clave de KeyVault	cuerda

Microsoft.CognitiveServices/accounts

Nombre	Descripción	Valor
apiVersion	La versión de api	'2024-10-01'
identidad	Identidad del recurso.	Identity
amable	El tipo del recurso.	cuerda
ubicación	Ubicación geográfica donde reside el recurso	cuerda
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 2 Longitud máxima = 64 Patrón = `^[a-zA-Z0-9][a-zA-Z0-9_.-]*$` (obligatorio)
Propiedades	Propiedades de la cuenta de Cognitive Services.	AccountProperties
Sku	Definición del modelo de recursos que representa la SKU	Sku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	"Microsoft.CognitiveServices/accounts"

MultiRegionSettings

Nombre	Descripción	Valor
Regiones		RegionSetting[]
routingMethod	Métodos de enrutamiento de varias regiones.	"Rendimiento" 'Prioridad' 'Ponderado'

NetworkRuleSet

Nombre	Descripción	Valor
puentear	Configuración de servicios de confianza.	"AzureServices" 'Ninguno'
defaultAction	Acción predeterminada cuando no hay ninguna regla de ipRules y de virtualNetworkRules coinciden. Esto solo se usa después de evaluar la propiedad bypass.	'Permitir' 'Denegar'
ipRules	Lista de reglas de direcciones IP.	ipRule[]
virtualNetworkRules	Lista de reglas de red virtual.	virtualNetworkRule[]

RaiMonitorConfig

Nombre	Descripción	Valor
adxStorageResourceId	Identificador del recurso de almacenamiento.	cuerda
identityClientId	Identificador de cliente de identidad para acceder al almacenamiento.	cuerda

RegionSetting

Nombre	Descripción	Valor
customsubdomain	Asigna la región al subdominio personalizado regional.	cuerda
nombre	Nombre de la región.	cuerda
valor	Valor de los métodos de enrutamiento prioritarios o ponderados.	Int

Sku

Nombre	Descripción	Valor
capacidad	Si la SKU admite el escalado horizontal o horizontal, se debe incluir el entero de capacidad. Si no es posible escalar horizontalmente o reducir horizontalmente el recurso, se puede omitir.	Int
familia	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.	cuerda
nombre	Nombre de la SKU. Por ejemplo, P3. Normalmente es un código de letra y número	string (obligatorio)
tamaño	Tamaño de la SKU. Cuando el campo de nombre es la combinación de nivel y otro valor, este sería el código independiente.	cuerda
nivel	El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put.	"Básico" "Enterprise" "Gratis" 'Premium' 'Estándar'

UserAssignedIdentity

Nombre	Descripción	Valor

UserOwnedAmlWorkspace

Nombre	Descripción	Valor
identityClientId	Identificador de cliente de identidad de un recurso de área de trabajo de AML.	cuerda
resourceId	Identificador de recurso completo de un recurso de área de trabajo de AML.	cuerda

UserOwnedStorage

Nombre	Descripción	Valor
identityClientId		cuerda
resourceId	Identificador de recurso completo de un recurso de Microsoft.Storage.	cuerda

VirtualNetworkRule

Nombre	Descripción	Valor
identificación	Identificador de recurso completo de una subred de red virtual, como "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1".	string (obligatorio)
ignoreMissingVnetServiceEndpoint	Omita el punto de conexión de servicio de red virtual que falta o no.	Bool
estado	Obtiene el estado de la regla de red virtual.	cuerda

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla	Descripción
configuración básica de Azure AI Studio	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
configuración básica de Azure AI Studio	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
configuración básica de Azure AI Studio	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
red restringida de Azure AI Studio Network	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con vínculo privado y salida deshabilitados, mediante claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
red restringida de Azure AI Studio Network	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con vínculo privado y salida deshabilitados, mediante claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
Azure AI Studio con la autenticación de id. de Entra de Microsoft	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la autenticación de id. de Entra de Microsoft para recursos dependientes, como Azure AI Services y Azure Storage.
claves de API de configuración básica del agente	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con la configuración básica mediante la autenticación de claves de API para la conexión del servicio de IA o AOAI. Los agentes usan recursos de almacenamiento y búsqueda multiinquilino totalmente administrados por Microsoft. No tendrá visibilidad ni control sobre estos recursos subyacentes de Azure.
de identidad de configuración básica del agente	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con la configuración básica mediante autenticación de identidad administrada para la conexión del servicio de IA/AOAI. Los agentes usan recursos de almacenamiento y búsqueda multiinquilino totalmente administrados por Microsoft. No tendrá visibilidad ni control sobre estos recursos subyacentes de Azure.
Implementación de un de recursos multiservicio de servicios de Azure AI	Esta plantilla implementa un recurso de servicios de Azure AI para que la inteligencia artificial llegue a todos los desarrolladores sin necesidad de experiencia en el aprendizaje automático. Todo lo que se necesita es una llamada API para insertar la capacidad de ver, escuchar, hablar, buscar, comprender y acelerar la toma de decisiones en las aplicaciones.
Implementación de un recurso de Azure AI Translator	Esta plantilla implementa un recurso de Azure AI Translator para que la inteligencia artificial llegue a todos los desarrolladores sin necesidad de experiencia en el aprendizaje automático.
Implementación de un recurso de Azure AI Vision	Esta plantilla implementa un recurso de Azure AI Vision para que la inteligencia artificial llegue a todos los desarrolladores sin necesidad de experiencia en el aprendizaje automático.
Implementación segura de Azure AI Studio con una red virtual administrada	Esta plantilla crea un entorno seguro de Azure AI Studio con restricciones sólidas de seguridad de red e identidad.
Agente protegido por red con identidad administrada de usuario	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con aislamiento de red virtual mediante autenticación de identidad administrada de usuario para la conexión del servicio de IA/AOAI y vínculos de red privada para conectar el agente a los datos seguros.
de configuración del agente estándar	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con la configuración estándar, lo que significa que con la autenticación de identidad administrada para conexiones de proyecto/centro y acceso a Internet público habilitado. Los agentes usan recursos de almacenamiento y búsqueda de un solo inquilino propiedad del cliente. Con esta configuración, tiene control total y visibilidad sobre estos recursos, pero incurrirá en costos en función del uso.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso accounts se puede implementar con operaciones destinadas a:

grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.CognitiveServices/accounts, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts@2024-10-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"
      ]
      amlWorkspace = {
        identityClientId = "string"
        resourceId = "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 = {
        bypass = "string"
        defaultAction = "string"
        ipRules = [
          {
            value = "string"
          }
        ]
        virtualNetworkRules = [
          {
            id = "string"
            ignoreMissingVnetServiceEndpoint = bool
            state = "string"
          }
        ]
      }
      publicNetworkAccess = "string"
      raiMonitorConfig = {
        adxStorageResourceId = "string"
        identityClientId = "string"
      }
      restore = bool
      restrictOutboundNetworkAccess = bool
      userOwnedStorage = [
        {
          identityClientId = "string"
          resourceId = "string"
        }
      ]
    }
  })
}

Valores de propiedad

AccountProperties

Nombre	Descripción	Valor
allowedFqdnList		string[]
amlWorkspace	Propiedades del área de trabajo de AML propiedad del usuario.	UserOwnedAmlWorkspace
apiProperties	Las propiedades de api de las API especiales.	ApiProperties
customSubDomainName	Nombre de subdominio opcional usado para la autenticación basada en tokens.	cuerda
disableLocalAuth		Bool
dynamicThrottlingEnabled	Marca para habilitar la limitación dinámica.	Bool
encriptación	Propiedades de cifrado para este recurso.	de cifrado
Ubicaciones	Configuración de varias regiones de la cuenta de Cognitive Services.	MultiRegionSettings
migrationToken	Token de migración de recursos.	cuerda
networkAcls	Colección de reglas que rigen la accesibilidad desde ubicaciones de red específicas.	NetworkRuleSet
publicNetworkAccess	Indica si se permite o no el acceso al punto de conexión público para esta cuenta.	'Deshabilitado' 'Habilitado'
raiMonitorConfig	Configuración de Cognitive Services Rai Monitor.	RaiMonitorConfig
restaurar		Bool
restrictOutboundNetworkAccess		Bool
userOwnedStorage	Las cuentas de almacenamiento de este recurso.	UserOwnedStorage []

AccountTags

Nombre	Descripción	Valor

ApiProperties

Nombre	Descripción	Valor
aadClientId	(Solo Metrics Advisor) Identificador de cliente de Azure AD (id. de aplicación).	cuerda Restricciones: Longitud máxima = 500
aadTenantId	(Solo Metrics Advisor) Identificador de inquilino de Azure AD.	cuerda Restricciones: Longitud máxima = 500
eventHubConnectionString	(Solo personalización) Marca para habilitar las estadísticas de Bing Search.	cuerda Restricciones: Longitud máxima = 1000 Patrón = `^( )Endpoint=sb://(.);( )SharedAccessKeyName=(.);( )SharedAccessKey=(.)$`
qnaAzureSearchEndpointId	(Solo QnAMaker) Identificador del punto de conexión de Azure Search de QnAMaker.	cuerda
qnaAzureSearchEndpointKey	(Solo QnAMaker) Clave de punto de conexión de Azure Search de QnAMaker.	cuerda
qnaRuntimeEndpoint	(Solo QnAMaker) Punto de conexión en tiempo de ejecución de QnAMaker.	cuerda
statisticsEnabled	(Solo Bing Search) Marca para habilitar las estadísticas de Bing Search.	Bool
storageAccountConnectionString	(Solo personalización) Cadena de conexión de la cuenta de almacenamiento.	cuerda Restricciones: Longitud máxima = 1000 Patrón = `^(( )DefaultEndpointsProtocol=(http\|https)( );( ))?AccountName=(.)AccountKey=(.)EndpointSuffix=(.)$`
superusuario	(Solo Metrics Advisor) Superusuario de Metrics Advisor.	cuerda Restricciones: Longitud máxima = 500
websiteName	(Solo Metrics Advisor) Nombre del sitio web de Metrics Advisor.	cuerda Restricciones: Longitud máxima = 500

Encriptación

Nombre	Descripción	Valor
keySource	Enumera el valor posible de keySource para el cifrado.	"Microsoft.CognitiveServices" "Microsoft.KeyVault"
keyVaultProperties	Propiedades de KeyVault	KeyVaultProperties

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Lista de identidades asignadas por el usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recurso de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre	Descripción	Valor

IpRule

Nombre	Descripción	Valor
valor	Intervalo de direcciones IPv4 en notación CIDR, como "124.56.78.91" (dirección IP simple) o "124.56.78.0/24" (todas las direcciones que comienzan por 124.56.78).	string (obligatorio)

KeyVaultProperties

Nombre	Descripción	Valor
identityClientId		cuerda
keyName	Nombre de la clave de KeyVault	cuerda
keyVaultUri	Uri de KeyVault	cuerda
keyVersion	Versión de la clave de KeyVault	cuerda

Microsoft.CognitiveServices/accounts

Nombre	Descripción	Valor
identidad	Identidad del recurso.	Identity
amable	El tipo del recurso.	cuerda
ubicación	Ubicación geográfica donde reside el recurso	cuerda
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 2 Longitud máxima = 64 Patrón = `^[a-zA-Z0-9][a-zA-Z0-9_.-]*$` (obligatorio)
Propiedades	Propiedades de la cuenta de Cognitive Services.	AccountProperties
Sku	Definición del modelo de recursos que representa la SKU	Sku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.CognitiveServices/accounts@2024-10-01"

MultiRegionSettings

Nombre	Descripción	Valor
Regiones		RegionSetting[]
routingMethod	Métodos de enrutamiento de varias regiones.	"Rendimiento" 'Prioridad' 'Ponderado'

NetworkRuleSet

Nombre	Descripción	Valor
puentear	Configuración de servicios de confianza.	"AzureServices" 'Ninguno'
defaultAction	Acción predeterminada cuando no hay ninguna regla de ipRules y de virtualNetworkRules coinciden. Esto solo se usa después de evaluar la propiedad bypass.	'Permitir' 'Denegar'
ipRules	Lista de reglas de direcciones IP.	ipRule[]
virtualNetworkRules	Lista de reglas de red virtual.	virtualNetworkRule[]

RaiMonitorConfig

Nombre	Descripción	Valor
adxStorageResourceId	Identificador del recurso de almacenamiento.	cuerda
identityClientId	Identificador de cliente de identidad para acceder al almacenamiento.	cuerda

RegionSetting

Nombre	Descripción	Valor
customsubdomain	Asigna la región al subdominio personalizado regional.	cuerda
nombre	Nombre de la región.	cuerda
valor	Valor de los métodos de enrutamiento prioritarios o ponderados.	Int

Sku

Nombre	Descripción	Valor
capacidad	Si la SKU admite el escalado horizontal o horizontal, se debe incluir el entero de capacidad. Si no es posible escalar horizontalmente o reducir horizontalmente el recurso, se puede omitir.	Int
familia	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.	cuerda
nombre	Nombre de la SKU. Por ejemplo, P3. Normalmente es un código de letra y número	string (obligatorio)
tamaño	Tamaño de la SKU. Cuando el campo de nombre es la combinación de nivel y otro valor, este sería el código independiente.	cuerda
nivel	El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put.	"Básico" "Enterprise" "Gratis" 'Premium' 'Estándar'

UserAssignedIdentity

Nombre	Descripción	Valor

UserOwnedAmlWorkspace

Nombre	Descripción	Valor
identityClientId	Identificador de cliente de identidad de un recurso de área de trabajo de AML.	cuerda
resourceId	Identificador de recurso completo de un recurso de área de trabajo de AML.	cuerda

UserOwnedStorage

Nombre	Descripción	Valor
identityClientId		cuerda
resourceId	Identificador de recurso completo de un recurso de Microsoft.Storage.	cuerda

VirtualNetworkRule

Nombre	Descripción	Valor
identificación	Identificador de recurso completo de una subred de red virtual, como "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1".	string (obligatorio)
ignoreMissingVnetServiceEndpoint	Omita el punto de conexión de servicio de red virtual que falta o no.	Bool
estado	Obtiene el estado de la regla de red virtual.	cuerda

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo	Descripción
Cognitive Service	Módulo de recursos de AVM para la cuenta de Cognitive Services ( Open AI)

Compartir a través de

Cuentas de Microsoft.CognitiveServices

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

AccountProperties

AccountTags

ApiProperties

Encriptación

Identidad

IdentityUserAssignedIdentities

IpRule

KeyVaultProperties

Microsoft.CognitiveServices/accounts

MultiRegionSettings

NetworkRuleSet

RaiMonitorConfig

RegionSetting

Sku

UserAssignedIdentity

UserOwnedAmlWorkspace

UserOwnedStorage

VirtualNetworkRule

Ejemplos de uso

Módulos comprobados de Azure

Ejemplos de inicio rápido de Azure

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

AccountProperties

AccountTags

ApiProperties

Encriptación

Identidad

IdentityUserAssignedIdentities

IpRule

KeyVaultProperties

Microsoft.CognitiveServices/accounts

MultiRegionSettings

NetworkRuleSet

RaiMonitorConfig

RegionSetting

Sku

UserAssignedIdentity

UserOwnedAmlWorkspace

UserOwnedStorage

VirtualNetworkRule

Ejemplos de uso

Plantillas de inicio rápido de Azure

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

AccountProperties

AccountTags

ApiProperties

Encriptación

Identidad

IdentityUserAssignedIdentities

IpRule

KeyVaultProperties

Microsoft.CognitiveServices/accounts

MultiRegionSettings

NetworkRuleSet

RaiMonitorConfig

RegionSetting

Sku

UserAssignedIdentity

UserOwnedAmlWorkspace

UserOwnedStorage

VirtualNetworkRule

Ejemplos de uso

Módulos comprobados de Azure

Comentarios

Recursos adicionales