Reservation - Merge

リファレンス

サービス:: Reserved VM Instances

API バージョン:: 2022-11-01

2 つの Reservationをマージします。
指定した 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

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

ヘッダー

Location: string
Retry-After: integer

Other Status Codes

予期しないエラー

例

Merge

要求のサンプル

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 Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Reservations.Models;
using Azure.ResourceManager.Reservations;

// 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

応答のサンプル

状態コード:: 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"
        ]
      }
    }
  }
]

状態コード:: 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	予約の現在の状態を表します。
PurchaseRequest	予約購入の要求
RenewPropertiesResponse	予約の更新プロパティ。
ReservationBillingPlan	課金プランを表します。
ReservationMergeProperties	予約のマージのプロパティ
ReservationResponse	予約の定義。
ReservationSplitProperties	予約分割のプロパティ
ReservationsProperties	予約のプロパティ
ReservationStatusCode
ReservationSwapProperties	予約スワップのプロパティ
ReservationTerm	予約の期間を表します。
ReservationUtilizationAggregates	予約使用率の集計値
ReservedResourceProperties	各予約済みリソースの種類に固有のプロパティ。該当しない場合は必須ではありません。
ReservedResourceType	予約されているリソースの種類。
SkuName	SKU の名前
systemData	リソースの作成と最後の変更に関連するメタデータ。
Utilization	予約の使用率

AppliedScopeProperties

Object

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

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

AppliedScopeType

列挙

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

値	説明
ManagementGroup
Shared
Single

BillingCurrencyTotal

Object

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

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

createdByType

列挙

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

値	説明
Application
Key
ManagedIdentity
User

Error

Object

エラー情報

名前	型	説明
error	ExtendedErrorInfo	エラーコードとエラーメッセージを含む拡張エラー情報

ErrorResponseCode

列挙

サービスが受信要求を処理できない理由を説明するエラーコード

値	説明
ActivateQuoteFailed
AppliedScopesNotAssociatedWithCommerceAccount
AppliedScopesSameAsExisting
AuthorizationFailed
BadRequest
BillingCustomerInputError
BillingError
BillingPaymentInstrumentHardError
BillingPaymentInstrumentSoftError
BillingScopeIdCannotBeChanged
BillingTransientError
CalculatePriceFailed
CapacityUpdateScopesFailed
ClientCertificateThumbprintNotSet
CreateQuoteFailed
Forbidden
FulfillmentConfigurationError
FulfillmentError
FulfillmentOutOfStockError
FulfillmentTransientError
HttpMethodNotSupported
InternalServerError
InvalidAccessToken
InvalidFulfillmentRequestParameters
InvalidHealthCheckType
InvalidLocationId
InvalidRefundQuantity
InvalidRequestContent
InvalidRequestUri
InvalidReservationId
InvalidReservationOrderId
InvalidSingleAppliedScopesCount
InvalidSubscriptionId
InvalidTenantId
MissingAppliedScopesForSingle
MissingTenantId
NoValidReservationsToReRate
NonsupportedAccountId
NotSpecified
NotSupportedCountry
OperationCannotBePerformedInCurrentState
OperationFailed
PatchValuesSameAsExisting
PaymentInstrumentNotFound
PurchaseError
ReRateOnlyAllowedForEA
RefundLimitExceeded
ReservationIdNotInReservationOrder
ReservationOrderCreationFailed
ReservationOrderIdAlreadyExists
ReservationOrderNotEnabled
ReservationOrderNotFound
RiskCheckFailed
RoleAssignmentCreationFailed
SelfServiceRefundNotSupported
ServerTimeout
UnauthenticatedRequestsThrottled
UnsupportedReservationTerm

ExtendedErrorInfo

Object

エラーコードとエラーメッセージを含む拡張エラー情報

名前	型	説明
code	ErrorResponseCode	サービスが受信要求を処理できない理由を説明するエラーコード
message	string

ExtendedStatusInfo

Object

名前	型	説明
message	string	状態コードに関する詳細情報を示すメッセージ。
statusCode	ReservationStatusCode

InstanceFlexibility

列挙

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

値	説明
Off
On

Kind

列挙

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

値	説明
Microsoft.Compute

MergeRequest

Object

予約のマージの要求

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

PricingCurrencyTotal

Object

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

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

ProvisioningState

列挙

予約の現在の状態を表します。

値	説明
BillingFailed
Cancelled
ConfirmedBilling
ConfirmedResourceHold
Created
Creating
Expired
Failed
Merged
PendingBilling
PendingResourceHold
Split
Succeeded

PurchaseRequest

Object

予約購入の要求

名前	型	規定値	説明
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 (int32)		予約の一部である SKU の数量。
properties.renew	boolean	False	これを true に設定すると、有効期限の日時に新しい予約が自動的に購入されます。
properties.reservedResourceProperties	ReservedResourceProperties		各予約済みリソースの種類に固有のプロパティ。該当しない場合は必須ではありません。
properties.reservedResourceType	ReservedResourceType		予約されているリソースの種類。
properties.reviewDateTime	string (date-time)		これは、Azure ハイブリッド特典を確認する必要がある日時です。
properties.term	ReservationTerm		予約の期間を表します。
sku	SkuName		SKU の名前

RenewPropertiesResponse

Object

予約の更新プロパティ。

名前	型	説明
billingCurrencyTotal	BillingCurrencyTotal	更新購入に対して顧客の現地通貨で請求される通貨と金額。税金は含まれていません。
pricingCurrencyTotal	PricingCurrencyTotal	Microsoft がレコードに使用する金額。払い戻し制限の計算に払い戻し中に使用されます。税金は含まれていません。これは、有効期限の 30 日前にロックされた価格です。
purchaseProperties	PurchaseRequest	予約購入の要求

ReservationBillingPlan

列挙

課金プランを表します。

値	説明
Monthly
Upfront

ReservationMergeProperties

Object

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

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

ReservationResponse

Object

予約の定義。

名前	型	説明
etag	integer (int32)
id	string (arm-id)	リソースの完全修飾リソース 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

Object

予約分割のプロパティ

名前	型	説明
splitDestinations	string[]	分割のために作成される宛先リソース ID の一覧。リソース ID の形式は /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	これが分割される予約のリソース ID。リソース ID の形式は /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

Object

予約のプロパティ

名前	型	規定値	説明
appliedScopeProperties	AppliedScopeProperties		適用されたスコープの種類に固有のプロパティ。該当しない場合は必須ではありません。 AppliedScopeType が ManagementGroup の場合は、tenantId と managementGroupId を指定する必要があります
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		同じ自動適合グループ内の SKU 間で予約割引を適用できるようにします。すべての 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		更新のために購入された予約の予約 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 (date-time)		これは、Azure ハイブリッド特典を確認する必要がある日時です。
skuDescription	string		英語での SKU の説明。
splitProperties	ReservationSplitProperties		予約分割のプロパティ
swapProperties	ReservationSwapProperties		予約スワップのプロパティ
term	ReservationTerm		予約の期間を表します。
userFriendlyAppliedScopeType	string		表示する予約の適用されたスコープの種類 (共有など)
userFriendlyRenewState	string		表示する予約の更新状態 (例: オン)
utilization	Utilization		予約の使用率

ReservationStatusCode

列挙

値	説明
Active
Expired
Merged
None
PaymentInstrumentError
Pending
Processing
PurchaseError
Split
Succeeded

ReservationSwapProperties

Object

予約スワップのプロパティ

名前	型	説明
swapDestination	string	元のリソースがスワップされる予約リソース ID。リソース ID の形式は /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	スワップされるソース予約のリソース ID。リソース ID の形式は /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

列挙

予約の期間を表します。

値	説明
P1Y
P3Y
P5Y

ReservationUtilizationAggregates

Object

予約使用率の集計値

名前	型	説明
grain	number	集計のグレイン
grainUnit	string	集計のグレイン単位
value	number	集計値
valueUnit	string	集計値の単位

ReservedResourceProperties

Object

各予約済みリソースの種類に固有のプロパティ。該当しない場合は必須ではありません。

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

ReservedResourceType

列挙

予約されているリソースの種類。

値	説明
AVS
AppService
AzureDataExplorer
AzureFiles
BlockBlob
CosmosDb
DataFactory
Databricks
DedicatedHost
ManagedDisk
MariaDb
MySql
NetAppStorage
PostgreSql
RedHat
RedHatOsa
RedisCache
SapHana
SqlAzureHybridBenefit
SqlDataWarehouse
SqlDatabases
SqlEdge
SuseLinux
VMwareCloudSimple
VirtualMachineSoftware
VirtualMachines

SkuName

Object

SKU の名前

名前	型	説明
name	string

systemData

Object

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

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

Utilization

Object

予約の使用率

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