Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Definición de recursos de Bicep
El tipo de recurso accounts/deployments 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/deployments, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2023-10-01-preview' = {
parent: resourceSymbolicName
name: 'string'
properties: {
capacitySettings: {
designatedCapacity: int
priority: int
}
currentCapacity: int
model: {
format: 'string'
name: 'string'
source: 'string'
version: 'string'
}
raiPolicyName: 'string'
scaleSettings: {
capacity: int
scaleType: '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 |
| fuente | Opcional. Id. de recurso de ARM de origen del modelo de implementación. | 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 |
| modelo | Propiedades del modelo de implementación de cuentas de Cognitive Services. | deploymentModel de |
| 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). | |
| 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:
- 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/deployments, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.CognitiveServices/accounts/deployments",
"apiVersion": "2023-10-01-preview",
"name": "string",
"properties": {
"capacitySettings": {
"designatedCapacity": "int",
"priority": "int"
},
"currentCapacity": "int",
"model": {
"format": "string",
"name": "string",
"source": "string",
"version": "string"
},
"raiPolicyName": "string",
"scaleSettings": {
"capacity": "int",
"scaleType": "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 | '2023-10-01-preestreno' |
| 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 |
| fuente | Opcional. Id. de recurso de ARM de origen del modelo de implementación. | 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 |
| modelo | Propiedades del modelo de implementación de cuentas de Cognitive Services. | deploymentModel de |
| 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). | |
| 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:
- 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/deployments, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.CognitiveServices/accounts/deployments@2023-10-01-preview"
name = "string"
parent_id = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
capacitySettings = {
designatedCapacity = int
priority = int
}
currentCapacity = int
model = {
format = "string"
name = "string"
source = "string"
version = "string"
}
raiPolicyName = "string"
scaleSettings = {
capacity = int
scaleType = "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@2023-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 |
| fuente | Opcional. Id. de recurso de ARM de origen del modelo de implementación. | 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 |
| modelo | Propiedades del modelo de implementación de cuentas de Cognitive Services. | deploymentModel de |
| 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). | |
| 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' |