Sdílet prostřednictvím


Reservation - Update

Aktualizace .Reservation
Aktualizace použitých oborů Reservation.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
reservationId
path True

string

ID položky rezervace

reservationOrderId
path True

string

ID objednávky rezervace

api-version
query True

string

Podporovaná verze.

Text požadavku

Name Typ Description
properties.appliedScopeProperties

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.

properties.appliedScopeType

AppliedScopeType

Typ použitého oboru.

properties.appliedScopes

string[]

Seznam předplatných, na která se výhoda použije. Nezadávejte, jestli je AppliedScopeType shared. Tato vlastnost bude vyřazena a nahrazena appliedScopeProperties místo pro Single AppliedScopeType.

properties.instanceFlexibility

InstanceFlexibility

Zapnutím této možnosti se sleva za rezervaci uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Pro VirtualMachines zadejte pouze rezervovaný typ prostředku.

properties.name

string

Zobrazovaný název rezervace

properties.renew

boolean

Pokud tuto hodnotu nastavíte na true, automaticky se k datu vypršení platnosti zakoupí nová rezervace.

properties.renewProperties

RenewProperties

properties.reviewDateTime

string

Jedná se o datum a čas, kdy je potřeba zkontrolovat Zvýhodněné hybridní využití Azure.

Odpovědi

Name Typ Description
200 OK

ReservationResponse

Vrátí aktualizovanou Reservationhodnotu .

202 Accepted

Žádost se přijme a zpracovává se.

Hlavičky

  • Azure-AsyncOperation: string
  • Location: string
  • Retry-After: integer
Other Status Codes

Error

Neočekávaná chyba

Příklady

PatchReservation

Ukázkový požadavek

PATCH https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc?api-version=2022-11-01

{
  "properties": {
    "appliedScopeType": "Shared",
    "instanceFlexibility": "Off"
  }
}

Ukázková odpověď

{
  "sku": {
    "name": "Standard_DS1_v2"
  },
  "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc",
  "type": "Microsoft.Capacity/reservationOrders/reservations",
  "name": "6ef59113-3482-40da-8d79-787f823e34bc",
  "etag": 4,
  "location": "eastus",
  "properties": {
    "appliedScopeType": "Shared",
    "renew": false,
    "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
    "quantity": 3,
    "provisioningState": "Succeeded",
    "expiryDate": "2018-09-22",
    "expiryDateTime": "2018-09-22T23:57:48.1891638Z",
    "displayName": "cabri_test",
    "billingPlan": "Monthly",
    "effectiveDateTime": "2017-09-22T23:57:48.1891638Z",
    "lastUpdatedDateTime": "2017-09-22T23:57:54.3768768Z",
    "reservedResourceType": "VirtualMachines",
    "instanceFlexibility": "Off",
    "skuDescription": "D1 v2",
    "mergeProperties": {
      "mergeSources": [
        "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
        "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
      ]
    }
  }
}
Azure-AsyncOperation: https://management.azure.com/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc?api-version=2022-11-01
Location: https://management.azure.com/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc?api-version=2022-11-01
Retry-After: 120

Definice

Name Description
AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.

AppliedScopeType

Typ použitého oboru.

BillingCurrencyTotal

Měna a částka, které budou zákazníkovi účtovány v místní měně zákazníka při nákupu pro prodloužení platnosti. Daň není zahrnuta.

createdByType

Typ identity, která prostředek vytvořila.

Error

Informace o chybě

ErrorResponseCode

Kód chyby popisující důvod, proč služba nemůže zpracovat příchozí požadavek

ExtendedErrorInfo

Rozšířené informace o chybách, včetně kódu chyby a chybové zprávy

ExtendedStatusInfo
InstanceFlexibility

Zapnutím této možnosti se sleva za rezervaci uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Pro VirtualMachines zadejte pouze rezervovaný typ prostředku.

Kind

Typ poskytovatele prostředků, který se má rezervovat.

Patch

Žádost o opravu rezervace

PricingCurrencyTotal

Částka, kterou Microsoft používá k záznamu. Používá se při refundaci pro výpočet limitu refundace. Daň není zahrnuta. Tato cena je uzamčena 30 dní před vypršením platnosti.

ProvisioningState

Představuje aktuální stav rezervace.

PurchaseRequest

Žádost o nákup rezervace

RenewProperties
RenewPropertiesResponse

Prodloužení vlastností rezervace.

ReservationBillingPlan

Představuje fakturační plány.

ReservationMergeProperties

Vlastnosti sloučení rezervací

ReservationResponse

Definice rezervace.

ReservationSplitProperties

Vlastnosti rozdělení rezervací

ReservationsProperties

Vlastnosti rezervací

ReservationStatusCode
ReservationSwapProperties

Vlastnosti prohození rezervací

ReservationTerm

Představuje dobu rezervace.

ReservationUtilizationAggregates

Agregované hodnoty využití rezervací

ReservedResourceProperties

Vlastnosti specifické pro každý rezervovaný typ prostředku. Není vyžadováno, pokud není k dispozici.

ReservedResourceType

Typ prostředku, který je rezervován.

SkuName

Název skladové položky

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Utilization

Využití rezervace

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.

Name Typ Description
displayName

string

Zobrazované jméno

managementGroupId

string

Plně kvalifikovaný identifikátor skupiny pro správu, ve které musí být výhoda uplatněna.

resourceGroupId

string

Plně kvalifikovaný identifikátor skupiny prostředků.

subscriptionId

string

Plně kvalifikovaný identifikátor předplatného.

tenantId

string

ID tenanta, u kterého by plán úspory měl použít výhodu

AppliedScopeType

Typ použitého oboru.

Name Typ Description
ManagementGroup

string

Shared

string

Single

string

BillingCurrencyTotal

Měna a částka, které budou zákazníkovi účtovány v místní měně zákazníka při nákupu pro prodloužení platnosti. Daň není zahrnuta.

Name Typ Description
amount

number

currencyCode

string

3písmenný kód měny ISO 4217 pro měnu používanou tímto záznamem o nákupu.

createdByType

Typ identity, která prostředek vytvořila.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

Error

Informace o chybě

Name Typ Description
error

ExtendedErrorInfo

Rozšířené informace o chybách, včetně kódu chyby a chybové zprávy

ErrorResponseCode

Kód chyby popisující důvod, proč služba nemůže zpracovat příchozí požadavek

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

Rozšířené informace o chybách, včetně kódu chyby a chybové zprávy

Name Typ Description
code

ErrorResponseCode

Kód chyby popisující důvod, proč služba nemůže zpracovat příchozí požadavek

message

string

ExtendedStatusInfo

Name Typ Description
message

string

Zpráva s podrobnými informacemi o stavovém kódu.

statusCode

ReservationStatusCode

InstanceFlexibility

Zapnutím této možnosti se sleva za rezervaci uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Pro VirtualMachines zadejte pouze rezervovaný typ prostředku.

Name Typ Description
Off

string

On

string

Kind

Typ poskytovatele prostředků, který se má rezervovat.

Name Typ Description
Microsoft.Compute

string

Patch

Žádost o opravu rezervace

Name Typ Default value Description
properties.appliedScopeProperties

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.

properties.appliedScopeType

AppliedScopeType

Typ použitého oboru.

properties.appliedScopes

string[]

Seznam předplatných, na která se výhoda použije. Nezadávejte, jestli je AppliedScopeType shared. Tato vlastnost bude vyřazena a nahrazena appliedScopeProperties místo pro Single AppliedScopeType.

properties.instanceFlexibility

InstanceFlexibility

Zapnutím této možnosti se sleva za rezervaci uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Pro VirtualMachines zadejte pouze rezervovaný typ prostředku.

properties.name

string

Zobrazovaný název rezervace

properties.renew

boolean

False

Pokud tuto hodnotu nastavíte na true, automaticky se k datu vypršení platnosti zakoupí nová rezervace.

properties.renewProperties

RenewProperties

properties.reviewDateTime

string

Jedná se o datum a čas, kdy je potřeba zkontrolovat Zvýhodněné hybridní využití Azure.

PricingCurrencyTotal

Částka, kterou Microsoft používá k záznamu. Používá se při refundaci pro výpočet limitu refundace. Daň není zahrnuta. Tato cena je uzamčena 30 dní před vypršením platnosti.

Name Typ Description
amount

number

currencyCode

string

3písmenný kód měny ISO 4217 pro měnu používanou tímto záznamem o nákupu.

ProvisioningState

Představuje aktuální stav rezervace.

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

Žádost o nákup rezervace

Name Typ Default value Description
location

string

Oblast Azure, ve které se nachází rezervovaný prostředek.

properties.appliedScopeProperties

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.

properties.appliedScopeType

AppliedScopeType

Typ použitého oboru.

properties.appliedScopes

string[]

Seznam předplatných, na která se výhoda použije. Nezadávejte, jestli je AppliedScopeType shared. Tato vlastnost bude vyřazena a nahrazena appliedScopeProperties místo pro Single AppliedScopeType.

properties.billingPlan

ReservationBillingPlan

Představuje fakturační plány.

properties.billingScopeId

string

Předplatné, které se bude účtovat za nákup rezervace nebo úspory

properties.displayName

string

Popisný název rezervace

properties.quantity

integer

Množství skladových položek, které jsou součástí rezervace.

properties.renew

boolean

False

Pokud tuto hodnotu nastavíte na true, automaticky se k datu vypršení platnosti zakoupí nová rezervace.

properties.reservedResourceProperties

ReservedResourceProperties

Vlastnosti specifické pro každý rezervovaný typ prostředku. Není vyžadováno, pokud není k dispozici.

properties.reservedResourceType

ReservedResourceType

Typ prostředku, který je rezervován.

properties.reviewDateTime

string

Jedná se o datum a čas, kdy je potřeba zkontrolovat Zvýhodněné hybridní využití Azure.

properties.term

ReservationTerm

Představuje dobu rezervace.

sku

SkuName

Název skladové položky

RenewProperties

Name Typ Description
purchaseProperties

PurchaseRequest

Žádost o nákup rezervace

RenewPropertiesResponse

Prodloužení vlastností rezervace.

Name Typ Description
billingCurrencyTotal

BillingCurrencyTotal

Měna a částka, které budou zákazníkovi účtovány v místní měně zákazníka při nákupu pro prodloužení platnosti. Daň není zahrnuta.

pricingCurrencyTotal

PricingCurrencyTotal

Částka, kterou Microsoft používá k záznamu. Používá se při refundaci pro výpočet limitu refundace. Daň není zahrnuta. Tato cena je uzamčena 30 dní před vypršením platnosti.

purchaseProperties

PurchaseRequest

Žádost o nákup rezervace

ReservationBillingPlan

Představuje fakturační plány.

Name Typ Description
Monthly

string

Upfront

string

ReservationMergeProperties

Vlastnosti sloučení rezervací

Name Typ Description
mergeDestination

string

ID prostředku rezervace vytvořeného kvůli sloučení. Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

mergeSources

string[]

ID prostředků zdrojové rezervace sloučená za účelem vytvoření této rezervace Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationResponse

Definice rezervace.

Name Typ Description
etag

integer

id

string

Plně kvalifikované ID prostředku Například /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{název_poskytovatele_prostředku}/{typ_prostředku}/{název_prostředku}.

kind

Kind

Typ poskytovatele prostředků, který se má rezervovat.

location

string

Oblast Azure, ve které se nachází rezervovaný prostředek.

name

string

Název prostředku

properties

ReservationsProperties

Vlastnosti přidružené k této rezervaci

sku

SkuName

Informace o SKU přidružené k této rezervaci

systemData

systemData

Azure Resource Manager metadata obsahující informace createdBy a modifiedBy.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ReservationSplitProperties

Vlastnosti rozdělení rezervací

Name Typ Description
splitDestinations

string[]

Seznam ID cílového prostředku, které se vytvořily z důvodu rozdělení Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

splitSource

string

ID prostředku rezervace, ze které se rozdělí. Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationsProperties

Vlastnosti rezervací

Name Typ Default value Description
appliedScopeProperties

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru. Není vyžadováno, pokud není k dispozici. Povinné a je potřeba zadat tenantId a managementGroupId, pokud appliedScopeType je ManagementGroup.

appliedScopeType

AppliedScopeType

Použitý typ oboru

appliedScopes

string[]

Seznam použitých oborů

archived

boolean

Označuje, jestli je rezervace archivovaná.

benefitStartTime

string

Toto je datum a čas, kdy výhoda rezervace začala.

billingPlan

ReservationBillingPlan

Možnosti fakturačního plánu dostupné pro tuto skladovou položku

billingScopeId

string

Předplatné, které se bude účtovat za nákup rezervace nebo úspory

capabilities

string

Možnosti rezervace

displayName

string

Popisný název pro uživatele, který snadno identifikuje rezervaci

displayProvisioningState

string

Stav zřizování rezervace pro zobrazení, např. Úspěch

effectiveDateTime

string

DateTime rezervace, od které začíná platnost této verze.

expiryDate

string

Toto je datum, kdy vyprší platnost rezervace.

expiryDateTime

string

Toto je datum a čas, kdy vyprší platnost rezervace.

extendedStatusInfo

ExtendedStatusInfo

Zpráva s podrobnými informacemi o stavovém kódu.

instanceFlexibility

InstanceFlexibility

Umožňuje uplatnit slevu za rezervaci napříč skladovými položkami v rámci stejné skupiny automatického přizpůsobení. Ne všechny skladové položky podporují flexibilitu velikosti instance.

lastUpdatedDateTime

string

DateTime poslední aktualizace rezervace.

mergeProperties

ReservationMergeProperties

Vlastnosti sloučení rezervací

provisioningState

ProvisioningState

Aktuální stav rezervace.

provisioningSubState

string

Dílčí stav zřizování rezervace, např. Úspěšné

purchaseDate

string

Toto je datum, kdy byla rezervace zakoupena.

purchaseDateTime

string

Jedná se o datum a čas, kdy byla rezervace zakoupena.

quantity

integer

Množství skladových položek, které jsou součástí rezervace.

renew

boolean

False

Pokud tuto hodnotu nastavíte na true, automaticky se k datu vypršení platnosti zakoupí nová rezervace.

renewDestination

string

ID rezervace zakoupené z důvodu prodloužení. Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.

renewProperties

RenewPropertiesResponse

Prodloužení vlastností rezervace.

renewSource

string

ID rezervace, ze které se tato rezervace obnovuje. Formát ID prostředku je /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.

reservedResourceType

ReservedResourceType

Typ prostředku, který je rezervován.

reviewDateTime

string

Jedná se o datum a čas, kdy je potřeba Zvýhodněné hybridní využití Azure zkontrolovat.

skuDescription

string

Popis skladové položky v angličtině.

splitProperties

ReservationSplitProperties

Vlastnosti rozdělení rezervací

swapProperties

ReservationSwapProperties

Vlastnosti prohození rezervací

term

ReservationTerm

Představuje dobu rezervace.

userFriendlyAppliedScopeType

string

Použitý typ rozsahu rezervace pro zobrazení, například Sdílené

userFriendlyRenewState

string

Stav prodloužení rezervace pro zobrazení, např. Zapnuto

utilization

Utilization

Využití rezervace

ReservationStatusCode

Name Typ Description
Active

string

Expired

string

Merged

string

None

string

PaymentInstrumentError

string

Pending

string

Processing

string

PurchaseError

string

Split

string

Succeeded

string

ReservationSwapProperties

Vlastnosti prohození rezervací

Name Typ Description
swapDestination

string

ID prostředku rezervace, na který se původní prostředek prohodí. Formát ID prostředku je /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

swapSource

string

ID prostředku zdrojové rezervace, která se prohodí. Formát ID prostředku je /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Představuje dobu rezervace.

Name Typ Description
P1Y

string

P3Y

string

P5Y

string

ReservationUtilizationAggregates

Agregované hodnoty využití rezervací

Name Typ Description
grain

number

Agregační interval

grainUnit

string

Agregační jednotka agregace

value

number

Agregovaná hodnota

valueUnit

string

Jednotka agregované hodnoty

ReservedResourceProperties

Vlastnosti specifické pro každý rezervovaný typ prostředku. Není vyžadováno, pokud není k dispozici.

Name Typ Description
instanceFlexibility

InstanceFlexibility

Zapnutím této možnosti se sleva za rezervaci uplatní na ostatní virtuální počítače ve stejné skupině velikostí virtuálních počítačů. Pro VirtualMachines zadejte pouze rezervovaný typ prostředku.

ReservedResourceType

Typ prostředku, který je rezervován.

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

Název skladové položky

Name Typ Description
name

string

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC)

createdBy

string

Identita, která vytvořila prostředek.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string

Časové razítko poslední změny prostředku (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.

Utilization

Využití rezervace

Name Typ Description
aggregates

ReservationUtilizationAggregates[]

Pole agregací využití rezervace

trend

string

Trend využití rezervace za posledních 7 dnů