Reservation - Split

Служба:

Reserved VM Instances

Версия API:

2022-11-01

Разделите Reservation.
Разделите на Reservation два Reservationс указанным распределением количества.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
reservationOrderId	path	True	string	Идентификатор заказа резервирования
api-version	query	True	string	Поддерживаемая версия.

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

Имя	Тип	Описание
properties.quantities	integer[]	Список количества создаваемых резервирований.
properties.reservationId	string	Идентификатор ресурса резервирования, который необходимо разделить. Формат идентификатора ресурса должен быть /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

Ответы

Имя	Тип	Описание
200 OK	ReservationResponse[]	Список объектов, созданных Reservationпосле операции разделения.
202 Accepted		Запрос принимается и обрабатывается Заголовки Location: string Retry-After: integer
Other Status Codes	Error	Непредвиденная ошибка.

Примеры

Split

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

HTTP

POST https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/split?api-version=2022-11-01

{
  "properties": {
    "quantities": [
      1,
      2
    ],
    "reservationId": "/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
  }
}

Java

import com.azure.resourcemanager.reservations.models.SplitRequest;
import java.util.Arrays;

/** Samples for Reservation Split. */
public final class Main {
    /*
     * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/SplitReservation.json
     */
    /**
     * Sample code: Split.
     *
     * @param manager Entry point to ReservationsManager.
     */
    public static void split(com.azure.resourcemanager.reservations.ReservationsManager manager) {
        manager
            .reservations()
            .split(
                "276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
                new SplitRequest()
                    .withQuantities(Arrays.asList(1, 2))
                    .withReservationId(
                        "/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"),
                com.azure.core.util.Context.NONE);
    }
}

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

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.reservations import AzureReservationAPI

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-reservations
# USAGE
    python split_reservation.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 = AzureReservationAPI(
        credential=DefaultAzureCredential(),
    )

    response = client.reservation.begin_split(
        reservation_order_id="276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
        body={
            "properties": {
                "quantities": [1, 2],
                "reservationId": "/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a",
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/SplitReservation.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

Go

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/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/1e7b408f3323e7f5424745718fe62c7a043a2337/specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/SplitReservation.json
func ExampleReservationClient_BeginSplit() {
	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.NewReservationClient().BeginSplit(ctx, "276e7ae4-84d0-4da6-ab4b-d6b94f3557da", armreservations.SplitRequest{
		Properties: &armreservations.SplitProperties{
			Quantities: []*int32{
				to.Ptr[int32](1),
				to.Ptr[int32](2)},
			ReservationID: to.Ptr("/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"),
		},
	}, 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 pull 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.ReservationResponseArray = []*armreservations.ReservationResponse{
	// 	{
	// 		Name: to.Ptr("00238563-7312-4c20-a134-8c030bf938a7"),
	// 		Type: to.Ptr("Microsoft.Capacity/reservationOrders/reservations"),
	// 		ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7"),
	// 		Etag: to.Ptr[int32](2),
	// 		Location: to.Ptr("eastus"),
	// 		Properties: &armreservations.Properties{
	// 			AppliedScopeProperties: &armreservations.AppliedScopeProperties{
	// 				DisplayName: to.Ptr("Azure subscription 1"),
	// 				SubscriptionID: to.Ptr("/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"),
	// 			},
	// 			AppliedScopeType: to.Ptr(armreservations.AppliedScopeTypeSingle),
	// 			BillingPlan: to.Ptr(armreservations.ReservationBillingPlanMonthly),
	// 			BillingScopeID: to.Ptr("/subscriptions/19376483-64b8-49e4-a931-d5248828720a"),
	// 			DisplayName: to.Ptr("cabri_test"),
	// 			EffectiveDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T01:00:30.925Z"); return t}()),
	// 			ExpiryDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2018-09-22"); return t}()),
	// 			ExpiryDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-09-22T01:00:30.925Z"); return t}()),
	// 			InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOff),
	// 			LastUpdatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T01:00:36.319Z"); return t}()),
	// 			ProvisioningState: to.Ptr(armreservations.ProvisioningStateSucceeded),
	// 			Quantity: to.Ptr[int32](1),
	// 			Renew: to.Ptr(false),
	// 			ReservedResourceType: to.Ptr(armreservations.ReservedResourceTypeVirtualMachines),
	// 			SKUDescription: to.Ptr("D1 v2"),
	// 			SplitProperties: &armreservations.ReservationSplitProperties{
	// 				SplitSource: to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"),
	// 			},
	// 		},
	// 		SKU: &armreservations.SKUName{
	// 			Name: to.Ptr("Standard_DS1_v2"),
	// 		},
	// 	},
	// 	{
	// 		Name: to.Ptr("e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"),
	// 		Type: to.Ptr("Microsoft.Capacity/reservationOrders/reservations"),
	// 		ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"),
	// 		Etag: to.Ptr[int32](2),
	// 		Location: to.Ptr("eastus"),
	// 		Properties: &armreservations.Properties{
	// 			AppliedScopeProperties: &armreservations.AppliedScopeProperties{
	// 				DisplayName: to.Ptr("Azure subscription 1"),
	// 				SubscriptionID: to.Ptr("/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"),
	// 			},
	// 			AppliedScopeType: to.Ptr(armreservations.AppliedScopeTypeSingle),
	// 			BillingPlan: to.Ptr(armreservations.ReservationBillingPlanMonthly),
	// 			BillingScopeID: to.Ptr("/subscriptions/19376483-64b8-49e4-a931-d5248828720a"),
	// 			DisplayName: to.Ptr("cabri_test"),
	// 			EffectiveDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T01:00:30.925Z"); return t}()),
	// 			ExpiryDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2018-09-22"); return t}()),
	// 			ExpiryDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-09-22T01:00:30.925Z"); return t}()),
	// 			InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOff),
	// 			LastUpdatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T01:00:36.319Z"); return t}()),
	// 			ProvisioningState: to.Ptr(armreservations.ProvisioningStateSucceeded),
	// 			Quantity: to.Ptr[int32](2),
	// 			Renew: to.Ptr(false),
	// 			ReservedResourceType: to.Ptr(armreservations.ReservedResourceTypeVirtualMachines),
	// 			SKUDescription: to.Ptr("D1 v2"),
	// 			SplitProperties: &armreservations.ReservationSplitProperties{
	// 				SplitSource: to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"),
	// 			},
	// 		},
	// 		SKU: &armreservations.SKUName{
	// 			Name: to.Ptr("Standard_DS1_v2"),
	// 		},
	// 	},
	// 	{
	// 		Name: to.Ptr("bcae77cd-3119-4766-919f-b50d36c75c7a"),
	// 		Type: to.Ptr("Microsoft.Capacity/reservationOrders/reservations"),
	// 		ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"),
	// 		Etag: to.Ptr[int32](10),
	// 		Location: to.Ptr("eastus"),
	// 		Properties: &armreservations.Properties{
	// 			AppliedScopeProperties: &armreservations.AppliedScopeProperties{
	// 				DisplayName: to.Ptr("Azure subscription 1"),
	// 				SubscriptionID: to.Ptr("/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"),
	// 			},
	// 			AppliedScopeType: to.Ptr(armreservations.AppliedScopeTypeSingle),
	// 			BillingPlan: to.Ptr(armreservations.ReservationBillingPlanMonthly),
	// 			BillingScopeID: to.Ptr("/subscriptions/19376483-64b8-49e4-a931-d5248828720a"),
	// 			DisplayName: to.Ptr("cabri_test"),
	// 			EffectiveDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T01:00:30.925Z"); return t}()),
	// 			ExpiryDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2018-09-22"); return t}()),
	// 			ExpiryDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-09-22T01:00:30.925Z"); return t}()),
	// 			ExtendedStatusInfo: &armreservations.ExtendedStatusInfo{
	// 				Message: to.Ptr("This reservation was split and is no longer active."),
	// 				StatusCode: to.Ptr(armreservations.ReservationStatusCodeSplit),
	// 			},
	// 			InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOff),
	// 			LastUpdatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T01:00:36.319Z"); return t}()),
	// 			ProvisioningState: to.Ptr(armreservations.ProvisioningStateSucceeded),
	// 			Quantity: to.Ptr[int32](3),
	// 			Renew: to.Ptr(false),
	// 			ReservedResourceType: to.Ptr(armreservations.ReservedResourceTypeVirtualMachines),
	// 			SKUDescription: to.Ptr("D1 v2"),
	// 			SplitProperties: &armreservations.ReservationSplitProperties{
	// 				SplitDestinations: []*string{
	// 					to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7"),
	// 					to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de")},
	// 				},
	// 			},
	// 			SKU: &armreservations.SKUName{
	// 				Name: to.Ptr("Standard_DS1_v2"),
	// 			},
	// 	}}
}

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

JavaScript

const { AzureReservationAPI } = require("@azure/arm-reservations");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Split a `Reservation` into two `Reservation`s with specified quantity distribution.
 *
 * @summary Split a `Reservation` into two `Reservation`s with specified quantity distribution.
 * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/SplitReservation.json
 */
async function split() {
  const reservationOrderId = "276e7ae4-84d0-4da6-ab4b-d6b94f3557da";
  const body = {
    quantities: [1, 2],
    reservationId:
      "/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a",
  };
  const credential = new DefaultAzureCredential();
  const client = new AzureReservationAPI(credential);
  const result = await client.reservation.beginSplitAndWait(reservationOrderId, body);
  console.log(result);
}

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

dotnet

using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Reservations;
using Azure.ResourceManager.Reservations.Models;

// Generated from example definition: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/SplitReservation.json
// this example is just showing the usage of "Reservation_Split" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ReservationOrderResource created on azure
// for more information of creating ReservationOrderResource, please refer to the document of ReservationOrderResource
Guid reservationOrderId = Guid.Parse("276e7ae4-84d0-4da6-ab4b-d6b94f3557da");
ResourceIdentifier reservationOrderResourceId = ReservationOrderResource.CreateResourceIdentifier(reservationOrderId);
ReservationOrderResource reservationOrder = client.GetReservationOrderResource(reservationOrderResourceId);

// invoke the operation
SplitContent content = new SplitContent()
{
    Quantities =
    {
    1,2
    },
    ReservationId = new ResourceIdentifier("/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"),
};
ArmOperation<IList<ReservationDetailData>> lro = await reservationOrder.SplitReservationAsync(WaitUntil.Completed, content);
IList<ReservationDetailData> result = lro.Value;

Console.WriteLine($"Succeeded: {result}");

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

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

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

200

[
  {
    "sku": {
      "name": "Standard_DS1_v2"
    },
    "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
    "type": "Microsoft.Capacity/reservationOrders/reservations",
    "name": "00238563-7312-4c20-a134-8c030bf938a7",
    "etag": 2,
    "location": "eastus",
    "properties": {
      "appliedScopeProperties": {
        "subscriptionId": "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3",
        "displayName": "Azure subscription 1"
      },
      "renew": false,
      "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
      "appliedScopeType": "Single",
      "quantity": 1,
      "provisioningState": "Succeeded",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T01:00:30.9253826Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T01:00:30.9253826Z",
      "lastUpdatedDateTime": "2017-09-22T01:00:36.3191627Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
      }
    }
  },
  {
    "sku": {
      "name": "Standard_DS1_v2"
    },
    "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
    "type": "Microsoft.Capacity/reservationOrders/reservations",
    "name": "e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
    "etag": 2,
    "location": "eastus",
    "properties": {
      "appliedScopeProperties": {
        "subscriptionId": "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3",
        "displayName": "Azure subscription 1"
      },
      "renew": false,
      "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
      "appliedScopeType": "Single",
      "quantity": 2,
      "provisioningState": "Succeeded",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T01:00:30.9253826Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T01:00:30.9253826Z",
      "lastUpdatedDateTime": "2017-09-22T01:00:36.3191627Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
      }
    }
  },
  {
    "sku": {
      "name": "Standard_DS1_v2"
    },
    "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a",
    "type": "Microsoft.Capacity/reservationOrders/reservations",
    "name": "bcae77cd-3119-4766-919f-b50d36c75c7a",
    "etag": 10,
    "location": "eastus",
    "properties": {
      "appliedScopeProperties": {
        "subscriptionId": "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3",
        "displayName": "Azure subscription 1"
      },
      "renew": false,
      "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
      "appliedScopeType": "Single",
      "quantity": 3,
      "provisioningState": "Cancelled",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T01:00:30.9253826Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T01:00:30.9253826Z",
      "extendedStatusInfo": {
        "statusCode": "Split",
        "message": "This reservation was split and is no longer active."
      },
      "lastUpdatedDateTime": "2017-09-22T01:00:36.3191627Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitDestinations": [
          "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
          "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
        ]
      }
    }
  }
]

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

202

Location: https://management.azure.com/providers/Microsoft.Capacity/reservationorders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/splitoperationresults/bcae77cd-3119-4766-919f-b50d36c75c7a_10?api-version=2022-11-01
Retry-After: 120

Определения

Имя	Описание
AppliedScopeProperties	Свойства, относящиеся к примененным область типу. Не требуется, если неприменимо. Требуется и необходимо предоставить tenantId и managementGroupId, если AppliedScopeType имеет значение ManagementGroup
AppliedScopeType	Тип примененной области.
BillingCurrencyTotal	Валюта и сумма, которые клиент будет взимать в местной валюте клиента для продления покупки. Налог не включен.
createdByType	Тип удостоверения, создавшего ресурс.
Error	Сведения об ошибках.
ErrorResponseCode	Код ошибки, описывающий причину, по которой служба не может обработать входящий запрос
ExtendedErrorInfo	Расширенные сведения об ошибке, включая код ошибки и сообщение об ошибке
ExtendedStatusInfo
InstanceFlexibility	При включении этого параметра скидка на резервирование применяется к другим виртуальным машинам в той же группе размера виртуальных машин. Укажите только для зарезервированного типа ресурса VirtualMachines.
Kind	Зарезервированный тип поставщика ресурсов.
PricingCurrencyTotal	Сумма, которую корпорация Майкрософт использует для записи. Используется при возврате средств для расчета лимита возмещения. Налог не включен. Эта цена заблокирована за 30 дней до истечения срока действия.
ProvisioningState	Представляет текущее состояние резервирования.
PurchaseRequest	Запрос на покупку резервирования
RenewPropertiesResponse	Свойства продления для резервирования.
ReservationBillingPlan	Представлять планы выставления счетов.
ReservationMergeProperties	Свойства слияния резервирования
ReservationResponse	Определение резервирования.
ReservationSplitProperties	Свойства разделения резервирования
ReservationsProperties	Свойства резервирований
ReservationStatusCode
ReservationSwapProperties	Свойства переключения резервирования
ReservationTerm	Представляет термин резервирования.
ReservationUtilizationAggregates	Агрегированные значения использования резервирования
ReservedResourceProperties	Свойства, относящиеся к каждому типу зарезервированного ресурса. Не требуется, если неприменимо.
ReservedResourceType	Тип зарезервированного ресурса.
SkuName	Имя SKU
SplitRequest	Запрос на разделение резервирования
systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.
Utilization	Использование резервирования

AppliedScopeProperties

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

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

AppliedScopeType

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

Имя	Тип	Описание
ManagementGroup	string
Shared	string
Single	string

BillingCurrencyTotal

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

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

createdByType

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

Имя	Тип	Описание
Application	string
Key	string
ManagedIdentity	string
User	string

Error

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

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

ErrorResponseCode

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

Имя	Тип	Описание
ActivateQuoteFailed	string
AppliedScopesNotAssociatedWithCommerceAccount	string
AppliedScopesSameAsExisting	string
AuthorizationFailed	string
BadRequest	string
BillingCustomerInputError	string
BillingError	string
BillingPaymentInstrumentHardError	string
BillingPaymentInstrumentSoftError	string
BillingScopeIdCannotBeChanged	string
BillingTransientError	string
CalculatePriceFailed	string
CapacityUpdateScopesFailed	string
ClientCertificateThumbprintNotSet	string
CreateQuoteFailed	string
Forbidden	string
FulfillmentConfigurationError	string
FulfillmentError	string
FulfillmentOutOfStockError	string
FulfillmentTransientError	string
HttpMethodNotSupported	string
InternalServerError	string
InvalidAccessToken	string
InvalidFulfillmentRequestParameters	string
InvalidHealthCheckType	string
InvalidLocationId	string
InvalidRefundQuantity	string
InvalidRequestContent	string
InvalidRequestUri	string
InvalidReservationId	string
InvalidReservationOrderId	string
InvalidSingleAppliedScopesCount	string
InvalidSubscriptionId	string
InvalidTenantId	string
MissingAppliedScopesForSingle	string
MissingTenantId	string
NoValidReservationsToReRate	string
NonsupportedAccountId	string
NotSpecified	string
NotSupportedCountry	string
OperationCannotBePerformedInCurrentState	string
OperationFailed	string
PatchValuesSameAsExisting	string
PaymentInstrumentNotFound	string
PurchaseError	string
ReRateOnlyAllowedForEA	string
RefundLimitExceeded	string
ReservationIdNotInReservationOrder	string
ReservationOrderCreationFailed	string
ReservationOrderIdAlreadyExists	string
ReservationOrderNotEnabled	string
ReservationOrderNotFound	string
RiskCheckFailed	string
RoleAssignmentCreationFailed	string
SelfServiceRefundNotSupported	string
ServerTimeout	string
UnauthenticatedRequestsThrottled	string
UnsupportedReservationTerm	string

ExtendedErrorInfo

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

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

ExtendedStatusInfo

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

InstanceFlexibility

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

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

Kind

Зарезервированный тип поставщика ресурсов.

Имя	Тип	Описание
Microsoft.Compute	string

PricingCurrencyTotal

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

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

ProvisioningState

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

Имя	Тип	Описание
BillingFailed	string
Cancelled	string
ConfirmedBilling	string
ConfirmedResourceHold	string
Created	string
Creating	string
Expired	string
Failed	string
Merged	string
PendingBilling	string
PendingResourceHold	string
Split	string
Succeeded	string

PurchaseRequest

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

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

RenewPropertiesResponse

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

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

ReservationBillingPlan

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

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

ReservationMergeProperties

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

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

ReservationResponse

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

Имя	Тип	Описание
etag	integer
id	string	Полный идентификатор ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	Kind	Зарезервированный тип поставщика ресурсов.
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		Свойства, относящиеся к примененным область типу. Не требуется, если неприменимо. Требуется и необходимо предоставить tenantId и managementGroupId, если AppliedScopeType имеет значение ManagementGroup
appliedScopeType	AppliedScopeType		Примененный тип область
appliedScopes	string[]		Список примененных областей
archived	boolean		Указывает, архивировано ли резервирование.
benefitStartTime	string		Это дата и время начала резервирования.
billingPlan	ReservationBillingPlan		Параметры плана выставления счетов, доступные для этого номера SKU.
billingScopeId	string		Подписка, которая будет взиматься за приобретение резервирования или накопительного плана
capabilities	string		Возможности резервирования
displayName	string		Понятное имя для пользователя, чтобы легко идентифицировать резервирование
displayProvisioningState	string		Состояние подготовки резервирования для отображения, например Успешно
effectiveDateTime	string		Дата и время резервирования, начиная с момента вступления в силу этой версии.
expiryDate	string		Это дата истечения срока действия резервирования.
expiryDateTime	string		Это дата и время истечения срока действия резервирования.
extendedStatusInfo	ExtendedStatusInfo		Сообщение с подробными сведениями о коде состояния.
instanceFlexibility	InstanceFlexibility		Позволяет применять скидку на резервирование по номерам SKU в одной группе автоматического размещения. Не все номера SKU поддерживают гибкость размера экземпляра.
lastUpdatedDateTime	string		DateTime последнего обновления резервирования.
mergeProperties	ReservationMergeProperties		Свойства слияния резервирования
provisioningState	ProvisioningState		Текущее состояние резервирования.
provisioningSubState	string		Подчиненное состояние подготовки резервирования, например Выполнено
purchaseDate	string		Это дата приобретения резервирования.
purchaseDateTime	string		Это дата и время приобретения резервирования.
quantity	integer		Количество номеров 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		Это дата и время, когда необходимо проверить Преимущество гибридного использования Azure.
skuDescription	string		Описание SKU на английском языке.
splitProperties	ReservationSplitProperties		Свойства разделения резервирования
swapProperties	ReservationSwapProperties		Свойства переключения резервирования
term	ReservationTerm		Представляет термин резервирования.
userFriendlyAppliedScopeType	string		Примененный область тип резервирования для отображения, например Общий
userFriendlyRenewState	string		Состояние продления резервирования для отображения, например On
utilization	Utilization		Использование резервирования

ReservationStatusCode

Имя	Тип	Описание
Active	string
Expired	string
Merged	string
None	string
PaymentInstrumentError	string
Pending	string
Processing	string
PurchaseError	string
Split	string
Succeeded	string

ReservationSwapProperties

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

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

ReservationTerm

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

Имя	Тип	Описание
P1Y	string
P3Y	string
P5Y	string

ReservationUtilizationAggregates

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

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

ReservedResourceProperties

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

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

ReservedResourceType

Тип зарезервированного ресурса.

Имя	Тип	Описание
AVS	string
AppService	string
AzureDataExplorer	string
AzureFiles	string
BlockBlob	string
CosmosDb	string
DataFactory	string
Databricks	string
DedicatedHost	string
ManagedDisk	string
MariaDb	string
MySql	string
NetAppStorage	string
PostgreSql	string
RedHat	string
RedHatOsa	string
RedisCache	string
SapHana	string
SqlAzureHybridBenefit	string
SqlDataWarehouse	string
SqlDatabases	string
SqlEdge	string
SuseLinux	string
VMwareCloudSimple	string
VirtualMachineSoftware	string
VirtualMachines	string

SkuName

Имя SKU

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

SplitRequest

Запрос на разделение резервирования

Имя	Тип	Описание
properties.quantities	integer[]	Список количества создаваемых резервирований.
properties.reservationId	string	Идентификатор ресурса резервирования, который необходимо разделить. Формат идентификатора ресурса должен быть /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

systemData

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

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

Utilization

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

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