Cuentas o implementaciones de Microsoft.CognitiveServices

• Más reciente
• 2025-10-01-vista previa
• 2025-09-01
• 2025-07-01-preview
• 2025-06-01
• 2025-04-01-vista previa
• 2024-10-01
• 2024-06-01-vista previa
• 2024-04-01-vista previa
• 2023-10-01-vista previa
• 2023-05-01
• 2022-12-01
• 2022-10-01
• 2022-03-01
• 2021-10-01

Definición de recursos de Bicep

El tipo de recurso accounts/deployments 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/deployments, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2025-10-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    capacitySettings: {
      designatedCapacity: int
      priority: int
    }
    currentCapacity: int
    deploymentState: 'string'
    model: {
      format: 'string'
      name: 'string'
      publisher: 'string'
      source: 'string'
      sourceAccount: 'string'
      version: 'string'
    }
    parentDeploymentName: 'string'
    raiPolicyName: 'string'
    scaleSettings: {
      capacity: int
      scaleType: 'string'
    }
    serviceTier: 'string'
    spilloverDeploymentName: 'string'
    versionUpgradeOption: 'string'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

Microsoft.CognitiveServices/accounts/deployments

Nombre	Descripción	Importancia
nombre	El nombre del recurso	string (obligatorio)
padre	En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para obtener más información, consulte recurso secundario fuera del recurso primario.	Nombre simbólico del recurso de tipo: cuentas
Propiedades	Propiedades de la implementación de la cuenta de Cognitive Services.	DeploymentProperties
código SKU	Definición del modelo de recursos que representa la SKU	Sku
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

DeploymentCapacitySettings

Nombre	Descripción	Importancia
designadoCapacity	Capacidad designada.	Int Restricciones: Valor mínimo = 0
prioridad	Prioridad de esta configuración de capacidad.	Int Restricciones: Valor mínimo = 0

Modelo de implementación

Nombre	Descripción	Importancia
formato	Formato del modelo de implementación.	cuerda / cadena
nombre	Nombre del modelo de implementación.	cuerda / cadena
editor	Publicador de modelos de implementación.	cuerda / cadena
fuente	Opcional. Id. de recurso de ARM de origen del modelo de implementación.	cuerda / cadena
sourceAccount	Opcional. Origen del modelo, otro identificador de recurso de ARM de cuentas de Microsoft.CognitiveServices.	cuerda / cadena
Versión	Opcional. Versión del modelo de implementación. Si no se especifica la versión, se asignará una versión predeterminada. La versión predeterminada es diferente para diferentes modelos y puede cambiar cuando hay una nueva versión disponible para un modelo. La versión predeterminada de un modelo se puede encontrar en la API de modelos de lista.	cuerda / cadena

DeploymentProperties

Nombre	Descripción	Importancia
capacitySettings	Solo uso interno.	DeploymentCapacitySettings
currentCapacity	Capacidad actual.	Int
deploymentState	El estado de la implementación. Controla si la implementación acepta solicitudes de inferencia. Use "En ejecución" para implementaciones activas que procesan solicitudes o "En pausa" para detener temporalmente la inferencia mientras se conserva la configuración de implementación.	'Pausado' 'Running'
modelo	Propiedades del modelo de implementación de cuentas de Cognitive Services.	deploymentModel de
parentDeploymentName	Nombre de la implementación primaria.	cuerda / cadena
raiPolicyName	Nombre de la directiva RAI.	cuerda / cadena
scaleSettings	Propiedades del modelo de implementación de cuentas de Cognitive Services. (En desuso, use Deployment.sku en su lugar).	DeploymentScaleSettings
serviceTier	Nivel de servicio de la implementación. Determina el precio y el nivel de rendimiento para el procesamiento de solicitudes. Use "Predeterminado" para precios estándar o "Prioridad" para procesamiento de mayor prioridad con precios premium. Nota: Las operaciones de pausa solo se admiten en SKU Standard, DataZoneStandard y GlobalStandard.	'Default' 'Prioridad'
spilloverDeploymentName	Especifica el nombre de implementación que debe atender las solicitudes cuando, de otro modo, la solicitud se habría limitado debido a que se alcanzó el límite de rendimiento de implementación actual.	cuerda / cadena
opción de actualización de versión	Opción de actualización de la versión del modelo de implementación.	'NoAutoUpgrade' 'OnceCurrentVersionExpired' 'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings

Nombre	Descripción	Importancia
capacidad	Capacidad de implementación.	Int
scaleType	Tipo de escala de implementación.	'Manual' 'Estándar'

DeploymentTags

Nombre	Descripción	Importancia

SKU

Nombre	Descripción	Importancia
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 / cadena
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 / cadena
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'

Ejemplos de uso

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
Claves básicas de API de configuración 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.
Identidad básica del programa de instalación 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.
Implemente Secure AI Foundry con una red virtual administrada	Esta plantilla crea un entorno seguro de Azure AI Foundry con sólidas restricciones 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.
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/deployments 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/deployments, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.CognitiveServices/accounts/deployments",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "properties": {
    "capacitySettings": {
      "designatedCapacity": "int",
      "priority": "int"
    },
    "currentCapacity": "int",
    "deploymentState": "string",
    "model": {
      "format": "string",
      "name": "string",
      "publisher": "string",
      "source": "string",
      "sourceAccount": "string",
      "version": "string"
    },
    "parentDeploymentName": "string",
    "raiPolicyName": "string",
    "scaleSettings": {
      "capacity": "int",
      "scaleType": "string"
    },
    "serviceTier": "string",
    "spilloverDeploymentName": "string",
    "versionUpgradeOption": "string"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

Microsoft.CognitiveServices/accounts/deployments

Nombre	Descripción	Importancia
apiVersion	La versión de api	'2025-10-01-preview'
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades de la implementación de la cuenta de Cognitive Services.	DeploymentProperties
código SKU	Definición del modelo de recursos que representa la SKU	Sku
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	"Microsoft.CognitiveServices/accounts/deployments"

DeploymentCapacitySettings

Nombre	Descripción	Importancia
designadoCapacity	Capacidad designada.	Int Restricciones: Valor mínimo = 0
prioridad	Prioridad de esta configuración de capacidad.	Int Restricciones: Valor mínimo = 0

Modelo de implementación

Nombre	Descripción	Importancia
formato	Formato del modelo de implementación.	cuerda / cadena
nombre	Nombre del modelo de implementación.	cuerda / cadena
editor	Publicador de modelos de implementación.	cuerda / cadena
fuente	Opcional. Id. de recurso de ARM de origen del modelo de implementación.	cuerda / cadena
sourceAccount	Opcional. Origen del modelo, otro identificador de recurso de ARM de cuentas de Microsoft.CognitiveServices.	cuerda / cadena
Versión	Opcional. Versión del modelo de implementación. Si no se especifica la versión, se asignará una versión predeterminada. La versión predeterminada es diferente para diferentes modelos y puede cambiar cuando hay una nueva versión disponible para un modelo. La versión predeterminada de un modelo se puede encontrar en la API de modelos de lista.	cuerda / cadena

DeploymentProperties

Nombre	Descripción	Importancia
capacitySettings	Solo uso interno.	DeploymentCapacitySettings
currentCapacity	Capacidad actual.	Int
deploymentState	El estado de la implementación. Controla si la implementación acepta solicitudes de inferencia. Use "En ejecución" para implementaciones activas que procesan solicitudes o "En pausa" para detener temporalmente la inferencia mientras se conserva la configuración de implementación.	'Pausado' 'Running'
modelo	Propiedades del modelo de implementación de cuentas de Cognitive Services.	deploymentModel de
parentDeploymentName	Nombre de la implementación primaria.	cuerda / cadena
raiPolicyName	Nombre de la directiva RAI.	cuerda / cadena
scaleSettings	Propiedades del modelo de implementación de cuentas de Cognitive Services. (En desuso, use Deployment.sku en su lugar).	DeploymentScaleSettings
serviceTier	Nivel de servicio de la implementación. Determina el precio y el nivel de rendimiento para el procesamiento de solicitudes. Use "Predeterminado" para precios estándar o "Prioridad" para procesamiento de mayor prioridad con precios premium. Nota: Las operaciones de pausa solo se admiten en SKU Standard, DataZoneStandard y GlobalStandard.	'Default' 'Prioridad'
spilloverDeploymentName	Especifica el nombre de implementación que debe atender las solicitudes cuando, de otro modo, la solicitud se habría limitado debido a que se alcanzó el límite de rendimiento de implementación actual.	cuerda / cadena
opción de actualización de versión	Opción de actualización de la versión del modelo de implementación.	'NoAutoUpgrade' 'OnceCurrentVersionExpired' 'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings

Nombre	Descripción	Importancia
capacidad	Capacidad de implementación.	Int
scaleType	Tipo de escala de implementación.	'Manual' 'Estándar'

DeploymentTags

Nombre	Descripción	Importancia

SKU

Nombre	Descripción	Importancia
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 / cadena
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 / cadena
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'

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
Claves básicas de API de configuración 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.
Identidad básica del programa de instalación 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.
Implemente Secure AI Foundry con una red virtual administrada	Esta plantilla crea un entorno seguro de Azure AI Foundry con sólidas restricciones 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.
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/deployments 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/deployments, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts/deployments@2025-10-01-preview"
  name = "string"
  parent_id = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      capacitySettings = {
        designatedCapacity = int
        priority = int
      }
      currentCapacity = int
      deploymentState = "string"
      model = {
        format = "string"
        name = "string"
        publisher = "string"
        source = "string"
        sourceAccount = "string"
        version = "string"
      }
      parentDeploymentName = "string"
      raiPolicyName = "string"
      scaleSettings = {
        capacity = int
        scaleType = "string"
      }
      serviceTier = "string"
      spilloverDeploymentName = "string"
      versionUpgradeOption = "string"
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Valores de propiedad

Microsoft.CognitiveServices/accounts/deployments

Nombre	Descripción	Importancia
nombre	El nombre del recurso	string (obligatorio)
parent_id	Identificador del recurso que es el elemento primario de este recurso.	Identificador del recurso de tipo: cuentas
Propiedades	Propiedades de la implementación de la cuenta de Cognitive Services.	DeploymentProperties
código SKU	Definición del modelo de recursos que representa la SKU	Sku
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.CognitiveServices/accounts/deployments@2025-10-01-preview"

DeploymentCapacitySettings

Nombre	Descripción	Importancia
designadoCapacity	Capacidad designada.	Int Restricciones: Valor mínimo = 0
prioridad	Prioridad de esta configuración de capacidad.	Int Restricciones: Valor mínimo = 0

Modelo de implementación

Nombre	Descripción	Importancia
formato	Formato del modelo de implementación.	cuerda / cadena
nombre	Nombre del modelo de implementación.	cuerda / cadena
editor	Publicador de modelos de implementación.	cuerda / cadena
fuente	Opcional. Id. de recurso de ARM de origen del modelo de implementación.	cuerda / cadena
sourceAccount	Opcional. Origen del modelo, otro identificador de recurso de ARM de cuentas de Microsoft.CognitiveServices.	cuerda / cadena
Versión	Opcional. Versión del modelo de implementación. Si no se especifica la versión, se asignará una versión predeterminada. La versión predeterminada es diferente para diferentes modelos y puede cambiar cuando hay una nueva versión disponible para un modelo. La versión predeterminada de un modelo se puede encontrar en la API de modelos de lista.	cuerda / cadena

DeploymentProperties

Nombre	Descripción	Importancia
capacitySettings	Solo uso interno.	DeploymentCapacitySettings
currentCapacity	Capacidad actual.	Int
deploymentState	El estado de la implementación. Controla si la implementación acepta solicitudes de inferencia. Use "En ejecución" para implementaciones activas que procesan solicitudes o "En pausa" para detener temporalmente la inferencia mientras se conserva la configuración de implementación.	'Pausado' 'Running'
modelo	Propiedades del modelo de implementación de cuentas de Cognitive Services.	deploymentModel de
parentDeploymentName	Nombre de la implementación primaria.	cuerda / cadena
raiPolicyName	Nombre de la directiva RAI.	cuerda / cadena
scaleSettings	Propiedades del modelo de implementación de cuentas de Cognitive Services. (En desuso, use Deployment.sku en su lugar).	DeploymentScaleSettings
serviceTier	Nivel de servicio de la implementación. Determina el precio y el nivel de rendimiento para el procesamiento de solicitudes. Use "Predeterminado" para precios estándar o "Prioridad" para procesamiento de mayor prioridad con precios premium. Nota: Las operaciones de pausa solo se admiten en SKU Standard, DataZoneStandard y GlobalStandard.	'Default' 'Prioridad'
spilloverDeploymentName	Especifica el nombre de implementación que debe atender las solicitudes cuando, de otro modo, la solicitud se habría limitado debido a que se alcanzó el límite de rendimiento de implementación actual.	cuerda / cadena
opción de actualización de versión	Opción de actualización de la versión del modelo de implementación.	'NoAutoUpgrade' 'OnceCurrentVersionExpired' 'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings

Nombre	Descripción	Importancia
capacidad	Capacidad de implementación.	Int
scaleType	Tipo de escala de implementación.	'Manual' 'Estándar'

DeploymentTags

Nombre	Descripción	Importancia

SKU

Nombre	Descripción	Importancia
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 / cadena
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 / cadena
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'

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de la implementación de cuentas de Cognitive Services.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0003"
}

variable "location" {
  type    = string
  default = "eastus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "account" {
  type      = "Microsoft.CognitiveServices/accounts@2022-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location

  body = {
    identity = {
      type                   = "None"
      userAssignedIdentities = null
    }
    kind = "OpenAI"
    properties = {
      disableLocalAuth              = false
      dynamicThrottlingEnabled      = false
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = false
    }
    sku = {
      name = "S0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "deployment" {
  type      = "Microsoft.CognitiveServices/accounts/deployments@2023-05-01"
  name      = "testdep"
  parent_id = azapi_resource.account.id
  body = {
    properties = {
      model = {
        format = "OpenAI"
        name   = "text-embedding-ada-002"
      }
    }
  }
}