Reservation Order - List

Serviço:

Reserved VM Instances

Versão da API:

2022-11-01

Obtenha tudo ReservationOrder.
Lista de todos os ReservationOrders a que o utilizador tem acesso no inquilino atual.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
api-version	query	True	string	Versão suportada.

Respostas

Name	Tipo	Description
200 OK	ReservationOrderList	Lista de ReservationOrders
Other Status Codes	Error	Erro inesperado

Exemplos

ReservationOrderList

Pedido de amostra

HTTP

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

Java

/** Samples for ReservationOrder List. */
public final class Main {
    /*
     * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/GetReservationOrders.json
     */
    /**
     * Sample code: ReservationOrderList.
     *
     * @param manager Entry point to ReservationsManager.
     */
    public static void reservationOrderList(com.azure.resourcemanager.reservations.ReservationsManager manager) {
        manager.reservationOrders().list(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 get_reservation_orders.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.list()
    for item in response:
        print(item)


# x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/GetReservationOrders.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/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/GetReservationOrders.json
func ExampleReservationOrderClient_NewListPager() {
	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)
	}
	pager := clientFactory.NewReservationOrderClient().NewListPager(nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.ReservationOrderList = armreservations.ReservationOrderList{
		// 	Value: []*armreservations.ReservationOrderResponse{
		// 		{
		// 			Name: to.Ptr("1e6407ba-37a5-499f-80ed-a3f0f338e443"),
		// 			Type: to.Ptr("Microsoft.Capacity/reservationOrders"),
		// 			Etag: to.Ptr[int32](7),
		// 			ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/1e6407ba-37a5-499f-80ed-a3f0f338e443"),
		// 			Properties: &armreservations.ReservationOrderProperties{
		// 				BenefitStartTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-29T21:20:23.813Z"); return t}()),
		// 				BillingPlan: to.Ptr(armreservations.ReservationBillingPlanMonthly),
		// 				CreatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-29T21:22:56.854Z"); return t}()),
		// 				DisplayName: to.Ptr("cabri"),
		// 				ExpiryDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2018-08-29"); return t}()),
		// 				ExpiryDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-29T21:20:23.813Z"); return t}()),
		// 				OriginalQuantity: to.Ptr[int32](1),
		// 				ProvisioningState: to.Ptr(armreservations.ProvisioningStateSucceeded),
		// 				RequestDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-29T21:20:23.813Z"); return t}()),
		// 				Reservations: []*armreservations.ReservationResponse{
		// 					{
		// 						ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/1e6407ba-37a5-499f-80ed-a3f0f338e443/reservations/cae5924e-7a15-419f-a369-124f52d4a106"),
		// 				}},
		// 				Term: to.Ptr(armreservations.ReservationTermP1Y),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("1ea6e203-288e-4732-b9e1-da8bbe10c614"),
		// 			Type: to.Ptr("Microsoft.Capacity/reservationOrders"),
		// 			Etag: to.Ptr[int32](7),
		// 			ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/1ea6e203-288e-4732-b9e1-da8bbe10c614"),
		// 			Properties: &armreservations.ReservationOrderProperties{
		// 				BenefitStartTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-30T12:55:40.279Z"); return t}()),
		// 				BillingPlan: to.Ptr(armreservations.ReservationBillingPlanMonthly),
		// 				CreatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-30T12:58:20.526Z"); return t}()),
		// 				DisplayName: to.Ptr("cabri"),
		// 				ExpiryDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2018-08-30"); return t}()),
		// 				ExpiryDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-30T12:58:20.526Z"); return t}()),
		// 				OriginalQuantity: to.Ptr[int32](9),
		// 				ProvisioningState: to.Ptr(armreservations.ProvisioningStateSucceeded),
		// 				RequestDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-30T12:55:40.279Z"); return t}()),
		// 				Reservations: []*armreservations.ReservationResponse{
		// 					{
		// 						ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/1ea6e203-288e-4732-b9e1-da8bbe10c614/reservations/d04fd48d-e3f6-42a3-a8f6-1ad0b7513e48"),
		// 				}},
		// 				Term: to.Ptr(armreservations.ReservationTermP1Y),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("1f14354c-dc12-4c8d-8090-6f295a3a34aa"),
		// 			Type: to.Ptr("Microsoft.Capacity/reservationOrders"),
		// 			Etag: to.Ptr[int32](7),
		// 			ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa"),
		// 			Properties: &armreservations.ReservationOrderProperties{
		// 				BenefitStartTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-30T03:49:19.025Z"); return t}()),
		// 				BillingPlan: to.Ptr(armreservations.ReservationBillingPlanMonthly),
		// 				CreatedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-30T03:51:49.808Z"); return t}()),
		// 				DisplayName: to.Ptr("cabri"),
		// 				ExpiryDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2018-08-30"); return t}()),
		// 				ExpiryDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-30T03:51:49.808Z"); return t}()),
		// 				OriginalQuantity: to.Ptr[int32](7),
		// 				ProvisioningState: to.Ptr(armreservations.ProvisioningStateSucceeded),
		// 				RequestDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-08-30T03:49:19.025Z"); return t}()),
		// 				Reservations: []*armreservations.ReservationResponse{
		// 					{
		// 						ID: to.Ptr("/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"),
		// 				}},
		// 				Term: to.Ptr(armreservations.ReservationTermP1Y),
		// 			},
		// 	}},
		// }
	}
}

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 List of all the `ReservationOrder`s that the user has access to in the current tenant.
 *
 * @summary List of all the `ReservationOrder`s that the user has access to in the current tenant.
 * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/GetReservationOrders.json
 */
async function reservationOrderList() {
  const credential = new DefaultAzureCredential();
  const client = new AzureReservationAPI(credential);
  const resArray = new Array();
  for await (let item of client.reservationOrder.list()) {
    resArray.push(item);
  }
  console.log(resArray);
}

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.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/GetReservationOrders.json
// this example is just showing the usage of "ReservationOrder_List" 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;

// get the collection of this ReservationOrderResource
ReservationOrderCollection collection = tenantResource.GetReservationOrders();

// invoke the operation and iterate over the result
await foreach (ReservationOrderResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    ReservationOrderData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta da amostra

Código de estado:

200

{
  "value": [
    {
      "id": "/providers/microsoft.capacity/reservationOrders/1e6407ba-37a5-499f-80ed-a3f0f338e443",
      "type": "Microsoft.Capacity/reservationOrders",
      "name": "1e6407ba-37a5-499f-80ed-a3f0f338e443",
      "etag": 7,
      "properties": {
        "displayName": "cabri",
        "requestDateTime": "2017-08-29T21:20:23.8134834Z",
        "createdDateTime": "2017-08-29T21:22:56.8541664Z",
        "benefitStartTime": "2017-08-29T21:20:23.8134834Z",
        "expiryDate": "2018-08-29",
        "expiryDateTime": "2018-08-29T21:20:23.8134834Z",
        "term": "P1Y",
        "billingPlan": "Monthly",
        "provisioningState": "Succeeded",
        "reservations": [
          {
            "id": "/providers/microsoft.capacity/reservationOrders/1e6407ba-37a5-499f-80ed-a3f0f338e443/reservations/cae5924e-7a15-419f-a369-124f52d4a106"
          }
        ],
        "originalQuantity": 1
      }
    },
    {
      "id": "/providers/microsoft.capacity/reservationOrders/1ea6e203-288e-4732-b9e1-da8bbe10c614",
      "type": "Microsoft.Capacity/reservationOrders",
      "name": "1ea6e203-288e-4732-b9e1-da8bbe10c614",
      "etag": 7,
      "properties": {
        "displayName": "cabri",
        "benefitStartTime": "2017-08-30T12:55:40.2799114Z",
        "requestDateTime": "2017-08-30T12:55:40.2799114Z",
        "createdDateTime": "2017-08-30T12:58:20.526Z",
        "expiryDate": "2018-08-30",
        "expiryDateTime": "2018-08-30T12:58:20.526Z",
        "term": "P1Y",
        "billingPlan": "Monthly",
        "provisioningState": "Succeeded",
        "reservations": [
          {
            "id": "/providers/microsoft.capacity/reservationOrders/1ea6e203-288e-4732-b9e1-da8bbe10c614/reservations/d04fd48d-e3f6-42a3-a8f6-1ad0b7513e48"
          }
        ],
        "originalQuantity": 9
      }
    },
    {
      "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
      "type": "Microsoft.Capacity/reservationOrders",
      "name": "1f14354c-dc12-4c8d-8090-6f295a3a34aa",
      "etag": 7,
      "properties": {
        "displayName": "cabri",
        "benefitStartTime": "2017-08-30T03:49:19.0252126Z",
        "requestDateTime": "2017-08-30T03:49:19.0252126Z",
        "createdDateTime": "2017-08-30T03:51:49.8083758Z",
        "expiryDate": "2018-08-30",
        "expiryDateTime": "2018-08-30T03:51:49.8083758Z",
        "term": "P1Y",
        "billingPlan": "Monthly",
        "provisioningState": "Succeeded",
        "reservations": [
          {
            "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
          }
        ],
        "originalQuantity": 7
      }
    }
  ],
  "nextLink": "https://management.azure.com/providers/Microsoft.Capacity/reservationOrders?api-version=2017-11-01&%24skiptoken=eyJyZyI6IjIwNTkyMzdlLWY3MmYtNDczYi1hNTZiLWExOGJkM2UwMDhlZCIsImlnIjpudWxsLCJzdCI6bnVsbH0%3d"
}

Definições

Name	Description
AppliedScopeProperties	Propriedades específicas do tipo de âmbito aplicado. Não é necessário se não for aplicável. Necessário e necessário para fornecer tenantId e managementGroupId se AppliedScopeType for ManagementGroup
AppliedScopeType	Tipo do Âmbito Aplicado.
BillingCurrencyTotal	Moeda e montante a que o cliente será cobrado na moeda local do cliente para compra de renovação. O imposto não está incluído.
createdByType	O tipo de identidade que criou o recurso.
Error	Informações de erro
ErrorResponseCode	Código de erro que descreve o motivo pelo qual o serviço não consegue processar o pedido recebido
ExtendedErrorInfo	Informações de erro expandidas, incluindo código de erro e mensagem de erro
ExtendedStatusInfo
InstanceFlexibility	Ativar esta opção aplicará o desconto de reserva a outras VMs no mesmo grupo de tamanho de VM. Especifique apenas para o tipo de recurso reservado VirtualMachines.
Kind	Tipo de Fornecedor de Recursos a ser reservado.
PaymentDetail	Informações sobre o pagamento relacionados com uma encomenda de reserva.
PaymentStatus	Descreve se o pagamento foi concluído, falhou, foi cancelado ou agendado no futuro.
Price	Informações de preços que contêm o montante e o código de moeda
PricingCurrencyTotal	Montante que a Microsoft utiliza para registo. Utilizado durante o reembolso para calcular o limite de reembolso. O imposto não está incluído. Este preço está bloqueado 30 dias antes de expirar.
ProvisioningState	Representar o estado atual da Reserva.
PurchaseRequest	O pedido de compra de reserva
RenewPropertiesResponse	As propriedades de renovação de uma reserva.
ReservationBillingPlan	Representar os planos de faturação.
ReservationMergeProperties	Propriedades da intercalação de reservas
ReservationOrderBillingPlanInformation	Informações que descrevem o tipo de plano de faturação para esta reserva.
ReservationOrderList	Lista de ReservationOrders
ReservationOrderResponse	Detalhes de uma encomenda de reserva a ser devolvida.
ReservationResponse	A definição da reserva.
ReservationSplitProperties	Propriedades da divisão da reserva
ReservationsProperties	As propriedades das reservas
ReservationStatusCode
ReservationSwapProperties	Propriedades da troca de reserva
ReservationTerm	Representar o termo da reserva.
ReservationUtilizationAggregates	Os valores agregados da utilização da reserva
ReservedResourceProperties	Propriedades específicas de cada tipo de recurso reservado. Não é necessário se não for aplicável.
ReservedResourceType	O tipo de recurso que está a ser reservado.
SkuName	O nome do SKU
systemData	Metadados relativos à criação e última modificação do recurso.
Utilization	Utilização da reserva

AppliedScopeProperties

Propriedades específicas do tipo de âmbito aplicado. Não é necessário se não for aplicável. Necessário e necessário para fornecer tenantId e managementGroupId se AppliedScopeType for ManagementGroup

Name	Tipo	Description
displayName	string	Nome a apresentar
managementGroupId	string	Identificador completamente qualificado do grupo de gestão onde o benefício tem de ser aplicado.
resourceGroupId	string	Identificador completamente qualificado do grupo de recursos.
subscriptionId	string	Identificador completamente qualificado da subscrição.
tenantId	string	ID do inquilino onde o plano de poupança deve aplicar benefícios.

AppliedScopeType

Tipo do Âmbito Aplicado.

Name	Tipo	Description
ManagementGroup	string
Shared	string
Single	string

BillingCurrencyTotal

Moeda e montante a que o cliente será cobrado na moeda local do cliente para compra de renovação. O imposto não está incluído.

Name	Tipo	Description
amount	number
currencyCode	string	O código de moeda iso 4217 de 3 letras para a moeda utilizada por este registo de compra.

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Error

Informações de erro

Name	Tipo	Description
error	ExtendedErrorInfo	Informações de erro expandidas, incluindo código de erro e mensagem de erro

ErrorResponseCode

Código de erro que descreve o motivo pelo qual o serviço não consegue processar o pedido recebido

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

Informações de erro expandidas, incluindo código de erro e mensagem de erro

Name	Tipo	Description
code	ErrorResponseCode	Código de erro que descreve o motivo pelo qual o serviço não consegue processar o pedido recebido
message	string

ExtendedStatusInfo

Name	Tipo	Description
message	string	A mensagem que fornece informações detalhadas sobre o código de estado.
statusCode	ReservationStatusCode

InstanceFlexibility

Ativar esta opção aplicará o desconto de reserva a outras VMs no mesmo grupo de tamanho de VM. Especifique apenas para o tipo de recurso reservado VirtualMachines.

Name	Tipo	Description
Off	string
On	string

Kind

Tipo de Fornecedor de Recursos a ser reservado.

Name	Tipo	Description
Microsoft.Compute	string

PaymentDetail

Informações sobre o pagamento relacionados com uma encomenda de reserva.

Name	Tipo	Description
billingAccount	string	Mostra a Conta que é cobrada por este pagamento.
billingCurrencyTotal	Price	Montante cobrado na moeda de faturação. Imposto não incluído. É nulo para pagamentos futuros
dueDate	string	Data em que o pagamento tem de ser feito.
extendedStatusInfo	ExtendedStatusInfo
paymentDate	string	Data em que a transação é concluída. É nulo quando está agendado.
pricingCurrencyTotal	Price	Montante em moeda de preços. Imposto não incluído.
status	PaymentStatus	Descreve se o pagamento foi concluído, falhou, foi cancelado ou agendado no futuro.

PaymentStatus

Descreve se o pagamento foi concluído, falhou, foi cancelado ou agendado no futuro.

Name	Tipo	Description
Cancelled	string
Failed	string
Scheduled	string
Succeeded	string

Price

Informações de preços que contêm o montante e o código de moeda

Name	Tipo	Description
amount	number
currencyCode	string	O código de moeda iso 4217 de 3 letras para a moeda utilizada por este registo de compra.

PricingCurrencyTotal

Montante que a Microsoft utiliza para registo. Utilizado durante o reembolso para calcular o limite de reembolso. O imposto não está incluído. Este preço está bloqueado 30 dias antes de expirar.

Name	Tipo	Description
amount	number
currencyCode	string	O código de moeda iso 4217 de 3 letras para a moeda utilizada por este registo de compra.

ProvisioningState

Representar o estado atual da Reserva.

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

O pedido de compra de reserva

Name	Tipo	Default value	Description
location	string		A região do Azure onde reside o recurso reservado.
properties.appliedScopeProperties	AppliedScopeProperties		Propriedades específicas do tipo de âmbito aplicado. Não é necessário se não for aplicável. Necessário e necessário para fornecer tenantId e managementGroupId se AppliedScopeType for ManagementGroup
properties.appliedScopeType	AppliedScopeType		Tipo do Âmbito Aplicado.
properties.appliedScopes	string[]		Lista das subscrições às quais o benefício será aplicado. Não especifique se AppliedScopeType é Partilhado. Esta propriedade será preterida e substituída por appliedScopeProperties em vez de Single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan		Representar os planos de faturação.
properties.billingScopeId	string		Subscrição que será cobrada pela compra de reserva ou plano de poupança
properties.displayName	string		Nome amigável da reserva
properties.quantity	integer		Quantidade de skUs que fazem parte da reserva.
properties.renew	boolean	False	Definir isto como verdadeiro comprará automaticamente uma nova reserva na data de expiração.
properties.reservedResourceProperties	ReservedResourceProperties		Propriedades específicas de cada tipo de recurso reservado. Não é necessário se não for aplicável.
properties.reservedResourceType	ReservedResourceType		O tipo de recurso que está a ser reservado.
properties.reviewDateTime	string		Esta é a data-hora em que o benefício híbrido do Azure precisa de ser revisto.
properties.term	ReservationTerm		Representar o termo da reserva.
sku	SkuName		O nome do SKU

RenewPropertiesResponse

As propriedades de renovação de uma reserva.

Name	Tipo	Description
billingCurrencyTotal	BillingCurrencyTotal	Moeda e montante a que o cliente será cobrado na moeda local do cliente para compra de renovação. O imposto não está incluído.
pricingCurrencyTotal	PricingCurrencyTotal	Montante que a Microsoft utiliza para registo. Utilizado durante o reembolso para calcular o limite de reembolso. O imposto não está incluído. Este preço está bloqueado 30 dias antes de expirar.
purchaseProperties	PurchaseRequest	O pedido de compra de reserva

ReservationBillingPlan

Representar os planos de faturação.

Name	Tipo	Description
Monthly	string
Upfront	string

ReservationMergeProperties

Propriedades da intercalação de reservas

Name	Tipo	Description
mergeDestination	string	ID do recurso de reserva Criado devido à intercalação. O formato do ID do recurso é /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources	string[]	IDs de recursos da reserva de origem intercalados para formar esta reserva. O formato do ID do recurso é /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationOrderBillingPlanInformation

Informações que descrevem o tipo de plano de faturação para esta reserva.

Name	Tipo	Description
nextPaymentDueDate	string	Para planos de faturação periódica, indica a data em que o próximo pagamento será processado. Nulo quando o total é pago.
pricingCurrencyTotal	Price	Montante a pagar pela Encomenda. O imposto não está incluído.
startDate	string	Data em que o plano de faturação é iniciado.
transactions	PaymentDetail[]	Informações sobre o pagamento relacionados com uma encomenda de reserva.

ReservationOrderList

Lista de ReservationOrders

Name	Tipo	Description
nextLink	string	URL para obter a página seguinte de reservationOrders.
value	ReservationOrderResponse[]	Detalhes de uma encomenda de reserva a ser devolvida.

ReservationOrderResponse

Detalhes de uma encomenda de reserva a ser devolvida.

Name	Tipo	Description
etag	integer
id	string	Identificador da reserva
name	string	Nome da reserva
properties.benefitStartTime	string	Este é o DateTime quando o benefício da reserva começou.
properties.billingPlan	ReservationBillingPlan	Representar os planos de faturação.
properties.createdDateTime	string	Este é o DateTime quando a reserva foi criada.
properties.displayName	string	Nome amigável para o utilizador identificar facilmente a reserva.
properties.expiryDate	string	Esta é a data em que a reserva irá expirar.
properties.expiryDateTime	string	Esta é a data-hora em que a reserva irá expirar.
properties.originalQuantity	integer	Quantidade Total de skUs comprados na reserva.
properties.planInformation	ReservationOrderBillingPlanInformation	Informações que descrevem o tipo de plano de faturação para esta reserva.
properties.provisioningState	ProvisioningState	Estado atual da reserva.
properties.requestDateTime	string	Este é o DateTime quando a reserva foi inicialmente pedida para compra.
properties.reservations	ReservationResponse[]	A definição da reserva.
properties.reviewDateTime	string	Esta é a data-hora em que o Benefício Híbrido do Azure tem de ser revisto.
properties.term	ReservationTerm	Representar o termo da reserva.
systemData	systemData	Metadados relativos à criação e última modificação do recurso.
type	string	Tipo de recurso. "Microsoft.Capacity/reservations"

ReservationResponse

A definição da reserva.

Name	Tipo	Description
etag	integer
id	string	ID de recurso completamente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	Kind	Tipo de Fornecedor de Recursos a ser reservado.
location	string	A região do Azure onde reside o recurso reservado.
name	string	O nome do recurso
properties	ReservationsProperties	As propriedades associadas a esta reserva
sku	SkuName	As informações do SKU associadas a esta reserva
systemData	systemData	O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ReservationSplitProperties

Propriedades da divisão da reserva

Name	Tipo	Description
splitDestinations	string[]	Lista do ID de recurso de destino que são criados devido à divisão. O formato do ID do recurso é /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	ID do recurso da reserva a partir da qual esta está dividida. O formato do ID do recurso é /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

As propriedades das reservas

Name	Tipo	Default value	Description
appliedScopeProperties	AppliedScopeProperties		Propriedades específicas do tipo de âmbito aplicado. Não é necessário se não for aplicável. Necessário e necessário para fornecer tenantId e managementGroupId se AppliedScopeType for ManagementGroup
appliedScopeType	AppliedScopeType		O tipo de âmbito aplicado
appliedScopes	string[]		A lista de âmbitos aplicados
archived	boolean		Indica se a reserva está arquivada
benefitStartTime	string		Este é o DateTime quando o benefício da reserva começou.
billingPlan	ReservationBillingPlan		As opções do plano de faturação disponíveis para este SKU.
billingScopeId	string		Subscrição que será cobrada pela compra de reserva ou plano de poupança
capabilities	string		Capacidades da reserva
displayName	string		Nome amigável para o utilizador identificar facilmente a reserva
displayProvisioningState	string		O estado de aprovisionamento da reserva para apresentação, por exemplo, Com êxito
effectiveDateTime	string		DateTime da reserva a partir da qual esta versão é eficaz.
expiryDate	string		Esta é a data em que a reserva irá expirar.
expiryDateTime	string		Esta é a data-hora em que a reserva irá expirar.
extendedStatusInfo	ExtendedStatusInfo		A mensagem que fornece informações detalhadas sobre o código de estado.
instanceFlexibility	InstanceFlexibility		Permite que o desconto de reserva seja aplicado entre skUs dentro do mesmo grupo de ajuste automático. Nem todos os skUs suportam a flexibilidade de tamanho de instância.
lastUpdatedDateTime	string		DateTime da última vez que a reserva foi atualizada.
mergeProperties	ReservationMergeProperties		Propriedades da intercalação de reservas
provisioningState	ProvisioningState		Estado atual da reserva.
provisioningSubState	string		O subestado de aprovisionamento da reserva, por exemplo, Com êxito
purchaseDate	string		Esta é a data em que a reserva foi comprada.
purchaseDateTime	string		Esta é a data-hora em que a reserva foi comprada.
quantity	integer		Quantidade de skUs que fazem parte da reserva.
renew	boolean	False	Definir isto como verdadeiro comprará automaticamente uma nova reserva na data de expiração.
renewDestination	string		ID de reserva da reserva comprada por causa da renovação. O formato do ID do recurso é /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties	RenewPropertiesResponse		As propriedades de renovação de uma reserva.
renewSource	string		ID de reserva da reserva a partir da qual esta reserva é renovada. O formato do ID do recurso é /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType	ReservedResourceType		O tipo de recurso que está a ser reservado.
reviewDateTime	string		Esta é a data-hora em que o Benefício Híbrido do Azure tem de ser revisto.
skuDescription	string		Descrição do SKU em inglês.
splitProperties	ReservationSplitProperties		Propriedades da divisão da reserva
swapProperties	ReservationSwapProperties		Propriedades da troca de reserva
term	ReservationTerm		Representar o termo da reserva.
userFriendlyAppliedScopeType	string		O tipo de âmbito aplicado da reserva para apresentação, por exemplo, Partilhado
userFriendlyRenewState	string		O estado de renovação da reserva para apresentação, por exemplo, Ativado
utilization	Utilization		Utilização da reserva

ReservationStatusCode

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

ReservationSwapProperties

Propriedades da troca de reserva

Name	Tipo	Description
swapDestination	string	ID do recurso de reserva para o qual o recurso original é trocado. O formato do ID do recurso é /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	ID do recurso da reserva de origem que é trocada. O formato do ID do recurso é /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Representar o termo da reserva.

Name	Tipo	Description
P1Y	string
P3Y	string
P5Y	string

ReservationUtilizationAggregates

Os valores agregados da utilização da reserva

Name	Tipo	Description
grain	number	O grão da agregação
grainUnit	string	A unidade de agregação
value	number	O valor agregado
valueUnit	string	A unidade de valor agregado

ReservedResourceProperties

Propriedades específicas de cada tipo de recurso reservado. Não é necessário se não for aplicável.

Name	Tipo	Description
instanceFlexibility	InstanceFlexibility	Ativar esta opção aplicará o desconto de reserva a outras VMs no mesmo grupo de tamanho de VM. Especifique apenas para o tipo de recurso reservado VirtualMachines.

ReservedResourceType

O tipo de recurso que está a ser reservado.

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

O nome do SKU

Name	Tipo	Description
name	string

systemData

Metadados relativos à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Utilization

Utilização da reserva

Name	Tipo	Description
aggregates	ReservationUtilizationAggregates[]	A matriz de agregações da utilização de uma reserva
trend	string	Última tendência de utilização de 7 dias para uma reserva