Deployments - Create Or Update
Atualize o estado das implantações especificadas associadas à conta dos Serviços Cognitivos.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}?api-version=2023-05-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta dos Serviços Cognitivos. Regex pattern: |
deployment
|
path | True |
string |
O nome da implantação associada à conta dos Serviços Cognitivos |
resource
|
path | True |
string |
O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas. |
subscription
|
path | True |
string |
A ID da assinatura de destino. |
api-version
|
query | True |
string |
A versão da API a ser usada para esta operação. |
Corpo da solicitação
Nome | Tipo | Description |
---|---|---|
properties |
Propriedades da implantação da conta dos Serviços Cognitivos. |
|
sku |
A definição do modelo de recurso que representa o SKU |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Crie/atualize a implantação com êxito. |
|
201 Created |
Crie a implantação com êxito. |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Exemplos
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"
}
}
Definições
Nome | Description |
---|---|
Call |
A conta dos Serviços Cognitivos do limite de taxa de chamada. |
created |
O tipo de identidade que criou o recurso. |
Deployment |
Implantação da conta dos Serviços Cognitivos. |
Deployment |
Propriedades do modelo de implantação de conta dos Serviços Cognitivos. |
Deployment |
Opção de atualização de versão do modelo de implantação. |
Deployment |
Propriedades da implantação da conta dos Serviços Cognitivos. |
Deployment |
Obtém o status do recurso no momento em que a operação foi chamada. |
Deployment |
Propriedades do modelo de implantação de conta dos Serviços Cognitivos. |
Deployment |
Tipo de escala de implantação. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
Os detalhes do erro. |
Error |
Resposta de erro |
Request |
|
Sku |
A definição do modelo de recurso que representa o SKU |
Sku |
Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT. |
system |
Metadados relativos à criação e à última modificação do recurso. |
Throttling |
CallRateLimit
A conta dos Serviços Cognitivos do limite de taxa de chamada.
Nome | Tipo | Description |
---|---|---|
count |
number |
O valor de contagem de Limite de Taxa de Chamada. |
renewalPeriod |
number |
O período de renovação em segundos de Limite de Taxa de Chamada. |
rules |
createdByType
O tipo de identidade que criou o recurso.
Nome | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Deployment
Implantação da conta dos Serviços Cognitivos.
Nome | Tipo | Description |
---|---|---|
etag |
string |
Etag de recurso. |
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
O nome do recurso |
properties |
Propriedades da implantação da conta dos Serviços Cognitivos. |
|
sku |
A definição do modelo de recurso que representa o SKU |
|
systemData |
Metadados relativos à criação e à última modificação do recurso. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
DeploymentModel
Propriedades do modelo de implantação de conta dos Serviços Cognitivos.
Nome | Tipo | Description |
---|---|---|
callRateLimit |
A conta dos Serviços Cognitivos do limite de taxa de chamada. |
|
format |
string |
Formato do modelo de implantação. |
name |
string |
Nome do modelo de implantação. |
source |
string |
Opcional. ID do recurso arm de origem do modelo de implantação. |
version |
string |
Opcional. Versão do modelo de implantação. Se a versão não for especificada, uma versão padrão será atribuída. A versão padrão é diferente para modelos diferentes e pode mudar quando há uma nova versão disponível para um modelo. A versão padrão de um modelo pode ser encontrada na API de modelos de lista. |
DeploymentModelVersionUpgradeOption
Opção de atualização de versão do modelo de implantação.
Nome | Tipo | Description |
---|---|---|
NoAutoUpgrade |
string |
|
OnceCurrentVersionExpired |
string |
|
OnceNewDefaultVersionAvailable |
string |
DeploymentProperties
Propriedades da implantação da conta dos Serviços Cognitivos.
Nome | Tipo | Description |
---|---|---|
callRateLimit |
A conta dos Serviços Cognitivos do limite de taxa de chamada. |
|
capabilities |
object |
As funcionalidades. |
model |
Propriedades do modelo de implantação de conta dos Serviços Cognitivos. |
|
provisioningState |
Obtém o status do recurso no momento em que a operação foi chamada. |
|
raiPolicyName |
string |
O nome da política RAI. |
rateLimits | ||
scaleSettings |
Propriedades do modelo de implantação de conta dos Serviços Cognitivos. |
|
versionUpgradeOption |
Opção de atualização de versão do modelo de implantação. |
DeploymentProvisioningState
Obtém o status do recurso no momento em que a operação foi chamada.
Nome | Tipo | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
Failed |
string |
|
Moving |
string |
|
Succeeded |
string |
DeploymentScaleSettings
Propriedades do modelo de implantação de conta dos Serviços Cognitivos.
Nome | Tipo | Description |
---|---|---|
activeCapacity |
integer |
Capacidade ativa de implantação. Esse valor pode ser diferente de |
capacity |
integer |
Capacidade de implantação. |
scaleType |
Tipo de escala de implantação. |
DeploymentScaleType
Tipo de escala de implantação.
Nome | Tipo | Description |
---|---|---|
Manual |
string |
|
Standard |
string |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
Nome | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ErrorDetail
Os detalhes do erro.
Nome | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
RequestMatchPattern
Nome | Tipo | Description |
---|---|---|
method |
string |
|
path |
string |
Sku
A definição do modelo de recurso que representa o SKU
Nome | Tipo | Description |
---|---|---|
capacity |
integer |
Se o SKU der suporte a expansão/entrada, o inteiro de capacidade deverá ser incluído. Se expansão/redução não for possível para o recurso, isso poderá ser omitido. |
family |
string |
Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui. |
name |
string |
O nome da SKU. Ex - P3. Normalmente, é um código de letra+número |
size |
string |
O tamanho do SKU. Quando o campo de nome é a combinação de camada e algum outro valor, esse seria o código autônomo. |
tier |
Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT. |
SkuTier
Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT.
Nome | Tipo | Description |
---|---|---|
Basic |
string |
|
Enterprise |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metadados relativos à criação e à última modificação do recurso.
Nome | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string |
O carimbo de data/hora da última modificação do recurso (UTC) |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
ThrottlingRule
Nome | Tipo | Description |
---|---|---|
count |
number |
|
dynamicThrottlingEnabled |
boolean |
|
key |
string |
|
matchPatterns | ||
minCount |
number |
|
renewalPeriod |
number |