Reservation Order - List

Tjänst:

Reserved VM Instances

API-version:

2022-11-01

Hämta alla ReservationOrders.
Lista över alla ReservationOrdersom användaren har åtkomst till i den aktuella klientorganisationen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
api-version	query	True	string	Version som stöds.

Svar

Name	Typ	Description
200 OK	ReservationOrderList	Lista över ReservationOrders
Other Status Codes	Error	Oväntat fel

Exempel

ReservationOrderList

Exempelbegäran

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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
AppliedScopeProperties	Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt. Krävs och måste ange tenantId och managementGroupId om AppliedScopeType är ManagementGroup
AppliedScopeType	Typ av tillämpat omfång.
BillingCurrencyTotal	Valuta och belopp som kunden debiteras i kundens lokala valuta för förnyelseköp. Skatt ingår inte.
createdByType	Den typ av identitet som skapade resursen.
Error	Felinformation
ErrorResponseCode	Felkod som beskriver orsaken till att tjänsten inte kan bearbeta den inkommande begäran
ExtendedErrorInfo	Utökad felinformation, inklusive felkod och felmeddelande
ExtendedStatusInfo
InstanceFlexibility	Om du aktiverar detta tillämpas reservationsrabatten på andra virtuella datorer i samma vm-storleksgrupp. Ange endast reserverad resurstyp för VirtualMachines.
Kind	Resursprovidertyp som ska reserveras.
PaymentDetail	Information om betalning relaterad till en reservationsbeställning.
PaymentStatus	Beskriver om betalningen har slutförts, misslyckats, avbrutits eller schemalagts i framtiden.
Price	Prisinformation som innehåller beloppet och valutakoden
PricingCurrencyTotal	Belopp som Microsoft använder för post. Används under återbetalningen för att beräkna återbetalningsgränsen. Skatt ingår inte. Detta är låst pris 30 dagar före förfallodatum.
ProvisioningState	Representerar det aktuella tillståndet för reservationen.
PurchaseRequest	Begäran om reservationsköp
RenewPropertiesResponse	Förnyelseegenskaperna för en reservation.
ReservationBillingPlan	Representera faktureringsplanerna.
ReservationMergeProperties	Egenskaper för reservationssammanslagning
ReservationOrderBillingPlanInformation	Information som beskriver typen av faktureringsplan för den här reservationen.
ReservationOrderList	Lista över ReservationOrders
ReservationOrderResponse	Information om en reservationsbeställning som returneras.
ReservationResponse	Definitionen av reservationen.
ReservationSplitProperties	Egenskaper för reservationsdelning
ReservationsProperties	Egenskaperna för reservationerna
ReservationStatusCode
ReservationSwapProperties	Egenskaper för reservationsbyte
ReservationTerm	Representera reservationsperioden.
ReservationUtilizationAggregates	Aggregerade värden för reservationsanvändning
ReservedResourceProperties	Egenskaper som är specifika för varje reserverad resurstyp. Krävs inte om det inte är tillämpligt.
ReservedResourceType	Typen av resurs som reserveras.
SkuName	Namnet på sku
systemData	Metadata som rör skapande och senaste ändring av resursen.
Utilization	Reservationsanvändning

AppliedScopeProperties

Objekt

Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt. Krävs och måste ange tenantId och managementGroupId om AppliedScopeType är ManagementGroup

Name	Typ	Description
displayName	string	Visningsnamn
managementGroupId	string	Fullständigt kvalificerad identifierare för den hanteringsgrupp där förmånen måste tillämpas.
resourceGroupId	string	Fullständigt kvalificerad identifierare för resursgruppen.
subscriptionId	string	Fullständigt kvalificerad identifierare för prenumerationen.
tenantId	string	Klientorganisations-ID där sparplanen ska tillämpa förmånen.

AppliedScopeType

Uppräkning

Typ av tillämpat omfång.

Värde	Description
ManagementGroup
Shared
Single

BillingCurrencyTotal

Objekt

Valuta och belopp som kunden debiteras i kundens lokala valuta för förnyelseköp. Skatt ingår inte.

Name	Typ	Description
amount	number
currencyCode	string	ISO 4217 3-bokstavs valutakod för den valuta som används av den här inköpsposten.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
Application
Key
ManagedIdentity
User

Error

Objekt

Felinformation

Name	Typ	Description
error	ExtendedErrorInfo	Utökad felinformation, inklusive felkod och felmeddelande

ErrorResponseCode

Uppräkning

Felkod som beskriver orsaken till att tjänsten inte kan bearbeta den inkommande begäran

Värde	Description
ActivateQuoteFailed
AppliedScopesNotAssociatedWithCommerceAccount
AppliedScopesSameAsExisting
AuthorizationFailed
BadRequest
BillingCustomerInputError
BillingError
BillingPaymentInstrumentHardError
BillingPaymentInstrumentSoftError
BillingScopeIdCannotBeChanged
BillingTransientError
CalculatePriceFailed
CapacityUpdateScopesFailed
ClientCertificateThumbprintNotSet
CreateQuoteFailed
Forbidden
FulfillmentConfigurationError
FulfillmentError
FulfillmentOutOfStockError
FulfillmentTransientError
HttpMethodNotSupported
InternalServerError
InvalidAccessToken
InvalidFulfillmentRequestParameters
InvalidHealthCheckType
InvalidLocationId
InvalidRefundQuantity
InvalidRequestContent
InvalidRequestUri
InvalidReservationId
InvalidReservationOrderId
InvalidSingleAppliedScopesCount
InvalidSubscriptionId
InvalidTenantId
MissingAppliedScopesForSingle
MissingTenantId
NoValidReservationsToReRate
NonsupportedAccountId
NotSpecified
NotSupportedCountry
OperationCannotBePerformedInCurrentState
OperationFailed
PatchValuesSameAsExisting
PaymentInstrumentNotFound
PurchaseError
ReRateOnlyAllowedForEA
RefundLimitExceeded
ReservationIdNotInReservationOrder
ReservationOrderCreationFailed
ReservationOrderIdAlreadyExists
ReservationOrderNotEnabled
ReservationOrderNotFound
RiskCheckFailed
RoleAssignmentCreationFailed
SelfServiceRefundNotSupported
ServerTimeout
UnauthenticatedRequestsThrottled
UnsupportedReservationTerm

ExtendedErrorInfo

Objekt

Utökad felinformation, inklusive felkod och felmeddelande

Name	Typ	Description
code	ErrorResponseCode	Felkod som beskriver orsaken till att tjänsten inte kan bearbeta den inkommande begäran
message	string

ExtendedStatusInfo

Objekt

Name	Typ	Description
message	string	Meddelandet med detaljerad information om statuskoden.
statusCode	ReservationStatusCode

InstanceFlexibility

Uppräkning

Om du aktiverar detta tillämpas reservationsrabatten på andra virtuella datorer i samma vm-storleksgrupp. Ange endast reserverad resurstyp för VirtualMachines.

Värde	Description
Off
On

Kind

Uppräkning

Resursprovidertyp som ska reserveras.

Värde	Description
Microsoft.Compute

PaymentDetail

Objekt

Information om betalning relaterad till en reservationsbeställning.

Name	Typ	Description
billingAccount	string	Visar det konto som debiteras för den här betalningen.
billingCurrencyTotal	Price	Belopp som debiteras i faktureringsvaluta. Skatt ingår inte. Är null för framtida betalningar
dueDate	string (date)	Datum då betalningen måste göras.
extendedStatusInfo	ExtendedStatusInfo
paymentDate	string (date)	Datum då transaktionen har slutförts. Är null när det är schemalagt.
pricingCurrencyTotal	Price	Belopp i prisvaluta. Skatt ingår inte.
status	PaymentStatus	Beskriver om betalningen har slutförts, misslyckats, avbrutits eller schemalagts i framtiden.

PaymentStatus

Uppräkning

Beskriver om betalningen har slutförts, misslyckats, avbrutits eller schemalagts i framtiden.

Värde	Description
Cancelled
Failed
Scheduled
Succeeded

Price

Objekt

Prisinformation som innehåller beloppet och valutakoden

Name	Typ	Description
amount	number (double)
currencyCode	string	ISO 4217 3-bokstavs valutakod för den valuta som används av den här inköpsposten.

PricingCurrencyTotal

Objekt

Belopp som Microsoft använder för post. Används under återbetalningen för att beräkna återbetalningsgränsen. Skatt ingår inte. Detta är låst pris 30 dagar före förfallodatum.

Name	Typ	Description
amount	number
currencyCode	string	ISO 4217 3-bokstavs valutakod för den valuta som används av den här inköpsposten.

ProvisioningState

Uppräkning

Representerar det aktuella tillståndet för reservationen.

Värde	Description
BillingFailed
Cancelled
ConfirmedBilling
ConfirmedResourceHold
Created
Creating
Expired
Failed
Merged
PendingBilling
PendingResourceHold
Split
Succeeded

PurchaseRequest

Objekt

Begäran om reservationsköp

Name	Typ	Standardvärde	Description
location	string		Den Azure-region där den reserverade resursen finns.
properties.appliedScopeProperties	AppliedScopeProperties		Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt. Krävs och måste ange tenantId och managementGroupId om AppliedScopeType är ManagementGroup
properties.appliedScopeType	AppliedScopeType		Typ av tillämpat omfång.
properties.appliedScopes	string[]		Lista över de prenumerationer som förmånen ska tillämpas på. Ange inte om AppliedScopeType är Delat. Den här egenskapen kommer att bli inaktuell och ersättas av appliedScopeProperties i stället för Single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan		Representera faktureringsplanerna.
properties.billingScopeId	string		Prenumeration som debiteras för köp av reservation eller sparplan
properties.displayName	string		Eget namn på reservationen
properties.quantity	integer (int32)		Antal sku:er som ingår i reservationen.
properties.renew	boolean	False	Om du anger värdet true köps automatiskt en ny reservation på förfallodatumtiden.
properties.reservedResourceProperties	ReservedResourceProperties		Egenskaper som är specifika för varje reserverad resurstyp. Krävs inte om det inte är tillämpligt.
properties.reservedResourceType	ReservedResourceType		Typen av resurs som reserveras.
properties.reviewDateTime	string (date-time)		Det här är den tidpunkt då Azure-hybridförmånen måste granskas.
properties.term	ReservationTerm		Representera reservationsperioden.
sku	SkuName		Namnet på sku

RenewPropertiesResponse

Objekt

Förnyelseegenskaperna för en reservation.

Name	Typ	Description
billingCurrencyTotal	BillingCurrencyTotal	Valuta och belopp som kunden debiteras i kundens lokala valuta för förnyelseköp. Skatt ingår inte.
pricingCurrencyTotal	PricingCurrencyTotal	Belopp som Microsoft använder för post. Används under återbetalningen för att beräkna återbetalningsgränsen. Skatt ingår inte. Detta är låst pris 30 dagar före förfallodatum.
purchaseProperties	PurchaseRequest	Begäran om reservationsköp

ReservationBillingPlan

Uppräkning

Representera faktureringsplanerna.

Värde	Description
Monthly
Upfront

ReservationMergeProperties

Objekt

Egenskaper för reservationssammanslagning

Name	Typ	Description
mergeDestination	string	Reservationsresurs-ID skapat på grund av sammanfogningen. Formatet för resurs-ID:t är /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources	string[]	Resurs-ID:t för källreservationen sammanfogas för att bilda den här reservationen. Formatet för resurs-ID:t är /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationOrderBillingPlanInformation

Objekt

Information som beskriver typen av faktureringsplan för den här reservationen.

Name	Typ	Description
nextPaymentDueDate	string (date)	För återkommande faktureringsplaner anger det datum då nästa betalning kommer att bearbetas. Null när summan betalas av.
pricingCurrencyTotal	Price	Belopp som ska betalas för beställningen. Skatt ingår inte.
startDate	string (date)	Datum då faktureringsplanen har startats.
transactions	PaymentDetail[]	Information om betalning relaterad till en reservationsbeställning.

ReservationOrderList

Objekt

Lista över ReservationOrders

Name	Typ	Description
nextLink	string	Url för att hämta nästa sida med reservationOrders.
value	ReservationOrderResponse[]	Information om en reservationsbeställning som returneras.

ReservationOrderResponse

Objekt

Information om en reservationsbeställning som returneras.

Name	Typ	Description
etag	integer (int32)
id	string	Identifierare för reservationen
name	string	Namn på reservationen
properties.benefitStartTime	string (date-time)	Det här är DateTime när reservationsförmånen startade.
properties.billingPlan	ReservationBillingPlan	Representera faktureringsplanerna.
properties.createdDateTime	string (date-time)	Det här är DateTime när reservationen skapades.
properties.displayName	string	Eget namn för användaren att enkelt identifiera reservationen.
properties.expiryDate	string (date)	Det här är det datum då reservationen upphör att gälla.
properties.expiryDateTime	string (date-time)	Det här är den tidpunkt då reservationen upphör att gälla.
properties.originalQuantity	integer (int32)	Totalt antal sku:er som köpts i reservationen.
properties.planInformation	ReservationOrderBillingPlanInformation	Information som beskriver typen av faktureringsplan för den här reservationen.
properties.provisioningState	ProvisioningState	Aktuellt tillstånd för reservationen.
properties.requestDateTime	string (date-time)	Det här är DateTime när reservationen ursprungligen begärdes för köp.
properties.reservations	ReservationResponse[]	Definitionen av reservationen.
properties.reviewDateTime	string (date-time)	Det här är den datum då Azure Hybrid-förmånen måste granskas.
properties.term	ReservationTerm	Representera reservationsperioden.
systemData	systemData	Metadata som rör skapande och senaste ändring av resursen.
type	string	Typ av resurs. "Microsoft.Capacity/reservations"

ReservationResponse

Objekt

Definitionen av reservationen.

Name	Typ	Description
etag	integer (int32)
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	Kind	Resursprovidertyp som ska reserveras.
location	string	Den Azure-region där den reserverade resursen finns.
name	string	Namnet på resursen
properties	ReservationsProperties	De egenskaper som är associerade med den här reservationen
sku	SkuName	SKU-informationen som är kopplad till den här reservationen
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

ReservationSplitProperties

Objekt

Egenskaper för reservationsdelning

Name	Typ	Description
splitDestinations	string[]	Lista över målresurs-ID som skapas på grund av delning. Formatet för resurs-ID:t är /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	Resurs-ID för reservationen som detta delas från. Formatet för resurs-ID:t är /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

Objekt

Egenskaperna för reservationerna

Name	Typ	Standardvärde	Description
appliedScopeProperties	AppliedScopeProperties		Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt. Krävs och måste ange tenantId och managementGroupId om AppliedScopeType är ManagementGroup
appliedScopeType	AppliedScopeType		Den tillämpade omfångstypen
appliedScopes	string[]		Listan över tillämpade omfång
archived	boolean		Anger om reservationen är arkiverad
benefitStartTime	string (date-time)		Det här är DateTime när reservationsförmånen startade.
billingPlan	ReservationBillingPlan		De alternativ för faktureringsplan som är tillgängliga för den här sku:n.
billingScopeId	string		Prenumeration som debiteras för köp av reservation eller sparplan
capabilities	string		Reservationens funktioner
displayName	string		Eget namn för användare för att enkelt identifiera reservationen
displayProvisioningState	string		Etableringstillståndet för reservationen för visning, t.ex. Lyckades
effectiveDateTime	string (date-time)		DateTime för reservationen som börjar när den här versionen gäller från.
expiryDate	string (date)		Det här är det datum då reservationen upphör att gälla.
expiryDateTime	string (date-time)		Det här är den tidpunkt då reservationen upphör att gälla.
extendedStatusInfo	ExtendedStatusInfo		Meddelandet med detaljerad information om statuskoden.
instanceFlexibility	InstanceFlexibility		Tillåter att reservationsrabatt tillämpas mellan sku:er i samma grupp för automatisk anpassning. Det är inte alla sku:er som har stöd för flexibel instansstorlek.
lastUpdatedDateTime	string (date-time)		DateTime för den senaste gången reservationen uppdaterades.
mergeProperties	ReservationMergeProperties		Egenskaper för reservationssammanslagning
provisioningState	ProvisioningState		Aktuellt tillstånd för reservationen.
provisioningSubState	string		Etableringens undertillstånd för reservationen, t.ex. Lyckades
purchaseDate	string (date)		Det här är datumet då reservationen köptes.
purchaseDateTime	string (date-time)		Det här är den tidpunkt då reservationen köptes.
quantity	integer (int32)		Antal sku:er som ingår i reservationen.
renew	boolean	False	Om du anger värdet true köps automatiskt en ny reservation på förfallodatumtiden.
renewDestination	string		Reservations-ID för reservationen som köps på grund av förnyelse. Formatet för resurs-ID:t är /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties	RenewPropertiesResponse		Förnyelseegenskaperna för en reservation.
renewSource	string		Reservations-ID för reservationen som reservationen förnyas från. Formatet för resurs-ID:t är /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType	ReservedResourceType		Typen av resurs som reserveras.
reviewDateTime	string (date-time)		Det här är den datum då Azure Hybrid-förmånen måste granskas.
skuDescription	string		Beskrivning av sku:n på engelska.
splitProperties	ReservationSplitProperties		Egenskaper för reservationsdelning
swapProperties	ReservationSwapProperties		Egenskaper för reservationsbyte
term	ReservationTerm		Representera reservationsperioden.
userFriendlyAppliedScopeType	string		Den tillämpade omfångstypen för reservationen för visning, t.ex. Delad
userFriendlyRenewState	string		Förnyelsetillståndet för reservationen för visning, t.ex. På
utilization	Utilization		Reservationsanvändning

ReservationStatusCode

Uppräkning

Värde	Description
Active
Expired
Merged
None
PaymentInstrumentError
Pending
Processing
PurchaseError
Split
Succeeded

ReservationSwapProperties

Objekt

Egenskaper för reservationsbyte

Name	Typ	Description
swapDestination	string	Reservationsresurs-ID som den ursprungliga resursen växlas till. Formatet för resurs-ID:t är /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	Resurs-ID för källreservationen som byts ut. Formatet för resurs-ID:t är /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Uppräkning

Representera reservationsperioden.

Värde	Description
P1Y
P3Y
P5Y

ReservationUtilizationAggregates

Objekt

Aggregerade värden för reservationsanvändning

Name	Typ	Description
grain	number	Kornet för aggregerade
grainUnit	string	Kornenheten för aggregerade
value	number	Aggregeringsvärdet
valueUnit	string	Den sammanställda värdeenheten

ReservedResourceProperties

Objekt

Egenskaper som är specifika för varje reserverad resurstyp. Krävs inte om det inte är tillämpligt.

Name	Typ	Description
instanceFlexibility	InstanceFlexibility	Om du aktiverar detta tillämpas reservationsrabatten på andra virtuella datorer i samma vm-storleksgrupp. Ange endast reserverad resurstyp för VirtualMachines.

ReservedResourceType

Uppräkning

Typen av resurs som reserveras.

Värde	Description
AVS
AppService
AzureDataExplorer
AzureFiles
BlockBlob
CosmosDb
DataFactory
Databricks
DedicatedHost
ManagedDisk
MariaDb
MySql
NetAppStorage
PostgreSql
RedHat
RedHatOsa
RedisCache
SapHana
SqlAzureHybridBenefit
SqlDataWarehouse
SqlDatabases
SqlEdge
SuseLinux
VMwareCloudSimple
VirtualMachineSoftware
VirtualMachines

SkuName

Objekt

Namnet på sku

Name	Typ	Description
name	string

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Utilization

Objekt

Reservationsanvändning

Name	Typ	Description
aggregates	ReservationUtilizationAggregates[]	Matrisen med aggregeringar av en reservations användning
trend	string	senaste 7 dagarnas användningstrend för en reservation