Reservation - Merge

Service:

Reserved VM Instances

API Version:

2022-11-01

Sloučí dvě Reservations.
Sloučit zadané Reservations do nového Reservation. Slučované dva Reservationobjekty musí mít stejné vlastnosti.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
reservationOrderId	path	True	string	ID objednávky rezervace
api-version	query	True	string	Podporovaná verze.

Text požadavku

Name	Typ	Description
properties.sources	string[]	Formát ID prostředku by měl být /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

Odpovědi

Name	Typ	Description
200 OK	ReservationResponse[]	Vrátí hodnotu vytvořenou Reservation po sloučení.
202 Accepted		Žádost se přijme a zpracovává se. Headers Location: string Retry-After: integer
Other Status Codes	Error	Neočekávaná chyba

Příklady

Merge

Sample Request

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

Sample Response

Status code:

200

[
  {
    "sku": {
      "name": "Standard_DS1_v2"
    },
    "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
    "type": "Microsoft.Capacity/reservationOrders/reservations",
    "name": "00238563-7312-4c20-a134-8c030bf938a7",
    "etag": 5,
    "location": "eastus",
    "properties": {
      "appliedScopeProperties": {
        "subscriptionId": "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3",
        "displayName": "Azure subscription 1"
      },
      "renew": false,
      "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
      "appliedScopeType": "Single",
      "quantity": 1,
      "provisioningState": "Cancelled",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T22:46:32.7632798Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
      "extendedStatusInfo": {
        "statusCode": "Merged",
        "message": "This reservation was merged and is no longer active."
      },
      "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
      },
      "mergeProperties": {
        "mergeDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"
      }
    }
  },
  {
    "sku": {
      "name": "Standard_DS1_v2"
    },
    "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
    "type": "Microsoft.Capacity/reservationOrders/reservations",
    "name": "e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
    "etag": 4,
    "location": "eastus",
    "properties": {
      "appliedScopeProperties": {
        "subscriptionId": "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3",
        "displayName": "Azure subscription 1"
      },
      "renew": false,
      "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
      "appliedScopeType": "Single",
      "quantity": 2,
      "provisioningState": "Cancelled",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T22:46:32.7632798Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
      "extendedStatusInfo": {
        "statusCode": "Merged",
        "message": "This reservation was merged and is no longer active."
      },
      "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
      },
      "mergeProperties": {
        "mergeDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"
      }
    }
  },
  {
    "sku": {
      "name": "Standard_DS1_v2"
    },
    "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc",
    "type": "Microsoft.Capacity/reservationOrders/reservations",
    "name": "6ef59113-3482-40da-8d79-787f823e34bc",
    "etag": 2,
    "location": "eastus",
    "properties": {
      "appliedScopeProperties": {
        "subscriptionId": "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3",
        "displayName": "Azure subscription 1"
      },
      "renew": false,
      "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
      "appliedScopeType": "Single",
      "quantity": 3,
      "provisioningState": "Succeeded",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T22:46:32.7632798Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
      "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "mergeProperties": {
        "mergeSources": [
          "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
          "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
        ]
      }
    }
  }
]

Status code:

202

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

Definice

Name	Description
AppliedScopeProperties	Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.
AppliedScopeType	Typ použitého oboru.
BillingCurrencyTotal	Měna a částka, která se zákazníkovi bude účtovat v místní měně zákazníka při nákupu pro prodloužení platnosti. Daň není zahrnuta.
createdByType	Typ identity, která vytvořila prostředek.
Error	Informace o chybě
ErrorResponseCode	Kód chyby popisující důvod, proč služba nemůže zpracovat příchozí požadavek
ExtendedErrorInfo	Rozšířené informace o chybách, včetně kódu chyby a chybové zprávy
ExtendedStatusInfo
InstanceFlexibility	Zapnutím této možnosti se sleva za rezervaci uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Pro VirtualMachines zadejte pouze rezervovaný typ prostředku.
Kind	Typ poskytovatele prostředků, který se má rezervovat.
MergeRequest	Žádost o sloučení rezervací
PricingCurrencyTotal	Částka, kterou Microsoft používá pro záznam. Používá se při refundaci pro výpočet limitu refundace. Daň není zahrnuta. Tato cena je uzamčena 30 dní před vypršením platnosti.
ProvisioningState	Představuje aktuální stav rezervace.
PurchaseRequest	Žádost o nákup rezervace
RenewPropertiesResponse	Vlastnosti pro prodloužení platnosti rezervace
ReservationBillingPlan	Představuje fakturační plány.
ReservationMergeProperties	Vlastnosti sloučení rezervací
ReservationResponse	Definice rezervace.
ReservationSplitProperties	Vlastnosti rozdělení rezervací
ReservationsProperties	Vlastnosti rezervací
ReservationStatusCode
ReservationSwapProperties	Vlastnosti prohození rezervací
ReservationTerm	Představuje termín rezervace.
ReservationUtilizationAggregates	Agregované hodnoty využití rezervací
ReservedResourceProperties	Vlastnosti specifické pro každý rezervovaný typ prostředku. Nepožaduje se, pokud není k dispozici.
ReservedResourceType	Typ prostředku, který je rezervován.
SkuName	Název skladové položky
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
Utilization	Využití rezervací

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.

Name	Typ	Description
displayName	string	Zobrazované jméno
managementGroupId	string	Plně kvalifikovaný identifikátor skupiny pro správu, ve které musí být výhoda uplatněna.
resourceGroupId	string	Plně kvalifikovaný identifikátor skupiny prostředků.
subscriptionId	string	Plně kvalifikovaný identifikátor předplatného.
tenantId	string	ID tenanta, u kterého by plán úspory měl použít výhodu

AppliedScopeType

Typ použitého oboru.

Name	Typ	Description
ManagementGroup	string
Shared	string
Single	string

BillingCurrencyTotal

Měna a částka, která se zákazníkovi bude účtovat v místní měně zákazníka při nákupu pro prodloužení platnosti. Daň není zahrnuta.

Name	Typ	Description
amount	number
currencyCode	string	Kód měny ISO 4217 s 3 písmeny pro měnu používanou tímto záznamem o nákupu.

createdByType

Typ identity, která vytvořila prostředek.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Error

Informace o chybě

Name	Typ	Description
error	ExtendedErrorInfo	Rozšířené informace o chybách, včetně kódu chyby a chybové zprávy

ErrorResponseCode

Kód chyby popisující důvod, proč služba nemůže zpracovat příchozí požadavek

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

Rozšířené informace o chybách, včetně kódu chyby a chybové zprávy

Name	Typ	Description
code	ErrorResponseCode	Kód chyby popisující důvod, proč služba nemůže zpracovat příchozí požadavek
message	string

ExtendedStatusInfo

Name	Typ	Description
message	string	Zpráva s podrobnými informacemi o stavovém kódu.
statusCode	ReservationStatusCode

InstanceFlexibility

Zapnutím této možnosti se sleva za rezervaci uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Pro VirtualMachines zadejte pouze rezervovaný typ prostředku.

Name	Typ	Description
Off	string
On	string

Kind

Typ poskytovatele prostředků, který se má rezervovat.

Name	Typ	Description
Microsoft.Compute	string

MergeRequest

Žádost o sloučení rezervací

Name	Typ	Description
properties.sources	string[]	ID prostředku by mělo být ve formátu /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

PricingCurrencyTotal

Částka, kterou Microsoft používá pro záznam. Používá se při refundaci pro výpočet limitu refundace. Daň není zahrnuta. Tato cena je uzamčena 30 dní před vypršením platnosti.

Name	Typ	Description
amount	number
currencyCode	string	Kód měny ISO 4217 s 3 písmeny pro měnu používanou tímto záznamem o nákupu.

ProvisioningState

Představuje aktuální stav rezervace.

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

Žádost o nákup rezervace

Name	Typ	Výchozí hodnota	Description
location	string		Oblast Azure, ve které se nachází rezervovaný prostředek.
properties.appliedScopeProperties	AppliedScopeProperties		Vlastnosti specifické pro použitý typ oboru. Nepožaduje se, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup
properties.appliedScopeType	AppliedScopeType		Typ použitého oboru.
properties.appliedScopes	string[]		Seznam předplatných, u kterých se výhoda uplatní. Nezadávejte, jestli je AppliedScopeType sdílený. Tato vlastnost bude zastaralá a nahrazena appliedScopeProperties místo pro Single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan		Představuje fakturační plány.
properties.billingScopeId	string		Předplatné, které se bude účtovat za nákup rezervace nebo úspory
properties.displayName	string		Popisný název rezervace
properties.quantity	integer		Množství skladových položek, které jsou součástí rezervace.
properties.renew	boolean	False	Pokud tuto hodnotu nastavíte na hodnotu true, automaticky si koupíte novou rezervaci k datu vypršení platnosti.
properties.reservedResourceProperties	ReservedResourceProperties		Vlastnosti specifické pro každý rezervovaný typ prostředku. Nepožaduje se, pokud není k dispozici.
properties.reservedResourceType	ReservedResourceType		Typ rezervovaného prostředku.
properties.reviewDateTime	string		Toto je datum a čas, kdy je potřeba zkontrolovat zvýhodněné hybridní využití Azure.
properties.term	ReservationTerm		Představuje termín rezervace.
sku	SkuName		Název skladové položky

RenewPropertiesResponse

Vlastnosti pro prodloužení platnosti rezervace

Name	Typ	Description
billingCurrencyTotal	BillingCurrencyTotal	Měna a částka, která se zákazníkovi bude účtovat v místní měně zákazníka při nákupu pro prodloužení platnosti. Daň není zahrnuta.
pricingCurrencyTotal	PricingCurrencyTotal	Částka, kterou Microsoft používá pro záznam. Používá se při refundaci pro výpočet limitu refundace. Daň není zahrnuta. Tato cena je uzamčena 30 dní před vypršením platnosti.
purchaseProperties	PurchaseRequest	Žádost o nákup rezervace

ReservationBillingPlan

Představuje fakturační plány.

Name	Typ	Description
Monthly	string
Upfront	string

ReservationMergeProperties

Vlastnosti sloučení rezervací

Name	Typ	Description
mergeDestination	string	ID prostředku rezervace vytvořeného kvůli sloučení. Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources	string[]	ID prostředků zdrojové rezervace sloučená za účelem vytvoření této rezervace Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationResponse

Definice rezervace.

Name	Typ	Description
etag	integer
id	string	Plně kvalifikované ID prostředku Například /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{název_poskytovatele_prostředku}/{typ_prostředku}/{název_prostředku}.
kind	Kind	Typ poskytovatele prostředků, který se má rezervovat.
location	string	Oblast Azure, ve které se nachází rezervovaný prostředek.
name	string	Název prostředku
properties	ReservationsProperties	Vlastnosti přidružené k této rezervaci
sku	SkuName	Informace o SKU přidružené k této rezervaci
systemData	systemData	Azure Resource Manager metadata obsahující informace createdBy a modifiedBy.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ReservationSplitProperties

Vlastnosti rozdělení rezervací

Name	Typ	Description
splitDestinations	string[]	Seznam ID cílového prostředku, které se vytvořily z důvodu rozdělení Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	ID prostředku rezervace, ze které se rozdělí. Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

Vlastnosti rezervací

Name	Typ	Výchozí hodnota	Description
appliedScopeProperties	AppliedScopeProperties		Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.
appliedScopeType	AppliedScopeType		Použitý typ oboru
appliedScopes	string[]		Seznam použitých oborů
archived	boolean		Označuje, jestli je rezervace archivovaná.
benefitStartTime	string		Toto je datum a čas, kdy výhoda rezervace začala.
billingPlan	ReservationBillingPlan		Možnosti fakturačního plánu dostupné pro tuto skladovou položku
billingScopeId	string		Předplatné, které se bude účtovat za nákup rezervace nebo úspory
capabilities	string		Možnosti rezervace
displayName	string		Popisný název pro uživatele, který snadno identifikuje rezervaci
displayProvisioningState	string		Stav zřizování rezervace pro zobrazení, např. Úspěch
effectiveDateTime	string		DateTime rezervace, od které začíná platnost této verze.
expiryDate	string		Toto je datum, kdy vyprší platnost rezervace.
expiryDateTime	string		Toto je datum a čas, kdy vyprší platnost rezervace.
extendedStatusInfo	ExtendedStatusInfo		Zpráva s podrobnými informacemi o stavovém kódu.
instanceFlexibility	InstanceFlexibility		Umožňuje uplatnit slevu za rezervaci napříč skladovými položkami v rámci stejné skupiny automatického přizpůsobení. Ne všechny skladové položky podporují flexibilitu velikosti instance.
lastUpdatedDateTime	string		DateTime poslední aktualizace rezervace.
mergeProperties	ReservationMergeProperties		Vlastnosti sloučení rezervací
provisioningState	ProvisioningState		Aktuální stav rezervace.
provisioningSubState	string		Dílčí stav zřizování rezervace, např. Úspěšné
purchaseDate	string		Toto je datum, kdy byla rezervace zakoupena.
purchaseDateTime	string		Jedná se o datum a čas, kdy byla rezervace zakoupena.
quantity	integer		Množství skladových položek, které jsou součástí rezervace.
renew	boolean	False	Pokud tuto hodnotu nastavíte na true, automaticky se k datu vypršení platnosti zakoupí nová rezervace.
renewDestination	string		ID rezervace zakoupené z důvodu prodloužení. Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties	RenewPropertiesResponse		Prodloužení vlastností rezervace.
renewSource	string		ID rezervace, ze které se tato rezervace obnovuje. Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType	ReservedResourceType		Typ prostředku, který je rezervován.
reviewDateTime	string		Jedná se o datum a čas, kdy je potřeba Zvýhodněné hybridní využití Azure zkontrolovat.
skuDescription	string		Popis skladové položky v angličtině.
splitProperties	ReservationSplitProperties		Vlastnosti rozdělení rezervací
swapProperties	ReservationSwapProperties		Vlastnosti prohození rezervací
term	ReservationTerm		Představuje dobu rezervace.
userFriendlyAppliedScopeType	string		Použitý typ rozsahu rezervace pro zobrazení, například Sdílené
userFriendlyRenewState	string		Stav prodloužení rezervace pro zobrazení, např. Zapnuto
utilization	Utilization		Využití rezervace

ReservationStatusCode

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

ReservationSwapProperties

Vlastnosti prohození rezervací

Name	Typ	Description
swapDestination	string	ID prostředku rezervace, na který se původní prostředek prohodí. Formát ID prostředku je /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	ID prostředku zdrojové rezervace, která se prohodí. Formát ID prostředku je /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Představuje termín rezervace.

Name	Typ	Description
P1Y	string
P3Y	string
P5Y	string

ReservationUtilizationAggregates

Agregované hodnoty využití rezervací

Name	Typ	Description
grain	number	Zrnitost agregace
grainUnit	string	Jednotka agregace
value	number	Agregovaná hodnota
valueUnit	string	Jednotka agregovaných hodnot

ReservedResourceProperties

Vlastnosti specifické pro každý rezervovaný typ prostředku. Nepožaduje se, pokud není k dispozici.

Name	Typ	Description
instanceFlexibility	InstanceFlexibility	Pokud tuto možnost zapnete, sleva za rezervaci se uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Zadejte pouze typ rezervovaného prostředku VirtualMachines.

ReservedResourceType

Typ prostředku, který je rezervován.

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

Název skladové položky

Name	Typ	Description
name	string

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string	Časové razítko vytvoření prostředku (UTC)
createdBy	string	Identita, která vytvořila prostředek.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string	Časové razítko poslední změny prostředku (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Utilization

Využití rezervací

Name	Typ	Description
aggregates	ReservationUtilizationAggregates[]	Pole agregací využití rezervace
trend	string	Trend využití rezervace za posledních 7 dnů