Compartir a través de


Cuentas de Microsoft.CognitiveServices

Definición de recursos de Bicep

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

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 =
aadTenantId (Solo Metrics Advisor) Identificador de inquilino de Azure AD. cuerda

Restricciones:
Longitud máxima =
eventHubConnectionString (Solo personalización) Marca para habilitar las estadísticas de Bing Search. cuerda

Restricciones:
Longitud máxima =
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 =
Patrón = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$
superusuario (Solo Metrics Advisor) Superusuario de Metrics Advisor. cuerda

Restricciones:
Longitud máxima =
websiteName (Solo Metrics Advisor) Nombre del sitio web de Metrics Advisor. cuerda

Restricciones:
Longitud máxima =

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 = 2
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 inicio rápido

En los ejemplos de inicio rápido siguientes se implementa 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.
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.

Definición de recursos de plantilla de ARM

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

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 =
aadTenantId (Solo Metrics Advisor) Identificador de inquilino de Azure AD. cuerda

Restricciones:
Longitud máxima =
eventHubConnectionString (Solo personalización) Marca para habilitar las estadísticas de Bing Search. cuerda

Restricciones:
Longitud máxima =
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 =
Patrón = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$
superusuario (Solo Metrics Advisor) Superusuario de Metrics Advisor. cuerda

Restricciones:
Longitud máxima =
websiteName (Solo Metrics Advisor) Nombre del sitio web de Metrics Advisor. cuerda

Restricciones:
Longitud máxima =

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 = 2
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

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
configuración básica de Azure AI Studio

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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.
Implementación de un de recursos multiservicio de servicios de Azure AI

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
Esta plantilla crea un entorno seguro de Azure AI Studio con restricciones sólidas de seguridad de red e identidad.

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 =
aadTenantId (Solo Metrics Advisor) Identificador de inquilino de Azure AD. cuerda

Restricciones:
Longitud máxima =
eventHubConnectionString (Solo personalización) Marca para habilitar las estadísticas de Bing Search. cuerda

Restricciones:
Longitud máxima =
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 =
Patrón = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$
superusuario (Solo Metrics Advisor) Superusuario de Metrics Advisor. cuerda

Restricciones:
Longitud máxima =
websiteName (Solo Metrics Advisor) Nombre del sitio web de Metrics Advisor. cuerda

Restricciones:
Longitud máxima =

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 = 2
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