Compartir a través de


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
accountName
path True

string

minLength: 2
maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$

Nombre de la cuenta de Cognitive Services.

deploymentName
path True

string

Nombre de la implementación asociada a la cuenta de Cognitive Services

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.

subscriptionId
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

DeploymentProperties

Propiedades de la implementación de la cuenta de Cognitive Services.

sku

Sku

Definición del modelo de recursos que representa la SKU

tags

object

Etiquetas de recursos.

Respuestas

Nombre Tipo Description
200 OK

Deployment

Cree o actualice correctamente la implementación.

201 Created

Deployment

Cree correctamente la implementación.

Other Status Codes

ErrorResponse

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
CallRateLimit

La cuenta de Cognitive Services limita la tasa de llamadas.

createdByType

Tipo de identidad que creó el recurso.

Deployment

Implementación de la cuenta de Cognitive Services.

DeploymentCapacitySettings

Solo uso interno.

DeploymentModel

Propiedades del modelo de implementación de cuentas de Cognitive Services.

DeploymentModelVersionUpgradeOption

Opción de actualización de la versión del modelo de implementación.

DeploymentProperties

Propiedades de la implementación de la cuenta de Cognitive Services.

DeploymentProvisioningState

Obtiene el estado del recurso en el momento en que se llamó a la operación.

DeploymentScaleSettings

Propiedades del modelo de implementación de cuentas de Cognitive Services. (En desuso, use Deployment.sku en su lugar).

DeploymentScaleType

Tipo de escala de implementación.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

RequestMatchPattern
Sku

Definición del modelo de recursos que representa la SKU

SkuTier

El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put.

systemData

Metadatos relativos a la creación y última modificación del recurso.

ThrottlingRule

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

ThrottlingRule[]

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

DeploymentProperties

Propiedades de la implementación de la cuenta de Cognitive Services.

sku

Sku

Definición del modelo de recursos que representa la SKU

systemData

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

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

CallRateLimit

La cuenta de Cognitive Services limita la tasa de llamadas.

capabilities

object

Las funcionalidades.

capacitySettings

DeploymentCapacitySettings

Solo uso interno.

currentCapacity

integer (int32)

Capacidad actual.

dynamicThrottlingEnabled

boolean

Si la limitación dinámica está habilitada.

model

DeploymentModel

Propiedades del modelo de implementación de cuentas de Cognitive Services.

parentDeploymentName

string

Nombre de la implementación primaria.

provisioningState

DeploymentProvisioningState

Obtiene el estado del recurso en el momento en que se llamó a la operación.

raiPolicyName

string

Nombre de la directiva RAI.

rateLimits

ThrottlingRule[]

scaleSettings

DeploymentScaleSettings

Propiedades del modelo de implementación de cuentas de Cognitive Services. (En desuso, use Deployment.sku en su lugar).

versionUpgradeOption

DeploymentModelVersionUpgradeOption

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 si el cliente actualizó recientemente capacity.

capacity

integer (int32)

Capacidad de implementación.

scaleType

DeploymentScaleType

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

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

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

SkuTier

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

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

createdByType

Tipo de identidad que modificó por última vez el recurso.

ThrottlingRule

Nombre Tipo Description
count

number

dynamicThrottlingEnabled

boolean

key

string

matchPatterns

RequestMatchPattern[]

minCount

number

renewalPeriod

number