Bagikan melalui


Capacity Reservations - Create Or Update

Operasi untuk membuat atau memperbarui reservasi kapasitas. Harap dicatat bahwa beberapa properti hanya dapat diatur selama pembuatan reservasi kapasitas. Silakan merujuk ke https://aka.ms/CapacityReservation untuk detail lebih lanjut.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}/capacityReservations/{capacityReservationName}?api-version=2024-03-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
capacityReservationGroupName
path True

string

Nama grup reservasi kapasitas.

capacityReservationName
path True

string

Nama reservasi kapasitas.

resourceGroupName
path True

string

Nama grup sumber daya.

subscriptionId
path True

string

Kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.

api-version
query True

string

Versi Api Klien.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
location True

string

Lokasi sumber daya

sku True

Sku

SKU sumber daya yang kapasitasnya perlu dicadangkan. Nama dan kapasitas SKU diperlukan untuk diatur. Saat ini Sku VM dengan kemampuan yang disebut 'CapacityReservationSupported' diatur ke true didukung. Lihat Daftar SKU Microsoft.Compute di wilayah (https://docs.microsoft.com/rest/api/compute/resourceskus/list) untuk nilai yang didukung.

tags

object

Tag sumber daya

zones

string[]

Zona Ketersediaan yang digunakan untuk reservasi kapasitas ini. Zona harus bernilai tunggal dan juga harus menjadi bagian untuk daftar zona yang ditentukan selama pembuatan grup reservasi kapasitas. Zona hanya dapat ditetapkan selama pembuatan. Jika tidak disediakan, reservasi hanya mendukung penyebaran non-zona. Jika disediakan, memberlakukan VM/VMSS menggunakan reservasi kapasitas ini untuk berada di zona yang sama.

Respons

Nama Jenis Deskripsi
200 OK

CapacityReservation

OK

201 Created

CapacityReservation

Dibuat

Other Status Codes

CloudError

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

Create or update a capacity reservation .

Permintaan sampel

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation?api-version=2024-03-01

{
  "location": "westus",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ]
}

Respon sampel

{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}
{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}

Definisi

Nama Deskripsi
ApiError

Kesalahan api.

ApiErrorBase

Basis kesalahan api.

CapacityReservation

Menentukan informasi tentang reservasi kapasitas.

CapacityReservationInstanceView

Tampilan instans reservasi kapasitas yang menyediakan sebagai rekam jepret properti runtime dari reservasi kapasitas yang dikelola oleh platform dan dapat berubah di luar operasi sarana kontrol.

CapacityReservationUtilization

Mewakili pemanfaatan reservasi kapasitas dalam hal sumber daya yang dialokasikan.

CloudError

Respons kesalahan dari layanan Komputasi.

InnerError

Detail kesalahan dalam.

InstanceViewStatus

Status tampilan instans.

Sku

Menjelaskan sku set skala komputer virtual. CATATAN: Jika SKU VM baru tidak didukung pada perangkat keras tempat set skala saat ini aktif, Anda perlu membatalkan alokasi VM dalam set skala sebelum memodifikasi nama SKU.

StatusLevelTypes

Kode tingkat.

SubResourceReadOnly

ApiError

Kesalahan api.

Nama Jenis Deskripsi
code

string

Kode kesalahan.

details

ApiErrorBase[]

Detail kesalahan Api

innererror

InnerError

Kesalahan dalam Api

message

string

Pesan kesalahan.

target

string

Target kesalahan tertentu.

ApiErrorBase

Basis kesalahan api.

Nama Jenis Deskripsi
code

string

Kode kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan tertentu.

CapacityReservation

Menentukan informasi tentang reservasi kapasitas.

Nama Jenis Deskripsi
id

string

ID sumber daya

location

string

Lokasi sumber daya

name

string

Nama sumber daya

properties.instanceView

CapacityReservationInstanceView

Tampilan instans reservasi Kapasitas.

properties.platformFaultDomainCount

integer

Menentukan nilai jumlah domain kesalahan yang didukung Reservasi Kapasitas untuk ukuran VM yang diminta. Catatan: Jumlah domain kesalahan yang ditentukan untuk sumber daya (seperti set skala komputer virtual) harus kurang dari atau sama dengan nilai ini jika disebarkan menggunakan reservasi kapasitas. Versi api minimum: 2022-08-01.

properties.provisioningState

string

Status penyediaan, yang hanya muncul dalam respons.

properties.provisioningTime

string

Waktu tanggal saat reservasi kapasitas terakhir diperbarui.

properties.reservationId

string

Id unik yang dihasilkan dan ditetapkan ke reservasi kapasitas oleh platform yang tidak berubah sepanjang masa pakai sumber daya.

properties.timeCreated

string

Menentukan waktu pembuatan sumber daya Reservasi Kapasitas. Versi api minimum: 2021-11-01.

properties.virtualMachinesAssociated

SubResourceReadOnly[]

Daftar semua id sumber daya komputer virtual yang terkait dengan reservasi kapasitas.

sku

Sku

SKU sumber daya yang kapasitasnya perlu dicadangkan. Nama dan kapasitas SKU diperlukan untuk diatur. Saat ini Sku VM dengan kemampuan yang disebut 'CapacityReservationSupported' diatur ke true didukung. Lihat Daftar SKU Microsoft.Compute di wilayah (https://docs.microsoft.com/rest/api/compute/resourceskus/list) untuk nilai yang didukung.

tags

object

Tag sumber daya

type

string

Jenis Sumber Daya

zones

string[]

Zona Ketersediaan yang digunakan untuk reservasi kapasitas ini. Zona harus bernilai tunggal dan juga harus menjadi bagian untuk daftar zona yang ditentukan selama pembuatan grup reservasi kapasitas. Zona hanya dapat ditetapkan selama pembuatan. Jika tidak disediakan, reservasi hanya mendukung penyebaran non-zona. Jika disediakan, memberlakukan VM/VMSS menggunakan reservasi kapasitas ini untuk berada di zona yang sama.

CapacityReservationInstanceView

Tampilan instans reservasi kapasitas yang menyediakan sebagai rekam jepret properti runtime dari reservasi kapasitas yang dikelola oleh platform dan dapat berubah di luar operasi sarana kontrol.

Nama Jenis Deskripsi
statuses

InstanceViewStatus[]

Informasi status sumber daya.

utilizationInfo

CapacityReservationUtilization

Kapasitas reservasi kapasitas yang tidak digunakan.

CapacityReservationUtilization

Mewakili pemanfaatan reservasi kapasitas dalam hal sumber daya yang dialokasikan.

Nama Jenis Deskripsi
currentCapacity

integer

Nilai memberikan kapasitas ukuran VM saat ini yang berhasil dipesan dan di mana pelanggan ditagih. Versi api minimum: 2022-08-01.

virtualMachinesAllocated

SubResourceReadOnly[]

Daftar semua id sumber daya komputer virtual yang dialokasikan terhadap reservasi kapasitas.

CloudError

Respons kesalahan dari layanan Komputasi.

Nama Jenis Deskripsi
error

ApiError

Kesalahan api.

InnerError

Detail kesalahan dalam.

Nama Jenis Deskripsi
errordetail

string

Pesan kesalahan internal atau cadangan pengecualian.

exceptiontype

string

Jenis pengecualian.

InstanceViewStatus

Status tampilan instans.

Nama Jenis Deskripsi
code

string

Kode status.

displayStatus

string

Label pendek yang dapat dilokalkan untuk status tersebut.

level

StatusLevelTypes

Kode tingkat.

message

string

Pesan status terperinci, termasuk untuk pemberitahuan dan pesan kesalahan.

time

string

Waktu status.

Sku

Menjelaskan sku set skala komputer virtual. CATATAN: Jika SKU VM baru tidak didukung pada perangkat keras tempat set skala saat ini aktif, Anda perlu membatalkan alokasi VM dalam set skala sebelum memodifikasi nama SKU.

Nama Jenis Deskripsi
capacity

integer

Menentukan jumlah komputer virtual dalam set skala.

name

string

Nama sku.

tier

string

Menentukan tingkat komputer virtual dalam set skala.

Nilai yang Mungkin:

Standar

Dasar

StatusLevelTypes

Kode tingkat.

Nama Jenis Deskripsi
Error

string

Info

string

Warning

string

SubResourceReadOnly

Nama Jenis Deskripsi
id

string

ID sumber daya