Reservation Order - Calculate

Service:

Reserved VM Instances

API Version:

2022-11-01

Calcolare il prezzo per un ReservationOrderoggetto .
Calcolare il prezzo per l'inserimento di un ReservationOrderoggetto .

POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
api-version	query	True	string	Versione supportata.

Corpo della richiesta

Nome	Tipo	Descrizione
location	string	Area di Azure in cui risiede la risorsa riservata.
properties.appliedScopeProperties	AppliedScopeProperties	Proprietà specifiche del tipo di ambito applicato. Non obbligatorio se non applicabile. Obbligatorio e necessario fornire tenantId e managementGroupId se AppliedScopeType è ManagementGroup
properties.appliedScopeType	AppliedScopeType	Tipo dell'ambito applicato.
properties.appliedScopes	string[]	Elenco delle sottoscrizioni a cui verrà applicato il vantaggio. Non specificare se AppliedScopeType è Shared. Questa proprietà verrà deprecata e sostituita da appliedScopeProperties per Single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan	Rappresentare i piani di fatturazione.
properties.billingScopeId	string	Sottoscrizione che verrà addebitata per l'acquisto della prenotazione o del piano di risparmio
properties.displayName	string	Nome descrittivo della prenotazione
properties.quantity	integer	Quantità degli SKU che fanno parte della prenotazione.
properties.renew	boolean	L'impostazione su true acquista automaticamente una nuova prenotazione all'ora di scadenza.
properties.reservedResourceProperties	ReservedResourceProperties	Proprietà specifiche per ogni tipo di risorsa riservata. Non obbligatorio se non applicabile.
properties.reservedResourceType	ReservedResourceType	Tipo della risorsa riservata.
properties.reviewDateTime	string	Si tratta della data in cui è necessario esaminare il vantaggio ibrido di Azure.
properties.term	ReservationTerm	Rappresenta il termine della prenotazione.
sku	SkuName	Nome dello SKU

Risposte

Nome	Tipo	Descrizione
200 OK	CalculatePriceResponse	Informazioni dettagliate sul prezzo per l'acquisto ReservationOrder
Other Status Codes	Error	Errore imprevisto

Esempio

CalculatePrice

Sample Request

HTTP

POST https://management.azure.com/providers/Microsoft.Capacity/calculatePrice?api-version=2022-11-01

{
  "sku": {
    "name": "standard_D1"
  },
  "location": "westus",
  "properties": {
    "reservedResourceType": "VirtualMachines",
    "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
    "term": "P1Y",
    "billingPlan": "Monthly",
    "quantity": 1,
    "displayName": "TestReservationOrder",
    "appliedScopes": null,
    "appliedScopeType": "Shared",
    "reservedResourceProperties": {
      "instanceFlexibility": "On"
    }
  }
}

Java

import com.azure.resourcemanager.reservations.models.AppliedScopeType;
import com.azure.resourcemanager.reservations.models.InstanceFlexibility;
import com.azure.resourcemanager.reservations.models.PurchaseRequest;
import com.azure.resourcemanager.reservations.models.PurchaseRequestPropertiesReservedResourceProperties;
import com.azure.resourcemanager.reservations.models.ReservationBillingPlan;
import com.azure.resourcemanager.reservations.models.ReservationTerm;
import com.azure.resourcemanager.reservations.models.ReservedResourceType;
import com.azure.resourcemanager.reservations.models.SkuName;

/** Samples for ReservationOrder Calculate. */
public final class Main {
    /*
     * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/CalculateReservationOrder.json
     */
    /**
     * Sample code: CalculatePrice.
     *
     * @param manager Entry point to ReservationsManager.
     */
    public static void calculatePrice(com.azure.resourcemanager.reservations.ReservationsManager manager) {
        manager
            .reservationOrders()
            .calculateWithResponse(
                new PurchaseRequest()
                    .withSku(new SkuName().withName("standard_D1"))
                    .withLocation("westus")
                    .withReservedResourceType(ReservedResourceType.VIRTUAL_MACHINES)
                    .withBillingScopeId("/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83")
                    .withTerm(ReservationTerm.P1Y)
                    .withBillingPlan(ReservationBillingPlan.MONTHLY)
                    .withQuantity(1)
                    .withDisplayName("TestReservationOrder")
                    .withAppliedScopeType(AppliedScopeType.SHARED)
                    .withReservedResourceProperties(
                        new PurchaseRequestPropertiesReservedResourceProperties()
                            .withInstanceFlexibility(InstanceFlexibility.ON)),
                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 calculate_reservation_order.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_order.calculate(
        body={
            "location": "westus",
            "properties": {
                "appliedScopeType": "Shared",
                "appliedScopes": None,
                "billingPlan": "Monthly",
                "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
                "displayName": "TestReservationOrder",
                "quantity": 1,
                "reservedResourceProperties": {"instanceFlexibility": "On"},
                "reservedResourceType": "VirtualMachines",
                "term": "P1Y",
            },
            "sku": {"name": "standard_D1"},
        },
    )
    print(response)


# x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/CalculateReservationOrder.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/CalculateReservationOrder.json
func ExampleReservationOrderClient_Calculate() {
	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)
	}
	res, err := clientFactory.NewReservationOrderClient().Calculate(ctx, armreservations.PurchaseRequest{
		Location: to.Ptr("westus"),
		Properties: &armreservations.PurchaseRequestProperties{
			AppliedScopeType: to.Ptr(armreservations.AppliedScopeTypeShared),
			BillingPlan:      to.Ptr(armreservations.ReservationBillingPlanMonthly),
			BillingScopeID:   to.Ptr("/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83"),
			DisplayName:      to.Ptr("TestReservationOrder"),
			Quantity:         to.Ptr[int32](1),
			ReservedResourceProperties: &armreservations.PurchaseRequestPropertiesReservedResourceProperties{
				InstanceFlexibility: to.Ptr(armreservations.InstanceFlexibilityOn),
			},
			ReservedResourceType: to.Ptr(armreservations.ReservedResourceTypeVirtualMachines),
			Term:                 to.Ptr(armreservations.ReservationTermP1Y),
		},
		SKU: &armreservations.SKUName{
			Name: to.Ptr("standard_D1"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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.CalculatePriceResponse = armreservations.CalculatePriceResponse{
	// 	Properties: &armreservations.CalculatePriceResponseProperties{
	// 		BillingCurrencyTotal: &armreservations.CalculatePriceResponsePropertiesBillingCurrencyTotal{
	// 			Amount: to.Ptr[float64](46),
	// 			CurrencyCode: to.Ptr("USD"),
	// 		},
	// 		PaymentSchedule: []*armreservations.PaymentDetail{
	// 			{
	// 				BillingCurrencyTotal: &armreservations.Price{
	// 					Amount: to.Ptr[float64](40),
	// 					CurrencyCode: to.Ptr("EUR"),
	// 				},
	// 				DueDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2019-05-14"); return t}()),
	// 				PricingCurrencyTotal: &armreservations.Price{
	// 					Amount: to.Ptr[float64](46),
	// 					CurrencyCode: to.Ptr("USD"),
	// 				},
	// 			},
	// 			{
	// 				DueDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2019-06-14"); return t}()),
	// 				PricingCurrencyTotal: &armreservations.Price{
	// 					Amount: to.Ptr[float64](46),
	// 					CurrencyCode: to.Ptr("USD"),
	// 				},
	// 			},
	// 			{
	// 				DueDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2019-07-14"); return t}()),
	// 				PricingCurrencyTotal: &armreservations.Price{
	// 					Amount: to.Ptr[float64](46),
	// 					CurrencyCode: to.Ptr("USD"),
	// 				},
	// 		}},
	// 		PricingCurrencyTotal: &armreservations.CalculatePriceResponsePropertiesPricingCurrencyTotal{
	// 			Amount: to.Ptr[float32](46),
	// 			CurrencyCode: to.Ptr("USD"),
	// 		},
	// 		ReservationOrderID: to.Ptr("6d9cec54-7de8-abcd-9de7-80f5d634f2d2"),
	// 		SKUDescription: to.Ptr("standard_D1"),
	// 		SKUTitle: to.Ptr("Reserved VM Instance, Standard_D1, US West, 1 Year"),
	// 	},
	// }
}

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 Calculate price for placing a `ReservationOrder`.
 *
 * @summary Calculate price for placing a `ReservationOrder`.
 * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/CalculateReservationOrder.json
 */
async function calculatePrice() {
  const body = {
    appliedScopeType: "Shared",
    appliedScopes: [],
    billingPlan: "Monthly",
    billingScopeId: "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
    displayName: "TestReservationOrder",
    location: "westus",
    quantity: 1,
    reservedResourceProperties: { instanceFlexibility: "On" },
    reservedResourceType: "VirtualMachines",
    sku: { name: "standard_D1" },
    term: "P1Y",
  };
  const credential = new DefaultAzureCredential();
  const client = new AzureReservationAPI(credential);
  const result = await client.reservationOrder.calculate(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/CalculateReservationOrder.json
// this example is just showing the usage of "ReservationOrder_Calculate" 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 TenantResource created on azure
// for more information of creating TenantResource, please refer to the document of TenantResource
var tenantResource = client.GetTenants().GetAllAsync().GetAsyncEnumerator().Current;

// invoke the operation
ReservationPurchaseContent content = new ReservationPurchaseContent()
{
    SkuName = "standard_D1",
    Location = new AzureLocation("westus"),
    ReservedResourceType = ReservedResourceType.VirtualMachines,
    BillingScopeId = new ResourceIdentifier("/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83"),
    Term = ReservationTerm.P1Y,
    BillingPlan = ReservationBillingPlan.Monthly,
    Quantity = 1,
    DisplayName = "TestReservationOrder",
    AppliedScopeType = AppliedScopeType.Shared,
    AppliedScopes =
    {
    },
    ReservedResourceInstanceFlexibility = InstanceFlexibility.On,
};
CalculatePriceResult result = await tenantResource.CalculateReservationOrderAsync(content);

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

{
  "properties": {
    "billingCurrencyTotal": {
      "currencyCode": "USD",
      "amount": 46
    },
    "reservationOrderId": "6d9cec54-7de8-abcd-9de7-80f5d634f2d2",
    "skuTitle": "Reserved VM Instance, Standard_D1, US West, 1 Year",
    "skuDescription": "standard_D1",
    "pricingCurrencyTotal": {
      "currencyCode": "USD",
      "amount": 46
    },
    "paymentSchedule": [
      {
        "dueDate": "2019-05-14",
        "pricingCurrencyTotal": {
          "currencyCode": "USD",
          "amount": 46
        },
        "billingCurrencyTotal": {
          "currencyCode": "EUR",
          "amount": 40
        }
      },
      {
        "dueDate": "2019-06-14",
        "pricingCurrencyTotal": {
          "currencyCode": "USD",
          "amount": 46
        }
      },
      {
        "dueDate": "2019-07-14",
        "pricingCurrencyTotal": {
          "currencyCode": "USD",
          "amount": 46
        }
      }
    ]
  }
}

Definizioni

Nome	Descrizione
AppliedScopeProperties	Proprietà specifiche del tipo di ambito applicato. Non obbligatorio se non applicabile. Obbligatorio e necessario fornire tenantId e managementGroupId se AppliedScopeType è ManagementGroup
AppliedScopeType	Tipo dell'ambito applicato.
BillingCurrencyTotal	Valuta e importo che il cliente verrà addebitato nella valuta locale del cliente per l'acquisto di rinnovo. L'imposta non è inclusa.
CalculatePriceResponse	Risposta del calcolo del prezzo per la prenotazione.
CalculatePriceResponseProperties	Proprietà per calcolare la risposta al prezzo
Error	Informazioni sugli errori
ErrorResponseCode	Codice di errore che descrive il motivo per cui il servizio non è in grado di elaborare la richiesta in ingresso
ExtendedErrorInfo	Informazioni estese sull'errore, inclusi il codice di errore e il messaggio di errore
ExtendedStatusInfo
InstanceFlexibility	Se si attiva questa opzione, lo sconto per la prenotazione verrà applicato ad altre macchine virtuali nello stesso gruppo di dimensioni della macchina virtuale. Specificare solo per il tipo di risorsa riservata VirtualMachines.
PaymentDetail	Informazioni sul pagamento correlato a un ordine di prenotazione.
PaymentStatus	Descrive se il pagamento viene completato, non riuscito, annullato o pianificato in futuro.
Price	Informazioni sui prezzi contenenti l'importo e il codice di valuta
PricingCurrencyTotal	Quantità usata da Microsoft per il record. Utilizzato durante il rimborso per calcolare il limite di rimborso. L'imposta non è inclusa. Questo prezzo è bloccato 30 giorni prima della scadenza.
PurchaseRequest	Richiesta di acquisto della prenotazione
ReservationBillingPlan	Rappresentare i piani di fatturazione.
ReservationStatusCode
ReservationTerm	Rappresenta il termine della prenotazione.
ReservedResourceProperties	Proprietà specifiche di ogni tipo di risorsa riservata. Non obbligatorio se non applicabile.
ReservedResourceType	Tipo della risorsa riservata.
SkuName	Nome dello SKU

AppliedScopeProperties

Proprietà specifiche del tipo di ambito applicato. Non obbligatorio se non applicabile. Obbligatorio e necessario fornire tenantId e managementGroupId se AppliedScopeType è ManagementGroup

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato
managementGroupId	string	Identificatore completo del gruppo di gestione in cui è necessario applicare il vantaggio.
resourceGroupId	string	Identificatore completo del gruppo di risorse.
subscriptionId	string	Identificatore completo della sottoscrizione.
tenantId	string	ID tenant in cui il piano di risparmio deve applicare il vantaggio.

AppliedScopeType

Tipo dell'ambito applicato.

Nome	Tipo	Descrizione
ManagementGroup	string
Shared	string
Single	string

BillingCurrencyTotal

Valuta e importo che il cliente verrà addebitato nella valuta locale del cliente per l'acquisto di rinnovo. L'imposta non è inclusa.

Nome	Tipo	Descrizione
amount	number
currencyCode	string	Codice valuta ISO 4217 a 3 lettere per la valuta utilizzata da questo record di acquisto.

CalculatePriceResponse

Risposta del calcolo del prezzo per la prenotazione.

Nome	Tipo	Descrizione
properties	CalculatePriceResponseProperties	Proprietà per calcolare la risposta al prezzo

CalculatePriceResponseProperties

Proprietà per calcolare la risposta al prezzo

Nome	Tipo	Descrizione
billingCurrencyTotal	BillingCurrencyTotal	Valuta e importo che il cliente verrà addebitato nella valuta locale del cliente. L'imposta non è inclusa.
grandTotal	number	Importo totale nella valuta dei prezzi.
isBillingPartnerManaged	boolean	True se la fatturazione è gestita da Microsoft Partner. Usato solo per gli account CSP.
isTaxIncluded	boolean	Indica se l'imposta è inclusa nel totale complessivo
netTotal	number	Importo totale netto nella valuta dei prezzi.
paymentSchedule	PaymentDetail[]	Informazioni sul pagamento correlato a un ordine di prenotazione.
pricingCurrencyTotal	PricingCurrencyTotal	Quantità usata da Microsoft per il record. Utilizzato durante il rimborso per calcolare il limite di rimborso. L'imposta non è inclusa.
reservationOrderId	string	GUID che rappresenta l'ordine di prenotazione che può essere effettuato dopo il calcolo del prezzo.
skuDescription	string	Descrizione dello SKU acquistato.
skuTitle	string	Titolo dello SKU acquistato.
taxTotal	number	Importo delle imposte nella valuta dei prezzi.

Error

Informazioni sugli errori

Nome	Tipo	Descrizione
error	ExtendedErrorInfo	Informazioni estese sull'errore, inclusi il codice di errore e il messaggio di errore

ErrorResponseCode

Codice di errore che descrive il motivo per cui il servizio non è in grado di elaborare la richiesta in ingresso

Nome	Tipo	Descrizione
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

Informazioni estese sull'errore, inclusi il codice di errore e il messaggio di errore

Nome	Tipo	Descrizione
code	ErrorResponseCode	Codice di errore che descrive il motivo per cui il servizio non è in grado di elaborare la richiesta in ingresso
message	string

ExtendedStatusInfo

Nome	Tipo	Descrizione
message	string	Messaggio che fornisce informazioni dettagliate sul codice di stato.
statusCode	ReservationStatusCode

InstanceFlexibility

Se si attiva questa opzione, lo sconto per la prenotazione verrà applicato ad altre macchine virtuali nello stesso gruppo di dimensioni della macchina virtuale. Specificare solo per il tipo di risorsa riservata VirtualMachines.

Nome	Tipo	Descrizione
Off	string
On	string

PaymentDetail

Informazioni sul pagamento correlato a un ordine di prenotazione.

Nome	Tipo	Descrizione
billingAccount	string	Mostra l'account addebitato per il pagamento.
billingCurrencyTotal	Price	Importo addebitato nella valuta di fatturazione. Imposta non inclusa. Valore Null per i pagamenti futuri
dueDate	string	Data in cui deve essere effettuato il pagamento.
extendedStatusInfo	ExtendedStatusInfo
paymentDate	string	Data di completamento della transazione. Valore Null quando è pianificato.
pricingCurrencyTotal	Price	Importo nella valuta dei prezzi. Imposta non inclusa.
status	PaymentStatus	Descrive se il pagamento viene completato, non riuscito, annullato o pianificato in futuro.

PaymentStatus

Descrive se il pagamento viene completato, non riuscito, annullato o pianificato in futuro.

Nome	Tipo	Descrizione
Cancelled	string
Failed	string
Scheduled	string
Succeeded	string

Price

Informazioni sui prezzi contenenti l'importo e il codice di valuta

Nome	Tipo	Descrizione
amount	number
currencyCode	string	Codice valuta ISO 4217 a 3 lettere per la valuta utilizzata da questo record di acquisto.

PricingCurrencyTotal

Quantità usata da Microsoft per il record. Utilizzato durante il rimborso per calcolare il limite di rimborso. L'imposta non è inclusa. Questo prezzo è bloccato 30 giorni prima della scadenza.

Nome	Tipo	Descrizione
amount	number
currencyCode	string	Codice valuta ISO 4217 a 3 lettere per la valuta utilizzata da questo record di acquisto.

PurchaseRequest

Richiesta di acquisto della prenotazione

Nome	Tipo	Valore predefinito	Descrizione
location	string		Area di Azure in cui risiede la risorsa riservata.
properties.appliedScopeProperties	AppliedScopeProperties		Proprietà specifiche del tipo di ambito applicato. Non obbligatorio se non applicabile. Obbligatorio e necessario fornire tenantId e managementGroupId se AppliedScopeType è ManagementGroup
properties.appliedScopeType	AppliedScopeType		Tipo dell'ambito applicato.
properties.appliedScopes	string[]		Elenco delle sottoscrizioni a cui verrà applicato il vantaggio. Non specificare se AppliedScopeType è Shared. Questa proprietà verrà deprecata e sostituita da appliedScopeProperties per Single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan		Rappresentare i piani di fatturazione.
properties.billingScopeId	string		Sottoscrizione che verrà addebitata per l'acquisto della prenotazione o del piano di risparmio
properties.displayName	string		Nome descrittivo della prenotazione
properties.quantity	integer		Quantità degli SKU che fanno parte della prenotazione.
properties.renew	boolean	False	Se si imposta su true, verrà automaticamente acquistata una nuova prenotazione alla data di scadenza.
properties.reservedResourceProperties	ReservedResourceProperties		Proprietà specifiche di ogni tipo di risorsa riservata. Non obbligatorio se non applicabile.
properties.reservedResourceType	ReservedResourceType		Tipo della risorsa riservata.
properties.reviewDateTime	string		Si tratta della data in cui è necessario esaminare il vantaggio Azure Hybrid.
properties.term	ReservationTerm		Rappresenta il termine della prenotazione.
sku	SkuName		Nome dello SKU

ReservationBillingPlan

Rappresentare i piani di fatturazione.

Nome	Tipo	Descrizione
Monthly	string
Upfront	string

ReservationStatusCode

Nome	Tipo	Descrizione
Active	string
Expired	string
Merged	string
None	string
PaymentInstrumentError	string
Pending	string
Processing	string
PurchaseError	string
Split	string
Succeeded	string

ReservationTerm

Rappresenta il termine della prenotazione.

Nome	Tipo	Descrizione
P1Y	string
P3Y	string
P5Y	string

ReservedResourceProperties

Proprietà specifiche di ogni tipo di risorsa riservata. Non obbligatorio se non applicabile.

Nome	Tipo	Descrizione
instanceFlexibility	InstanceFlexibility	Se si attiva questa opzione, lo sconto per la prenotazione verrà applicato ad altre macchine virtuali nello stesso gruppo di dimensioni della macchina virtuale. Specificare solo per il tipo di risorsa riservata VirtualMachines.

ReservedResourceType

Tipo della risorsa riservata.

Nome	Tipo	Descrizione
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

Nome dello SKU

Nome	Tipo	Descrizione
name	string