Reservation Order - Purchase

Служба:: Reserved VM Instances

Версия API:: 2022-11-01

Приобретите ReservationOrder и создайте ресурс в указанном URI.

PUT https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}?api-version=2022-11-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
reservationOrderId	path	True	string	Идентификатор заказа резервирования
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

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

Имя	Тип	Описание
location	string	Регион Azure, в котором находится зарезервированный ресурс.
properties.appliedScopeProperties	AppliedScopeProperties	Свойства, относящиеся к примененным типу области. Не требуется, если применимо. Требуется и необходимо предоставить идентификатор клиента и managementGroupId, если AppliedScopeType — ManagementGroup
properties.appliedScopeType	AppliedScopeType	Тип примененной области.
properties.appliedScopes	string[]	Список подписок, которые будут применены преимущества. Не указывайте, является ли Метод AppliedScopeType общим. Это свойство будет устарело и заменено примененнымScopeProperties вместо single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan	Представляет планы выставления счетов.
properties.billingScopeId	string	Подписка, которая будет взиматься за резервирование покупки или план экономии
properties.displayName	string	Понятное имя резервирования
properties.quantity	integer (int32)	Количество номеров SKU, входящих в резервирование.
properties.renew	boolean	Если задано значение true, он автоматически приобретет новое резервирование по времени окончания срока действия.
properties.reservedResourceProperties	PurchaseRequestPropertiesReservedResourceProperties	Свойства, относящиеся к каждому зарезервированного типа ресурса. Не требуется, если применимо.
properties.reservedResourceType	ReservedResourceType	Тип зарезервированного ресурса. В дополнение к нижеперечисленным типам мы также добавили следующие: OpenAIPTU, MDC, Sentinel.
properties.reviewDateTime	string (date-time)	Это время даты, когда необходимо проверить преимущество гибридной среды Azure.
properties.term	ReservationTerm	Представляет срок резервирования.
sku	SkuName	Имя SKU

Ответы

Имя	Тип	Описание
200 OK	ReservationOrderResponse	Операция обновления ресурса 'ReservationOrderResponse' успешно прошла
202 Accepted	ReservationOrderResponse	Заявка принята в обработку, но обработка еще не завершена. Заголовки Location: string Retry-After: integer
Other Status Codes	Error	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

ReservationOrderResponse

Операция обновления ресурса 'ReservationOrderResponse' успешно прошла

202 Accepted

ReservationOrderResponse

Заявка принята в обработку, но обработка еще не завершена.

Заголовки

Location: string
Retry-After: integer

Other Status Codes

Error

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

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

azure_auth

Azure Active Directory OAuth2 Flow.

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

Области

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

Примеры

Purchase

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

PUT https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/a075419f-44cc-497f-b68a-14ee811d48b9?api-version=2022-11-01

{
  "location": "westus",
  "properties": {
    "appliedScopeType": "Shared",
    "appliedScopes": null,
    "billingPlan": "Monthly",
    "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
    "displayName": "TestReservationOrder",
    "quantity": 1,
    "renew": false,
    "reservedResourceProperties": {
      "instanceFlexibility": "On"
    },
    "reservedResourceType": "VirtualMachines",
    "term": "P1Y"
  },
  "sku": {
    "name": "standard_D1"
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.reservations import ReservationsMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-reservations
# USAGE
    python purchase_reservation_order.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ReservationsMgmtClient(
        credential=DefaultAzureCredential(),
    )

    response = client.reservation_order.begin_purchase(
        reservation_order_id="a075419f-44cc-497f-b68a-14ee811d48b9",
        body={
            "location": "westus",
            "properties": {
                "appliedScopeType": "Shared",
                "appliedScopes": None,
                "billingPlan": "Monthly",
                "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
                "displayName": "TestReservationOrder",
                "quantity": 1,
                "renew": False,
                "reservedResourceProperties": {"instanceFlexibility": "On"},
                "reservedResourceType": "VirtualMachines",
                "term": "P1Y",
            },
            "sku": {"name": "standard_D1"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2022-11-01/PurchaseReservationOrder.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armreservations_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/reservations/armreservations/v4"
)

// Generated from example definition: 2022-11-01/PurchaseReservationOrder.json
func ExampleReservationOrderClient_BeginPurchase() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armreservations.NewClientFactory(cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewReservationOrderClient().BeginPurchase(ctx, "a075419f-44cc-497f-b68a-14ee811d48b9", armreservations.PurchaseRequest{
		Location: to.Ptr("westus"),
		Properties: &armreservations.PurchaseRequestProperties{
			AppliedScopeType: to.Ptr(armreservations.AppliedScopeTypeShared),
			BillingPlan:      to.Ptr(armreservations.ReservationBillingPlanMonthly),
			BillingScopeID:   to.Ptr("/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83"),
			DisplayName:      to.Ptr("TestReservationOrder"),
			Quantity:         to.Ptr[int32](1),
			Renew:            to.Ptr(false),
			ReservedResourceProperties: &armreservations.PurchaseRequestPropertiesReservedResourceProperties{
				InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOn),
			},
			ReservedResourceType: to.Ptr(armreservations.ReservedResourceTypeVirtualMachines),
			Term:                 to.Ptr(armreservations.ReservationTermP1Y),
		},
		SKU: &armreservations.SKUName{
			Name: to.Ptr("standard_D1"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to poll the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armreservations.ReservationOrderClientPurchaseResponse{
	// 	ReservationOrderResponse: armreservations.ReservationOrderResponse{
	// 		Name: to.Ptr("1f14354c-dc12-4c8d-8090-6f295a3a34aa"),
	// 		Type: to.Ptr("Microsoft.Capacity/reservationOrders"),
	// 		Etag: to.Ptr[int32](7),
	// 		ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa"),
	// 		Properties: &armreservations.ReservationOrderProperties{
	// 			BillingPlan: to.Ptr(armreservations.ReservationBillingPlanMonthly),
	// 			CreatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-30T03:51:49.8083758Z"); return t}()),
	// 			DisplayName: to.Ptr("cabri"),
	// 			ExpiryDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.DateOnly, "2018-08-30"); return t}()),
	// 			ExpiryDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-30T03:51:49.8083758Z"); return t}()),
	// 			OriginalQuantity: to.Ptr[int32](7),
	// 			ProvisioningState: to.Ptr(armreservations.ProvisioningStateSucceeded),
	// 			RequestDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-30T03:49:19.0252126Z"); return t}()),
	// 			Reservations: []*armreservations.ReservationResponse{
	// 				{
	// 					ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"),
	// 				},
	// 			},
	// 			Term: to.Ptr(armreservations.ReservationTermP1Y),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

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

{
  "name": "1f14354c-dc12-4c8d-8090-6f295a3a34aa",
  "type": "Microsoft.Capacity/reservationOrders",
  "etag": 7,
  "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
  "properties": {
    "billingPlan": "Monthly",
    "createdDateTime": "2017-08-30T03:51:49.8083758Z",
    "displayName": "cabri",
    "expiryDate": "2018-08-30",
    "expiryDateTime": "2018-08-30T03:51:49.8083758Z",
    "originalQuantity": 7,
    "provisioningState": "Succeeded",
    "requestDateTime": "2017-08-30T03:49:19.0252126Z",
    "reservations": [
      {
        "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
      }
    ],
    "term": "P1Y"
  }
}

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

Location: https://management.azure.com/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa?api-version=2022-11-01
Retry-After: 120

{
  "name": "1f14354c-dc12-4c8d-8090-6f295a3a34aa",
  "type": "Microsoft.Capacity/reservationOrders",
  "etag": 7,
  "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
  "properties": {
    "billingPlan": "Monthly",
    "createdDateTime": "2017-08-30T03:51:49.8083758Z",
    "displayName": "cabri",
    "expiryDate": "2018-08-30",
    "expiryDateTime": "2018-08-30T03:51:49.8083758Z",
    "originalQuantity": 7,
    "provisioningState": "Succeeded",
    "requestDateTime": "2017-08-30T03:49:19.0252126Z",
    "reservations": [
      {
        "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
      }
    ],
    "term": "P1Y"
  }
}

Определения

Имя	Описание
AppliedScopeProperties	Свойства, относящиеся к примененным типу области. Не требуется, если применимо. Требуется и необходимо предоставить идентификатор клиента и managementGroupId, если AppliedScopeType — ManagementGroup
AppliedScopeType	Тип примененной области.
createdByType	Тип удостоверения, создавшего ресурс.
Error	Сведения об ошибке
ErrorResponseCode	Код ошибки, описывающий причину, по которой служба не может обработать входящий запрос
ExtendedErrorInfo	Расширенные сведения об ошибках, включая код ошибки и сообщение об ошибке
ExtendedStatusInfo
InstanceFlexibility	Включение этого параметра применит скидку на резервирование к другим виртуальным машинам в той же группе размеров виртуальной машины. Укажите только зарезервированный тип ресурса VirtualMachines.
PaymentDetail	Сведения об оплате, связанной с заказом на резервирование.
PaymentStatus	Описывает, завершен ли платеж, сбой, отмена или планирование в будущем.
Price	Сведения о ценах, содержащие сумму и код валюты
ProvisioningState	Представляет текущее состояние резервирования.
PurchaseRequest	Запрос на покупку резервирования
PurchaseRequestPropertiesReservedResourceProperties	Свойства, относящиеся к каждому зарезервированного типа ресурса. Не требуется, если применимо.
RenewPropertiesResponse	Свойства продления резервирования.
RenewPropertiesResponseBillingCurrencyTotal	Валюта и сумма, которые клиент будет взиматься в местную валюту клиента за покупку продления. Налог не включен.
RenewPropertiesResponsePricingCurrencyTotal	Сумма, которую корпорация Майкрософт использует для записи. Используется во время возврата средств для расчета лимита возврата. Налог не включен. Эта цена заблокирована за 30 дней до истечения срока действия.
ReservationBillingPlan	Представляет планы выставления счетов.
ReservationMergeProperties	Свойства слияния резервирования
ReservationOrderBillingPlanInformation	Сведения о типе плана выставления счетов для этого резервирования.
ReservationOrderResponse	Сведения о возвращаемом заказе на резервирование.
ReservationResponse	Определение резервирования.
ReservationSplitProperties	Свойства разделения резервирования
ReservationsProperties	Свойства резервирования
ReservationsPropertiesUtilization	Использование резервирования
ReservationStatusCode
ReservationSwapProperties	Свойства переключения резервирования
ReservationTerm	Представляет срок резервирования.
ReservationUtilizationAggregates	Агрегированные значения использования резервирования
ReservedResourceType	Тип зарезервированного ресурса. В дополнение к нижеперечисленным типам мы также добавили следующие: OpenAIPTU, MDC, Sentinel.
SkuName	Имя SKU
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

AppliedScopeProperties

Объект

Свойства, относящиеся к примененным типу области. Не требуется, если применимо. Требуется и необходимо предоставить идентификатор клиента и managementGroupId, если AppliedScopeType — ManagementGroup

Имя	Тип	Описание
displayName	string	Отображаемое имя
managementGroupId	string	Полный идентификатор группы управления, в которой необходимо применить преимущество.
resourceGroupId	string	Полный идентификатор группы ресурсов.
subscriptionId	string	Полный идентификатор подписки.
tenantId	string	Идентификатор клиента, в котором должен применяться план экономии.

AppliedScopeType

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

Тип примененной области.

Значение	Описание
Single	Single
Shared	Общее
ManagementGroup	ManagementGroup

createdByType

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

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

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

Error

Объект

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

Имя	Тип	Описание
error	ExtendedErrorInfo	Расширенные сведения об ошибках, включая код ошибки и сообщение об ошибке

ErrorResponseCode

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

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

Значение	Описание
NotSpecified	Не указано
InternalServerError	Внутренняя ошибка сервера
ServerTimeout	ServerTimeout
AuthorizationFailed	Ошибка авторизации
BadRequest	Неверный запрос
ClientCertificateThumbprintNotSet	ClientCertificateThumbprintNotSet
InvalidRequestContent	СодержимоеЗапросаНедействительно
OperationFailed	Операция провалилась
HttpMethodNotSupported	HttpMethodNotsupported
InvalidRequestUri	InvalidRequestUri
MissingTenantId	MissingTenantId
InvalidTenantId	InvalidTenantId
InvalidReservationOrderId	InvalidReservationOrderId
InvalidReservationId	InvalidReservationId
ReservationIdNotInReservationOrder	РезервацияIdNotInReservationOrderOrder
ReservationOrderNotFound	РезервированиеНеНайдено
InvalidSubscriptionId	InvalidSubscriptionId
InvalidAccessToken	InvalidAccessToken
InvalidLocationId	InvalidLocationId
UnauthenticatedRequestsThrottled	Неаутентифицированные запросыОграничены
InvalidHealthCheckType	InvalidHealthCheckType
Forbidden	Запрещено
BillingScopeIdCannotBeChanged	BillingScopeIdCannotBeChanged
AppliedScopesNotAssociatedWithCommerceAccount	AppliedScopesNotAssociatedWithCommerceAccount
PatchValuesSameAsExisting	PatchValuesSameAsExisting
RoleAssignmentCreationFailed	РольПрисваиваниеСоздание неудачно
ReservationOrderCreationFailed	Заказ на бронированиеСоздание неудачно
ReservationOrderNotEnabled	ReservationOrderNotEnabled
CapacityUpdateScopesFailed	ВозможностьОбновлениеScopesFailed
UnsupportedReservationTerm	Термин резервации без поддержки
ReservationOrderIdAlreadyExists	РезервированиеПорядокIdУжеСуществует.
RiskCheckFailed	RiskCheckFail
CreateQuoteFailed	СоздатьQuoteFailed
ActivateQuoteFailed	АктивироватьQuoteFailed
NonsupportedAccountId	NonsupportedAccountId
PaymentInstrumentNotFound	PaymentInstrumentNotFound
MissingAppliedScopesForSingle	MissingAppliedScopesForSingle
NoValidReservationsToReRate	NoValidReservationsToReRate
ReRateOnlyAllowedForEA	ReRateOnlyAllowedForEA
OperationCannotBePerformedInCurrentState	ОперацияНеМожет Быть ВыполненаВ Текущем Состоянии
InvalidSingleAppliedScopesCount	InvalidSingleAppliedScopesCount
InvalidFulfillmentRequestParameters	InvalidFulfillmentRequestParameters
NotSupportedCountry	Неподдерживаемая страна
InvalidRefundQuantity	InvalidRefundQuantity
PurchaseError	ПокупкаОшибка
BillingCustomerInputError	BillingCustomerInputError
BillingPaymentInstrumentSoftError	BillingPaymentInstrumentSoftError
BillingPaymentInstrumentHardError	BillingPaymentInstrumentHardError
BillingTransientError	BillingTransientError
BillingError	BillingError
FulfillmentConfigurationError	FulfillmentConfigurationError
FulfillmentOutOfStockError	FulfillmentOutOfStockError
FulfillmentTransientError	FulfillmentTransientError
FulfillmentError	FulfillmentError
CalculatePriceFailed	ВычислитьЦенуНеудача
AppliedScopesSameAsExisting	Applied ScopesSameAsExist
SelfServiceRefundNotSupported	СамообслуживаниеВозвратНе поддерживается.
RefundLimitExceeded	Лимит возвратаПревышен

ExtendedErrorInfo

Объект

Расширенные сведения об ошибках, включая код ошибки и сообщение об ошибке

Имя	Тип	Описание
code	ErrorResponseCode	Код ошибки, описывающий причину, по которой служба не может обработать входящий запрос
message	string

ExtendedStatusInfo

Объект

Имя	Тип	Описание
message	string	В сообщении содержатся подробные сведения о коде состояния.
statusCode	ReservationStatusCode

InstanceFlexibility

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

Включение этого параметра применит скидку на резервирование к другим виртуальным машинам в той же группе размеров виртуальной машины. Укажите только зарезервированный тип ресурса VirtualMachines.

Значение	Описание
On	Вкл
Off	Выкл.

PaymentDetail

Объект

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

Имя	Тип	Описание
billingAccount	string	Отображает учетную запись, которая взимается за этот платеж.
billingCurrencyTotal	Price	Сумма, взимаемая в валюте выставления счетов. Налог не включен. Значение NULL для будущих платежей
dueDate	string (date)	Дата завершения оплаты.
extendedStatusInfo	ExtendedStatusInfo
paymentDate	string (date)	Дата завершения транзакции. Значение NULL, если оно запланировано.
pricingCurrencyTotal	Price	Сумма в валюте ценообразования. Налог не включен.
status	PaymentStatus	Описывает, завершен ли платеж, сбой, отмена или планирование в будущем.

PaymentStatus

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

Описывает, завершен ли платеж, сбой, отмена или планирование в будущем.

Значение	Описание
Succeeded	Succeeded
Failed	Неудача
Scheduled	Запланировано
Cancelled	Отменено

Price

Объект

Сведения о ценах, содержащие сумму и код валюты

Имя	Тип	Описание
amount	number (double)
currencyCode	string	Код валюты ISO 4217 3-буквы для валюты, используемой этой записью покупки.

ProvisioningState

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

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

Значение	Описание
Creating	Создавать
PendingResourceHold	Ожидание РесурсаДержать
ConfirmedResourceHold	ПодтвержденоResourceHold
PendingBilling	Ожидается выставление счетов
ConfirmedBilling	ПодтвержденоВыставление счетов
Created	Создано
Succeeded	Succeeded
Cancelled	Отменено
Expired	Срок действия истек
BillingFailed	БиллингНеудача
Failed	Неудача
Split	Разделение
Merged	Слившийся

PurchaseRequest

Объект

Запрос на покупку резервирования

Имя	Тип	Default value	Описание
location	string		Регион Azure, в котором находится зарезервированный ресурс.
properties.appliedScopeProperties	AppliedScopeProperties		Свойства, относящиеся к примененным типу области. Не требуется, если применимо. Требуется и необходимо предоставить идентификатор клиента и managementGroupId, если AppliedScopeType — ManagementGroup
properties.appliedScopeType	AppliedScopeType		Тип примененной области.
properties.appliedScopes	string[]		Список подписок, которые будут применены преимущества. Не указывайте, является ли Метод AppliedScopeType общим. Это свойство будет устарело и заменено примененнымScopeProperties вместо single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan		Представляет планы выставления счетов.
properties.billingScopeId	string		Подписка, которая будет взиматься за резервирование покупки или план экономии
properties.displayName	string		Понятное имя резервирования
properties.quantity	integer (int32)		Количество номеров SKU, входящих в резервирование.
properties.renew	boolean	False	Если задано значение true, он автоматически приобретет новое резервирование по времени окончания срока действия.
properties.reservedResourceProperties	PurchaseRequestPropertiesReservedResourceProperties		Свойства, относящиеся к каждому зарезервированного типа ресурса. Не требуется, если применимо.
properties.reservedResourceType	ReservedResourceType		Тип зарезервированного ресурса. В дополнение к нижеперечисленным типам мы также добавили следующие: OpenAIPTU, MDC, Sentinel.
properties.reviewDateTime	string (date-time)		Это время даты, когда необходимо проверить преимущество гибридной среды Azure.
properties.term	ReservationTerm		Представляет срок резервирования.
sku	SkuName		Имя SKU

PurchaseRequestPropertiesReservedResourceProperties

Объект

Свойства, относящиеся к каждому зарезервированного типа ресурса. Не требуется, если применимо.

Имя	Тип	Описание
instanceFlexibility	InstanceFlexibility	Включение этого параметра применит скидку на резервирование к другим виртуальным машинам в той же группе размеров виртуальной машины. Укажите только зарезервированный тип ресурса VirtualMachines.

RenewPropertiesResponse

Объект

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

Имя	Тип	Описание
billingCurrencyTotal	RenewPropertiesResponseBillingCurrencyTotal	Валюта и сумма, которые клиент будет взиматься в местную валюту клиента за покупку продления. Налог не включен.
pricingCurrencyTotal	RenewPropertiesResponsePricingCurrencyTotal	Сумма, которую корпорация Майкрософт использует для записи. Используется во время возврата средств для расчета лимита возврата. Налог не включен. Эта цена заблокирована за 30 дней до истечения срока действия.
purchaseProperties	PurchaseRequest	Запрос на покупку резервирования

RenewPropertiesResponseBillingCurrencyTotal

Объект

Валюта и сумма, которые клиент будет взиматься в местную валюту клиента за покупку продления. Налог не включен.

Имя	Тип	Описание
amount	number (float)
currencyCode	string	Код валюты ISO 4217 3-буквы для валюты, используемой этой записью покупки.

RenewPropertiesResponsePricingCurrencyTotal

Объект

Сумма, которую корпорация Майкрософт использует для записи. Используется во время возврата средств для расчета лимита возврата. Налог не включен. Эта цена заблокирована за 30 дней до истечения срока действия.

Имя	Тип	Описание
amount	number (float)
currencyCode	string	Код валюты ISO 4217 3-буквы для валюты, используемой этой записью покупки.

ReservationBillingPlan

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

Представляет планы выставления счетов.

Значение	Описание
Upfront	Upfront
Monthly	Monthly

ReservationMergeProperties

Объект

Свойства слияния резервирования

Имя	Тип	Описание
mergeDestination	string	Идентификатор ресурса резервирования создан из-за слияния. Формат идентификатора ресурса : /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources	string[]	Идентификаторы ресурсов объединенного исходного резервирования для формирования этого резервирования. Формат идентификатора ресурса : /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationOrderBillingPlanInformation

Объект

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

Имя	Тип	Описание
nextPaymentDueDate	string (date)	Для планов повторяющихся выставления счетов указывается дата обработки следующего платежа. Значение NULL при выплате суммы.
pricingCurrencyTotal	Price	Сумма денег, которую необходимо заплатить за заказ. Налог не включен.
startDate	string (date)	Дата начала плана выставления счетов.
transactions	PaymentDetail[]	Сведения об оплате, связанной с заказом на резервирование.

ReservationOrderResponse

Объект

Сведения о возвращаемом заказе на резервирование.

Имя	Тип	Описание
etag	integer (int32)
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties.benefitStartTime	string (date-time)	Это dateTime при запуске преимущества резервирования.
properties.billingPlan	ReservationBillingPlan	Представляет планы выставления счетов.
properties.createdDateTime	string (date-time)	Это dateTime при создании резервирования.
properties.displayName	string	Понятное имя пользователя, чтобы легко определить резервирование.
properties.expiryDate	string (date)	Это дата истечения срока действия резервирования.
properties.expiryDateTime	string (date-time)	Это время даты, когда срок действия резервирования истекает.
properties.originalQuantity	integer (int32)	Общее количество номеров skus, приобретенных в резервировании.
properties.planInformation	ReservationOrderBillingPlanInformation	Сведения о типе плана выставления счетов для этого резервирования.
properties.provisioningState	ProvisioningState	Текущее состояние резервирования.
properties.requestDateTime	string (date-time)	Это dateTime, когда резервация изначально запрашивалась для покупки.
properties.reservations	ReservationResponse[]	Определение резервирования.
properties.reviewDateTime	string (date-time)	Это дата, когда необходимо проверить преимущество гибридной среды Azure.
properties.term	ReservationTerm	Представляет срок резервирования.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

ReservationResponse

Объект

Определение резервирования.

Имя	Тип	Описание
etag	integer (int32)
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	enum: Microsoft.Compute	Тип поставщика ресурсов, зарезервированный.
location	string	Регион Azure, в котором находится зарезервированный ресурс.
name	string	Имя ресурса
properties	ReservationsProperties	Свойства, связанные с этим резервированием
sku	SkuName	Сведения sku, связанные с этим резервированием
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

ReservationSplitProperties

Объект

Свойства разделения резервирования

Имя	Тип	Описание
splitDestinations	string[]	Список идентификаторов целевого ресурса, создаваемых из-за разделения. Формат идентификатора ресурса : /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	Идентификатор ресурса резервирования, из которого выполняется разделение. Формат идентификатора ресурса : /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

Объект

Свойства резервирования

Имя	Тип	Default value	Описание
appliedScopeProperties	AppliedScopeProperties		Свойства, относящиеся к примененным типу области. Не требуется, если применимо. Требуется и необходимо предоставить идентификатор клиента и managementGroupId, если AppliedScopeType — ManagementGroup
appliedScopeType	AppliedScopeType		Примененный тип области
appliedScopes	string[]		Список примененных областей
archived	boolean		Указывает, архивируется ли резервирование
benefitStartTime	string (date-time)		Это dateTime при запуске преимущества резервирования.
billingPlan	ReservationBillingPlan		Параметры плана выставления счетов, доступные для этого номера SKU.
billingScopeId	string		Подписка, которая будет взиматься за резервирование покупки или план экономии
capabilities	string		Возможности резервирования
displayName	string		Понятное имя для пользователя, чтобы легко определить резервирование
displayProvisioningState	string		Состояние подготовки резервирования для отображения, например успешное выполнение
effectiveDateTime	string (date-time)		DateTime резервирования, начиная с этой версии.
expiryDate	string (date)		Это дата истечения срока действия резервирования.
expiryDateTime	string (date-time)		Это время даты, когда срок действия резервирования истекает.
extendedStatusInfo	ExtendedStatusInfo		В сообщении содержатся подробные сведения о коде состояния.
instanceFlexibility	InstanceFlexibility		Позволяет применять скидку на резервирование по номерам skus в одной группе автоподбора. Не все номера SKU поддерживают гибкость размера экземпляра.
lastUpdatedDateTime	string (date-time)		Дата и время последнего обновления резервирования.
mergeProperties	ReservationMergeProperties		Свойства слияния резервирования
provisioningState	ProvisioningState		Текущее состояние резервирования.
provisioningSubState	string		Под состояние подготовки резервирования, например успешное выполнение
purchaseDate	string (date)		Это дата приобретения резервирования.
purchaseDateTime	string (date-time)		Это время даты при покупке резервирования.
quantity	integer (int32)		Количество номеров SKU, входящих в резервирование. Должно быть больше нуля.
renew	boolean	False	Если задано значение true, он автоматически приобретет новое резервирование по времени окончания срока действия.
renewDestination	string		Идентификатор резервирования резервирования, приобретенного из-за продления. Формат идентификатора ресурса — /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties	RenewPropertiesResponse		Свойства продления резервирования.
renewSource	string		Идентификатор резервирования, из которого продлено это резервирование. Формат идентификатора ресурса — /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType	ReservedResourceType		Тип зарезервированного ресурса.
reviewDateTime	string (date-time)		Это дата, когда необходимо проверить преимущество гибридной среды Azure.
skuDescription	string		Описание SKU на английском языке.
splitProperties	ReservationSplitProperties		Свойства разделения резервирования
swapProperties	ReservationSwapProperties		Свойства переключения резервирования
term	ReservationTerm		Представляет срок резервирования.
userFriendlyAppliedScopeType	string		Примененный тип области резервирования для отображения, например shared.
userFriendlyRenewState	string		Состояние продления резервирования для отображения, например вкл.
utilization	ReservationsPropertiesUtilization		Использование резервирования

ReservationsPropertiesUtilization

Объект

Использование резервирования

Имя	Тип	Описание
aggregates	ReservationUtilizationAggregates[]	Массив статистических выражений использования резервирования
trend	string	тенденция использования за последние 7 дней для резервирования

ReservationStatusCode

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

Значение	Описание
None	Нет
Pending	В ожидании
Processing	Обработка
Active	Активный
PurchaseError	ПокупкаОшибка
PaymentInstrumentError	PaymentInstrumentError
Split	Разделение
Merged	Слившийся
Expired	Срок действия истек
Succeeded	Succeeded

ReservationSwapProperties

Объект

Свойства переключения резервирования

Имя	Тип	Описание
swapDestination	string	Идентификатор ресурса резервирования, на который переключится исходный ресурс. Формат идентификатора ресурса : /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	Идентификатор ресурса исходного резервирования, который получает переключение. Формат идентификатора ресурса : /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

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

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

Значение	Описание
P1Y	P1Y
P3Y	P3Y
P5Y	P5Y

ReservationUtilizationAggregates

Объект

Агрегированные значения использования резервирования

Имя	Тип	Описание
grain	number (float)	Зерно агрегата
grainUnit	string	Единица зерна агрегата
value	number (float)	Агрегированное значение
valueUnit	string	Единица агрегированного значения

ReservedResourceType

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

Тип зарезервированного ресурса. В дополнение к нижеперечисленным типам мы также добавили следующие: OpenAIPTU, MDC, Sentinel.

Значение	Описание
VirtualMachines	Виртуальные машины
SqlDatabases	SqlDatabases
SuseLinux	SuseLinux
CosmosDb	CosmosDb
RedHat	RedHat
SqlDataWarehouse	SqlDataWarehouse
VMwareCloudSimple	VMwareCloudSimple
RedHatOsa	RedHatOsa
Databricks	Databricks
AppService	AppService
ManagedDisk	Управляемый диск
BlockBlob	BlockBlob
RedisCache	RedisCache
AzureDataExplorer	AzureDataExplorer
MySql	MySql
MariaDb	MariaDb
PostgreSql	PostgreSql
DedicatedHost	ПосвящённыйВедущий
SapHana	SapHana
SqlAzureHybridBenefit	SqlAzureHybridBenefit
AVS	AVS
DataFactory	DataFactory
NetAppStorage	NetAppStorage
AzureFiles	AzureFiles
SqlEdge	SqlEdge
VirtualMachineSoftware	VirtualMachineSoftware

SkuName

Объект

Имя SKU

Имя	Тип	Описание
name	string

systemData

Объект

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

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