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=2023-05-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nombre de la cuenta de Cognitive Services. Regex pattern: |
deployment
|
path | True |
string |
Nombre de la implementación asociada a la cuenta de Cognitive Services |
resource
|
path | True |
string |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
subscription
|
path | True |
string |
Identificador de la suscripción de destino. |
api-version
|
query | True |
string |
Versión de API que se usará para la 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 |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Cree o actualice correctamente la implementación. |
|
201 Created |
Cree la implementación correctamente. |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
Ejemplos
PutDeployment
Sample Request
PUT https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.CognitiveServices/accounts/accountName/deployments/deploymentName?api-version=2023-05-01
{
"sku": {
"name": "Standard",
"capacity": 1
},
"properties": {
"model": {
"format": "OpenAI",
"name": "ada",
"version": "1"
}
}
}
Sample Response
{
"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 |
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. |
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 relacionados con la creación y la última modificación del recurso. |
Throttling |
CallRateLimit
La cuenta de Cognitive Services limita la tasa de llamadas.
Nombre | Tipo | Description |
---|---|---|
count |
number |
El valor de recuento del límite de frecuencia de llamadas. |
renewalPeriod |
number |
El período de renovación en segundos del límite de frecuencia de llamadas. |
rules |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Deployment
Implementación de la cuenta de Cognitive Services.
Nombre | Tipo | Description |
---|---|---|
etag |
string |
Etag de recursos. |
id |
string |
Identificador de recurso completo del 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 relacionados con la creación y la última modificación del recurso. |
|
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
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. |
source |
string |
Opcional. Id. de recurso de ARM de origen del modelo de implementación. |
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 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.
Nombre | Tipo | Description |
---|---|---|
NoAutoUpgrade |
string |
|
OnceCurrentVersionExpired |
string |
|
OnceNewDefaultVersionAvailable |
string |
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. |
model |
Propiedades del modelo de implementación de cuentas de Cognitive Services. |
|
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. |
|
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.
Nombre | Tipo | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
Failed |
string |
|
Moving |
string |
|
Succeeded |
string |
DeploymentScaleSettings
Propiedades del modelo de implementación de cuentas de Cognitive Services.
Nombre | Tipo | Description |
---|---|---|
activeCapacity |
integer |
Capacidad activa de implementación. Este valor puede ser diferente de |
capacity |
integer |
Capacidad de implementación. |
scaleType |
Tipo de escala de implementación. |
DeploymentScaleType
Tipo de escala de implementación.
Nombre | Tipo | Description |
---|---|---|
Manual |
string |
|
Standard |
string |
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 |
Los detalles del error. |
|
message |
string |
El 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 |
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 |
El 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 algún 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.
Nombre | Tipo | Description |
---|---|---|
Basic |
string |
|
Enterprise |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
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 |
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 |