Deployments - Create Or Update
Actualice el estado de las implementaciones especificadas asociadas a la cuenta de Cognitive Services.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}?api-version=2024-10-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string minLength: 2maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ |
Nombre de la cuenta de Cognitive Services. |
deployment
|
path | True |
string |
Nombre de la implementación asociada a la cuenta de Cognitive Services |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas. |
subscription
|
path | True |
string minLength: 1 |
Identificador de la suscripción de destino. |
api-version
|
query | True |
string minLength: 1 |
Versión de la API que se va a usar para esta operación. |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
properties |
Propiedades de la implementación de la cuenta de Cognitive Services. |
|
sku |
Definición del modelo de recursos que representa la SKU |
|
tags |
object |
Etiquetas de recursos. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Cree o actualice correctamente la implementación. |
|
201 Created |
Cree correctamente la implementación. |
|
Other Status Codes |
Respuesta de error que describe por qué se produjo un error en la operación. |
Ejemplos
PutDeployment
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.CognitiveServices/accounts/accountName/deployments/deploymentName?api-version=2024-10-01
{
"sku": {
"name": "Standard",
"capacity": 1
},
"properties": {
"model": {
"format": "OpenAI",
"name": "ada",
"version": "1"
}
}
}
Respuesta de muestra
{
"id": "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.CognitiveServices/accounts/accountName/deployments/deploymentName",
"name": "deploymentName",
"type": "Microsoft.CognitiveServices/accounts/deployments",
"sku": {
"name": "Standard",
"capacity": 1
},
"properties": {
"model": {
"format": "OpenAI",
"name": "ada",
"version": "1"
},
"provisioningState": "Succeeded"
}
}
{
"id": "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.CognitiveServices/accounts/accountName/deployments/deploymentName",
"name": "deploymentName",
"type": "Microsoft.CognitiveServices/accounts/deployments",
"sku": {
"name": "Standard",
"capacity": 1
},
"properties": {
"model": {
"format": "OpenAI",
"name": "ada",
"version": "1"
},
"provisioningState": "Accepted"
}
}
Definiciones
Nombre | Description |
---|---|
Call |
La cuenta de Cognitive Services limita la tasa de llamadas. |
created |
Tipo de identidad que creó el recurso. |
Deployment |
Implementación de la cuenta de Cognitive Services. |
Deployment |
Solo uso interno. |
Deployment |
Propiedades del modelo de implementación de cuentas de Cognitive Services. |
Deployment |
Opción de actualización de la versión del modelo de implementación. |
Deployment |
Propiedades de la implementación de la cuenta de Cognitive Services. |
Deployment |
Obtiene el estado del recurso en el momento en que se llamó a la operación. |
Deployment |
Propiedades del modelo de implementación de cuentas de Cognitive Services. (En desuso, use Deployment.sku en su lugar). |
Deployment |
Tipo de escala de implementación. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Request |
|
Sku |
Definición del modelo de recursos que representa la SKU |
Sku |
El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put. |
system |
Metadatos relativos a la creación y última modificación del recurso. |
Throttling |
CallRateLimit
La cuenta de Cognitive Services limita la tasa de llamadas.
Nombre | Tipo | Description |
---|---|---|
count |
number |
Valor de recuento del límite de frecuencia de llamadas. |
renewalPeriod |
number |
Período de renovación en segundos del límite de frecuencia de llamadas. |
rules |
createdByType
Tipo de identidad que creó el recurso.
Valor | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
Deployment
Implementación de la cuenta de Cognitive Services.
Nombre | Tipo | Description |
---|---|---|
etag |
string |
Etag de recursos. |
id |
string |
Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nombre del recurso |
properties |
Propiedades de la implementación de la cuenta de Cognitive Services. |
|
sku |
Definición del modelo de recursos que representa la SKU |
|
systemData |
Metadatos relativos a la creación y última modificación del recurso. |
|
tags |
object |
Etiquetas de recursos. |
type |
string |
Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
DeploymentCapacitySettings
Solo uso interno.
Nombre | Tipo | Description |
---|---|---|
designatedCapacity |
integer (int32) minimum: 0 |
Capacidad designada. |
priority |
integer (int32) minimum: 0 |
Prioridad de esta configuración de capacidad. |
DeploymentModel
Propiedades del modelo de implementación de cuentas de Cognitive Services.
Nombre | Tipo | Description |
---|---|---|
callRateLimit |
La cuenta de Cognitive Services limita la tasa de llamadas. |
|
format |
string |
Formato del modelo de implementación. |
name |
string |
Nombre del modelo de implementación. |
publisher |
string |
Publicador de modelos de implementación. |
source |
string |
Opcional. Id. de recurso de ARM de origen del modelo de implementación. |
sourceAccount |
string (arm-id) |
Opcional. Origen del modelo, otro identificador de recurso de ARM de cuentas de Microsoft.CognitiveServices. |
version |
string |
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. |
DeploymentModelVersionUpgradeOption
Opción de actualización de la versión del modelo de implementación.
Valor | Description |
---|---|
NoAutoUpgrade | |
OnceCurrentVersionExpired | |
OnceNewDefaultVersionAvailable |
DeploymentProperties
Propiedades de la implementación de la cuenta de Cognitive Services.
Nombre | Tipo | Description |
---|---|---|
callRateLimit |
La cuenta de Cognitive Services limita la tasa de llamadas. |
|
capabilities |
object |
Las funcionalidades. |
capacitySettings |
Solo uso interno. |
|
currentCapacity |
integer (int32) |
Capacidad actual. |
dynamicThrottlingEnabled |
boolean |
Si la limitación dinámica está habilitada. |
model |
Propiedades del modelo de implementación de cuentas de Cognitive Services. |
|
parentDeploymentName |
string |
Nombre de la implementación primaria. |
provisioningState |
Obtiene el estado del recurso en el momento en que se llamó a la operación. |
|
raiPolicyName |
string |
Nombre de la directiva RAI. |
rateLimits | ||
scaleSettings |
Propiedades del modelo de implementación de cuentas de Cognitive Services. (En desuso, use Deployment.sku en su lugar). |
|
versionUpgradeOption |
Opción de actualización de la versión del modelo de implementación. |
DeploymentProvisioningState
Obtiene el estado del recurso en el momento en que se llamó a la operación.
Valor | Description |
---|---|
Accepted | |
Canceled | |
Creating | |
Deleting | |
Disabled | |
Failed | |
Moving | |
Succeeded |
DeploymentScaleSettings
Propiedades del modelo de implementación de cuentas de Cognitive Services. (En desuso, use Deployment.sku en su lugar).
Nombre | Tipo | Description |
---|---|---|
activeCapacity |
integer (int32) |
Capacidad activa de implementación. Este valor puede ser diferente de |
capacity |
integer (int32) |
Capacidad de implementación. |
scaleType |
Tipo de escala de implementación. |
DeploymentScaleType
Tipo de escala de implementación.
Valor | Description |
---|---|
Manual | |
Standard |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
Mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
RequestMatchPattern
Nombre | Tipo | Description |
---|---|---|
method |
string |
|
path |
string |
Sku
Definición del modelo de recursos que representa la SKU
Nombre | Tipo | Description |
---|---|---|
capacity |
integer (int32) |
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. |
family |
string |
Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. |
name |
string |
Nombre de la SKU. Por ejemplo, P3. Normalmente es un código de letra y número |
size |
string |
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. |
tier |
El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put. |
SkuTier
El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put.
Valor | Description |
---|---|
Basic | |
Enterprise | |
Free | |
Premium | |
Standard |
systemData
Metadatos relativos a la creación y última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string (date-time) |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string (date-time) |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
ThrottlingRule
Nombre | Tipo | Description |
---|---|---|
count |
number |
|
dynamicThrottlingEnabled |
boolean |
|
key |
string |
|
matchPatterns | ||
minCount |
number |
|
renewalPeriod |
number |