Reservation Order - Purchase

Usługa:

Reserved VM Instances

Wersja interfejsu API:

2022-11-01

Kup ReservationOrder i utwórz zasób w ramach określonego identyfikatora URI.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
reservationOrderId	path	True	string	Identyfikator zamówienia rezerwacji
api-version	query	True	string	Obsługiwana wersja.

Treść żądania

Nazwa	Typ	Opis
location	string	Region świadczenia usługi Azure, w którym znajduje się zasób zarezerwowany.
properties.appliedScopeProperties	AppliedScopeProperties	Właściwości specyficzne dla zastosowanego typu zakresu. Nie jest wymagane, jeśli nie ma zastosowania. Wymagane i należy podać identyfikator tenantId i managementGroupId, jeśli AppliedScopeType jest ManagementGroup
properties.appliedScopeType	AppliedScopeType	Typ zastosowanego zakresu.
properties.appliedScopes	string[]	Lista subskrypcji, dla których zostanie zastosowana korzyść. Nie należy określać, czy parametr AppliedScopeType jest udostępniony. Ta właściwość będzie przestarzała i zastąpiona przez appliedScopeProperties zamiast elementu Single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan	Przedstawianie planów rozliczeniowych.
properties.billingScopeId	string	Subskrypcja, która zostanie obciążona opłatą za zakup rezerwacji lub planu oszczędnościowego
properties.displayName	string	Przyjazna nazwa rezerwacji
properties.quantity	integer	Ilość jednostek SKU, które są częścią rezerwacji.
properties.renew	boolean	Ustawienie wartości true spowoduje automatyczne zakup nowej rezerwacji w dniu wygaśnięcia.
properties.reservedResourceProperties	ReservedResourceProperties	Właściwości specyficzne dla każdego typu zasobu zarezerwowanego. Nie jest wymagane, jeśli nie ma zastosowania.
properties.reservedResourceType	ReservedResourceType	Typ zasobu, który jest zarezerwowany.
properties.reviewDateTime	string	Jest to data i godzina przeglądu korzyści użycia hybrydowego platformy Azure.
properties.term	ReservationTerm	Reprezentuje okres rezerwacji.
sku	SkuName	Nazwa jednostki SKU

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ReservationOrderResponse	Zasób został utworzony
202 Accepted	ReservationOrderResponse	Żądanie jest akceptowane i przetwarzane. Link wyniku operacji znajduje się w nagłówku lokalizacji. Nagłówki Location: string Retry-After: integer
Other Status Codes	Error	Nieoczekiwany błąd

Przykłady

Purchase

Przykładowe żądanie

HTTP

PUT https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/a075419f-44cc-497f-b68a-14ee811d48b9?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"
    },
    "renew": false
  }
}

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 Purchase. */
public final class Main {
    /*
     * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/PurchaseReservationOrder.json
     */
    /**
     * Sample code: Purchase.
     *
     * @param manager Entry point to ReservationsManager.
     */
    public static void purchase(com.azure.resourcemanager.reservations.ReservationsManager manager) {
        manager
            .reservationOrders()
            .purchase(
                "a075419f-44cc-497f-b68a-14ee811d48b9",
                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)
                    .withRenew(false)
                    .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 purchase_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.begin_purchase(
        reservation_order_id="a075419f-44cc-497f-b68a-14ee811d48b9",
        body={
            "location": "westus",
            "properties": {
                "appliedScopeType": "Shared",
                "appliedScopes": None,
                "billingPlan": "Monthly",
                "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
                "displayName": "TestReservationOrder",
                "quantity": 1,
                "renew": False,
                "reservedResourceProperties": {"instanceFlexibility": "On"},
                "reservedResourceType": "VirtualMachines",
                "term": "P1Y",
            },
            "sku": {"name": "standard_D1"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/PurchaseReservationOrder.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/PurchaseReservationOrder.json
func ExampleReservationOrderClient_BeginPurchase() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armreservations.NewClientFactory(cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewReservationOrderClient().BeginPurchase(ctx, "a075419f-44cc-497f-b68a-14ee811d48b9", 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),
			Renew:            to.Ptr(false),
			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)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ReservationOrderResponse = armreservations.ReservationOrderResponse{
	// 	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{
	// 		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 Purchase `ReservationOrder` and create resource under the specified URI.
 *
 * @summary Purchase `ReservationOrder` and create resource under the specified URI.
 * x-ms-original-file: specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/PurchaseReservationOrder.json
 */
async function purchase() {
  const reservationOrderId = "a075419f-44cc-497f-b68a-14ee811d48b9";
  const body = {
    appliedScopeType: "Shared",
    appliedScopes: [],
    billingPlan: "Monthly",
    billingScopeId: "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
    displayName: "TestReservationOrder",
    location: "westus",
    quantity: 1,
    renew: false,
    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.beginPurchaseAndWait(reservationOrderId, body);
  console.log(result);
}

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

dotnet

using System;
using System.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/PurchaseReservationOrder.json
// this example is just showing the usage of "ReservationOrder_Purchase" 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
Guid reservationOrderId = Guid.Parse("a075419f-44cc-497f-b68a-14ee811d48b9");
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 =
    {
    },
    IsRenewEnabled = false,
    ReservedResourceInstanceFlexibility = InstanceFlexibility.On,
};
ArmOperation<ReservationOrderResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, reservationOrderId, content);
ReservationOrderResource result = lro.Value;

// the variable result 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 = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Przykładowa odpowiedź

Kod stanu:

200

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

Kod stanu:

202

Location: https://management.azure.com/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa?api-version=2022-11-01
Retry-After: 120

{
  "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",
    "billingPlan": "Monthly",
    "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",
    "provisioningState": "Succeeded",
    "reservations": [
      {
        "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
      }
    ],
    "originalQuantity": 7
  }
}

Definicje

Nazwa	Opis
AppliedScopeProperties	Właściwości specyficzne dla zastosowanego typu zakresu. Nie jest wymagane, jeśli nie ma zastosowania. Wymagane i należy podać identyfikator tenantId i managementGroupId, jeśli AppliedScopeType jest ManagementGroup
AppliedScopeType	Typ zastosowanego zakresu.
BillingCurrencyTotal	Waluta i kwota, jaką klient będzie pobierał w lokalnej walucie klienta w celu zakupu odnowienia. Podatek nie jest uwzględniany.
createdByType	Typ tożsamości, która utworzyła zasób.
Error	Informacje o błędzie
ErrorResponseCode	Kod błędu opisujący przyczynę, dla którego usługa nie może przetworzyć żądania przychodzącego
ExtendedErrorInfo	Rozszerzone informacje o błędzie, w tym kod błędu i komunikat o błędzie
ExtendedStatusInfo
InstanceFlexibility	Włączenie tej opcji spowoduje zastosowanie rabatu za rezerwację do innych maszyn wirtualnych w tej samej grupie rozmiarów maszyn wirtualnych. Określ tylko typ zasobu zarezerwowanego virtualmachines.
Kind	Typ dostawcy zasobów, który ma być zarezerwowany.
PaymentDetail	Informacje o płatności związane z zamówieniem rezerwacji.
PaymentStatus	Opisuje, czy płatność została ukończona, zakończona niepowodzeniem, anulowana lub zaplanowana w przyszłości.
Price	Informacje o cenach zawierające kwotę i kod waluty
PricingCurrencyTotal	Kwota używana przez firmę Microsoft dla rekordu. Używany podczas obliczania limitu zwrotu kosztów. Podatek nie jest uwzględniany. Jest to zablokowana cena 30 dni przed wygaśnięciem.
ProvisioningState	Reprezentuje bieżący stan rezerwacji.
PurchaseRequest	Żądanie zakupu rezerwacji
RenewPropertiesResponse	Właściwości odnawiania rezerwacji.
ReservationBillingPlan	Przedstawianie planów rozliczeniowych.
ReservationMergeProperties	Właściwości scalania rezerwacji
ReservationOrderBillingPlanInformation	Informacje opisujące typ planu rozliczeniowego dla tej rezerwacji.
ReservationOrderResponse	Szczegóły zwracanego zamówienia rezerwacji.
ReservationResponse	Definicja rezerwacji.
ReservationSplitProperties	Właściwości podziału rezerwacji
ReservationsProperties	Właściwości rezerwacji
ReservationStatusCode
ReservationSwapProperties	Właściwości zamiany rezerwacji
ReservationTerm	Reprezentuje okres rezerwacji.
ReservationUtilizationAggregates	Zagregowane wartości wykorzystania rezerwacji
ReservedResourceProperties	Właściwości specyficzne dla każdego typu zasobu zarezerwowanego. Nie jest wymagane, jeśli nie ma zastosowania.
ReservedResourceType	Typ zasobu, który jest zarezerwowany.
SkuName	Nazwa jednostki SKU
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Utilization	Wykorzystanie rezerwacji

AppliedScopeProperties

Właściwości specyficzne dla zastosowanego typu zakresu. Nie jest wymagane, jeśli nie ma zastosowania. Wymagane i należy podać identyfikator tenantId i managementGroupId, jeśli AppliedScopeType jest ManagementGroup

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana
managementGroupId	string	W pełni kwalifikowany identyfikator grupy zarządzania, w której należy zastosować korzyść.
resourceGroupId	string	W pełni kwalifikowany identyfikator grupy zasobów.
subscriptionId	string	W pełni kwalifikowany identyfikator subskrypcji.
tenantId	string	Identyfikator dzierżawy, w którym plan oszczędności powinien stosować korzyść.

AppliedScopeType

Typ zastosowanego zakresu.

Nazwa	Typ	Opis
ManagementGroup	string
Shared	string
Single	string

BillingCurrencyTotal

Waluta i kwota, jaką klient będzie pobierał w lokalnej walucie klienta w celu zakupu odnowienia. Podatek nie jest uwzględniany.

Nazwa	Typ	Opis
amount	number
currencyCode	string	Kod waluty ISO 4217 3-literowy dla waluty używanej przez ten rekord zakupu.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

Error

Informacje o błędzie

Nazwa	Typ	Opis
error	ExtendedErrorInfo	Rozszerzone informacje o błędzie, w tym kod błędu i komunikat o błędzie

ErrorResponseCode

Kod błędu opisujący przyczynę, dla którego usługa nie może przetworzyć żądania przychodzącego

Nazwa	Typ	Opis
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

Rozszerzone informacje o błędzie, w tym kod błędu i komunikat o błędzie

Nazwa	Typ	Opis
code	ErrorResponseCode	Kod błędu opisujący przyczynę, dla którego usługa nie może przetworzyć żądania przychodzącego
message	string

ExtendedStatusInfo

Nazwa	Typ	Opis
message	string	Komunikat zawierający szczegółowe informacje o kodzie stanu.
statusCode	ReservationStatusCode

InstanceFlexibility

Włączenie tej opcji spowoduje zastosowanie rabatu za rezerwację do innych maszyn wirtualnych w tej samej grupie rozmiarów maszyn wirtualnych. Określ tylko typ zasobu zarezerwowanego virtualmachines.

Nazwa	Typ	Opis
Off	string
On	string

Kind

Typ dostawcy zasobów, który ma być zarezerwowany.

Nazwa	Typ	Opis
Microsoft.Compute	string

PaymentDetail

Informacje o płatności związane z zamówieniem rezerwacji.

Nazwa	Typ	Opis
billingAccount	string	Pokazuje konto, które jest naliczane za tę płatność.
billingCurrencyTotal	Price	Kwota naliczona w walucie rozliczeniowej. Nieuwzględnianie podatku. Ma wartość null dla przyszłych płatności
dueDate	string	Data wykonania płatności.
extendedStatusInfo	ExtendedStatusInfo
paymentDate	string	Data zakończenia transakcji. Wartość null jest równa null, gdy jest zaplanowana.
pricingCurrencyTotal	Price	Kwota w walucie cenowej. Nieuwzględnianie podatku.
status	PaymentStatus	Opisuje, czy płatność została ukończona, zakończona niepowodzeniem, anulowana lub zaplanowana w przyszłości.

PaymentStatus

Opisuje, czy płatność została ukończona, zakończona niepowodzeniem, anulowana lub zaplanowana w przyszłości.

Nazwa	Typ	Opis
Cancelled	string
Failed	string
Scheduled	string
Succeeded	string

Price

Informacje o cenach zawierające kwotę i kod waluty

Nazwa	Typ	Opis
amount	number
currencyCode	string	Kod waluty ISO 4217 3-literowy dla waluty używanej przez ten rekord zakupu.

PricingCurrencyTotal

Kwota używana przez firmę Microsoft dla rekordu. Używany podczas obliczania limitu zwrotu kosztów. Podatek nie jest uwzględniany. Jest to zablokowana cena 30 dni przed wygaśnięciem.

Nazwa	Typ	Opis
amount	number
currencyCode	string	Kod waluty ISO 4217 3-literowy dla waluty używanej przez ten rekord zakupu.

ProvisioningState

Reprezentuje bieżący stan rezerwacji.

Nazwa	Typ	Opis
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

Żądanie zakupu rezerwacji

Nazwa	Typ	Domyślna wartość	Opis
location	string		Region świadczenia usługi Azure, w którym znajduje się zasób zarezerwowany.
properties.appliedScopeProperties	AppliedScopeProperties		Właściwości specyficzne dla zastosowanego typu zakresu. Nie jest wymagane, jeśli nie ma zastosowania. Wymagane i należy podać identyfikator tenantId i managementGroupId, jeśli AppliedScopeType jest ManagementGroup
properties.appliedScopeType	AppliedScopeType		Typ zastosowanego zakresu.
properties.appliedScopes	string[]		Lista subskrypcji, dla których zostanie zastosowana korzyść. Nie należy określać, czy parametr AppliedScopeType jest udostępniony. Ta właściwość będzie przestarzała i zastąpiona przez appliedScopeProperties zamiast elementu Single AppliedScopeType.
properties.billingPlan	ReservationBillingPlan		Przedstawianie planów rozliczeniowych.
properties.billingScopeId	string		Subskrypcja, która zostanie obciążona opłatą za zakup rezerwacji lub planu oszczędnościowego
properties.displayName	string		Przyjazna nazwa rezerwacji
properties.quantity	integer		Ilość jednostek SKU, które są częścią rezerwacji.
properties.renew	boolean	False	Ustawienie wartości true spowoduje automatyczne zakup nowej rezerwacji w dniu wygaśnięcia.
properties.reservedResourceProperties	ReservedResourceProperties		Właściwości specyficzne dla każdego typu zasobu zarezerwowanego. Nie jest wymagane, jeśli nie ma zastosowania.
properties.reservedResourceType	ReservedResourceType		Typ zasobu, który jest zarezerwowany.
properties.reviewDateTime	string		Jest to data i godzina przeglądu korzyści użycia hybrydowego platformy Azure.
properties.term	ReservationTerm		Reprezentuje okres rezerwacji.
sku	SkuName		Nazwa jednostki SKU

RenewPropertiesResponse

Właściwości odnawiania rezerwacji.

Nazwa	Typ	Opis
billingCurrencyTotal	BillingCurrencyTotal	Waluta i kwota, jaką klient będzie pobierał w lokalnej walucie klienta w celu zakupu odnowienia. Podatek nie jest uwzględniany.
pricingCurrencyTotal	PricingCurrencyTotal	Kwota używana przez firmę Microsoft dla rekordu. Używany podczas obliczania limitu zwrotu kosztów. Podatek nie jest uwzględniany. Jest to zablokowana cena 30 dni przed wygaśnięciem.
purchaseProperties	PurchaseRequest	Żądanie zakupu rezerwacji

ReservationBillingPlan

Przedstawianie planów rozliczeniowych.

Nazwa	Typ	Opis
Monthly	string
Upfront	string

ReservationMergeProperties

Właściwości scalania rezerwacji

Nazwa	Typ	Opis
mergeDestination	string	Identyfikator zasobu rezerwacji Utworzony z powodu scalania. Format identyfikatora zasobu to /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources	string[]	Identyfikatory zasobów scalonej rezerwacji źródłowej w celu utworzenia tej rezerwacji. Format identyfikatora zasobu to /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationOrderBillingPlanInformation

Informacje opisujące typ planu rozliczeniowego dla tej rezerwacji.

Nazwa	Typ	Opis
nextPaymentDueDate	string	W przypadku cyklicznych planów rozliczeniowych wskazuje datę przetworzenia następnej płatności. Wartość null, gdy suma jest wypłacana.
pricingCurrencyTotal	Price	Kwota pieniędzy do zapłaty za zamówienie. Podatek nie jest uwzględniany.
startDate	string	Data rozpoczęcia planu rozliczeniowego.
transactions	PaymentDetail[]	Informacje o płatności związane z zamówieniem rezerwacji.

ReservationOrderResponse

Szczegóły zwracanego zamówienia rezerwacji.

Nazwa	Typ	Opis
etag	integer
id	string	Identyfikator rezerwacji
name	string	Nazwa rezerwacji
properties.benefitStartTime	string	Jest to data/godzina rozpoczęcia świadczenia rezerwacji.
properties.billingPlan	ReservationBillingPlan	Przedstawianie planów rozliczeniowych.
properties.createdDateTime	string	Jest to data/godzina utworzenia rezerwacji.
properties.displayName	string	Przyjazna nazwa użytkownika do łatwego zidentyfikowania rezerwacji.
properties.expiryDate	string	Jest to data wygaśnięcia rezerwacji.
properties.expiryDateTime	string	Jest to data i godzina wygaśnięcia rezerwacji.
properties.originalQuantity	integer	Łączna ilość jednostek SKU zakupionych w rezerwacji.
properties.planInformation	ReservationOrderBillingPlanInformation	Informacje opisujące typ planu rozliczeniowego dla tej rezerwacji.
properties.provisioningState	ProvisioningState	Bieżący stan rezerwacji.
properties.requestDateTime	string	Jest to data/godzina, gdy rezerwacja została początkowo zażądana w celu zakupu.
properties.reservations	ReservationResponse[]	Definicja rezerwacji.
properties.reviewDateTime	string	Jest to data i godzina przeglądu Korzyść użycia hybrydowego platformy Azure.
properties.term	ReservationTerm	Reprezentuje okres rezerwacji.
systemData	systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
type	string	Typ zasobu. "Microsoft.Capacity/reservations"

ReservationResponse

Definicja rezerwacji.

Nazwa	Typ	Opis
etag	integer
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	Kind	Typ dostawcy zasobów, który ma być zarezerwowany.
location	string	Region świadczenia usługi Azure, w którym znajduje się zasób zarezerwowany.
name	string	Nazwa zasobu
properties	ReservationsProperties	Właściwości skojarzone z tą rezerwacją
sku	SkuName	Informacje o jednostce SKU skojarzone z tą rezerwacją
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ReservationSplitProperties

Właściwości podziału rezerwacji

Nazwa	Typ	Opis
splitDestinations	string[]	Lista identyfikatorów zasobów docelowych, które zostały utworzone z powodu podziału. Format identyfikatora zasobu to /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	Identyfikator zasobu rezerwacji, z której jest on podzielony. Format identyfikatora zasobu to /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

Właściwości rezerwacji

Nazwa	Typ	Domyślna wartość	Opis
appliedScopeProperties	AppliedScopeProperties		Właściwości specyficzne dla zastosowanego typu zakresu. Nie jest wymagane, jeśli nie ma zastosowania. Wymagane i należy podać identyfikator tenantId i managementGroupId, jeśli AppliedScopeType jest ManagementGroup
appliedScopeType	AppliedScopeType		Zastosowany typ zakresu
appliedScopes	string[]		Lista zastosowanych zakresów
archived	boolean		Wskazuje, czy rezerwacja jest zarchiwizowana
benefitStartTime	string		Jest to data/godzina rozpoczęcia świadczenia rezerwacji.
billingPlan	ReservationBillingPlan		Opcje planu rozliczeniowego dostępne dla tej jednostki SKU.
billingScopeId	string		Subskrypcja, która zostanie obciążona opłatą za zakup rezerwacji lub planu oszczędnościowego
capabilities	string		Możliwości rezerwacji
displayName	string		Przyjazna nazwa użytkownika do łatwego identyfikowania rezerwacji
displayProvisioningState	string		Stan aprowizacji rezerwacji na potrzeby wyświetlania, np. Powodzenie
effectiveDateTime	string		Data/godzina rezerwacji rozpoczynająca się od momentu wejścia w życie tej wersji.
expiryDate	string		Jest to data wygaśnięcia rezerwacji.
expiryDateTime	string		Jest to data i godzina wygaśnięcia rezerwacji.
extendedStatusInfo	ExtendedStatusInfo		Komunikat zawierający szczegółowe informacje o kodzie stanu.
instanceFlexibility	InstanceFlexibility		Umożliwia stosowanie rabatu za rezerwację między jednostkami SKU w ramach tej samej grupy autodopasowania. Nie wszystkie jednostki SKU obsługują elastyczność rozmiaru wystąpienia.
lastUpdatedDateTime	string		Data/godzina ostatniej aktualizacji rezerwacji.
mergeProperties	ReservationMergeProperties		Właściwości scalania rezerwacji
provisioningState	ProvisioningState		Bieżący stan rezerwacji.
provisioningSubState	string		Stan podrzędny aprowizacji rezerwacji, np. Powodzenie
purchaseDate	string		Jest to data zakupu rezerwacji.
purchaseDateTime	string		Jest to data zakupu rezerwacji.
quantity	integer		Ilość jednostek SKU, które są częścią rezerwacji.
renew	boolean	False	Ustawienie wartości true spowoduje automatyczne zakup nowej rezerwacji w dniu wygaśnięcia.
renewDestination	string		Identyfikator rezerwacji rezerwacji zakupionej z powodu odnowienia. Format identyfikatora zasobu to /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties	RenewPropertiesResponse		Właściwości odnawiania rezerwacji.
renewSource	string		Identyfikator rezerwacji, z której ta rezerwacja jest odnawiana. Format identyfikatora zasobu to /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType	ReservedResourceType		Typ zasobu, który jest zarezerwowany.
reviewDateTime	string		Jest to data i godzina przeglądu Korzyść użycia hybrydowego platformy Azure.
skuDescription	string		Opis jednostki SKU w języku angielskim.
splitProperties	ReservationSplitProperties		Właściwości podziału rezerwacji
swapProperties	ReservationSwapProperties		Właściwości zamiany rezerwacji
term	ReservationTerm		Reprezentuje okres rezerwacji.
userFriendlyAppliedScopeType	string		Zastosowany typ zakresu rezerwacji do wyświetlenia, np. Udostępniony
userFriendlyRenewState	string		Stan odnowienia rezerwacji na potrzeby wyświetlania, np. Wł.
utilization	Utilization		Wykorzystanie rezerwacji

ReservationStatusCode

Nazwa	Typ	Opis
Active	string
Expired	string
Merged	string
None	string
PaymentInstrumentError	string
Pending	string
Processing	string
PurchaseError	string
Split	string
Succeeded	string

ReservationSwapProperties

Właściwości zamiany rezerwacji

Nazwa	Typ	Opis
swapDestination	string	Identyfikator zasobu rezerwacji, do którego zostaje zamieniony oryginalny zasób. Format identyfikatora zasobu to /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	Identyfikator zasobu źródłowej rezerwacji, która zostaje zamieniona. Format identyfikatora zasobu to /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Reprezentuje okres rezerwacji.

Nazwa	Typ	Opis
P1Y	string
P3Y	string
P5Y	string

ReservationUtilizationAggregates

Zagregowane wartości wykorzystania rezerwacji

Nazwa	Typ	Opis
grain	number	Ziarno agregacji
grainUnit	string	Jednostka ziarna agregacji
value	number	Wartość agregacji
valueUnit	string	Jednostka wartości zagregowanej

ReservedResourceProperties

Właściwości specyficzne dla każdego typu zasobu zarezerwowanego. Nie jest wymagane, jeśli nie ma zastosowania.

Nazwa	Typ	Opis
instanceFlexibility	InstanceFlexibility	Włączenie tej opcji spowoduje zastosowanie rabatu za rezerwację do innych maszyn wirtualnych w tej samej grupie rozmiarów maszyn wirtualnych. Określ tylko typ zasobu zarezerwowanego virtualmachines.

ReservedResourceType

Typ zasobu, który jest zarezerwowany.

Nazwa	Typ	Opis
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

Nazwa jednostki SKU

Nazwa	Typ	Opis
name	string

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Utilization

Wykorzystanie rezerwacji

Nazwa	Typ	Opis
aggregates	ReservationUtilizationAggregates[]	Tablica agregacji wykorzystania rezerwacji
trend	string	trend wykorzystania rezerwacji z ostatnich 7 dni