Deployments - Create Or Update
Aktualisieren Sie den Status der angegebenen Bereitstellungen, die dem Cognitive Services-Konto zugeordnet sind.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}?api-version=2023-05-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Cognitive Services-Kontos. Regex pattern: |
deployment
|
path | True |
string |
Der Name der Bereitstellung, die dem Cognitive Services-Konto zugeordnet ist |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
properties |
Eigenschaften der Cognitive Services-Kontobereitstellung. |
|
sku |
Die Ressourcenmodelldefinition, die die SKU darstellt |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erstellen/Aktualisieren Sie die Bereitstellung erfolgreich. |
|
201 Created |
Erstellen Sie die Bereitstellung erfolgreich. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Beispiele
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"
}
}
Definitionen
Name | Beschreibung |
---|---|
Call |
Das Cognitive Services-Konto für die Anrufratenbegrenzung. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Deployment |
Bereitstellung eines Cognitive Services-Kontos. |
Deployment |
Eigenschaften des Cognitive Services-Kontobereitstellungsmodells. |
Deployment |
Upgradeoption der Bereitstellungsmodellversion. |
Deployment |
Eigenschaften der Cognitive Services-Kontobereitstellung. |
Deployment |
Ruft die status der Ressource zum Zeitpunkt des Aufrufs des Vorgangs ab. |
Deployment |
Eigenschaften des Cognitive Services-Kontobereitstellungsmodells. |
Deployment |
Bereitstellungsskalierungstyp. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Request |
|
Sku |
Die Ressourcenmodelldefinition, die die SKU darstellt |
Sku |
Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst über mehrere Ebenen verfügt, aber für einen PUT nicht erforderlich ist. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
Throttling |
CallRateLimit
Das Cognitive Services-Konto für die Anrufratenbegrenzung.
Name | Typ | Beschreibung |
---|---|---|
count |
number |
Der Count-Wert des Anrufratenlimits. |
renewalPeriod |
number |
Der Verlängerungszeitraum in Sekunden des Anrufratenlimits. |
rules |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Deployment
Bereitstellung eines Cognitive Services-Kontos.
Name | Typ | Beschreibung |
---|---|---|
etag |
string |
Ressourcen-Etag. |
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Der Name der Ressource |
properties |
Eigenschaften der Cognitive Services-Kontobereitstellung. |
|
sku |
Die Ressourcenmodelldefinition, die die SKU darstellt |
|
systemData |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
|
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
DeploymentModel
Eigenschaften des Cognitive Services-Kontobereitstellungsmodells.
Name | Typ | Beschreibung |
---|---|---|
callRateLimit |
Das Cognitive Services-Konto für die Anrufratenbegrenzung. |
|
format |
string |
Bereitstellungsmodellformat. |
name |
string |
Name des Bereitstellungsmodells. |
source |
string |
Optional. ARM-Ressourcen-ID der Bereitstellungsmodellquelle. |
version |
string |
Optional. Bereitstellungsmodellversion. Wenn version nicht angegeben wird, wird eine Standardversion zugewiesen. Die Standardversion unterscheidet sich für verschiedene Modelle und kann sich ändern, wenn eine neue Version für ein Modell verfügbar ist. Die Standardversion für ein Modell kann über die Listenmodell-API gefunden werden. |
DeploymentModelVersionUpgradeOption
Upgradeoption der Bereitstellungsmodellversion.
Name | Typ | Beschreibung |
---|---|---|
NoAutoUpgrade |
string |
|
OnceCurrentVersionExpired |
string |
|
OnceNewDefaultVersionAvailable |
string |
DeploymentProperties
Eigenschaften der Cognitive Services-Kontobereitstellung.
Name | Typ | Beschreibung |
---|---|---|
callRateLimit |
Das Cognitive Services-Konto für die Anrufratenbegrenzung. |
|
capabilities |
object |
Die Funktionen. |
model |
Eigenschaften des Cognitive Services-Kontobereitstellungsmodells. |
|
provisioningState |
Ruft die status der Ressource zum Zeitpunkt des Aufrufs des Vorgangs ab. |
|
raiPolicyName |
string |
Der Name der RAI-Richtlinie. |
rateLimits | ||
scaleSettings |
Eigenschaften des Cognitive Services-Kontobereitstellungsmodells. |
|
versionUpgradeOption |
Upgradeoption der Bereitstellungsmodellversion. |
DeploymentProvisioningState
Ruft die status der Ressource zum Zeitpunkt des Aufrufs des Vorgangs ab.
Name | Typ | Beschreibung |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
Failed |
string |
|
Moving |
string |
|
Succeeded |
string |
DeploymentScaleSettings
Eigenschaften des Cognitive Services-Kontobereitstellungsmodells.
Name | Typ | Beschreibung |
---|---|---|
activeCapacity |
integer |
Aktive Bereitstellungskapazität. Dieser Wert kann sich von dem |
capacity |
integer |
Bereitstellungskapazität. |
scaleType |
Bereitstellungsskalierungstyp. |
DeploymentScaleType
Bereitstellungsskalierungstyp.
Name | Typ | Beschreibung |
---|---|---|
Manual |
string |
|
Standard |
string |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorDetail
Die Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
RequestMatchPattern
Name | Typ | Beschreibung |
---|---|---|
method |
string |
|
path |
string |
Sku
Die Ressourcenmodelldefinition, die die SKU darstellt
Name | Typ | Beschreibung |
---|---|---|
capacity |
integer |
Wenn die SKU das Horizontal-/Einskalieren unterstützt, sollte die ganze Kapazität enthalten sein. Wenn das Horizontal-/Einskalieren für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. |
family |
string |
Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden. |
name |
string |
Der Name der SKU. Beispiel: P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. |
size |
string |
Die SKU-Größe. Wenn das Feld name die Kombination aus Ebene und einem anderen Wert ist, ist dies der eigenständige Code. |
tier |
Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst über mehrere Ebenen verfügt, aber für einen PUT nicht erforderlich ist. |
SkuTier
Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst über mehrere Ebenen verfügt, aber für einen PUT nicht erforderlich ist.
Name | Typ | Beschreibung |
---|---|---|
Basic |
string |
|
Enterprise |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
ThrottlingRule
Name | Typ | Beschreibung |
---|---|---|
count |
number |
|
dynamicThrottlingEnabled |
boolean |
|
key |
string |
|
matchPatterns | ||
minCount |
number |
|
renewalPeriod |
number |