Reservation - Split

Service:

Reserved VM Instances

Version d'API:

2022-11-01

Fractionnez .Reservation
Fractionnez un Reservation en deux Reservationavec une distribution de quantité spécifiée.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
reservationOrderId	path	True	string	ID de commande de la réservation
api-version	query	True	string	Version prise en charge.

Corps de la demande

Nom	Type	Description
properties.quantities	integer[]	Liste des quantités dans les nouvelles réservations à créer.
properties.reservationId	string	ID de ressource de la réservation à fractionner. Le format de l’ID de ressource doit être /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

Réponses

Nom	Type	Description
200 OK	ReservationResponse[]	Liste des Reservations créés après l’opération de fractionnement.
202 Accepted		La demande est acceptée et est en cours de traitement En-têtes Location: string Retry-After: integer
Other Status Codes	Error	Erreur inattendue

Exemples

Split

Exemple de requête

HTTP

POST https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/split?api-version=2022-11-01

{
  "properties": {
    "quantities": [
      1,
      2
    ],
    "reservationId": "/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
  }
}

Java

import com.azure.resourcemanager.reservations.models.SplitRequest;
import java.util.Arrays;

/** Samples for Reservation Split. */
public final class Main {
    /*
     * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/SplitReservation.json
     */
    /**
     * Sample code: Split.
     *
     * @param manager Entry point to ReservationsManager.
     */
    public static void split(com.azure.resourcemanager.reservations.ReservationsManager manager) {
        manager
            .reservations()
            .split(
                "276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
                new SplitRequest()
                    .withQuantities(Arrays.asList(1, 2))
                    .withReservationId(
                        "/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"),
                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 split_reservation.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_split(
        reservation_order_id="276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
        body={
            "properties": {
                "quantities": [1, 2],
                "reservationId": "/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a",
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/SplitReservation.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/SplitReservation.json
func ExampleReservationClient_BeginSplit() {
	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().BeginSplit(ctx, "276e7ae4-84d0-4da6-ab4b-d6b94f3557da", armreservations.SplitRequest{
		Properties: &armreservations.SplitProperties{
			Quantities: []*int32{
				to.Ptr[int32](1),
				to.Ptr[int32](2)},
			ReservationID: to.Ptr("/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"),
		},
	}, 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](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-22T01:00:30.925Z"); 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-22T01:00:30.925Z"); return t}()),
	// 			InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOff),
	// 			LastUpdatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T01:00:36.319Z"); return t}()),
	// 			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](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-22T01:00:30.925Z"); 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-22T01:00:30.925Z"); return t}()),
	// 			InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOff),
	// 			LastUpdatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T01:00:36.319Z"); return t}()),
	// 			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("bcae77cd-3119-4766-919f-b50d36c75c7a"),
	// 		Type: to.Ptr("Microsoft.Capacity/reservationOrders/reservations"),
	// 		ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"),
	// 		Etag: to.Ptr[int32](10),
	// 		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-22T01:00:30.925Z"); 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-22T01:00:30.925Z"); return t}()),
	// 			ExtendedStatusInfo: &armreservations.ExtendedStatusInfo{
	// 				Message: to.Ptr("This reservation was split and is no longer active."),
	// 				StatusCode: to.Ptr(armreservations.ReservationStatusCodeSplit),
	// 			},
	// 			InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOff),
	// 			LastUpdatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-09-22T01:00:36.319Z"); return t}()),
	// 			ProvisioningState: to.Ptr(armreservations.ProvisioningStateSucceeded),
	// 			Quantity: to.Ptr[int32](3),
	// 			Renew: to.Ptr(false),
	// 			ReservedResourceType: to.Ptr(armreservations.ReservedResourceTypeVirtualMachines),
	// 			SKUDescription: to.Ptr("D1 v2"),
	// 			SplitProperties: &armreservations.ReservationSplitProperties{
	// 				SplitDestinations: []*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")},
	// 				},
	// 			},
	// 			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 Split a `Reservation` into two `Reservation`s with specified quantity distribution.
 *
 * @summary Split a `Reservation` into two `Reservation`s with specified quantity distribution.
 * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/SplitReservation.json
 */
async function split() {
  const reservationOrderId = "276e7ae4-84d0-4da6-ab4b-d6b94f3557da";
  const body = {
    quantities: [1, 2],
    reservationId:
      "/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a",
  };
  const credential = new DefaultAzureCredential();
  const client = new AzureReservationAPI(credential);
  const result = await client.reservation.beginSplitAndWait(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/SplitReservation.json
// this example is just showing the usage of "Reservation_Split" 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
SplitContent content = new SplitContent()
{
    Quantities =
    {
    1,2
    },
    ReservationId = new ResourceIdentifier("/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"),
};
ArmOperation<IList<ReservationDetailData>> lro = await reservationOrder.SplitReservationAsync(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

Exemple de réponse

Code d’état:

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": 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": 1,
      "provisioningState": "Succeeded",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T01:00:30.9253826Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T01:00:30.9253826Z",
      "lastUpdatedDateTime": "2017-09-22T01:00:36.3191627Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
      }
    }
  },
  {
    "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": 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": 2,
      "provisioningState": "Succeeded",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T01:00:30.9253826Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T01:00:30.9253826Z",
      "lastUpdatedDateTime": "2017-09-22T01:00:36.3191627Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
      }
    }
  },
  {
    "sku": {
      "name": "Standard_DS1_v2"
    },
    "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a",
    "type": "Microsoft.Capacity/reservationOrders/reservations",
    "name": "bcae77cd-3119-4766-919f-b50d36c75c7a",
    "etag": 10,
    "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": "Cancelled",
      "expiryDate": "2018-09-22",
      "expiryDateTime": "2018-09-22T01:00:30.9253826Z",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T01:00:30.9253826Z",
      "extendedStatusInfo": {
        "statusCode": "Split",
        "message": "This reservation was split and is no longer active."
      },
      "lastUpdatedDateTime": "2017-09-22T01:00:36.3191627Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitDestinations": [
          "/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"
        ]
      }
    }
  }
]

Code d’état:

202

Location: https://management.azure.com/providers/Microsoft.Capacity/reservationorders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/splitoperationresults/bcae77cd-3119-4766-919f-b50d36c75c7a_10?api-version=2022-11-01
Retry-After: 120

Définitions

Nom	Description
AppliedScopeProperties	Propriétés spécifiques au type d’étendue appliqué. Non obligatoire s’il n’est pas applicable. Requis et doivent fournir tenantId et managementGroupId si AppliedScopeType est ManagementGroup
AppliedScopeType	Type de l’étendue appliquée.
BillingCurrencyTotal	Devise et montant que le client sera facturé dans la devise locale du client pour le renouvellement de l’achat. La taxe n’est pas incluse.
createdByType	Type d’identité qui a créé la ressource.
Error	Informations sur l'erreur
ErrorResponseCode	Code d’erreur décrivant la raison pour laquelle le service n’est pas en mesure de traiter la demande entrante
ExtendedErrorInfo	Informations d’erreur étendues, notamment le code d’erreur et le message d’erreur
ExtendedStatusInfo
InstanceFlexibility	L’activation de cette option applique la remise de réservation à d’autres machines virtuelles du même groupe de taille de machine virtuelle. Spécifiez uniquement pour le type de ressource réservée VirtualMachines.
Kind	Type de fournisseur de ressources à réserver.
PricingCurrencyTotal	Montant utilisé par Microsoft pour l’enregistrement. Utilisé lors du remboursement pour le calcul de la limite de remboursement. La taxe n’est pas incluse. Il s’agit d’un prix verrouillé 30 jours avant l’expiration.
ProvisioningState	Représente l’état actuel de la réservation.
PurchaseRequest	Demande d’achat de réservation
RenewPropertiesResponse	Propriétés de renouvellement d’une réservation.
ReservationBillingPlan	Représentez les plans de facturation.
ReservationMergeProperties	Propriétés de la fusion de réservations
ReservationResponse	Définition de la réservation.
ReservationSplitProperties	Propriétés du fractionnement de réservation
ReservationsProperties	Propriétés des réservations
ReservationStatusCode
ReservationSwapProperties	Propriétés de l’échange de réservation
ReservationTerm	Représente le terme de réservation.
ReservationUtilizationAggregates	Valeurs agrégées de l’utilisation des réservations
ReservedResourceProperties	Propriétés spécifiques à chaque type de ressource réservée. Non obligatoire s’il n’est pas applicable.
ReservedResourceType	Type de la ressource réservée.
SkuName	Nom de la référence sku
SplitRequest	Demande de fractionnement de réservation
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
Utilization	Utilisation des réservations

AppliedScopeProperties

Propriétés spécifiques au type d’étendue appliqué. Non obligatoire s’il n’est pas applicable. Requis et doivent fournir tenantId et managementGroupId si AppliedScopeType est ManagementGroup

Nom	Type	Description
displayName	string	Nom d’affichage
managementGroupId	string	Identificateur complet du groupe d’administration dans lequel l’avantage doit être appliqué.
resourceGroupId	string	Identificateur complet du groupe de ressources.
subscriptionId	string	Identificateur complet de l’abonnement.
tenantId	string	ID de locataire dans lequel le plan d’économies doit appliquer l’avantage.

AppliedScopeType

Type de l’étendue appliquée.

Nom	Type	Description
ManagementGroup	string
Shared	string
Single	string

BillingCurrencyTotal

Devise et montant que le client sera facturé dans la devise locale du client pour le renouvellement de l’achat. La taxe n’est pas incluse.

Nom	Type	Description
amount	number
currencyCode	string	Code monétaire ISO 4217 à 3 lettres pour la devise utilisée par cet enregistrement d’achat.

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Error

Informations sur l'erreur

Nom	Type	Description
error	ExtendedErrorInfo	Informations d’erreur étendues, notamment le code d’erreur et le message d’erreur

ErrorResponseCode

Code d’erreur décrivant la raison pour laquelle le service n’est pas en mesure de traiter la demande entrante

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

Informations d’erreur étendues, notamment le code d’erreur et le message d’erreur

Nom	Type	Description
code	ErrorResponseCode	Code d’erreur décrivant la raison pour laquelle le service n’est pas en mesure de traiter la requête entrante
message	string

ExtendedStatusInfo

Nom	Type	Description
message	string	Message fournissant des informations détaillées sur le code status.
statusCode	ReservationStatusCode

InstanceFlexibility

L’activation de cette option applique la remise de réservation à d’autres machines virtuelles du même groupe de taille de machine virtuelle. Spécifiez uniquement pour le type de ressource réservée VirtualMachines.

Nom	Type	Description
Off	string
On	string

Kind

Type de fournisseur de ressources à réserver.

Nom	Type	Description
Microsoft.Compute	string

PricingCurrencyTotal

Montant utilisé par Microsoft pour l’enregistrement. Utilisé lors du remboursement pour le calcul de la limite de remboursement. La taxe n’est pas incluse. Il s’agit d’un prix verrouillé 30 jours avant l’expiration.

Nom	Type	Description
amount	number
currencyCode	string	Code monétaire ISO 4217 à 3 lettres pour la devise utilisée par cet enregistrement d’achat.

ProvisioningState

Représente l’état actuel de la réservation.

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

Demande d’achat de réservation

Nom	Type	Valeur par défaut	Description
location	string		Région Azure où réside la ressource réservée.
properties.appliedScopeProperties	AppliedScopeProperties		Propriétés spécifiques au type d’étendue appliqué. Non obligatoire s’il n’est pas applicable. Obligatoire et doit fournir tenantId et managementGroupId si AppliedScopeType est ManagementGroupGroup
properties.appliedScopeType	AppliedScopeType		Type de l’étendue appliquée.
properties.appliedScopes	string[]		Liste des abonnements auxquels l’avantage sera appliqué. Ne spécifiez pas si AppliedScopeType est Partagé. Cette propriété sera dépréciée et remplacée par appliedScopeProperties à la place pour Single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan		Représenter les plans de facturation.
properties.billingScopeId	string		Abonnement qui sera facturé pour l’achat d’une réservation ou d’un plan d’économies
properties.displayName	string		Nom convivial de la réservation
properties.quantity	integer		Quantité des références skus qui font partie de la réservation.
properties.renew	boolean	False	La définition de cette valeur sur true permet d’acheter automatiquement une nouvelle réservation à l’heure de la date d’expiration.
properties.reservedResourceProperties	ReservedResourceProperties		Propriétés spécifiques à chaque type de ressource réservée. Non obligatoire s’il n’est pas applicable.
properties.reservedResourceType	ReservedResourceType		Type de la ressource réservée.
properties.reviewDateTime	string		Il s’agit de la date-heure à laquelle l’avantage hybride Azure doit être examiné.
properties.term	ReservationTerm		Représente le terme de réservation.
sku	SkuName		Nom de la référence sku

RenewPropertiesResponse

Propriétés de renouvellement d’une réservation.

Nom	Type	Description
billingCurrencyTotal	BillingCurrencyTotal	Devise et montant que le client sera facturé dans la devise locale du client pour le renouvellement de l’achat. La taxe n’est pas incluse.
pricingCurrencyTotal	PricingCurrencyTotal	Montant utilisé par Microsoft pour l’enregistrement. Utilisé lors du remboursement pour le calcul de la limite de remboursement. La taxe n’est pas incluse. Il s’agit d’un prix verrouillé 30 jours avant l’expiration.
purchaseProperties	PurchaseRequest	Demande d’achat de réservation

ReservationBillingPlan

Représentez les plans de facturation.

Nom	Type	Description
Monthly	string
Upfront	string

ReservationMergeProperties

Propriétés de la fusion de réservations

Nom	Type	Description
mergeDestination	string	ID de ressource de réservation créé en raison de la fusion. Le format de l’ID de ressource est /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources	string[]	ID de ressource de la réservation source fusionnée pour former cette réservation. Le format de l’ID de ressource est /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationResponse

Définition de la réservation.

Nom	Type	Description
etag	integer
id	string	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
kind	Kind	Type de fournisseur de ressources à réserver.
location	string	Région Azure où réside la ressource réservée.
name	string	nom de la ressource.
properties	ReservationsProperties	Propriétés associées à cette réservation
sku	SkuName	Informations de référence SKU associées à cette réservation
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ReservationSplitProperties

Propriétés du fractionnement de réservation

Nom	Type	Description
splitDestinations	string[]	Liste des ID de ressource de destination créés en raison du fractionnement. Le format de l’ID de ressource est /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	ID de ressource de la réservation à partir de laquelle il est fractionné. Le format de l’ID de ressource est /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

Propriétés des réservations

Nom	Type	Valeur par défaut	Description
appliedScopeProperties	AppliedScopeProperties		Propriétés spécifiques au type d’étendue appliqué. Non obligatoire s’il n’est pas applicable. Requis et doivent fournir tenantId et managementGroupId si AppliedScopeType est ManagementGroup
appliedScopeType	AppliedScopeType		Type d’étendue appliqué
appliedScopes	string[]		Liste des étendues appliquées
archived	boolean		Indique si la réservation est archivée
benefitStartTime	string		Il s’agit du DateTime au démarrage de l’avantage de réservation.
billingPlan	ReservationBillingPlan		Options de plan de facturation disponibles pour cette référence SKU.
billingScopeId	string		Abonnement qui sera facturé pour l’achat d’une réservation ou d’un plan d’économies
capabilities	string		Fonctionnalités de la réservation
displayName	string		Nom convivial permettant à l’utilisateur d’identifier facilement la réservation
displayProvisioningState	string		État d’approvisionnement de la réservation pour l’affichage, par exemple Réussi
effectiveDateTime	string		DateTime de la réservation commençant à partir de la date d’entrée en vigueur de cette version.
expiryDate	string		Il s’agit de la date d’expiration de la réservation.
expiryDateTime	string		Il s’agit de la date et de l’heure d’expiration de la réservation.
extendedStatusInfo	ExtendedStatusInfo		Message fournissant des informations détaillées sur le code status.
instanceFlexibility	InstanceFlexibility		Autorise l’application d’une remise de réservation sur plusieurs références SKU au sein du même groupe d’ajustement automatique. Toutes les références SKU ne prennent pas en charge instance flexibilité de taille.
lastUpdatedDateTime	string		DateTime de la dernière mise à jour de la réservation.
mergeProperties	ReservationMergeProperties		Propriétés de la fusion de réservations
provisioningState	ProvisioningState		État actuel de la réservation.
provisioningSubState	string		Sous-état d’approvisionnement de la réservation, par exemple Succeeded
purchaseDate	string		Il s’agit de la date à laquelle la réservation a été achetée.
purchaseDateTime	string		Il s’agit de la date et de l’heure d’achat de la réservation.
quantity	integer		Quantité des références SKU qui font partie de la réservation.
renew	boolean	False	La définition de cette valeur sur true permet d’acheter automatiquement une nouvelle réservation à la date d’expiration.
renewDestination	string		ID de réservation de la réservation achetée en raison d’un renouvellement. Le format de l’ID de ressource est /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties	RenewPropertiesResponse		Propriétés de renouvellement d’une réservation.
renewSource	string		ID de réservation de la réservation à partir de laquelle cette réservation est renouvelée. Le format de l’ID de ressource est /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType	ReservedResourceType		Type de la ressource réservée.
reviewDateTime	string		Il s’agit de la date et de l’heure à laquelle le Azure Hybrid Benefit doit être examiné.
skuDescription	string		Description de la référence SKU en anglais.
splitProperties	ReservationSplitProperties		Propriétés du fractionnement de réservation
swapProperties	ReservationSwapProperties		Propriétés de l’échange de réservation
term	ReservationTerm		Représente le terme de réservation.
userFriendlyAppliedScopeType	string		Type d’étendue appliqué de la réservation pour l’affichage, par exemple Partagé
userFriendlyRenewState	string		État de renouvellement de la réservation pour l’affichage, par exemple Activé
utilization	Utilization		Utilisation des réservations

ReservationStatusCode

Nom	Type	Description
Active	string
Expired	string
Merged	string
None	string
PaymentInstrumentError	string
Pending	string
Processing	string
PurchaseError	string
Split	string
Succeeded	string

ReservationSwapProperties

Propriétés de l’échange de réservation

Nom	Type	Description
swapDestination	string	ID de ressource de réservation vers lequel la ressource d’origine est permutée. Le format de l’ID de ressource est /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	ID de ressource de la réservation source qui est permutée. Le format de l’ID de ressource est /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Représente le terme de réservation.

Nom	Type	Description
P1Y	string
P3Y	string
P5Y	string

ReservationUtilizationAggregates

Valeurs agrégées de l’utilisation des réservations

Nom	Type	Description
grain	number	Grain de l’agrégat
grainUnit	string	Unité de grain de l’agrégat
value	number	Valeur d’agrégation
valueUnit	string	Unité de valeur d’agrégation

ReservedResourceProperties

Propriétés spécifiques à chaque type de ressource réservée. Non obligatoire s’il n’est pas applicable.

Nom	Type	Description
instanceFlexibility	InstanceFlexibility	L’activation de cette option applique la remise de réservation à d’autres machines virtuelles du même groupe de tailles de machine virtuelle. Spécifiez uniquement pour le type de ressource réservée VirtualMachines.

ReservedResourceType

Type de la ressource réservée.

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

Nom de la référence sku

Nom	Type	Description
name	string

SplitRequest

Demande de fractionnement de réservation

Nom	Type	Description
properties.quantities	integer[]	Liste des quantités dans les nouvelles réservations à créer.
properties.reservationId	string	ID de ressource de la réservation à fractionner. Le format de l’ID de ressource doit être /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

Utilization

Utilisation des réservations

Nom	Type	Description
aggregates	ReservationUtilizationAggregates[]	Tableau des agrégats de l’utilisation d’une réservation
trend	string	Tendance d’utilisation des 7 derniers jours pour une réservation