你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Reservation - Merge

参考

服务:: Reserved VM Instances

API 版本:: 2022-11-01

合并两 Reservation个。
将指定的 Reservation合并到新的 Reservation中。要合并的两 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 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

示例响应

状态代码:: 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	创建资源的标识类型。
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

特定于所应用范围类型的属性。如果不适用，则不需要。如果 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

创建资源的标识类型。

名称	类型	说明
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

表示预留的当前状态。

名称	类型	说明
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 资源管理器元数据。
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		上次更新预留时间的 DateTime。
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		要显示的预留的续订状态，例如“打开”
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	创建资源的标识。
createdByType	createdByType	创建资源的标识类型。
lastModifiedAt	string	资源上次修改的时间戳 (UTC)
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识类型。

Utilization

预留利用率

名称	类型	说明
aggregates	ReservationUtilizationAggregates[]	预留利用率的聚合数组
trend	string	预留的最近 7 天利用率趋势