Deployments - Create Or Update
Aktualizujte stav zadaných nasazení přidružených k účtu služeb Cognitive Services.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}?api-version=2023-05-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
account
|
path | True |
string |
Název účtu služeb Cognitive Services. Regex pattern: |
deployment
|
path | True |
string |
Název nasazení přidruženého k účtu služeb Cognitive Services |
resource
|
path | True |
string |
Název skupiny prostředků. V názvu se rozlišují malá a velká písmena. |
subscription
|
path | True |
string |
ID cílového předplatného. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
Text požadavku
Name | Typ | Description |
---|---|---|
properties |
Vlastnosti nasazení účtu služeb Cognitive Services. |
|
sku |
Definice modelu prostředků představující skladovou položku |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Úspěšně vytvořte nebo aktualizujte nasazení. |
|
201 Created |
Úspěšně vytvořte nasazení. |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Příklady
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"
}
}
Definice
Name | Description |
---|---|
Call |
Limit četnosti volání účtu služeb Cognitive Services. |
created |
Typ identity, která prostředek vytvořila. |
Deployment |
Nasazení účtu služeb Cognitive Services. |
Deployment |
Vlastnosti modelu nasazení účtu služeb Cognitive Services |
Deployment |
Možnost upgradu verze modelu nasazení |
Deployment |
Vlastnosti nasazení účtu služeb Cognitive Services. |
Deployment |
Získá stav prostředku v době, kdy byla operace volána. |
Deployment |
Vlastnosti modelu nasazení účtu služeb Cognitive Services |
Deployment |
Typ škálování nasazení |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
Request |
|
Sku |
Definice modelu prostředků představující skladovou položku |
Sku |
Toto pole musí poskytovatel prostředků implementovat, pokud má služba více než jednu úroveň, ale nevyžaduje se u PUT. |
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
Throttling |
CallRateLimit
Limit četnosti volání účtu služeb Cognitive Services.
Name | Typ | Description |
---|---|---|
count |
number |
Hodnota počtu v limitu četnosti volání. |
renewalPeriod |
number |
Doba prodlužování platnosti limitu četnosti volání v sekundách. |
rules |
createdByType
Typ identity, která prostředek vytvořila.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Deployment
Nasazení účtu služeb Cognitive Services.
Name | Typ | Description |
---|---|---|
etag |
string |
Značka ETag prostředku. |
id |
string |
Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku} |
name |
string |
Název prostředku |
properties |
Vlastnosti nasazení účtu služeb Cognitive Services. |
|
sku |
Definice modelu prostředků představující skladovou položku |
|
systemData |
Metadata týkající se vytvoření a poslední změny prostředku. |
|
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
DeploymentModel
Vlastnosti modelu nasazení účtu služeb Cognitive Services
Name | Typ | Description |
---|---|---|
callRateLimit |
Limit četnosti volání účtu služeb Cognitive Services. |
|
format |
string |
Formát modelu nasazení. |
name |
string |
Název modelu nasazení. |
source |
string |
Nepovinný parametr. ID prostředku ARM zdroje modelu nasazení |
version |
string |
Nepovinný parametr. Verze modelu nasazení. Pokud není verze zadaná, přiřadí se výchozí verze. Výchozí verze se liší pro různé modely a může se změnit, když je pro model k dispozici nová verze. Výchozí verzi modelu najdete v rozhraní API výpisu modelů. |
DeploymentModelVersionUpgradeOption
Možnost upgradu verze modelu nasazení
Name | Typ | Description |
---|---|---|
NoAutoUpgrade |
string |
|
OnceCurrentVersionExpired |
string |
|
OnceNewDefaultVersionAvailable |
string |
DeploymentProperties
Vlastnosti nasazení účtu služeb Cognitive Services.
Name | Typ | Description |
---|---|---|
callRateLimit |
Limit četnosti volání účtu služeb Cognitive Services. |
|
capabilities |
object |
Možnosti. |
model |
Vlastnosti modelu nasazení účtu služeb Cognitive Services |
|
provisioningState |
Získá stav prostředku v době, kdy byla operace volána. |
|
raiPolicyName |
string |
Název zásady RAI. |
rateLimits | ||
scaleSettings |
Vlastnosti modelu nasazení účtu služeb Cognitive Services |
|
versionUpgradeOption |
Možnost upgradu verze modelu nasazení |
DeploymentProvisioningState
Získá stav prostředku v době, kdy byla operace volána.
Name | Typ | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
Failed |
string |
|
Moving |
string |
|
Succeeded |
string |
DeploymentScaleSettings
Vlastnosti modelu nasazení účtu služeb Cognitive Services
Name | Typ | Description |
---|---|---|
activeCapacity |
integer |
Aktivní kapacita nasazení. Tato hodnota se může lišit od |
capacity |
integer |
Kapacita nasazení. |
scaleType |
Typ škálování nasazení |
DeploymentScaleType
Typ škálování nasazení
Name | Typ | Description |
---|---|---|
Manual |
string |
|
Standard |
string |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
RequestMatchPattern
Name | Typ | Description |
---|---|---|
method |
string |
|
path |
string |
Sku
Definice modelu prostředků představující skladovou položku
Name | Typ | Description |
---|---|---|
capacity |
integer |
Pokud skladová položka podporuje horizontální navýšení/snížení kapacity, mělo by být zahrnuto celé číslo kapacity. Pokud pro prostředek není možné škálovat na více nebo více instancí, může se to vynechat. |
family |
string |
Pokud má služba různé generace hardwaru pro stejnou skladovou položku, můžete to tady zaznamenat. |
name |
string |
Název skladové položky. Příklad – P3. Obvykle se jedná o písmeno+číselný kód. |
size |
string |
Velikost skladové položky. Pokud je pole pro název kombinací vrstvy a nějaké jiné hodnoty, jedná se o samostatný kód. |
tier |
Toto pole musí poskytovatel prostředků implementovat, pokud má služba více než jednu úroveň, ale nevyžaduje se u PUT. |
SkuTier
Toto pole musí poskytovatel prostředků implementovat, pokud má služba více než jednu úroveň, ale nevyžaduje se u PUT.
Name | Typ | Description |
---|---|---|
Basic |
string |
|
Enterprise |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Časové razítko vytvoření prostředku (UTC) |
createdBy |
string |
Identita, která vytvořila prostředek. |
createdByType |
Typ identity, která prostředek vytvořila. |
|
lastModifiedAt |
string |
Časové razítko poslední změny prostředku (UTC) |
lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |
ThrottlingRule
Name | Typ | Description |
---|---|---|
count |
number |
|
dynamicThrottlingEnabled |
boolean |
|
key |
string |
|
matchPatterns | ||
minCount |
number |
|
renewalPeriod |
number |