Deployments - Create Or Update
Zaktualizuj stan określonych wdrożeń skojarzonych z kontem usług Cognitive Services.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}?api-version=2023-05-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
account
|
path | True |
string |
Nazwa konta usług Cognitive Services. Wzorzec wyrażenia regularnego: |
deployment
|
path | True |
string |
Nazwa wdrożenia skojarzonego z kontem usług Cognitive Services |
resource
|
path | True |
string |
Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter. |
subscription
|
path | True |
string |
Identyfikator subskrypcji docelowej. |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
Nazwa | Typ | Opis |
---|---|---|
properties |
Właściwości wdrożenia konta usług Cognitive Services. |
|
sku |
Definicja modelu zasobów reprezentująca jednostkę SKU |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Pomyślnie utwórz/zaktualizuj wdrożenie. |
|
201 Created |
Pomyślnie utwórz wdrożenie. |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Przykłady
PutDeployment
Przykładowe żądanie
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"
}
}
}
Przykładowa odpowiedź
{
"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"
}
}
Definicje
Nazwa | Opis |
---|---|
Call |
Limit liczby wywołań konta usług Cognitive Services. |
created |
Typ tożsamości, która utworzyła zasób. |
Deployment |
Wdrażanie konta usług Cognitive Services. |
Deployment |
Właściwości modelu wdrażania konta usług Cognitive Services. |
Deployment |
Opcja uaktualniania wersji modelu wdrażania. |
Deployment |
Właściwości wdrożenia konta usług Cognitive Services. |
Deployment |
Pobiera stan zasobu w momencie wywołania operacji. |
Deployment |
Właściwości modelu wdrażania konta usług Cognitive Services. |
Deployment |
Typ skali wdrożenia. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Request |
|
Sku |
Definicja modelu zasobów reprezentująca jednostkę SKU |
Sku |
To pole jest wymagane do zaimplementowania przez dostawcę zasobów, jeśli usługa ma więcej niż jedną warstwę, ale nie jest wymagana w put. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
Throttling |
CallRateLimit
Limit liczby wywołań konta usług Cognitive Services.
Nazwa | Typ | Opis |
---|---|---|
count |
number |
Wartość licznika limitu liczby wywołań. |
renewalPeriod |
number |
Okres odnawiania w sekundach limitu liczby wywołań. |
rules |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Deployment
Wdrażanie konta usług Cognitive Services.
Nazwa | Typ | Opis |
---|---|---|
etag |
string |
Zasób Etag. |
id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nazwa zasobu |
properties |
Właściwości wdrożenia konta usług Cognitive Services. |
|
sku |
Definicja modelu zasobów reprezentująca jednostkę SKU |
|
systemData |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
|
type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
DeploymentModel
Właściwości modelu wdrażania konta usług Cognitive Services.
Nazwa | Typ | Opis |
---|---|---|
callRateLimit |
Limit liczby wywołań konta usług Cognitive Services. |
|
format |
string |
Format modelu wdrażania. |
name |
string |
Nazwa modelu wdrażania. |
source |
string |
Opcjonalny. Identyfikator zasobu usługi ARM źródła modelu wdrażania. |
version |
string |
Opcjonalny. Wersja modelu wdrażania. Jeśli wersja nie zostanie określona, zostanie przypisana domyślna wersja. Wersja domyślna jest inna w przypadku różnych modeli i może ulec zmianie, gdy istnieje nowa wersja dostępna dla modelu. Domyślna wersja modelu można znaleźć w interfejsie API modeli listy. |
DeploymentModelVersionUpgradeOption
Opcja uaktualniania wersji modelu wdrażania.
Nazwa | Typ | Opis |
---|---|---|
NoAutoUpgrade |
string |
|
OnceCurrentVersionExpired |
string |
|
OnceNewDefaultVersionAvailable |
string |
DeploymentProperties
Właściwości wdrożenia konta usług Cognitive Services.
Nazwa | Typ | Opis |
---|---|---|
callRateLimit |
Limit liczby wywołań konta usług Cognitive Services. |
|
capabilities |
object |
Możliwości. |
model |
Właściwości modelu wdrażania konta usług Cognitive Services. |
|
provisioningState |
Pobiera stan zasobu w momencie wywołania operacji. |
|
raiPolicyName |
string |
Nazwa zasad RAI. |
rateLimits | ||
scaleSettings |
Właściwości modelu wdrażania konta usług Cognitive Services. |
|
versionUpgradeOption |
Opcja uaktualniania wersji modelu wdrażania. |
DeploymentProvisioningState
Pobiera stan zasobu w momencie wywołania operacji.
Nazwa | Typ | Opis |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
Failed |
string |
|
Moving |
string |
|
Succeeded |
string |
DeploymentScaleSettings
Właściwości modelu wdrażania konta usług Cognitive Services.
Nazwa | Typ | Opis |
---|---|---|
activeCapacity |
integer |
Aktywna pojemność wdrożenia. Ta wartość może się różnić od |
capacity |
integer |
Pojemność wdrożenia. |
scaleType |
Typ skali wdrożenia. |
DeploymentScaleType
Typ skali wdrożenia.
Nazwa | Typ | Opis |
---|---|---|
Manual |
string |
|
Standard |
string |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt błędu. |
RequestMatchPattern
Nazwa | Typ | Opis |
---|---|---|
method |
string |
|
path |
string |
Sku
Definicja modelu zasobów reprezentująca jednostkę SKU
Nazwa | Typ | Opis |
---|---|---|
capacity |
integer |
Jeśli jednostka SKU obsługuje skalowanie w poziomie/w poziomie, należy uwzględnić liczbę całkowitą pojemności. Jeśli skalowanie w poziomie/w nie jest możliwe dla zasobu, może to zostać pominięte. |
family |
string |
Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. |
name |
string |
Nazwa jednostki SKU. Ex — P3. Zazwyczaj jest to kod litery i cyfry |
size |
string |
Rozmiar jednostki SKU. Gdy pole nazwy jest kombinacją warstwy i inną wartością, będzie to autonomiczny kod. |
tier |
To pole jest wymagane do zaimplementowania przez dostawcę zasobów, jeśli usługa ma więcej niż jedną warstwę, ale nie jest wymagana w put. |
SkuTier
To pole jest wymagane do zaimplementowania przez dostawcę zasobów, jeśli usługa ma więcej niż jedną warstwę, ale nie jest wymagana w put.
Nazwa | Typ | Opis |
---|---|---|
Basic |
string |
|
Enterprise |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string |
Sygnatura czasowa tworzenia zasobu (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string |
Sygnatura czasowa ostatniej modyfikacji zasobu (UTC) |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
ThrottlingRule
Nazwa | Typ | Opis |
---|---|---|
count |
number |
|
dynamicThrottlingEnabled |
boolean |
|
key |
string |
|
matchPatterns | ||
minCount |
number |
|
renewalPeriod |
number |