Standby Virtual Machine Pools - Create Or Update

Ссылка

Служба:: Standby Pools

Версия API:: 2025-03-01

Создание резервного кода StandbyVirtualMachinePoolResource

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/{standbyVirtualMachinePoolName}?api-version=2025-03-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не учитывает регистр.
standbyVirtualMachinePoolName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	Имя резервного пула виртуальных машин
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть UUID.
api-version	query	True	string minLength: 1	Версия API, используемая для этой операции.

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Географическое расположение, в котором находится ресурс
properties.virtualMachineState	True	VirtualMachineState	Указывает требуемое состояние виртуальных машин в пуле.
properties.attachedVirtualMachineScaleSetId		string (arm-id)	Указывает полный идентификатор ресурса масштабируемого набора виртуальных машин, к которому подключен пул.
properties.elasticityProfile		StandbyVirtualMachinePoolElasticityProfile	Задает профиль эластичности резервных пулов виртуальных машин.
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	StandbyVirtualMachinePoolResource	Операция обновления ресурса "StandbyVirtualMachinePoolResource" выполнена успешно
201 Created	StandbyVirtualMachinePoolResource	Операция создания ресурса "StandbyVirtualMachinePoolResource" выполнена успешно Заголовки Retry-After: integer
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

StandbyVirtualMachinePoolResource

Операция обновления ресурса "StandbyVirtualMachinePoolResource" выполнена успешно

201 Created

StandbyVirtualMachinePoolResource

Операция создания ресурса "StandbyVirtualMachinePoolResource" выполнена успешно

Заголовки

Retry-After: integer

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

StandbyVirtualMachinePools_CreateOrUpdate

Образец запроса

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool?api-version=2025-03-01

{
  "properties": {
    "elasticityProfile": {
      "maxReadyCapacity": 304,
      "minReadyCapacity": 300
    },
    "virtualMachineState": "Running",
    "attachedVirtualMachineScaleSetId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachineScaleSets/myVmss"
  },
  "tags": {},
  "location": "West US"
}

Пример ответа

Код состояния:: 200

{
  "properties": {
    "elasticityProfile": {
      "maxReadyCapacity": 304,
      "minReadyCapacity": 300
    },
    "virtualMachineState": "Running",
    "attachedVirtualMachineScaleSetId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachineScaleSets/myVmss",
    "provisioningState": "Succeeded"
  },
  "tags": {},
  "location": "West US",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool",
  "name": "pool",
  "type": "Microsoft.StandbyPool/standbyVirtualMachinePools",
  "systemData": {
    "createdBy": "pooluser@microsoft.com",
    "createdByType": "User",
    "createdAt": "2023-09-07T16:33:22.210Z",
    "lastModifiedBy": "pooluser@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2023-09-07T16:33:22.210Z"
  }
}

Код состояния:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus

{
  "properties": {
    "elasticityProfile": {
      "maxReadyCapacity": 304,
      "minReadyCapacity": 300
    },
    "virtualMachineState": "Running",
    "attachedVirtualMachineScaleSetId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachineScaleSets/myVmss",
    "provisioningState": "Succeeded"
  },
  "tags": {},
  "location": "West US",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool",
  "name": "pool",
  "type": "Microsoft.StandbyPool/standbyVirtualMachinePools",
  "systemData": {
    "createdBy": "pooluser@microsoft.com",
    "createdByType": "User",
    "createdAt": "2023-09-07T16:33:22.210Z",
    "lastModifiedBy": "pooluser@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2023-09-07T16:33:22.210Z"
  }
}

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
ProvisioningState	Состояние подготовки
StandbyVirtualMachinePoolElasticityProfile	Сведения о профиле эластичности.
StandbyVirtualMachinePoolResource	РезервныйVirtualMachinePoolResource.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
VirtualMachineState	Состояние резервных виртуальных машин

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

ProvisioningState

Перечисление

Состояние подготовки

Значение	Описание
Canceled	Создание ресурсов было отменено.
Deleting	Удаляется ресурс.
Failed	Не удалось создать ресурс.
Succeeded	Ресурс создан.

StandbyVirtualMachinePoolElasticityProfile

Object

Сведения о профиле эластичности.

Имя	Тип	Описание
maxReadyCapacity	integer (int64) minimum: 0 maximum: 2000	Указывает максимальное количество виртуальных машин в резервном пуле виртуальных машин.
minReadyCapacity	integer (int64) minimum: 0 maximum: 2000	Указывает требуемое минимальное количество виртуальных машин в резервном пуле виртуальных машин. MinReadyCapacity не может превышать MaxReadyCapacity.

StandbyVirtualMachinePoolResource

Object

РезервныйVirtualMachinePoolResource.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties.attachedVirtualMachineScaleSetId	string (arm-id)	Указывает полный идентификатор ресурса масштабируемого набора виртуальных машин, к которому подключен пул.
properties.elasticityProfile	StandbyVirtualMachinePoolElasticityProfile	Задает профиль эластичности резервных пулов виртуальных машин.
properties.provisioningState	ProvisioningState	Состояние последней операции.
properties.virtualMachineState	VirtualMachineState	Указывает требуемое состояние виртуальных машин в пуле.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

systemData

Object

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

VirtualMachineState

Перечисление

Состояние резервных виртуальных машин

Значение	Описание
Deallocated	Виртуальная машина выпустила аренду на базовом оборудовании и отключена.
Hibernated	Виртуальная машина выпустила аренду на базовом оборудовании и отключена. Содержимое памяти виртуальной машины хранится на диске ОС. При повторном запуске приложения и процессы, которые ранее выполнялись в виртуальной машине, возобновлялись из состояния до гибернации.
Running	Виртуальная машина запущена и запущена.

Поделиться через

Standby Virtual Machine Pools - Create Or Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

StandbyVirtualMachinePools_CreateOrUpdate

Образец запроса

Пример ответа

Определения

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningState

StandbyVirtualMachinePoolElasticityProfile

StandbyVirtualMachinePoolResource

systemData

VirtualMachineState

Дополнительные ресурсы