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


Capacity Reservations - Create Or Update

Операция создания или обновления резервирования емкости. Обратите внимание, что некоторые свойства можно задать только во время создания резервирования емкости. Дополнительные сведения см https://aka.ms/CapacityReservation . в статье.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}/capacityReservations/{capacityReservationName}?api-version=2024-03-01

Параметры URI

Имя В Обязательно Тип Описание
capacityReservationGroupName
path True

string

Имя группы резервирования емкости.

capacityReservationName
path True

string

Имя резервирования емкости.

resourceGroupName
path True

string

Имя группы ресурсов.

subscriptionId
path True

string

Учетные данные подписки, которые однозначно идентифицируют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы.

api-version
query True

string

Версия API клиента.

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

Имя Обязательно Тип Описание
location True

string

Расположение ресурса

sku True

Sku

SKU ресурса, для которого необходимо зарезервировать емкость. Необходимо задать имя и емкость номера SKU. В настоящее время поддерживаются номера SKU виртуальных машин с функцией CapacityReservationSupported, которая имеет значение true. Поддерживаемые значения см. в статье Список SKU Microsoft.Compute в регионе (https://docs.microsoft.com/rest/api/compute/resourceskus/list).

tags

object

Теги ресурсов

zones

string[]

Зона доступности, используемая для резервирования емкости. Зона должна быть одним значением, а также входить в список зон, указанных при создании группы резервирования емкости. Зона может быть назначена только во время создания. Если этот параметр не указан, резервирование поддерживает только незональные развертывания. Если этот параметр указан, виртуальные машины или vmSS, использующие резервирование емкости, будут находиться в той же зоне.

Ответы

Имя Тип Описание
200 OK

CapacityReservation

ОК

201 Created

CapacityReservation

Создание

Other Status Codes

CloudError

Ответ об ошибке, описывающий причину сбоя операции.

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

azure_auth

Поток OAuth2 в Azure Active Directory

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

Области

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

Примеры

Create or update a capacity reservation .

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

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation?api-version=2024-03-01

{
  "location": "westus",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ]
}

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

{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}
{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}

Определения

Имя Описание
ApiError

Ошибка API.

ApiErrorBase

База ошибок API.

CapacityReservation

Указывает сведения о резервировании емкости.

CapacityReservationInstanceView

Представление экземпляра резервирования емкости, которое предоставляет snapshot свойств среды выполнения резервирования мощности, управляемого платформой и может изменяться за пределами операций уровня управления.

CapacityReservationUtilization

Представляет использование резервирования емкости с точки зрения выделенных ресурсов.

CloudError

Ответ об ошибке от службы вычислений.

InnerError

Сведения о внутренней ошибке.

InstanceViewStatus

Состояние представления экземпляра.

Sku

Описывает номер SKU масштабируемого набора виртуальных машин. ПРИМЕЧАНИЕ. Если новый номер SKU виртуальной машины не поддерживается на оборудовании, на который сейчас работает масштабируемый набор, перед изменением имени SKU необходимо освободить виртуальные машины в масштабируемом наборе.

StatusLevelTypes

Код уровня.

SubResourceReadOnly

ApiError

Ошибка API.

Имя Тип Описание
code

string

Код ошибки.

details

ApiErrorBase[]

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

innererror

InnerError

Внутренняя ошибка API

message

string

Сообщение об ошибке.

target

string

Целевой объект конкретной ошибки.

ApiErrorBase

База ошибок API.

Имя Тип Описание
code

string

Код ошибки.

message

string

Сообщение об ошибке.

target

string

Целевой объект конкретной ошибки.

CapacityReservation

Указывает сведения о резервировании емкости.

Имя Тип Описание
id

string

Идентификатор ресурса

location

string

Расположение ресурса

name

string

Имя ресурса

properties.instanceView

CapacityReservationInstanceView

Представление экземпляра резервирования мощности.

properties.platformFaultDomainCount

integer

Указывает значение количества доменов сбоя, которое резервная мощность поддерживает для запрошенного размера виртуальной машины. Примечание: Число доменов сбоя, указанное для ресурса (например, масштабируемого набора виртуальных машин), должно быть меньше или равно этому значению при развертывании с использованием резервирования емкости. Минимальная версия API: 2022-08-01.

properties.provisioningState

string

Состояние подготовки, которое отображается только в ответе.

properties.provisioningTime

string

Дата последнего обновления резервирования емкости.

properties.reservationId

string

Уникальный идентификатор, созданный и назначенный платформе резервирования емкости, который не изменяется в течение всего времени существования ресурса.

properties.timeCreated

string

Указывает время создания ресурса резервирования мощности. Минимальная версия API: 2021-11-01.

properties.virtualMachinesAssociated

SubResourceReadOnly[]

Список всех идентификаторов ресурсов виртуальных машин, связанных с резервированием емкости.

sku

Sku

SKU ресурса, для которого необходимо зарезервировать емкость. Необходимо задать имя и емкость номера SKU. В настоящее время поддерживаются номера SKU виртуальных машин с функцией CapacityReservationSupported, которая имеет значение true. Поддерживаемые значения см. в статье Список SKU Microsoft.Compute в регионе (https://docs.microsoft.com/rest/api/compute/resourceskus/list).

tags

object

Теги ресурсов

type

string

Тип ресурса

zones

string[]

Зона доступности, используемая для резервирования емкости. Зона должна быть одним значением, а также входить в список зон, указанных при создании группы резервирования емкости. Зона может быть назначена только во время создания. Если этот параметр не указан, резервирование поддерживает только незональные развертывания. Если этот параметр указан, виртуальные машины или vmSS, использующие резервирование емкости, будут находиться в той же зоне.

CapacityReservationInstanceView

Представление экземпляра резервирования емкости, которое предоставляет snapshot свойств среды выполнения резервирования мощности, управляемого платформой и может изменяться за пределами операций уровня управления.

Имя Тип Описание
statuses

InstanceViewStatus[]

Сведения о состоянии ресурса.

utilizationInfo

CapacityReservationUtilization

Неиспользуемая емкость резервирования емкости.

CapacityReservationUtilization

Представляет использование резервирования емкости с точки зрения выделенных ресурсов.

Имя Тип Описание
currentCapacity

integer

Значение предоставляет текущую емкость размера виртуальной машины, которая была успешно зарезервирована и за которую клиенту выставляется счет. Минимальная версия API: 2022-08-01.

virtualMachinesAllocated

SubResourceReadOnly[]

Список всех идентификаторов ресурсов виртуальных машин, выделенных для резервирования емкости.

CloudError

Ответ об ошибке от службы вычислений.

Имя Тип Описание
error

ApiError

Ошибка API.

InnerError

Сведения о внутренней ошибке.

Имя Тип Описание
errordetail

string

Внутреннее сообщение об ошибке или дамп исключений.

exceptiontype

string

Тип исключения.

InstanceViewStatus

Состояние представления экземпляра.

Имя Тип Описание
code

string

Код состояния.

displayStatus

string

Короткая локализуемая метка состояния.

level

StatusLevelTypes

Код уровня.

message

string

Подробное сообщение о состоянии, в том числе для оповещений и сообщений об ошибках.

time

string

Время состояния.

Sku

Описывает номер SKU масштабируемого набора виртуальных машин. ПРИМЕЧАНИЕ. Если новый номер SKU виртуальной машины не поддерживается на оборудовании, на который сейчас работает масштабируемый набор, перед изменением имени SKU необходимо освободить виртуальные машины в масштабируемом наборе.

Имя Тип Описание
capacity

integer

Указывает количество виртуальных машин в масштабируемом наборе.

name

string

Имя SKU.

tier

string

Указывает уровень виртуальных машин в масштабируемом наборе.

Возможные значения:

Standard Edition

Основной

StatusLevelTypes

Код уровня.

Имя Тип Описание
Error

string

Info

string

Warning

string

SubResourceReadOnly

Имя Тип Описание
id

string

Идентификатор ресурса