Reservation - Merge

Dienst:

Reserved VM Instances

API-Version:

2022-11-01

Führt zwei Reservations zusammen.
Führen Sie die angegebenen Reservations in einem neuen Reservationzusammen. Die beiden Reservations, die zusammengeführt werden, müssen dieselben Eigenschaften aufweisen.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
reservationOrderId	path	True	string	Bestell-ID der Reservierung
api-version	query	True	string	Unterstützte Version.

Anforderungstext

Name	Typ	Beschreibung
properties.sources	string[]	Das Format der Ressourcen-ID sollte /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} sein.

Antworten

Name	Typ	Beschreibung
200 OK	ReservationResponse[]	Gibt das Reservation nach dem Merge erstellte zurück.
202 Accepted		Die Anforderung wird akzeptiert und wird verarbeitet. Header Location: string Retry-After: integer
Other Status Codes	Error	Unerwarteter Fehler

Beispiele

Merge

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Statuscode:

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

Definitionen

Name	Beschreibung
AppliedScopeProperties	Spezifische Eigenschaften für den angewendeten Bereichstyp. Nicht erforderlich, falls nicht zutreffend. Erforderlich und müssen tenantId und managementGroupId angeben, wenn AppliedScopeType ManagementGroup ist.
AppliedScopeType	Typ des angewendeten Bereichs.
BillingCurrencyTotal	Währung und Betrag, die dem Kunden für den Kauf der Verlängerung in der lokalen Währung des Kunden in Rechnung gestellt werden. Die Steuer ist nicht inbegriffen.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
Error	Fehlerinformationen
ErrorResponseCode	Fehlercode, der den Grund beschreibt, warum der Dienst die eingehende Anforderung nicht verarbeiten kann
ExtendedErrorInfo	Erweiterte Fehlerinformationen einschließlich Fehlercode und Fehlermeldung
ExtendedStatusInfo
InstanceFlexibility	Wenn Sie dies aktivieren, wird der Reservierungsrabatt auf andere VMs in derselben VM-Größengruppe angewendet. Geben Sie nur für den reservierten Ressourcentyp VirtualMachines an.
Kind	Ressourcenanbietertyp, der reserviert werden soll.
MergeRequest	Die Anforderung für die Reservierungszusammenführung
PricingCurrencyTotal	Betrag, den Microsoft für die Aufzeichnung verwendet. Wird während der Rückerstattung für die Berechnung des Erstattungslimits verwendet. Die Steuer ist nicht inbegriffen. Dies ist der Gesperrte Preis 30 Tage vor Ablauf.
ProvisioningState	Stellen Sie den aktuellen Zustand der Reservierung dar.
PurchaseRequest	Die Anforderung für den Kauf einer Reservierung
RenewPropertiesResponse	Die Verlängerungseigenschaften für eine Reservierung.
ReservationBillingPlan	Stellen Sie die Abrechnungspläne dar.
ReservationMergeProperties	Eigenschaften der Reservierungszusammenführung
ReservationResponse	Die Definition der Reservierung.
ReservationSplitProperties	Eigenschaften der Reservierungsaufteilung
ReservationsProperties	Die Eigenschaften der Reservierungen
ReservationStatusCode
ReservationSwapProperties	Eigenschaften des Reservierungstauschs
ReservationTerm	Stellen Sie den Reservierungsbegriff dar.
ReservationUtilizationAggregates	Die Aggregatwerte der Reservierungsauslastung
ReservedResourceProperties	Eigenschaften, die für jeden reservierten Ressourcentyp spezifisch sind. Nicht erforderlich, falls nicht zutreffend.
ReservedResourceType	Der Typ der Ressource, die reserviert wird.
SkuName	Der Name der sku
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Utilization	Reservierungsnutzung

AppliedScopeProperties

Spezifische Eigenschaften für den angewendeten Bereichstyp. Nicht erforderlich, falls nicht zutreffend. Erforderlich und müssen tenantId und managementGroupId angeben, wenn AppliedScopeType ManagementGroup ist.

Name	Typ	Beschreibung
displayName	string	Anzeigename
managementGroupId	string	Vollqualifizierter Bezeichner der Verwaltungsgruppe, in der der Vorteil angewendet werden muss.
resourceGroupId	string	Vollqualifizierter Bezeichner der Ressourcengruppe.
subscriptionId	string	Vollqualifizierter Bezeichner des Abonnements.
tenantId	string	Mandanten-ID, bei der der Sparplan den Vorteil anwenden soll.

AppliedScopeType

Typ des angewendeten Bereichs.

Name	Typ	Beschreibung
ManagementGroup	string
Shared	string
Single	string

BillingCurrencyTotal

Währung und Betrag, die dem Kunden für den Kauf der Verlängerung in der lokalen Währung des Kunden in Rechnung gestellt werden. Die Steuer ist nicht inbegriffen.

Name	Typ	Beschreibung
amount	number
currencyCode	string	Der 3-Buchstaben-Währungscode nach ISO 4217 für die Währung, die von diesem Kaufdatensatz verwendet wird.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

Error

Fehlerinformationen

Name	Typ	Beschreibung
error	ExtendedErrorInfo	Erweiterte Fehlerinformationen einschließlich Fehlercode und Fehlermeldung

ErrorResponseCode

Fehlercode, der den Grund beschreibt, warum der Dienst die eingehende Anforderung nicht verarbeiten kann

Name	Typ	Beschreibung
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

Erweiterte Fehlerinformationen einschließlich Fehlercode und Fehlermeldung

Name	Typ	Beschreibung
code	ErrorResponseCode	Fehlercode, der den Grund beschreibt, warum der Dienst die eingehende Anforderung nicht verarbeiten kann
message	string

ExtendedStatusInfo

Name	Typ	Beschreibung
message	string	Die Nachricht mit detaillierten Informationen zum status Code.
statusCode	ReservationStatusCode

InstanceFlexibility

Wenn Sie dies aktivieren, wird der Reservierungsrabatt auf andere VMs in derselben VM-Größengruppe angewendet. Geben Sie nur für den reservierten Ressourcentyp VirtualMachines an.

Name	Typ	Beschreibung
Off	string
On	string

Kind

Ressourcenanbietertyp, der reserviert werden soll.

Name	Typ	Beschreibung
Microsoft.Compute	string

MergeRequest

Die Anforderung für die Reservierungszusammenführung

Name	Typ	Beschreibung
properties.sources	string[]	Das Format der Ressourcen-ID sollte /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} sein.

PricingCurrencyTotal

Betrag, den Microsoft für die Aufzeichnung verwendet. Wird während der Rückerstattung für die Berechnung des Erstattungslimits verwendet. Die Steuer ist nicht inbegriffen. Dies ist der Gesperrte Preis 30 Tage vor Ablauf.

Name	Typ	Beschreibung
amount	number
currencyCode	string	Der 3-Buchstaben-Währungscode nach ISO 4217 für die Währung, die von diesem Kaufdatensatz verwendet wird.

ProvisioningState

Stellen Sie den aktuellen Zustand der Reservierung dar.

Name	Typ	Beschreibung
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

Die Anforderung für den Kauf einer Reservierung

Name	Typ	Standardwert	Beschreibung
location	string		Die Azure-Region, in der sich die reservierte Ressource befindet.
properties.appliedScopeProperties	AppliedScopeProperties		Spezifische Eigenschaften für den angewendeten Bereichstyp. Nicht erforderlich, falls nicht zutreffend. Erforderlich und müssen tenantId und managementGroupId angeben, wenn AppliedScopeType ManagementGroup ist.
properties.appliedScopeType	AppliedScopeType		Typ des angewendeten Bereichs.
properties.appliedScopes	string[]		Liste der Abonnements, für die der Vorteil angewendet wird. Geben Sie nicht an, ob AppliedScopeType freigegeben ist. Diese Eigenschaft ist veraltet und wird stattdessen für Single AppliedScopeType durch appliedScopeProperties ersetzt.
properties.billingPlan	ReservationBillingPlan		Stellen Sie die Abrechnungspläne dar.
properties.billingScopeId	string		Abonnement, das für den Kauf einer Reservierung oder eines Sparplans in Rechnung gestellt wird
properties.displayName	string		Anzeigename der Reservierung
properties.quantity	integer		Menge der Skus, die Teil der Reservierung sind.
properties.renew	boolean	False	Wenn Sie diesen Wert auf true festlegen, wird automatisch eine neue Reservierung am Ablaufdatum erworben.
properties.reservedResourceProperties	ReservedResourceProperties		Eigenschaften, die für jeden reservierten Ressourcentyp spezifisch sind. Nicht erforderlich, falls nicht zutreffend.
properties.reservedResourceType	ReservedResourceType		Der Typ der Ressource, die reserviert wird.
properties.reviewDateTime	string		Dies ist das Datum und die Uhrzeit, zu dem der Azure-Hybridvorteil überprüft werden muss.
properties.term	ReservationTerm		Stellen Sie den Reservierungsbegriff dar.
sku	SkuName		Der Name der sku

RenewPropertiesResponse

Die Verlängerungseigenschaften für eine Reservierung.

Name	Typ	Beschreibung
billingCurrencyTotal	BillingCurrencyTotal	Währung und Betrag, die dem Kunden für den Kauf der Verlängerung in der lokalen Währung des Kunden in Rechnung gestellt werden. Die Steuer ist nicht inbegriffen.
pricingCurrencyTotal	PricingCurrencyTotal	Betrag, den Microsoft für die Aufzeichnung verwendet. Wird während der Rückerstattung für die Berechnung des Erstattungslimits verwendet. Die Steuer ist nicht inbegriffen. Dies ist der Gesperrte Preis 30 Tage vor Ablauf.
purchaseProperties	PurchaseRequest	Die Anforderung für den Kauf einer Reservierung

ReservationBillingPlan

Stellen Sie die Abrechnungspläne dar.

Name	Typ	Beschreibung
Monthly	string
Upfront	string

ReservationMergeProperties

Eigenschaften der Reservierungszusammenführung

Name	Typ	Beschreibung
mergeDestination	string	Reservierungsressourcen-ID, die aufgrund des Merges erstellt wurde. Das Format der Ressourcen-ID lautet /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources	string[]	Ressourcen-IDs der Quellreservierung werden zu dieser Reservierung zusammengeführt. Das Format der Ressourcen-ID lautet /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationResponse

Die Definition der Reservierung.

Name	Typ	Beschreibung
etag	integer
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	Kind	Ressourcenanbietertyp, der reserviert werden soll.
location	string	Die Azure-Region, in der sich die reservierte Ressource befindet.
name	string	Der Name der Ressource
properties	ReservationsProperties	Die dieser Reservierung zugeordneten Eigenschaften
sku	SkuName	Die dieser Reservierung zugeordneten SKU-Informationen
systemData	systemData	Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ReservationSplitProperties

Eigenschaften der Reservierungsaufteilung

Name	Typ	Beschreibung
splitDestinations	string[]	Liste der Zielressourcen-ID, die aufgrund der Aufteilung erstellt werden. Das Format der Ressourcen-ID lautet /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	Ressourcen-ID der Reservierung, von der diese geteilt wird. Das Format der Ressourcen-ID lautet /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

Die Eigenschaften der Reservierungen

Name	Typ	Standardwert	Beschreibung
appliedScopeProperties	AppliedScopeProperties		Spezifische Eigenschaften für den angewendeten Bereichstyp. Nicht erforderlich, falls nicht zutreffend. Erforderlich und müssen tenantId und managementGroupId angeben, wenn AppliedScopeType ManagementGroup ist.
appliedScopeType	AppliedScopeType		Der angewendete Bereichstyp
appliedScopes	string[]		Die Liste der angewendeten Bereiche
archived	boolean		Gibt an, ob die Reservierung archiviert wird.
benefitStartTime	string		Dies ist die DateTime, als der Reservierungsvorteil gestartet wurde.
billingPlan	ReservationBillingPlan		Die für diese SKU verfügbaren Abrechnungsplanoptionen.
billingScopeId	string		Abonnement, das für den Kauf einer Reservierung oder eines Sparplans in Rechnung gestellt wird
capabilities	string		Funktionen der Reservierung
displayName	string		Anzeigename für benutzerfreundliche Identifizierung der Reservierung
displayProvisioningState	string		Der Bereitstellungsstatus der Reservierung für die Anzeige, z. B. Erfolgreich
effectiveDateTime	string		DateTime der Reservierung ab dem Zeitpunkt, ab dem diese Version wirksam wird.
expiryDate	string		Dies ist das Datum, an dem die Reservierung abläuft.
expiryDateTime	string		Dies ist das Datum und die Uhrzeit, an dem die Reservierung abläuft.
extendedStatusInfo	ExtendedStatusInfo		Die Nachricht mit detaillierten Informationen zum status Code.
instanceFlexibility	InstanceFlexibility		Ermöglicht das Anwenden des Reservierungsrabatts auf Skus innerhalb derselben Gruppe mit automatischer Anpassung. Nicht alle Skus unterstützen instance Größenflexibilität.
lastUpdatedDateTime	string		DateTime der letzten Aktualisierung der Reservierung.
mergeProperties	ReservationMergeProperties		Eigenschaften der Reservierungszusammenführung
provisioningState	ProvisioningState		Aktueller Status der Reservierung.
provisioningSubState	string		Der Bereitstellungsunterzustand der Reservierung, z. B. Erfolgreich
purchaseDate	string		Dies ist das Datum, an dem die Reservierung erworben wurde.
purchaseDateTime	string		Dies ist das Datum und die Uhrzeit des Kaufs der Reservierung.
quantity	integer		Menge der Skus, die Teil der Reservierung sind.
renew	boolean	False	Wenn Sie diesen Wert auf true festlegen, wird automatisch eine neue Reservierung am Ablaufdatum erworben.
renewDestination	string		Reservierungs-ID der Reservierung, die aufgrund der Verlängerung erworben wird. Das Format der Ressourcen-ID lautet /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties	RenewPropertiesResponse		Die Verlängerungseigenschaften für eine Reservierung.
renewSource	string		Reservierungs-ID der Reservierung, von der aus diese Reservierung verlängert wird. Das Format der Ressourcen-ID lautet /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType	ReservedResourceType		Der Typ der Ressource, die reserviert wird.
reviewDateTime	string		Dies ist der Zeitpunkt, zu dem die Azure-Hybridvorteil überprüft werden muss.
skuDescription	string		Beschreibung der sku auf Englisch.
splitProperties	ReservationSplitProperties		Eigenschaften der Reservierungsaufteilung
swapProperties	ReservationSwapProperties		Eigenschaften des Reservierungstauschs
term	ReservationTerm		Stellen Sie den Reservierungsbegriff dar.
userFriendlyAppliedScopeType	string		Der angewendete Bereichstyp der Reservierung für die Anzeige, z. B. Shared
userFriendlyRenewState	string		Der Verlängerungsstatus der Reservierung zur Anzeige, z. B. Ein
utilization	Utilization		Reservierungsnutzung

ReservationStatusCode

Name	Typ	Beschreibung
Active	string
Expired	string
Merged	string
None	string
PaymentInstrumentError	string
Pending	string
Processing	string
PurchaseError	string
Split	string
Succeeded	string

ReservationSwapProperties

Eigenschaften des Reservierungstauschs

Name	Typ	Beschreibung
swapDestination	string	Reservierungsressourcen-ID, an die die ursprüngliche Ressource ausgetauscht wird. Das Format der Ressourcen-ID lautet /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	Ressourcen-ID der Quellreservierung, die ausgetauscht wird. Das Format der Ressourcen-ID lautet /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Stellen Sie den Reservierungsbegriff dar.

Name	Typ	Beschreibung
P1Y	string
P3Y	string
P5Y	string

ReservationUtilizationAggregates

Die Aggregatwerte der Reservierungsauslastung

Name	Typ	Beschreibung
grain	number	Das Korn des Aggregats
grainUnit	string	Die Korneinheit des Aggregats
value	number	Der Aggregatwert
valueUnit	string	Die Aggregatwerteinheit

ReservedResourceProperties

Eigenschaften, die für jeden reservierten Ressourcentyp spezifisch sind. Nicht erforderlich, falls nicht zutreffend.

Name	Typ	Beschreibung
instanceFlexibility	InstanceFlexibility	Wenn Sie dies aktivieren, wird der Reservierungsrabatt auf andere VMs in derselben VM-Größengruppe angewendet. Geben Sie nur für den reservierten Ressourcentyp VirtualMachines an.

ReservedResourceType

Der Typ der Ressource, die reserviert wird.

Name	Typ	Beschreibung
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

Der Name der sku

Name	Typ	Beschreibung
name	string

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Utilization

Reservierungsnutzung

Name	Typ	Beschreibung
aggregates	ReservationUtilizationAggregates[]	Das Array von Aggregaten der Nutzung einer Reservierung
trend	string	Auslastungstrend der letzten 7 Tage für eine Reservierung