Reservation - Merge

  • Referensi
Service:
Reserved VM Instances
API Version:
2019-04-01

Menggabungkan dua Reservations.
Gabungkan s yang ditentukan Reservationke dalam yang baru Reservation. Keduanya Reservationdigabungkan harus memiliki properti yang sama.

POST https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/merge?api-version=2019-04-01

Parameter URI

Name In Required Type Description
reservationOrderId
 path True
  • string

Id Pesanan reservasi
api-version
 query True
  • string

Versi yang didukung untuk dokumen ini adalah 2019-04-01

Isi Permintaan

Name Type Description
properties.sources
  • string[]

Format id sumber daya harus /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

Respons

Name Type Description
200 OK

Mengembalikan yang Reservation dibuat setelah penggabungan.
202 Accepted

Permintaan diterima dan sedang diproses
Other Status Codes

Kesalahan tidak terduga

Contoh

Merge

Sample Request

POST https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/merge?api-version=2019-04-01

{
  "properties": {
    "sources": [
      "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/cea04232-932e-47db-acb5-e29a945ecc73",
      "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/5bf54dc7-dacd-4f46-a16b-7b78f4a59799"
    ]
  }
}

Sample Response

Status code:
200 
[
  {
    "sku": {
      "name": "Standard_DS1_v2"
    },
    "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
    "type": "Microsoft.Capacity/reservationOrders/reservations",
    "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/00238563-7312-4c20-a134-8c030bf938a7",
    "etag": 5,
    "location": "eastus",
    "properties": {
      "appliedScopes": [
        "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
      ],
      "renew": false,
      "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
      "appliedScopeType": "Single",
      "quantity": 1,
      "provisioningState": "Cancelled",
      "expiryDate": "2018-09-22",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
      "extendedStatusInfo": {
        "statusCode": "Merged",
        "message": "This reservation was merged and is no longer active."
      },
      "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
      },
      "mergeProperties": {
        "mergeDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"
      }
    }
  },
  {
    "sku": {
      "name": "Standard_DS1_v2"
    },
    "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
    "type": "Microsoft.Capacity/reservationOrders/reservations",
    "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
    "etag": 4,
    "location": "eastus",
    "properties": {
      "appliedScopes": [
        "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
      ],
      "renew": false,
      "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
      "appliedScopeType": "Single",
      "quantity": 2,
      "provisioningState": "Cancelled",
      "expiryDate": "2018-09-22",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
      "extendedStatusInfo": {
        "statusCode": "Merged",
        "message": "This reservation was merged and is no longer active."
      },
      "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
      "reservedResourceType": "VirtualMachines",
      "instanceFlexibility": "Off",
      "skuDescription": "D1 v2",
      "splitProperties": {
        "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
      },
      "mergeProperties": {
        "mergeDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"
      }
    }
  },
  {
    "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": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/6ef59113-3482-40da-8d79-787f823e34bc",
    "etag": 2,
    "location": "eastus",
    "properties": {
      "appliedScopes": [
        "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
      ],
      "renew": false,
      "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
      "appliedScopeType": "Single",
      "quantity": 3,
      "provisioningState": "Succeeded",
      "expiryDate": "2018-09-22",
      "displayName": "cabri_test",
      "billingPlan": "Monthly",
      "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
      "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
      "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"
        ]
      }
    }
  }
]
Status code:
202

Definisi

AppliedScopeProperties
AppliedScopeType

Jenis Cakupan yang Diterapkan.
BillingCurrencyTotal

Mata uang dan jumlah yang akan dikenakan pelanggan dalam mata uang lokal pelanggan untuk pembelian perpanjangan. Pajak tidak termasuk.
Error
ErrorResponseCode
ExtendedErrorInfo
ExtendedStatusInfo
InstanceFlexibility

Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.
MergeRequest
PricingCurrencyTotal

Jumlah yang digunakan Microsoft untuk rekaman. Digunakan selama pengembalian dana untuk menghitung batas pengembalian dana. Pajak tidak termasuk. Ini adalah harga terkunci 30 hari sebelum kedaluwarsa.
PurchaseRequest
RenewPropertiesResponse
ReservationBillingPlan

Mewakili paket penagihan.
ReservationMergeProperties
ReservationProperties
ReservationResponse
ReservationSplitProperties
ReservationStatusCode
ReservationSwapProperties
ReservationTerm

Mewakili jangka waktu Reservasi.
ReservedResourceProperties

Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku.
ReservedResourceType

Jenis sumber daya yang sedang dicadangkan.
SkuName

AppliedScopeProperties

Name Type Description
displayName
  • string

Nama tampilan grup manajemen
managementGroupId
  • string

ID grup manajemen format /providers/Microsoft.Management/managementGroups/{managementGroupId}
tenantId
  • string

ID penyewa dari jenis cakupan yang diterapkan

AppliedScopeType

Jenis Cakupan yang Diterapkan.

Name Type Description
Shared
  • string
Single
  • string

BillingCurrencyTotal

Mata uang dan jumlah yang akan dikenakan pelanggan dalam mata uang lokal pelanggan untuk pembelian perpanjangan. Pajak tidak termasuk.

Name Type Description
amount
  • number
currencyCode
  • string

Error

Name Type Description
error

ErrorResponseCode

Name Type Description
ActivateQuoteFailed
  • string
AppliedScopesNotAssociatedWithCommerceAccount
  • 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
ReservationIdNotInReservationOrder
  • string
ReservationOrderCreationFailed
  • string
ReservationOrderIdAlreadyExists
  • string
ReservationOrderNotEnabled
  • string
ReservationOrderNotFound
  • string
RiskCheckFailed
  • string
RoleAssignmentCreationFailed
  • string
ServerTimeout
  • string
UnauthenticatedRequestsThrottled
  • string
UnsupportedReservationTerm
  • string

ExtendedErrorInfo

Name Type Description
code
message
  • string

ExtendedStatusInfo

Name Type Description
message
  • string

Pesan yang memberikan informasi terperinci tentang kode status.
statusCode

InstanceFlexibility

Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.

Name Type Description
Off
  • string
On
  • string

MergeRequest

Name Type Description
properties.sources
  • string[]

Format id sumber daya harus /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

PricingCurrencyTotal

Jumlah yang digunakan Microsoft untuk rekaman. Digunakan selama pengembalian dana untuk menghitung batas pengembalian dana. Pajak tidak termasuk. Ini adalah harga terkunci 30 hari sebelum kedaluwarsa.

Name Type Description
amount
  • number
currencyCode
  • string

PurchaseRequest

Name Type Default Value Description
location
  • string

Wilayah Azure tempat sumber daya yang dipesan berada.
properties.appliedScopeType

Jenis Cakupan yang Diterapkan.
properties.appliedScopes
  • string[]

Daftar langganan yang akan diterapkan manfaatnya. Jangan tentukan apakah AppliedScopeType dibagikan.
properties.billingPlan

Mewakili paket penagihan.
properties.billingScopeId
  • string

Langganan yang akan dikenakan biaya untuk membeli Reservasi
properties.displayName
  • string

Nama reservasi yang mudah diingat
properties.instanceFlexibility

Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.
properties.quantity
  • integer

Kuantitas SKU yang merupakan bagian dari Reservasi. Harus lebih besar dari nol.
properties.renew
  • boolean
False

Mengatur ini ke true akan secara otomatis membeli reservasi baru pada tanggal kedaluwarsa.
properties.reservedResourceProperties

Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku.
properties.reservedResourceType

Jenis sumber daya yang sedang dicadangkan.
properties.term

Mewakili jangka waktu Reservasi.
sku

RenewPropertiesResponse

Name Type Description
billingCurrencyTotal

Mata uang dan jumlah yang akan dikenakan pelanggan dalam mata uang lokal pelanggan untuk pembelian perpanjangan. Pajak tidak termasuk.
pricingCurrencyTotal

Jumlah yang digunakan Microsoft untuk rekaman. Digunakan selama pengembalian dana untuk menghitung batas pengembalian dana. Pajak tidak termasuk. Ini adalah harga terkunci 30 hari sebelum kedaluwarsa.
purchaseProperties

ReservationBillingPlan

Mewakili paket penagihan.

Name Type Description
Monthly
  • string
Upfront
  • string

ReservationMergeProperties

Name Type Description
mergeDestination
  • string

Id Sumber Daya Reservasi Dibuat karena penggabungan. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
mergeSources
  • string[]

Id Sumber Daya dari Reservasi Sumber digabungkan untuk membentuk Reservasi ini. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationProperties

Name Type Default Value Description
appliedScopeProperties
appliedScopeType

Jenis Cakupan yang Diterapkan.
appliedScopes
  • string[]

Daftar langganan yang akan diterapkan manfaatnya. Jangan tentukan apakah AppliedScopeType dibagikan.
archived
  • boolean

Properti untuk menentukan apakah reservasi diarsipkan atau tidak
benefitStartTime
  • string

Ini adalah DateTime ketika manfaat reservasi dimulai.
billingPlan

Mewakili paket penagihan.
billingScopeId
  • string

Langganan yang akan dikenakan biaya untuk membeli Reservasi
capabilities
  • string

Mencantumkan Kemampuan reservasi
displayName
  • string

Nama yang mudah diingat bagi pengguna untuk mengidentifikasi reservasi dengan mudah
effectiveDateTime
  • string

TanggalWaktu Reservasi dimulai saat versi ini berlaku.
expiryDate
  • string

Ini adalah tanggal ketika Reservasi akan kedaluwarsa.
extendedStatusInfo
instanceFlexibility

Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.
lastUpdatedDateTime
  • string

DateTime terakhir kali Reservasi diperbarui.
mergeProperties
provisioningState
  • string

Status reservasi saat ini.
quantity
  • integer

Kuantitas SKU yang merupakan bagian dari Reservasi. Harus lebih besar dari nol.
renew
  • boolean
False

Mengatur ini ke true akan secara otomatis membeli reservasi baru pada tanggal kedaluwarsa.
renewDestination
  • string

Id Reservasi reservasi yang dibeli karena perpanjangan. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
renewProperties
renewSource
  • string

Id Reservasi reservasi tempat reservasi ini diperpanjang. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.
reservedResourceType

Jenis sumber daya yang sedang dicadangkan.
skuDescription
  • string

Deskripsi SKU dalam bahasa Inggris.
splitProperties
swapProperties
term

Mewakili jangka waktu Reservasi.

ReservationResponse

Name Type Description
etag
  • integer
id
  • string

Pengidentifikasi reservasi
location
  • string

Wilayah Azure tempat sumber daya yang dipesan berada.
name
  • string

Nama reservasi
properties
sku
type
  • string

Jenis sumber daya. "Microsoft.Capacity/reservationOrders/reservations"

ReservationSplitProperties

Name Type Description
splitDestinations
  • string[]

Daftar Id Sumber Daya tujuan yang dibuat karena pemisahan. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
splitSource
  • string

Id Sumber Daya Reservasi tempat ini dibagi. Format Id sumber daya adalah /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationStatusCode

Name Type Description
Active
  • string
Expired
  • string
Merged
  • string
None
  • string
PaymentInstrumentError
  • string
Pending
  • string
PurchaseError
  • string
Split
  • string
Succeeded
  • string

ReservationSwapProperties

Name Type Description
swapDestination
  • string

Id Sumber Daya Reservasi tempat sumber daya asli ditukar. Format Id sumber daya adalah /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}
swapSource
  • string

ID Sumber Daya dari Reservasi Sumber yang ditukar. Format Id sumber daya adalah /providers/microsoft.capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}

ReservationTerm

Mewakili jangka waktu Reservasi.

Name Type Description
P1Y
  • string
P3Y
  • string

ReservedResourceProperties

Properti khusus untuk setiap jenis sumber daya yang dipesan. Tidak diperlukan jika tidak berlaku.

Name Type Description
instanceFlexibility

Mengaktifkan ini akan menerapkan diskon reservasi ke VM lain dalam grup ukuran VM yang sama. Hanya tentukan untuk jenis sumber daya cadangan VirtualMachines.

ReservedResourceType

Jenis sumber daya yang sedang dicadangkan.

Name Type Description
AppService
  • string
AzureDataExplorer
  • string
BlockBlob
  • string
CosmosDb
  • string
Databricks
  • string
DedicatedHost
  • string
ManagedDisk
  • string
MariaDb
  • string
MySql
  • string
PostgreSql
  • string
RedHat
  • string
RedHatOsa
  • string
RedisCache
  • string
SapHana
  • string
SqlAzureHybridBenefit
  • string
SqlDataWarehouse
  • string
SqlDatabases
  • string
SuseLinux
  • string
VMwareCloudSimple
  • string
VirtualMachines
  • string

SkuName

Name Type Description
name
  • string