Deployments - Create Or Update
Werk de status bij van opgegeven implementaties die zijn gekoppeld aan het Cognitive Services-account.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}?api-version=2023-05-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
De naam van het Cognitive Services-account. Regex pattern: |
deployment
|
path | True |
string |
De naam van de implementatie die is gekoppeld aan het Cognitive Services-account |
resource
|
path | True |
string |
De naam van de resourcegroep. De naam is niet hoofdlettergevoelig. |
subscription
|
path | True |
string |
De id van het doelabonnement. |
api-version
|
query | True |
string |
De API-versie die voor deze bewerking moet worden gebruikt. |
Aanvraagbody
Name | Type | Description |
---|---|---|
properties |
Eigenschappen van cognitive services-accountimplementatie. |
|
sku |
De definitie van het resourcemodel die de SKU vertegenwoordigt |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
De implementatie is gemaakt/bijgewerkt. |
|
201 Created |
De implementatie is gemaakt. |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Voorbeelden
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"
}
}
Definities
Name | Description |
---|---|
Call |
Het Cognitive Services-account voor de aanroepsnelheidslimiet. |
created |
Het type identiteit waarmee de resource is gemaakt. |
Deployment |
Implementatie van Cognitive Services-account. |
Deployment |
Eigenschappen van het implementatiemodel van het Cognitive Services-account. |
Deployment |
Upgradeoptie voor implementatiemodelversie. |
Deployment |
Eigenschappen van cognitive services-accountimplementatie. |
Deployment |
Hiermee wordt de status van de resource opgehaald op het moment dat de bewerking werd aangeroepen. |
Deployment |
Eigenschappen van het implementatiemodel van het Cognitive Services-account. |
Deployment |
Type implementatieschaal. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
Request |
|
Sku |
De definitie van het resourcemodel die de SKU vertegenwoordigt |
Sku |
Dit veld moet worden geïmplementeerd door de resourceprovider als de service meer dan één laag heeft, maar niet vereist is voor een PUT. |
system |
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource. |
Throttling |
CallRateLimit
Het Cognitive Services-account voor de aanroepsnelheidslimiet.
Name | Type | Description |
---|---|---|
count |
number |
De tellingswaarde van Limiet voor aanroepfrequentie. |
renewalPeriod |
number |
De verlengingsperiode in seconden van De aanroepfrequentielimiet. |
rules |
createdByType
Het type identiteit waarmee de resource is gemaakt.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Deployment
Implementatie van Cognitive Services-account.
Name | Type | Description |
---|---|---|
etag |
string |
Resource-Etag. |
id |
string |
Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
De naam van de resource |
properties |
Eigenschappen van cognitive services-accountimplementatie. |
|
sku |
De definitie van het resourcemodel die de SKU vertegenwoordigt |
|
systemData |
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource. |
|
type |
string |
Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts' |
DeploymentModel
Eigenschappen van het implementatiemodel van het Cognitive Services-account.
Name | Type | Description |
---|---|---|
callRateLimit |
Het Cognitive Services-account voor de aanroepsnelheidslimiet. |
|
format |
string |
Indeling implementatiemodel. |
name |
string |
Naam van implementatiemodel. |
source |
string |
Optioneel. ARM-resource-id van implementatiemodelbron. |
version |
string |
Optioneel. Versie van implementatiemodel. Als de versie niet is opgegeven, wordt er een standaardversie toegewezen. De standaardversie verschilt voor verschillende modellen en kan worden gewijzigd wanneer er een nieuwe versie beschikbaar is voor een model. De standaardversie voor een model is te vinden in de API voor lijstmodellen. |
DeploymentModelVersionUpgradeOption
Upgradeoptie voor implementatiemodelversie.
Name | Type | Description |
---|---|---|
NoAutoUpgrade |
string |
|
OnceCurrentVersionExpired |
string |
|
OnceNewDefaultVersionAvailable |
string |
DeploymentProperties
Eigenschappen van cognitive services-accountimplementatie.
Name | Type | Description |
---|---|---|
callRateLimit |
Het Cognitive Services-account voor de aanroepsnelheidslimiet. |
|
capabilities |
object |
De mogelijkheden. |
model |
Eigenschappen van het implementatiemodel van het Cognitive Services-account. |
|
provisioningState |
Hiermee wordt de status van de resource opgehaald op het moment dat de bewerking werd aangeroepen. |
|
raiPolicyName |
string |
De naam van RAI-beleid. |
rateLimits | ||
scaleSettings |
Eigenschappen van het implementatiemodel van het Cognitive Services-account. |
|
versionUpgradeOption |
Upgradeoptie voor implementatiemodelversie. |
DeploymentProvisioningState
Hiermee wordt de status van de resource opgehaald op het moment dat de bewerking werd aangeroepen.
Name | Type | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
Failed |
string |
|
Moving |
string |
|
Succeeded |
string |
DeploymentScaleSettings
Eigenschappen van het implementatiemodel van het Cognitive Services-account.
Name | Type | Description |
---|---|---|
activeCapacity |
integer |
Actieve capaciteit implementeren. Deze waarde kan afwijken van |
capacity |
integer |
Implementatiecapaciteit. |
scaleType |
Type implementatieschaal. |
DeploymentScaleType
Type implementatieschaal.
Name | Type | Description |
---|---|---|
Manual |
string |
|
Standard |
string |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
Name | Type | Description |
---|---|---|
info |
object |
De aanvullende informatie. |
type |
string |
Het type aanvullende informatie. |
ErrorDetail
De foutdetails.
Name | Type | Description |
---|---|---|
additionalInfo |
De fout aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
Het foutobject. |
RequestMatchPattern
Name | Type | Description |
---|---|---|
method |
string |
|
path |
string |
Sku
De definitie van het resourcemodel die de SKU vertegenwoordigt
Name | Type | Description |
---|---|---|
capacity |
integer |
Als de SKU uitschalen/inschalen ondersteunt, moet het gehele getal van de capaciteit worden opgenomen. Als uitschalen/inschalen niet mogelijk is voor de resource, kan dit worden weggelaten. |
family |
string |
Als de service verschillende generaties hardware voor dezelfde SKU heeft, kan die hier worden vastgelegd. |
name |
string |
De naam van de SKU. Ex - P3. Het is meestal een letter+cijfercode |
size |
string |
De SKU-grootte. Wanneer het naamveld de combinatie van laag en een andere waarde is, is dit de zelfstandige code. |
tier |
Dit veld moet worden geïmplementeerd door de resourceprovider als de service meer dan één laag heeft, maar niet vereist is voor een PUT. |
SkuTier
Dit veld moet worden geïmplementeerd door de resourceprovider als de service meer dan één laag heeft, maar niet vereist is voor een PUT.
Name | Type | Description |
---|---|---|
Basic |
string |
|
Enterprise |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.
Name | Type | Description |
---|---|---|
createdAt |
string |
De tijdstempel van het maken van resources (UTC). |
createdBy |
string |
De identiteit die de resource heeft gemaakt. |
createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
lastModifiedAt |
string |
Het tijdstempel van de laatste wijziging van de resource (UTC) |
lastModifiedBy |
string |
De identiteit die de resource het laatst heeft gewijzigd. |
lastModifiedByType |
Het type identiteit dat de resource het laatst heeft gewijzigd. |
ThrottlingRule
Name | Type | Description |
---|---|---|
count |
number |
|
dynamicThrottlingEnabled |
boolean |
|
key |
string |
|
matchPatterns | ||
minCount |
number |
|
renewalPeriod |
number |