Deployments - Create Or Update
Uppdatera tillståndet för angivna distributioner som är associerade med Cognitive Services-kontot.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}?api-version=2023-05-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
account
|
path | True |
string |
Namnet på Cognitive Services-kontot. Reguljärt uttrycksmönster: |
deployment
|
path | True |
string |
Namnet på distributionen som är associerad med Cognitive Services-kontot |
resource
|
path | True |
string |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
subscription
|
path | True |
string |
ID för målprenumerationen. |
api-version
|
query | True |
string |
Den API-version som ska användas för den här åtgärden. |
Begärandetext
Name | Typ | Description |
---|---|---|
properties |
Egenskaper för cognitive services-kontodistribution. |
|
sku |
Resursmodelldefinitionen som representerar SKU |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Skapa/uppdatera distributionen. |
|
201 Created |
Skapa distributionen. |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Exempel
PutDeployment
Exempelbegäran
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"
}
}
}
Exempelsvar
{
"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"
}
}
Definitioner
Name | Description |
---|---|
Call |
Anropsfrekvensen begränsar Cognitive Services-kontot. |
created |
Den typ av identitet som skapade resursen. |
Deployment |
Cognitive Services-kontodistribution. |
Deployment |
Egenskaper för Cognitive Services-kontodistributionsmodellen. |
Deployment |
Uppgraderingsalternativ för distributionsmodellversion. |
Deployment |
Egenskaper för cognitive services-kontodistribution. |
Deployment |
Hämtar status för resursen när åtgärden anropades. |
Deployment |
Egenskaper för Cognitive Services-kontodistributionsmodellen. |
Deployment |
Distributionsskalningstyp. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Request |
|
Sku |
Resursmodelldefinitionen som representerar SKU |
Sku |
Det här fältet måste implementeras av resursprovidern om tjänsten har mer än en nivå, men inte krävs på en PUT. |
system |
Metadata som rör skapande och senaste ändring av resursen. |
Throttling |
CallRateLimit
Anropsfrekvensen begränsar Cognitive Services-kontot.
Name | Typ | Description |
---|---|---|
count |
number |
Antalsvärdet för gräns för samtalsfrekvens. |
renewalPeriod |
number |
Förnyelseperioden i sekunder av samtalsfrekvensgränsen. |
rules |
createdByType
Den typ av identitet som skapade resursen.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Deployment
Cognitive Services-kontodistribution.
Name | Typ | Description |
---|---|---|
etag |
string |
Resurs-Etag. |
id |
string |
Fullständigt kvalificerat resurs-ID för resursen. Exempel – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Namnet på resursen |
properties |
Egenskaper för cognitive services-kontodistribution. |
|
sku |
Resursmodelldefinitionen som representerar SKU |
|
systemData |
Metadata som rör skapande och senaste ändring av resursen. |
|
type |
string |
Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts" |
DeploymentModel
Egenskaper för Cognitive Services-kontodistributionsmodellen.
Name | Typ | Description |
---|---|---|
callRateLimit |
Anropsfrekvensen begränsar Cognitive Services-kontot. |
|
format |
string |
Distributionsmodellformat. |
name |
string |
Namn på distributionsmodell. |
source |
string |
Valfritt. ARM-resurs-ID för distributionsmodellkälla. |
version |
string |
Valfritt. Distributionsmodellversion. Om versionen inte anges tilldelas en standardversion. Standardversionen är annorlunda för olika modeller och kan ändras när det finns en ny version tillgänglig för en modell. Det gick att hitta standardversionen för en modell från API:et för listmodeller. |
DeploymentModelVersionUpgradeOption
Uppgraderingsalternativ för distributionsmodellversion.
Name | Typ | Description |
---|---|---|
NoAutoUpgrade |
string |
|
OnceCurrentVersionExpired |
string |
|
OnceNewDefaultVersionAvailable |
string |
DeploymentProperties
Egenskaper för cognitive services-kontodistribution.
Name | Typ | Description |
---|---|---|
callRateLimit |
Anropsfrekvensen begränsar Cognitive Services-kontot. |
|
capabilities |
object |
Funktionerna. |
model |
Egenskaper för Cognitive Services-kontodistributionsmodellen. |
|
provisioningState |
Hämtar status för resursen när åtgärden anropades. |
|
raiPolicyName |
string |
Namnet på RAI-principen. |
rateLimits | ||
scaleSettings |
Egenskaper för Cognitive Services-kontodistributionsmodellen. |
|
versionUpgradeOption |
Uppgraderingsalternativ för distributionsmodellversion. |
DeploymentProvisioningState
Hämtar status för resursen när åtgärden anropades.
Name | Typ | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
Failed |
string |
|
Moving |
string |
|
Succeeded |
string |
DeploymentScaleSettings
Egenskaper för Cognitive Services-kontodistributionsmodellen.
Name | Typ | Description |
---|---|---|
activeCapacity |
integer |
Aktiv kapacitet för distribution. Det här värdet kan skilja sig från |
capacity |
integer |
Distributionskapacitet. |
scaleType |
Distributionsskalningstyp. |
DeploymentScaleType
Distributionsskalningstyp.
Name | Typ | Description |
---|---|---|
Manual |
string |
|
Standard |
string |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
Name | Typ | Description |
---|---|---|
info |
object |
Den ytterligare informationen. |
type |
string |
Ytterligare informationstyp. |
ErrorDetail
Felinformationen.
Name | Typ | Description |
---|---|---|
additionalInfo |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorResponse
Felsvar
Name | Typ | Description |
---|---|---|
error |
Felobjektet. |
RequestMatchPattern
Name | Typ | Description |
---|---|---|
method |
string |
|
path |
string |
Sku
Resursmodelldefinitionen som representerar SKU
Name | Typ | Description |
---|---|---|
capacity |
integer |
Om SKU:n har stöd för utskalning/inskalning bör kapacitetsheltalet inkluderas. Om det inte går att skala ut/in för resursen kan detta utelämnas. |
family |
string |
Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här. |
name |
string |
Namnet på SKU:n. Ex - P3. Det är vanligtvis en bokstav+nummerkod |
size |
string |
SKU-storleken. När namnfältet är kombinationen av nivå och något annat värde är detta den fristående koden. |
tier |
Det här fältet måste implementeras av resursprovidern om tjänsten har mer än en nivå, men inte krävs på en PUT. |
SkuTier
Det här fältet måste implementeras av resursprovidern om tjänsten har mer än en nivå, men inte krävs på en PUT.
Name | Typ | Description |
---|---|---|
Basic |
string |
|
Enterprise |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metadata som rör skapande och senaste ändring av resursen.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Tidsstämpeln för resursskapande (UTC). |
createdBy |
string |
Identiteten som skapade resursen. |
createdByType |
Den typ av identitet som skapade resursen. |
|
lastModifiedAt |
string |
Tidsstämpeln för resursens senaste ändring (UTC) |
lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |
ThrottlingRule
Name | Typ | Description |
---|---|---|
count |
number |
|
dynamicThrottlingEnabled |
boolean |
|
key |
string |
|
matchPatterns | ||
minCount |
number |
|
renewalPeriod |
number |