Reservation - Merge

Servicio:

Reserved VM Instances

Versión de la API:

2022-11-01

Combina dos Reservations.
Combine los Reservationespecificados en un nuevo Reservation. Los dos Reservationque se combinan deben tener las mismas propiedades.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
reservationOrderId	path	True	string	Id. de pedido de la reserva
api-version	query	True	string	Versión admitida.

Cuerpo de la solicitud

Nombre	Tipo	Description
properties.sources	string[]	El formato del identificador de recurso debe ser /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

Respuestas

Nombre	Tipo	Description
200 OK	ReservationResponse[]	Devuelve el Reservation creado después de la combinación.
202 Accepted		Se acepta la solicitud y se está procesando. Encabezados Location: string Retry-After: integer
Other Status Codes	Error	Error inesperado

Ejemplos

Merge

Solicitud de ejemplo

HTTP

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"
    ]
  }
}

Java

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

Python

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

Go

package armreservations_test

import (
	"context"
	"log"

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

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/1e7b408f3323e7f5424745718fe62c7a043a2337/specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/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

JavaScript

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

dotnet

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

Respuesta de muestra

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

Definiciones

Nombre	Description
AppliedScopeProperties	Propiedades específicas del tipo de ámbito aplicado. No es necesario si no es aplicable. Obligatorio y necesario proporcionar tenantId y managementGroupId si AppliedScopeType es ManagementGroup
AppliedScopeType	Tipo del ámbito aplicado.
BillingCurrencyTotal	Moneda y importe que se cobrará al cliente en la moneda local del cliente para la compra de renovación. No se incluye el impuesto.
createdByType	Tipo de identidad que creó el recurso.
Error	Información de error
ErrorResponseCode	Código de error que describe el motivo por el que el servicio no puede procesar la solicitud entrante
ExtendedErrorInfo	Información de error extendida, incluido el código de error y el mensaje de error
ExtendedStatusInfo
InstanceFlexibility	Al activar esto, se aplicará el descuento de reserva a otras máquinas virtuales del mismo grupo de tamaño de máquina virtual. Especifique solo el tipo de recurso reservado VirtualMachines.
Kind	Tipo de proveedor de recursos que se va a reservar.
MergeRequest	Solicitud de combinación de reservas
PricingCurrencyTotal	Cantidad que Microsoft usa para el registro. Se usa durante el reembolso para calcular el límite de reembolso. No se incluye el impuesto. Este precio está bloqueado 30 días antes de la expiración.
ProvisioningState	Representa el estado actual de la reserva.
PurchaseRequest	Solicitud de compra de reserva
RenewPropertiesResponse	Propiedades de renovación de una reserva.
ReservationBillingPlan	Representa los planes de facturación.
ReservationMergeProperties	Propiedades de la combinación de reservas
ReservationResponse	Definición de la reserva.
ReservationSplitProperties	Propiedades de división de reserva
ReservationsProperties	Propiedades de las reservas
ReservationStatusCode
ReservationSwapProperties	Propiedades del intercambio de reservas
ReservationTerm	Representa el plazo de reserva.
ReservationUtilizationAggregates	Valores agregados del uso de reservas
ReservedResourceProperties	Propiedades específicas de cada tipo de recurso reservado. No es necesario si no es aplicable.
ReservedResourceType	Tipo del recurso que se está reservando.
SkuName	El nombre de la SKU
systemData	Metadatos relativos a la creación y última modificación del recurso.
Utilization	Uso de reservas

AppliedScopeProperties

Object

Propiedades específicas del tipo de ámbito aplicado. No es necesario si no es aplicable. Obligatorio y necesario proporcionar tenantId y managementGroupId si AppliedScopeType es ManagementGroup

Nombre	Tipo	Description
displayName	string	Nombre para mostrar
managementGroupId	string	Identificador completo del grupo de administración en el que se debe aplicar la ventaja.
resourceGroupId	string	Identificador completo del grupo de recursos.
subscriptionId	string	Identificador completo de la suscripción.
tenantId	string	Id. de inquilino en el que el plan de ahorro debe aplicar la ventaja.

AppliedScopeType

Enumeración

Tipo del ámbito aplicado.

Valor	Description
ManagementGroup
Shared
Single

BillingCurrencyTotal

Object

Moneda y importe que se cobrará al cliente en la moneda local del cliente para la compra de renovación. No se incluye el impuesto.

Nombre	Tipo	Description
amount	number
currencyCode	string	El código de moneda iso 4217 de 3 letras para la moneda utilizada por este registro de compra.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

Error

Object

Información de error

Nombre	Tipo	Description
error	ExtendedErrorInfo	Información de error extendida, incluido el código de error y el mensaje de error

ErrorResponseCode

Enumeración

Código de error que describe el motivo por el que el servicio no puede procesar la solicitud entrante

Valor	Description
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

Información de error extendida, incluido el código de error y el mensaje de error

Nombre	Tipo	Description
code	ErrorResponseCode	Código de error que describe el motivo por el que el servicio no puede procesar la solicitud entrante
message	string

ExtendedStatusInfo

Object

Nombre	Tipo	Description
message	string	Mensaje que proporciona información detallada sobre el código de estado.
statusCode	ReservationStatusCode

InstanceFlexibility

Enumeración

Al activar esto, se aplicará el descuento de reserva a otras máquinas virtuales del mismo grupo de tamaño de máquina virtual. Especifique solo el tipo de recurso reservado VirtualMachines.

Valor	Description
Off
On

Kind

Enumeración

Tipo de proveedor de recursos que se va a reservar.

Valor	Description
Microsoft.Compute

MergeRequest

Object

Solicitud de combinación de reservas

Nombre	Tipo	Description
properties.sources	string[]	El formato del identificador de recurso debe ser /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

PricingCurrencyTotal

Object

Cantidad que Microsoft usa para el registro. Se usa durante el reembolso para calcular el límite de reembolso. No se incluye el impuesto. Este precio está bloqueado 30 días antes de la expiración.

Nombre	Tipo	Description
amount	number
currencyCode	string	El código de moneda iso 4217 de 3 letras para la moneda utilizada por este registro de compra.

ProvisioningState

Enumeración

Representa el estado actual de la reserva.

Valor	Description
BillingFailed
Cancelled
ConfirmedBilling
ConfirmedResourceHold
Created
Creating
Expired
Failed
Merged
PendingBilling
PendingResourceHold
Split
Succeeded

PurchaseRequest

Object

Solicitud de compra de reserva

Nombre	Tipo	Valor predeterminado	Description
location	string		Región de Azure donde reside el recurso reservado.
properties.appliedScopeProperties	AppliedScopeProperties		Propiedades específicas del tipo de ámbito aplicado. No es necesario si no es aplicable. Obligatorio y necesario proporcionar tenantId y managementGroupId si AppliedScopeType es ManagementGroup
properties.appliedScopeType	AppliedScopeType		Tipo del ámbito aplicado.
properties.appliedScopes	string[]		Lista de las suscripciones a las que se aplicará la ventaja. No especifique si AppliedScopeType es Shared. Esta propiedad quedará en desuso y se reemplazará por appliedScopeProperties en su lugar para Single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan		Representa los planes de facturación.
properties.billingScopeId	string		Suscripción que se cobrará por la reserva de compra o el plan de ahorro
properties.displayName	string		Nombre descriptivo de la reserva
properties.quantity	integer (int32)		Cantidad de las sku que forman parte de la reserva.
properties.renew	boolean	False	Si se establece en true, se adquirirá automáticamente una nueva reserva en la fecha de expiración.
properties.reservedResourceProperties	ReservedResourceProperties		Propiedades específicas de cada tipo de recurso reservado. No es necesario si no es aplicable.
properties.reservedResourceType	ReservedResourceType		Tipo del recurso que se está reservando.
properties.reviewDateTime	string (date-time)		Esta es la fecha y hora en que se debe revisar la ventaja híbrida de Azure.
properties.term	ReservationTerm		Representa el plazo de reserva.
sku	SkuName		El nombre de la SKU

RenewPropertiesResponse

Object

Propiedades de renovación de una reserva.

Nombre	Tipo	Description
billingCurrencyTotal	BillingCurrencyTotal	Moneda y importe que se cobrará al cliente en la moneda local del cliente para la compra de renovación. No se incluye el impuesto.
pricingCurrencyTotal	PricingCurrencyTotal	Cantidad que Microsoft usa para el registro. Se usa durante el reembolso para calcular el límite de reembolso. No se incluye el impuesto. Este precio está bloqueado 30 días antes de la expiración.
purchaseProperties	PurchaseRequest	Solicitud de compra de reserva

ReservationBillingPlan

Enumeración

Representa los planes de facturación.

Valor	Description
Monthly
Upfront

ReservationMergeProperties

Object

Propiedades de la combinación de reservas

Nombre	Tipo	Description
mergeDestination	string	Identificador de recurso de reserva Creado debido a la combinación. El formato del identificador de recurso es /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources	string[]	Identificadores de recursos de la reserva de origen combinados para formar esta reserva. El formato del identificador de recurso es /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationResponse

Object

Definición de la reserva.

Nombre	Tipo	Description
etag	integer (int32)
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	Kind	Tipo de proveedor de recursos que se va a reservar.
location	string	Región de Azure donde reside el recurso reservado.
name	string	Nombre del recurso
properties	ReservationsProperties	Propiedades asociadas a esta reserva
sku	SkuName	Información de SKU asociada a esta reserva
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ReservationSplitProperties

Object

Propiedades de división de reserva

Nombre	Tipo	Description
splitDestinations	string[]	Lista del identificador de recurso de destino que se crea debido a la división. El formato del identificador de recurso es /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	Identificador de recurso de la reserva desde la que se divide. El formato del identificador de recurso es /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

Object

Propiedades de las reservas

Nombre	Tipo	Valor predeterminado	Description
appliedScopeProperties	AppliedScopeProperties		Propiedades específicas del tipo de ámbito aplicado. No es necesario si no es aplicable. Obligatorio y necesario proporcionar tenantId y managementGroupId si AppliedScopeType es ManagementGroup
appliedScopeType	AppliedScopeType		Tipo de ámbito aplicado
appliedScopes	string[]		Lista de ámbitos aplicados
archived	boolean		Indica si la reserva está archivada.
benefitStartTime	string (date-time)		Esta es la fecha y hora en que se inició la ventaja de reserva.
billingPlan	ReservationBillingPlan		Las opciones del plan de facturación disponibles para esta SKU.
billingScopeId	string		Suscripción que se cobrará por la reserva de compra o el plan de ahorro
capabilities	string		Funcionalidades de la reserva
displayName	string		Nombre descriptivo para que el usuario identifique fácilmente la reserva
displayProvisioningState	string		Estado de aprovisionamiento de la reserva para mostrar, por ejemplo, Correcto
effectiveDateTime	string (date-time)		DateTime de la reserva a partir de la fecha y hora desde la que esta versión es efectiva.
expiryDate	string (date)		Esta es la fecha en que expirará la reserva.
expiryDateTime	string (date-time)		Esta es la fecha y hora en que expirará la reserva.
extendedStatusInfo	ExtendedStatusInfo		Mensaje que proporciona información detallada sobre el código de estado.
instanceFlexibility	InstanceFlexibility		Permite aplicar el descuento por reserva en las sku del mismo grupo de ajuste automático. No todas las sku admiten flexibilidad de tamaño de instancia.
lastUpdatedDateTime	string (date-time)		DateTime de la última vez que se actualizó la reserva.
mergeProperties	ReservationMergeProperties		Propiedades de la combinación de reservas
provisioningState	ProvisioningState		Estado actual de la reserva.
provisioningSubState	string		El subestamento de aprovisionamiento de la reserva, por ejemplo, Correcto
purchaseDate	string (date)		Esta es la fecha en que se compró la reserva.
purchaseDateTime	string (date-time)		Esta es la fecha y hora en que se compró la reserva.
quantity	integer (int32)		Cantidad de las sku que forman parte de la reserva.
renew	boolean	False	Si se establece en true, se adquirirá automáticamente una nueva reserva en la fecha de expiración.
renewDestination	string		Id. de reserva de la reserva que se compra debido a la renovación. El formato del identificador de recurso es /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties	RenewPropertiesResponse		Propiedades de renovación de una reserva.
renewSource	string		Id. de reserva de la reserva desde la que se renueva esta reserva. El formato del identificador de recurso es /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType	ReservedResourceType		Tipo del recurso que se está reservando.
reviewDateTime	string (date-time)		Esta es la fecha y hora en que se debe revisar la Ventaja híbrida de Azure.
skuDescription	string		Descripción de la SKU en inglés.
splitProperties	ReservationSplitProperties		Propiedades de división de reserva
swapProperties	ReservationSwapProperties		Propiedades del intercambio de reservas
term	ReservationTerm		Representa el plazo de reserva.
userFriendlyAppliedScopeType	string		El tipo de ámbito aplicado de la reserva para mostrar, por ejemplo, Compartido
userFriendlyRenewState	string		Estado de renovación de la reserva para mostrar, por ejemplo, Activado
utilization	Utilization		Uso de reservas

ReservationStatusCode

Enumeración

Valor	Description
Active
Expired
Merged
None
PaymentInstrumentError
Pending
Processing
PurchaseError
Split
Succeeded

ReservationSwapProperties

Object

Propiedades del intercambio de reservas

Nombre	Tipo	Description
swapDestination	string	Identificador de recurso de reserva al que se intercambia el recurso original. El formato del identificador de recurso es /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	Identificador de recurso de la reserva de origen que se intercambia. El formato del identificador de recurso es /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Enumeración

Representa el plazo de reserva.

Valor	Description
P1Y
P3Y
P5Y

ReservationUtilizationAggregates

Object

Valores agregados del uso de reservas

Nombre	Tipo	Description
grain	number	El grano del agregado
grainUnit	string	Unidad de grano del agregado
value	number	Valor agregado
valueUnit	string	Unidad de valor agregado

ReservedResourceProperties

Object

Propiedades específicas de cada tipo de recurso reservado. No es necesario si no es aplicable.

Nombre	Tipo	Description
instanceFlexibility	InstanceFlexibility	Al activar esto, se aplicará el descuento de reserva a otras máquinas virtuales del mismo grupo de tamaño de máquina virtual. Especifique solo el tipo de recurso reservado VirtualMachines.

ReservedResourceType

Enumeración

Tipo del recurso que se está reservando.

Valor	Description
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

El nombre de la SKU

Nombre	Tipo	Description
name	string

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Utilization

Object

Uso de reservas

Nombre	Tipo	Description
aggregates	ReservationUtilizationAggregates[]	Matriz de agregados del uso de una reserva
trend	string	tendencia de uso de los últimos 7 días para una reserva