Reservation - Merge

リファレンス

Service:: Reserved VM Instances

API Version:: 2022-11-01

2 つの Reservations をマージします。
指定した Reservationを新しい Reservationにマージします。マージされる 2 つの Reservationプロパティは同じである必要があります。

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

URI パラメーター

名前	/	必須	型	説明
reservationOrderId	path	True	string	予約の注文 ID
api-version	query	True	string	サポートされているバージョン。

要求本文

名前	型	説明
properties.sources	string[]	リソース ID の形式は /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} にする必要があります

応答

名前型説明

200 OK

ReservationResponse[]

マージ後に作成された Reservation を返します。

202 Accepted

要求が受け入れられ、処理中です

Headers

Location: string
Retry-After: integer

Other Status Codes

予期しないエラーが発生しました。

例

Merge

Sample Request

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

{
  "properties": {
    "sources": [
      "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/cea04232-932e-47db-acb5-e29a945ecc73",
      "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/5bf54dc7-dacd-4f46-a16b-7b78f4a59799"
    ]
  }
}

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

/** Samples for Reservation Merge. */
public final class Main {
    /*
     * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/MergeReservations.json
     */
    /**
     * Sample code: Merge.
     *
     * @param manager Entry point to ReservationsManager.
     */
    public static void merge(com.azure.resourcemanager.reservations.ReservationsManager manager) {
        manager
            .reservations()
            .merge(
                "276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
                new MergeRequest()
                    .withSources(
                        Arrays
                            .asList(
                                "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/cea04232-932e-47db-acb5-e29a945ecc73",
                                "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/5bf54dc7-dacd-4f46-a16b-7b78f4a59799")),
                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

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

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-reservations
# USAGE
    python merge_reservations.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_merge(
        reservation_order_id="276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
        body={
            "properties": {
                "sources": [
                    "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/cea04232-932e-47db-acb5-e29a945ecc73",
                    "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/5bf54dc7-dacd-4f46-a16b-7b78f4a59799",
                ]
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/MergeReservations.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/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/MergeReservations.json
func ExampleReservationClient_BeginMerge() {
	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().BeginMerge(ctx, "276e7ae4-84d0-4da6-ab4b-d6b94f3557da", armreservations.MergeRequest{
		Properties: &armreservations.MergeProperties{
			Sources: []*string{
				to.Ptr("/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/cea04232-932e-47db-acb5-e29a945ecc73"),
				to.Ptr("/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/5bf54dc7-dacd-4f46-a16b-7b78f4a59799")},
		},
	}, 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](5),
	// 		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-22T22:46:32.763Z"); 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-22T22:46:32.763Z"); return t}()),
	// 			ExtendedStatusInfo: &armreservations.ExtendedStatusInfo{
	// 				Message: to.Ptr("This reservation was merged and is no longer active."),
	// 				StatusCode: to.Ptr(armreservations.ReservationStatusCodeMerged),
	// 			},
	// 			InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOff),
	// 			LastUpdatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T22:46:32.763Z"); return t}()),
	// 			MergeProperties: &armreservations.ReservationMergeProperties{
	// 				MergeDestination: to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"),
	// 			},
	// 			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](4),
	// 		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-22T22:46:32.763Z"); 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-22T22:46:32.763Z"); return t}()),
	// 			ExtendedStatusInfo: &armreservations.ExtendedStatusInfo{
	// 				Message: to.Ptr("This reservation was merged and is no longer active."),
	// 				StatusCode: to.Ptr(armreservations.ReservationStatusCodeMerged),
	// 			},
	// 			InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOff),
	// 			LastUpdatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T22:46:32.763Z"); return t}()),
	// 			MergeProperties: &armreservations.ReservationMergeProperties{
	// 				MergeDestination: to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"),
	// 			},
	// 			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("6ef59113-3482-40da-8d79-787f823e34bc"),
	// 		Type: to.Ptr("Microsoft.Capacity/reservationOrders/reservations"),
	// 		ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"),
	// 		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-22T22:46:32.763Z"); 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-22T22:46:32.763Z"); return t}()),
	// 			InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOff),
	// 			LastUpdatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T22:46:32.763Z"); return t}()),
	// 			MergeProperties: &armreservations.ReservationMergeProperties{
	// 				MergeSources: []*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")},
	// 				},
	// 				ProvisioningState: to.Ptr(armreservations.ProvisioningStateSucceeded),
	// 				Quantity: to.Ptr[int32](3),
	// 				Renew: to.Ptr(false),
	// 				ReservedResourceType: to.Ptr(armreservations.ReservedResourceTypeVirtualMachines),
	// 				SKUDescription: to.Ptr("D1 v2"),
	// 			},
	// 			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

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

/**
 * This sample demonstrates how to Merge the specified `Reservation`s into a new `Reservation`. The two `Reservation`s being merged must have same properties.
 *
 * @summary Merge the specified `Reservation`s into a new `Reservation`. The two `Reservation`s being merged must have same properties.
 * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/MergeReservations.json
 */
async function merge() {
  const reservationOrderId = "276e7ae4-84d0-4da6-ab4b-d6b94f3557da";
  const body = {
    sources: [
      "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/cea04232-932e-47db-acb5-e29a945ecc73",
      "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/5bf54dc7-dacd-4f46-a16b-7b78f4a59799",
    ],
  };
  const credential = new DefaultAzureCredential();
  const client = new AzureReservationAPI(credential);
  const result = await client.reservation.beginMergeAndWait(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

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/MergeReservations.json
// this example is just showing the usage of "Reservation_Merge" 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
MergeContent content = new MergeContent()
{
    Sources =
    {
    "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/cea04232-932e-47db-acb5-e29a945ecc73","/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/5bf54dc7-dacd-4f46-a16b-7b78f4a59799"
    },
};
ArmOperation<IList<ReservationDetailData>> lro = await reservationOrder.MergeReservationAsync(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

Sample Response

Status code:: 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": 5,
    "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": "Cancelled",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T22:46:32.7632798Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
      "extendedStatusInfo": {
        "statusCode": "Merged",
        "message": "This reservation was merged and is no longer active."
      },
      "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
      },
      "mergeProperties": {
        "mergeDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"
      }
    }
  },
  {
    "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": 4,
    "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": "Cancelled",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T22:46:32.7632798Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
      "extendedStatusInfo": {
        "statusCode": "Merged",
        "message": "This reservation was merged and is no longer active."
      },
      "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
      },
      "mergeProperties": {
        "mergeDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"
      }
    }
  },
  {
    "sku": {
      "name": "Standard_DS1_v2"
    },
    "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc",
    "type": "Microsoft.Capacity/reservationOrders/reservations",
    "name": "6ef59113-3482-40da-8d79-787f823e34bc",
    "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": 3,
      "provisioningState": "Succeeded",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T22:46:32.7632798Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
      "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "mergeProperties": {
        "mergeSources": [
          "/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"
        ]
      }
    }
  }
]

Status code:: 202

Location: https://management.azure.com/providers/Microsoft.Capacity/reservationorders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/mergeoperationresults/6ef59113-3482-40da-8d79-787f823e34bc_10?api-version=2022-11-01
Retry-After: 120

定義

名前	説明
AppliedScopeProperties	適用されたスコープの種類に固有のプロパティ。該当しない場合は必須ではありません。 AppliedScopeType が ManagementGroup の場合は、tenantId と managementGroupId を指定する必要があり、必須
AppliedScopeType	適用されたスコープの種類。
BillingCurrencyTotal	顧客が更新購入のためにお客様の現地通貨で請求される通貨と金額。税金は含まれていません。
createdByType	リソースを作成した ID の種類。
Error	エラー情報
ErrorResponseCode	サービスが受信要求を処理できない理由を説明するエラーコード
ExtendedErrorInfo	エラーコードとエラーメッセージを含む拡張エラー情報
ExtendedStatusInfo
InstanceFlexibility	これをオンにすると、同じ VM サイズグループ内の他の VM に予約割引が適用されます。 VirtualMachines の予約済みリソースの種類にのみを指定します。
Kind	予約するリソースプロバイダーの種類。
MergeRequest	予約のマージの要求
PricingCurrencyTotal	Microsoft がレコードに使用する金額。払い戻し制限を計算するために払い戻し中に使用されます。税金は含まれていません。これは、有効期限の 30 日前にロックされた価格です。
ProvisioningState	Reservation の現在の状態を表します。
PurchaseRequest	予約購入の要求
RenewPropertiesResponse	予約の更新プロパティ。
ReservationBillingPlan	課金プランを表します。
ReservationMergeProperties	予約のマージのプロパティ
ReservationResponse	予約の定義。
ReservationSplitProperties	予約分割のプロパティ
ReservationsProperties	予約のプロパティ
ReservationStatusCode
ReservationSwapProperties	予約スワップのプロパティ
ReservationTerm	予約の期間を表します。
ReservationUtilizationAggregates	予約使用率の集計値
ReservedResourceProperties	各予約済みリソースの種類に固有のプロパティ。該当しない場合は必須ではありません。
ReservedResourceType	予約されているリソースの種類。
SkuName	SKU の名前
systemData	リソースの作成と最後の変更に関連するメタデータ。
Utilization	予約の使用率

AppliedScopeProperties

適用されたスコープの種類に固有のプロパティ。該当しない場合は必須ではありません。 AppliedScopeType が ManagementGroup の場合は、tenantId と managementGroupId を指定する必要があり、必須

名前	型	説明
displayName	string	表示名
managementGroupId	string	特典を適用する必要がある管理グループの完全修飾識別子。
resourceGroupId	string	リソースグループの完全修飾識別子。
subscriptionId	string	サブスクリプションの完全修飾識別子。
tenantId	string	節約プランが特典を適用する必要があるテナント ID。

AppliedScopeType

適用されたスコープの種類。

名前	型	説明
ManagementGroup	string
Shared	string
Single	string

BillingCurrencyTotal

顧客が更新購入のためにお客様の現地通貨で請求される通貨と金額。税金は含まれていません。

名前	型	説明
amount	number
currencyCode	string	この購入レコードで使用される通貨の ISO 4217 3 文字の通貨コード。

createdByType

リソースを作成した ID の種類。

名前	型	説明
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

これをオンにすると、同じ VM サイズグループ内の他の VM に予約割引が適用されます。 VirtualMachines の予約済みリソースの種類にのみを指定します。

名前	型	説明
Off	string
On	string

Kind

予約するリソースプロバイダーの種類。

名前	型	説明
Microsoft.Compute	string

MergeRequest

予約のマージの要求

名前	型	説明
properties.sources	string[]	リソース ID の形式は /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} にする必要があります

PricingCurrencyTotal

Microsoft がレコードに使用する金額。払い戻し制限を計算するために払い戻し中に使用されます。税金は含まれていません。これは、有効期限の 30 日前にロックされた価格です。

名前	型	説明
amount	number
currencyCode	string	この購入レコードで使用される通貨の ISO 4217 3 文字の通貨コード。

ProvisioningState

Reservation の現在の状態を表します。

名前	型	説明
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

予約購入の要求

名前	型	既定値	説明
location	string		予約済みリソースが格納されている Azure リージョン。
properties.appliedScopeProperties	AppliedScopeProperties		適用されたスコープの種類に固有のプロパティ。該当しない場合は必須ではありません。 AppliedScopeType が ManagementGroup の場合は、tenantId と managementGroupId を指定する必要があり、必須
properties.appliedScopeType	AppliedScopeType		適用されたスコープの種類。
properties.appliedScopes	string[]		特典が適用されるサブスクリプションの一覧。 AppliedScopeType が Shared かどうかを指定しないでください。このプロパティは非推奨となり、Single AppliedScopeType の代わりに appliedScopeProperties に置き換えられます。
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	Microsoft がレコードに使用する金額。払い戻し制限を計算するために払い戻し中に使用されます。税金は含まれていません。これは、有効期限の 30 日前にロックされた価格です。
purchaseProperties	PurchaseRequest	予約購入の要求

ReservationBillingPlan

課金プランを表します。

名前	型	説明
Monthly	string
Upfront	string

ReservationMergeProperties

予約のマージのプロパティ

名前	型	説明
mergeDestination	string	予約リソース ID マージのために作成されました。リソース ID の形式は /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} です
mergeSources	string[]	この予約を形成するためにマージされたソース予約のリソース ID。リソース ID の形式は /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} です

ReservationResponse

予約の定義。

名前	型	説明
etag	integer
id	string	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	Kind	予約するリソースプロバイダーの種類。
location	string	予約済みリソースが格納されている Azure リージョン。
name	string	リソースの名前
properties	ReservationsProperties	この予約に関連付けられているプロパティ
sku	SkuName	この予約に関連付けられている SKU 情報
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

ReservationSplitProperties

予約分割のプロパティ

名前	型	説明
splitDestinations	string[]	分割が原因で作成されたターゲットリソース ID の一覧。リソース ID の形式は /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} です
splitSource	string	これが分割される予約のリソース ID。リソース ID の形式は /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} です

ReservationsProperties

予約のプロパティ

名前	型	既定値	説明
appliedScopeProperties	AppliedScopeProperties		適用されたスコープの種類に固有のプロパティ。該当しない場合は必須ではありません。 AppliedScopeType が ManagementGroup の場合は、tenantId と managementGroupId を指定する必要があり、必須
appliedScopeType	AppliedScopeType		適用されたスコープの種類
appliedScopes	string[]		適用されたスコープの一覧
archived	boolean		予約がアーカイブされているかどうかを示します
benefitStartTime	string		これは、予約特典が開始されたときの DateTime です。
billingPlan	ReservationBillingPlan		この SKU で使用できる課金プランオプション。
billingScopeId	string		予約または節約プランの購入に対して課金されるサブスクリプション
capabilities	string		予約の機能
displayName	string		予約を簡単に識別するためのユーザーのフレンドリ名
displayProvisioningState	string		表示する予約のプロビジョニング状態 (成功など)
effectiveDateTime	string		このバージョンが有効になったときに開始される予約の DateTime。
expiryDate	string		これは、予約の有効期限が切れる日付です。
expiryDateTime	string		これは、予約の有効期限が切れる日時です。
extendedStatusInfo	ExtendedStatusInfo		状態コードに関する詳細情報を示すメッセージ。
instanceFlexibility	InstanceFlexibility		同じ自動調整グループ内の SKU 間で予約割引を適用できるようにします。すべての SKU でインスタンスサイズの柔軟性がサポートされているわけではありません。
lastUpdatedDateTime	string		予約が最後に更新された日時。
mergeProperties	ReservationMergeProperties		予約のマージのプロパティ
provisioningState	ProvisioningState		予約の現在の状態。
provisioningSubState	string		予約のプロビジョニングサブ状態 (成功など)
purchaseDate	string		これは、予約が購入された日付です。
purchaseDateTime	string		これは、予約が購入された日時です。
quantity	integer		予約の一部である SKU の数量。
renew	boolean	False	これを true に設定すると、有効期限時に新しい予約が自動的に購入されます。
renewDestination	string		更新のために購入された予約の予約 ID。リソース ID の形式は /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} です。
renewProperties	RenewPropertiesResponse		予約の更新プロパティ。
renewSource	string		この予約の更新元の予約の予約 ID。リソース ID の形式は /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	元のリソースがスワップされる予約リソース ID。リソース ID の形式は /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} です
swapSource	string	スワップされるソース予約のリソース ID。リソース ID の形式は /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	これをオンにすると、同じ VM サイズグループ内の他の VM に予約割引が適用されます。 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

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

Utilization

予約の使用率

名前	型	説明
aggregates	ReservationUtilizationAggregates[]	予約の使用率の集計の配列
trend	string	予約の過去 7 日間の使用率の傾向