Reservation Order - Purchase

Service:

Reserved VM Instances

API Version:

2022-11-01

Belirtilen URI altında kaynak satın alın ReservationOrder ve oluşturun.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
reservationOrderId	path	True	string	Rezervasyonun Sipariş Kimliği
api-version	query	True	string	Desteklenen sürüm.

İstek Gövdesi

Name	Tür	Description
location	string	Ayrılmış kaynağın bulunduğu Azure bölgesi.
properties.appliedScopeProperties	AppliedScopeProperties	Uygulanan kapsam türüne özgü özellikler. Uygulanamazsa gerekli değildir. AppliedScopeType ManagementGroup ise gerekli ve tenantId ve managementGroupId sağlamaları gerekiyor
properties.appliedScopeType	AppliedScopeType	Uygulanan Kapsamın türü.
properties.appliedScopes	string[]	Avantajın uygulanacağı aboneliklerin listesi. AppliedScopeType öğesinin Paylaşılan olup olmadığını belirtmeyin. Bu özellik, Tek AppliedScopeType yerine appliedScopeProperties tarafından kullanım dışı bırakılacak ve değiştirilecektir.
properties.billingPlan	ReservationBillingPlan	Faturalama planlarını temsil edin.
properties.billingScopeId	string	Rezervasyon veya tasarruf planı satın almak için ücretlendirilecek abonelik
properties.displayName	string	Rezervasyonun kolay adı
properties.quantity	integer	Rezervasyonun parçası olan sku'ların miktarı.
properties.renew	boolean	Bunu true olarak ayarlamak, son kullanma tarihi saatinde otomatik olarak yeni bir rezervasyon satın alır.
properties.reservedResourceProperties	ReservedResourceProperties	Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir.
properties.reservedResourceType	ReservedResourceType	Ayrılan kaynağın türü.
properties.reviewDateTime	string	Bu, Azure hibrit avantajının gözden geçirilmesi gereken tarih saatidir.
properties.term	ReservationTerm	Rezervasyon terimini temsil edin.
sku	SkuName	Sku adı

Yanıtlar

Name	Tür	Description
200 OK	ReservationOrderResponse	Kaynak oluşturuldu
202 Accepted	ReservationOrderResponse	İstek kabul edilir ve işlenir. İşlem sonucu bağlantısı konum üst bilgisindedir. Headers Location: string Retry-After: integer
Other Status Codes	Error	Beklenmeyen hata

Örnekler

Purchase

Sample Request

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

Sample Response

Status code:

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

Status code:

202

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

Response Body

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

Tanımlar

Name	Description
AppliedScopeProperties	Uygulanan kapsam türüne özgü özellikler. Uygulanamazsa gerekli değildir. AppliedScopeType ManagementGroup ise gerekli ve tenantId ve managementGroupId sağlamaları gerekiyor
AppliedScopeType	Uygulanan Kapsamın türü.
BillingCurrencyTotal	Yenileme satın alma işlemi için müşterinin yerel para birimi cinsinden tahsil edilecek para birimi ve tutar. Vergi dahil değildir.
createdByType	Kaynağı oluşturan kimliğin türü.
Error	Hata bilgileri
ErrorResponseCode	Hizmetin gelen isteği işleyememe nedenini açıklayan hata kodu
ExtendedErrorInfo	Hata kodu ve hata iletisi de dahil olmak üzere genişletilmiş hata bilgileri
ExtendedStatusInfo
InstanceFlexibility	Bunu açmak, rezervasyon indirimini aynı VM boyut grubundaki diğer VM'lere uygular. Yalnızca VirtualMachines ayrılmış kaynak türü için belirtin.
Kind	Ayrılacak Kaynak Sağlayıcısı türü.
PaymentDetail	Rezervasyon siparişiyle ilgili ödemeyle ilgili bilgiler.
PaymentStatus	Ödemenin gelecekte tamamlandığını, başarısız olduğunu, iptal edilip edilmediğini veya zamanlandığını açıklar.
Price	Tutarı ve para birimi kodunu içeren fiyatlandırma bilgileri
PricingCurrencyTotal	Microsoft'un kayıt için kullandığı tutar. Para iadesi limitini hesaplamak için para iadesi sırasında kullanılır. Vergi dahil değildir. Bu, süresi dolmadan 30 gün önce kilitlenmiş fiyattır.
ProvisioningState	Rezervasyonun geçerli durumunu temsil edin.
PurchaseRequest	Rezervasyon satın alma isteği
RenewPropertiesResponse	Rezervasyonun yenileme özellikleri.
ReservationBillingPlan	Faturalama planlarını temsil edin.
ReservationMergeProperties	Rezervasyon birleştirme özellikleri
ReservationOrderBillingPlanInformation	Bu rezervasyon için faturalama planının türünü açıklayan bilgiler.
ReservationOrderResponse	İade edilen rezervasyon siparişinin ayrıntıları.
ReservationResponse	Rezervasyonun tanımı.
ReservationSplitProperties	Rezervasyon bölme özellikleri
ReservationsProperties	Rezervasyonların özellikleri
ReservationStatusCode
ReservationSwapProperties	Rezervasyon değiştirme özellikleri
ReservationTerm	Rezervasyon terimini temsil edin.
ReservationUtilizationAggregates	Rezervasyon kullanımının toplam değerleri
ReservedResourceProperties	Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir.
ReservedResourceType	Ayrılmış kaynağın türü.
SkuName	SKU'nun adı
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Utilization	Rezervasyon kullanımı

AppliedScopeProperties

Uygulanan kapsam türüne özgü özellikler. Uygulanamazsa gerekli değildir. AppliedScopeType ManagementGroup ise gerekli ve tenantId ve managementGroupId sağlamaları gerekiyor

Name	Tür	Description
displayName	string	Görünen ad
managementGroupId	string	Avantajın uygulanması gereken yönetim grubunun tam tanımlayıcısı.
resourceGroupId	string	Kaynak grubunun tam tanımlayıcısı.
subscriptionId	string	Aboneliğin tam tanımlayıcısı.
tenantId	string	Tasarruf planının avantajı uygulaması gereken Kiracı Kimliği.

AppliedScopeType

Uygulanan Kapsamın türü.

Name	Tür	Description
ManagementGroup	string
Shared	string
Single	string

BillingCurrencyTotal

Yenileme satın alma işlemi için müşterinin yerel para birimi cinsinden tahsil edilecek para birimi ve tutar. Vergi dahil değildir.

Name	Tür	Description
amount	number
currencyCode	string	Bu satın alma kaydı tarafından kullanılan para birimi için ISO 4217 3 harfli para birimi kodu.

createdByType

Kaynağı oluşturan kimliğin türü.

Name	Tür	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Error

Hata bilgileri

Name	Tür	Description
error	ExtendedErrorInfo	Hata kodu ve hata iletisi de dahil olmak üzere genişletilmiş hata bilgileri

ErrorResponseCode

Hizmetin gelen isteği işleyememe nedenini açıklayan hata kodu

Name	Tür	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

Hata kodu ve hata iletisi de dahil olmak üzere genişletilmiş hata bilgileri

Name	Tür	Description
code	ErrorResponseCode	Hizmetin gelen isteği işleyememe nedenini açıklayan hata kodu
message	string

ExtendedStatusInfo

Name	Tür	Description
message	string	Durum kodu hakkında ayrıntılı bilgi veren ileti.
statusCode	ReservationStatusCode

InstanceFlexibility

Bunu açmak, rezervasyon indirimini aynı VM boyut grubundaki diğer VM'lere uygular. Yalnızca VirtualMachines ayrılmış kaynak türü için belirtin.

Name	Tür	Description
Off	string
On	string

Kind

Ayrılacak Kaynak Sağlayıcısı türü.

Name	Tür	Description
Microsoft.Compute	string

PaymentDetail

Rezervasyon siparişiyle ilgili ödemeyle ilgili bilgiler.

Name	Tür	Description
billingAccount	string	Bu ödeme için ücretlendirilen Hesabı gösterir.
billingCurrencyTotal	Price	Faturalama para birimi cinsinden ücretlendirilen tutar. Vergi dahil değildir. Gelecekteki ödemeler için null
dueDate	string	Ödemenin yapılması gereken tarih.
extendedStatusInfo	ExtendedStatusInfo
paymentDate	string	İşlemin tamamlandığı tarih. Zamanlandığında null olur.
pricingCurrencyTotal	Price	Fiyatlandırma para birimi cinsinden tutar. Vergi dahil değildir.
status	PaymentStatus	Ödemenin gelecekte tamamlandığını, başarısız olduğunu, iptal edilip edilmediğini veya zamanlandığını açıklar.

PaymentStatus

Ödemenin gelecekte tamamlandığını, başarısız olduğunu, iptal edilip edilmediğini veya zamanlandığını açıklar.

Name	Tür	Description
Cancelled	string
Failed	string
Scheduled	string
Succeeded	string

Price

Tutarı ve para birimi kodunu içeren fiyatlandırma bilgileri

Name	Tür	Description
amount	number
currencyCode	string	Bu satın alma kaydı tarafından kullanılan para birimi için ISO 4217 3 harfli para birimi kodu.

PricingCurrencyTotal

Microsoft'un kayıt için kullandığı tutar. Para iadesi limitini hesaplamak için para iadesi sırasında kullanılır. Vergi dahil değildir. Bu, süresi dolmadan 30 gün önce kilitlenmiş fiyattır.

Name	Tür	Description
amount	number
currencyCode	string	Bu satın alma kaydı tarafından kullanılan para birimi için ISO 4217 3 harfli para birimi kodu.

ProvisioningState

Rezervasyonun geçerli durumunu temsil edin.

Name	Tür	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

Rezervasyon satın alma isteği

Name	Tür	Varsayılan değer	Description
location	string		Ayrılmış kaynağın bulunduğu Azure bölgesi.
properties.appliedScopeProperties	AppliedScopeProperties		Uygulanan kapsam türüne özgü özellikler. Uygulanamazsa gerekli değildir. AppliedScopeType ManagementGroup ise gerekli ve tenantId ve managementGroupId sağlamaları gerekiyor
properties.appliedScopeType	AppliedScopeType		Uygulanan Kapsamın türü.
properties.appliedScopes	string[]		Avantajın uygulanacağı aboneliklerin listesi. AppliedScopeType öğesinin Shared olup olmadığını belirtmeyin. Bu özellik, Single AppliedScopeType yerine appliedScopeProperties tarafından kullanım dışı bırakılacak ve değiştirilecektir.
properties.billingPlan	ReservationBillingPlan		Faturalama planlarını temsil edin.
properties.billingScopeId	string		Rezervasyon veya tasarruf planı satın almak için ücretlendirilecek abonelik
properties.displayName	string		Rezervasyonun kolay adı
properties.quantity	integer		Rezervasyonun parçası olan sku'ların miktarı.
properties.renew	boolean	False	Bunu true olarak ayarlamak, son kullanma tarihi saatinde otomatik olarak yeni bir rezervasyon satın alır.
properties.reservedResourceProperties	ReservedResourceProperties		Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir.
properties.reservedResourceType	ReservedResourceType		Ayrılmış kaynağın türü.
properties.reviewDateTime	string		Bu, Azure hibrit avantajının gözden geçirilmesi gereken tarih saatidir.
properties.term	ReservationTerm		Rezervasyon terimini temsil edin.
sku	SkuName		SKU'nun adı

RenewPropertiesResponse

Rezervasyonun yenileme özellikleri.

Name	Tür	Description
billingCurrencyTotal	BillingCurrencyTotal	Yenileme satın alma işlemi için müşterinin yerel para birimi cinsinden tahsil edilecek para birimi ve tutar. Vergi dahil değildir.
pricingCurrencyTotal	PricingCurrencyTotal	Microsoft'un kayıt için kullandığı tutar. Para iadesi limitini hesaplamak için para iadesi sırasında kullanılır. Vergi dahil değildir. Bu, süresi dolmadan 30 gün önce kilitlenmiş fiyattır.
purchaseProperties	PurchaseRequest	Rezervasyon satın alma isteği

ReservationBillingPlan

Faturalama planlarını temsil edin.

Name	Tür	Description
Monthly	string
Upfront	string

ReservationMergeProperties

Rezervasyon birleştirme özellikleri

Name	Tür	Description
mergeDestination	string	Ayırma kaynak kimliği Birleştirme nedeniyle oluşturuldu. Kaynak kimliğinin biçimi: /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources	string[]	Bu rezervasyonu oluşturmak için birleştirilen kaynak rezervasyonun kaynak kimlikleri. Kaynak kimliğinin biçimi: /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationOrderBillingPlanInformation

Bu rezervasyon için faturalama planının türünü açıklayan bilgiler.

Name	Tür	Description
nextPaymentDueDate	string	Yinelenen ödeme planları için, bir sonraki ödemenin işlendiği tarihi gösterir. Toplam ödendiğinde null.
pricingCurrencyTotal	Price	Sipariş için ödenecek para miktarı. Vergi dahil değildir.
startDate	string	Faturalama planının başladığı tarih.
transactions	PaymentDetail[]	Rezervasyon siparişiyle ilgili ödemeyle ilgili bilgiler.

ReservationOrderResponse

İade edilen rezervasyon siparişinin ayrıntıları.

Name	Tür	Description
etag	integer
id	string	Rezervasyonun tanımlayıcısı
name	string	Rezervasyonun adı
properties.benefitStartTime	string	Bu, rezervasyon avantajının başladığı Tarih Saat değeridir.
properties.billingPlan	ReservationBillingPlan	Faturalama planlarını temsil edin.
properties.createdDateTime	string	Bu, rezervasyonun oluşturulduğu Tarih Saat değeridir.
properties.displayName	string	Kullanıcının rezervasyonu kolayca tanımlaması için kolay ad.
properties.expiryDate	string	Bu, rezervasyonun süresinin dolacağı tarihtir.
properties.expiryDateTime	string	Bu, rezervasyonun süresinin dolacağı tarih-saattir.
properties.originalQuantity	integer	Rezervasyonda satın alınan sku'ların Toplam Miktarı.
properties.planInformation	ReservationOrderBillingPlanInformation	Bu rezervasyon için faturalama planının türünü açıklayan bilgiler.
properties.provisioningState	ProvisioningState	Rezervasyonun geçerli durumu.
properties.requestDateTime	string	Bu, rezervasyonun ilk satın alma için istenildiği Tarih Saat değeridir.
properties.reservations	ReservationResponse[]	Rezervasyonun tanımı.
properties.reviewDateTime	string	Bu, Azure Hibrit Avantajı gözden geçirilmesi gereken tarih-saattir.
properties.term	ReservationTerm	Rezervasyon terimini temsil edin.
systemData	systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
type	string	Kaynak türü. "Microsoft.Capacity/reservations"

ReservationResponse

Rezervasyonun tanımı.

Name	Tür	Description
etag	integer
id	string	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	Kind	Ayrılacak Kaynak Sağlayıcısı türü.
location	string	Ayrılmış kaynağın bulunduğu Azure bölgesi.
name	string	Kaynağın adı
properties	ReservationsProperties	Bu rezervasyonla ilişkili özellikler
sku	SkuName	Bu rezervasyonla ilişkili sku bilgileri
systemData	systemData	Azure Resource Manager createdBy ve modifiedBy bilgilerini içeren meta veriler.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

ReservationSplitProperties

Rezervasyon bölme özellikleri

Name	Tür	Description
splitDestinations	string[]	Bölme nedeniyle oluşturulan hedef kaynak kimliğinin listesi. Kaynak kimliğinin biçimi: /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource	string	Bunun bölündüğü rezervasyonun kaynak kimliği. Kaynak kimliğinin biçimi: /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

Rezervasyonların özellikleri

Name	Tür	Varsayılan değer	Description
appliedScopeProperties	AppliedScopeProperties		Uygulanan kapsam türüne özgü özellikler. Uygulanamazsa gerekli değildir. Gerekli ve AppliedScopeType ManagementGroup ise tenantId ve managementGroupId sağlamanız gerekir
appliedScopeType	AppliedScopeType		Uygulanan kapsam türü
appliedScopes	string[]		Uygulanan kapsamların listesi
archived	boolean		Rezervasyonun arşivlenip arşivlenmediğini gösterir
benefitStartTime	string		Bu, rezervasyon avantajının başladığı TarihSaat'tir.
billingPlan	ReservationBillingPlan		Bu sku için kullanılabilir faturalama planı seçenekleri.
billingScopeId	string		Rezervasyon veya tasarruf planı satın almak için ücretlendirilecek abonelik
capabilities	string		Rezervasyonun özellikleri
displayName	string		Kullanıcının rezervasyonu kolayca tanımlaması için kolay ad
displayProvisioningState	string		Görüntüleme için rezervasyonun sağlama durumu, örneğin Başarılı
effectiveDateTime	string		Bu sürüm geçerli olduğunda başlayan rezervasyonun DateTime değeri.
expiryDate	string		Bu, rezervasyonun süresinin dolacağı tarihtir.
expiryDateTime	string		Bu, rezervasyonun süresinin dolacağı tarih-saattir.
extendedStatusInfo	ExtendedStatusInfo		Durum kodu hakkında ayrıntılı bilgi veren ileti.
instanceFlexibility	InstanceFlexibility		Rezervasyon indiriminin aynı otomatik sığdırma grubu içindeki sku'lara uygulanmasına izin verir. Tüm sku'lar örnek boyutu esnekliğini desteklemez.
lastUpdatedDateTime	string		Rezervasyonun son güncelleştirilişinin DateTime değeri.
mergeProperties	ReservationMergeProperties		Rezervasyon birleştirme özellikleri
provisioningState	ProvisioningState		Rezervasyonun geçerli durumu.
provisioningSubState	string		Rezervasyonun sağlama alt durumu, örneğin Başarılı
purchaseDate	string		Bu, rezervasyonun satın alındığı tarihtir.
purchaseDateTime	string		Bu, rezervasyonun satın alındığı tarih-saattir.
quantity	integer		Rezervasyonun parçası olan sku'ların miktarı.
renew	boolean	False	Bunu true olarak ayarlamak, son kullanma tarihi saatinde otomatik olarak yeni bir rezervasyon satın alır.
renewDestination	string		Yenileme nedeniyle satın alınan rezervasyonun rezervasyon kimliği. Kaynak kimliğinin biçimi : /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties	RenewPropertiesResponse		Rezervasyonun yenileme özellikleri.
renewSource	string		Bu rezervasyonun yenilendiği rezervasyonun rezervasyon kimliği. Kaynak kimliğinin biçimi : /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType	ReservedResourceType		Ayrılan kaynağın türü.
reviewDateTime	string		Bu, Azure Hibrit Avantajı gözden geçirilmesi gereken tarih-saattir.
skuDescription	string		İngilizce sku açıklaması.
splitProperties	ReservationSplitProperties		Rezervasyon bölme özellikleri
swapProperties	ReservationSwapProperties		Rezervasyon değiştirme özellikleri
term	ReservationTerm		Rezervasyon terimini temsil edin.
userFriendlyAppliedScopeType	string		Görüntüleme için rezervasyonun uygulanan kapsam türü, örneğin Paylaşılan
userFriendlyRenewState	string		Görüntüleme için rezervasyonun yenileme durumu, örneğin Açık
utilization	Utilization		Rezervasyon kullanımı

ReservationStatusCode

Name	Tür	Description
Active	string
Expired	string
Merged	string
None	string
PaymentInstrumentError	string
Pending	string
Processing	string
PurchaseError	string
Split	string
Succeeded	string

ReservationSwapProperties

Rezervasyon değiştirme özellikleri

Name	Tür	Description
swapDestination	string	Özgün kaynağın değiştirildiğini rezervasyon kaynak kimliği. Kaynak kimliğinin biçimi: /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource	string	Değiştirilen kaynak rezervasyonun kaynak kimliği. Kaynak kimliğinin biçimi: /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Rezervasyon terimini temsil edin.

Name	Tür	Description
P1Y	string
P3Y	string
P5Y	string

ReservationUtilizationAggregates

Rezervasyon kullanımının toplam değerleri

Name	Tür	Description
grain	number	Toplamanın dilimi
grainUnit	string	Toplamanın tane birimi
value	number	Toplama değeri
valueUnit	string	Toplama değeri birimi

ReservedResourceProperties

Her ayrılmış kaynak türüne özgü özellikler. Uygulanamazsa gerekli değildir.

Name	Tür	Description
instanceFlexibility	InstanceFlexibility	Bunu açmak, rezervasyon indirimini aynı VM boyut grubundaki diğer VM'lere uygular. Yalnızca VirtualMachines ayrılmış kaynak türü için belirtin.

ReservedResourceType

Ayrılmış kaynağın türü.

Name	Tür	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

SKU'nun adı

Name	Tür	Description
name	string

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimliğin türü.

Utilization

Rezervasyon kullanımı

Name	Tür	Description
aggregates	ReservationUtilizationAggregates[]	Rezervasyonun kullanımının toplam dizisi
trend	string	rezervasyon için son 7 günlük kullanım eğilimi