Deployments - Create Or Update
Обновление состояния указанных развертываний, связанных с учетной записью Cognitive Services.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}?api-version=2023-05-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
account
|
path | True |
string |
Имя учетной записи Cognitive Services. Шаблон регулярного выражения: |
deployment
|
path | True |
string |
Имя развертывания, связанного с учетной записью Cognitive Services |
resource
|
path | True |
string |
Имя группы ресурсов. Регистр букв в имени не учитывается. |
subscription
|
path | True |
string |
Идентификатор целевой подписки. |
api-version
|
query | True |
string |
Версия API, используемая для данной операции. |
Текст запроса
Имя | Тип | Описание |
---|---|---|
properties |
Свойства развертывания учетной записи Cognitive Services. |
|
sku |
Определение модели ресурсов, представляющее SKU |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Успешное создание или обновление развертывания. |
|
201 Created |
Создайте развертывание успешно. |
|
Other Status Codes |
Ответ об ошибке, описывающий причину сбоя операции. |
Примеры
PutDeployment
Образец запроса
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"
}
}
}
Пример ответа
{
"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"
}
}
Определения
Имя | Описание |
---|---|
Call |
Учетная запись Cognitive Services с ограничением частоты вызовов. |
created |
Тип удостоверения, создавшего ресурс. |
Deployment |
Развертывание учетной записи Cognitive Services. |
Deployment |
Свойства модели развертывания учетных записей Cognitive Services. |
Deployment |
Параметр обновления версии модели развертывания. |
Deployment |
Свойства развертывания учетной записи Cognitive Services. |
Deployment |
Возвращает состояние ресурса на момент вызова операции. |
Deployment |
Свойства модели развертывания учетных записей Cognitive Services. |
Deployment |
Тип масштабирования развертывания. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Сведения об ошибке. |
Error |
Сообщение об ошибке |
Request |
|
Sku |
Определение модели ресурсов, представляющее SKU |
Sku |
Это поле должно быть реализовано поставщиком ресурсов, если служба имеет несколько уровней, но не требуется в PUT. |
system |
Метаданные, относящиеся к созданию и последнему изменению ресурса. |
Throttling |
CallRateLimit
Учетная запись Cognitive Services с ограничением частоты вызовов.
Имя | Тип | Описание |
---|---|---|
count |
number |
Значение счетчика ограничения частоты вызовов. |
renewalPeriod |
number |
Период продления в секундах ограничения частоты вызовов. |
rules |
createdByType
Тип удостоверения, создавшего ресурс.
Имя | Тип | Описание |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Deployment
Развертывание учетной записи Cognitive Services.
Имя | Тип | Описание |
---|---|---|
etag |
string |
Etag ресурса. |
id |
string |
Полный идентификатор ресурса. Например: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Имя ресурса. |
properties |
Свойства развертывания учетной записи Cognitive Services. |
|
sku |
Определение модели ресурсов, представляющее SKU |
|
systemData |
Метаданные, относящиеся к созданию и последнему изменению ресурса. |
|
type |
string |
Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft.Storage/storageAccounts. |
DeploymentModel
Свойства модели развертывания учетных записей Cognitive Services.
Имя | Тип | Описание |
---|---|---|
callRateLimit |
Учетная запись Cognitive Services с ограничением частоты вызовов. |
|
format |
string |
Формат модели развертывания. |
name |
string |
Имя модели развертывания. |
source |
string |
Необязательный элемент. Идентификатор ресурса ARM источника модели развертывания. |
version |
string |
Необязательный элемент. Версия модели развертывания. Если версия не указана, будет назначена версия по умолчанию. Версия по умолчанию отличается для разных моделей и может измениться при наличии новой версии для модели. Версию по умолчанию для модели можно найти в API моделей списков. |
DeploymentModelVersionUpgradeOption
Параметр обновления версии модели развертывания.
Имя | Тип | Описание |
---|---|---|
NoAutoUpgrade |
string |
|
OnceCurrentVersionExpired |
string |
|
OnceNewDefaultVersionAvailable |
string |
DeploymentProperties
Свойства развертывания учетной записи Cognitive Services.
Имя | Тип | Описание |
---|---|---|
callRateLimit |
Учетная запись Cognitive Services с ограничением частоты вызовов. |
|
capabilities |
object |
Возможности. |
model |
Свойства модели развертывания учетных записей Cognitive Services. |
|
provisioningState |
Возвращает состояние ресурса на момент вызова операции. |
|
raiPolicyName |
string |
Имя политики RAI. |
rateLimits | ||
scaleSettings |
Свойства модели развертывания учетных записей Cognitive Services. |
|
versionUpgradeOption |
Параметр обновления версии модели развертывания. |
DeploymentProvisioningState
Возвращает состояние ресурса на момент вызова операции.
Имя | Тип | Описание |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
Failed |
string |
|
Moving |
string |
|
Succeeded |
string |
DeploymentScaleSettings
Свойства модели развертывания учетных записей Cognitive Services.
Имя | Тип | Описание |
---|---|---|
activeCapacity |
integer |
Активная емкость развертывания. Это значение может отличаться от |
capacity |
integer |
Емкость развертывания. |
scaleType |
Тип масштабирования развертывания. |
DeploymentScaleType
Тип масштабирования развертывания.
Имя | Тип | Описание |
---|---|---|
Manual |
string |
|
Standard |
string |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Тип дополнительных сведений. |
ErrorDetail
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorResponse
Сообщение об ошибке
Имя | Тип | Описание |
---|---|---|
error |
Объект error. |
RequestMatchPattern
Имя | Тип | Описание |
---|---|---|
method |
string |
|
path |
string |
Sku
Определение модели ресурсов, представляющее SKU
Имя | Тип | Описание |
---|---|---|
capacity |
integer |
Если номер SKU поддерживает горизонтальное увеличение масштаба, необходимо включить целое число емкости. Если горизонтальное увеличение масштаба для ресурса невозможно, это может быть опущено. |
family |
string |
Если служба имеет разные поколения оборудования для одного номера SKU, то это можно записать здесь. |
name |
string |
Имя номера SKU. Ex - P3. Обычно это буква+числовой код. |
size |
string |
Размер номера SKU. Если поле имени является сочетанием уровня и некоторого другого значения, это будет автономный код. |
tier |
Это поле должно быть реализовано поставщиком ресурсов, если служба имеет несколько уровней, но не требуется в PUT. |
SkuTier
Это поле должно быть реализовано поставщиком ресурсов, если служба имеет несколько уровней, но не требуется в PUT.
Имя | Тип | Описание |
---|---|---|
Basic |
string |
|
Enterprise |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Метаданные, относящиеся к созданию и последнему изменению ресурса.
Имя | Тип | Описание |
---|---|---|
createdAt |
string |
Метка времени создания ресурса (UTC). |
createdBy |
string |
Удостоверение, создающее ресурс. |
createdByType |
Тип удостоверения, создавшего ресурс. |
|
lastModifiedAt |
string |
Метка времени последнего изменения ресурса (UTC) |
lastModifiedBy |
string |
Удостоверение, которое последним изменял ресурс. |
lastModifiedByType |
Тип удостоверения, которое последним изменял ресурс. |
ThrottlingRule
Имя | Тип | Описание |
---|---|---|
count |
number |
|
dynamicThrottlingEnabled |
boolean |
|
key |
string |
|
matchPatterns | ||
minCount |
number |
|
renewalPeriod |
number |