Udostępnij za pośrednictwem


Capacity Reservations - Create Or Update

Operacja tworzenia lub aktualizowania rezerwacji pojemności. Należy pamiętać, że niektóre właściwości można ustawić tylko podczas tworzenia rezerwacji pojemności. Aby uzyskać więcej informacji, zapoznaj się z https://aka.ms/CapacityReservation tematem .

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
capacityReservationGroupName
path True

string

Nazwa grupy rezerwacji pojemności.

capacityReservationName
path True

string

Nazwa rezerwacji pojemności.

resourceGroupName
path True

string

Nazwa grupy zasobów.

subscriptionId
path True

string

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

api-version
query True

string

Wersja interfejsu API klienta.

Treść żądania

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja zasobu

sku True

Sku

Jednostka SKU zasobu, dla którego pojemność musi być zarezerwowana. Należy ustawić nazwę jednostki SKU i pojemność. Obecnie obsługiwane są jednostki SKU maszyn wirtualnych z możliwością o nazwie "CapacityReservationSupported" ustawioną na wartość true. Aby uzyskać obsługiwane wartości, zapoznaj się z tematem Lista jednostek SKU Microsoft.Compute w regionie (https://docs.microsoft.com/rest/api/compute/resourceskus/list).

tags

object

Tagi zasobów

zones

string[]

Strefa dostępności do użycia dla tej rezerwacji pojemności. Strefa musi być pojedynczą wartością, a także powinna być częścią listy stref określonych podczas tworzenia grupy rezerwacji pojemności. Strefę można przypisać tylko podczas tworzenia. Jeśli nie zostanie podana, rezerwacja obsługuje tylko wdrożenia inne niż strefowe. W razie potrzeby wymusza użycie tej rezerwacji pojemności maszyn wirtualnych/maszyn wirtualnych przy użyciu tej rezerwacji pojemności, aby znajdować się w tej samej strefie.

Odpowiedzi

Nazwa Typ Opis
200 OK

CapacityReservation

OK

201 Created

CapacityReservation

Utworzone

Other Status Codes

CloudError

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Create or update a capacity reservation .

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
ApiError

Błąd interfejsu API.

ApiErrorBase

Baza błędów interfejsu API.

CapacityReservation

Określa informacje o rezerwacji pojemności.

CapacityReservationInstanceView

Widok wystąpienia rezerwacji pojemności, który udostępnia jako migawkę właściwości środowiska uruchomieniowego rezerwacji pojemności zarządzanej przez platformę i może zmieniać się poza operacjami płaszczyzny sterowania.

CapacityReservationUtilization

Reprezentuje wykorzystanie rezerwacji pojemności w odniesieniu do przydzielonych zasobów.

CloudError

Odpowiedź o błędzie z usługi Compute.

InnerError

Szczegóły błędu wewnętrznego.

InstanceViewStatus

Stan widoku wystąpienia.

Sku

Opisuje jednostkę SKU zestawu skalowania maszyn wirtualnych. UWAGA: Jeśli nowa jednostka SKU maszyny wirtualnej nie jest obecnie obsługiwana na sprzęcie, zestaw skalowania jest obecnie włączony, należy cofnąć przydział maszyn wirtualnych w zestawie skalowania przed zmodyfikowaniem nazwy jednostki SKU.

StatusLevelTypes

Kod poziomu.

SubResourceReadOnly

ApiError

Błąd interfejsu API.

Nazwa Typ Opis
code

string

Kod błędu.

details

ApiErrorBase[]

Szczegóły błędu interfejsu API

innererror

InnerError

Wewnętrzny błąd interfejsu API

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

ApiErrorBase

Baza błędów interfejsu API.

Nazwa Typ Opis
code

string

Kod błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

CapacityReservation

Określa informacje o rezerwacji pojemności.

Nazwa Typ Opis
id

string

Identyfikator zasobu

location

string

Lokalizacja zasobu

name

string

Nazwa zasobu

properties.instanceView

CapacityReservationInstanceView

Widok wystąpienia rezerwacji pojemności.

properties.platformFaultDomainCount

integer

Określa wartość liczby domen błędów obsługiwaną przez rezerwację pojemności dla żądanego rozmiaru maszyny wirtualnej. Uwaga: Liczba domen błędów określona dla zasobu (na przykład zestawu skalowania maszyn wirtualnych) musi być mniejsza lub równa tej wartości, jeśli jest wdrażana przy użyciu rezerwacji pojemności. Minimalna wersja interfejsu API: 2022-08-01.

properties.provisioningState

string

Stan aprowizacji, który pojawia się tylko w odpowiedzi.

properties.provisioningTime

string

Data ostatniej aktualizacji rezerwacji pojemności.

properties.reservationId

string

Unikatowy identyfikator wygenerowany i przypisany do rezerwacji pojemności przez platformę, która nie zmienia się przez cały okres istnienia zasobu.

properties.timeCreated

string

Określa godzinę utworzenia zasobu rezerwacja pojemności. Minimalna wersja interfejsu API: 2021-11-01.

properties.virtualMachinesAssociated

SubResourceReadOnly[]

Lista wszystkich identyfikatorów zasobów maszyny wirtualnej skojarzonych z rezerwacją pojemności.

sku

Sku

Jednostka SKU zasobu, dla którego pojemność musi być zarezerwowana. Należy ustawić nazwę jednostki SKU i pojemność. Obecnie obsługiwane są jednostki SKU maszyn wirtualnych z możliwością o nazwie "CapacityReservationSupported" ustawioną na wartość true. Aby uzyskać obsługiwane wartości, zapoznaj się z tematem Lista jednostek SKU Microsoft.Compute w regionie (https://docs.microsoft.com/rest/api/compute/resourceskus/list).

tags

object

Tagi zasobów

type

string

Typ zasobu

zones

string[]

Strefa dostępności do użycia dla tej rezerwacji pojemności. Strefa musi być pojedynczą wartością, a także powinna być częścią listy stref określonych podczas tworzenia grupy rezerwacji pojemności. Strefę można przypisać tylko podczas tworzenia. Jeśli nie zostanie podana, rezerwacja obsługuje tylko wdrożenia inne niż strefowe. W razie potrzeby wymusza użycie tej rezerwacji pojemności maszyn wirtualnych/maszyn wirtualnych przy użyciu tej rezerwacji pojemności, aby znajdować się w tej samej strefie.

CapacityReservationInstanceView

Widok wystąpienia rezerwacji pojemności, który udostępnia jako migawkę właściwości środowiska uruchomieniowego rezerwacji pojemności zarządzanej przez platformę i może zmieniać się poza operacjami płaszczyzny sterowania.

Nazwa Typ Opis
statuses

InstanceViewStatus[]

Informacje o stanie zasobu.

utilizationInfo

CapacityReservationUtilization

Nieuprawnionej pojemności rezerwacji pojemności.

CapacityReservationUtilization

Reprezentuje wykorzystanie rezerwacji pojemności w odniesieniu do przydzielonych zasobów.

Nazwa Typ Opis
currentCapacity

integer

Wartość zapewnia bieżącą pojemność rozmiaru maszyny wirtualnej, który został pomyślnie zarezerwowany i dla którego klient otrzymuje opłaty. Minimalna wersja interfejsu API: 2022-08-01.

virtualMachinesAllocated

SubResourceReadOnly[]

Lista wszystkich identyfikatorów zasobów maszyn wirtualnych przydzielonych do rezerwacji pojemności.

CloudError

Odpowiedź o błędzie z usługi Compute.

Nazwa Typ Opis
error

ApiError

Błąd interfejsu API.

InnerError

Szczegóły błędu wewnętrznego.

Nazwa Typ Opis
errordetail

string

Wewnętrzny komunikat o błędzie lub zrzut wyjątku.

exceptiontype

string

Typ wyjątku.

InstanceViewStatus

Stan widoku wystąpienia.

Nazwa Typ Opis
code

string

Kod stanu.

displayStatus

string

Krótka etykieta lokalizowalna dla stanu.

level

StatusLevelTypes

Kod poziomu.

message

string

Szczegółowy komunikat o stanie, w tym alerty i komunikaty o błędach.

time

string

Czas stanu.

Sku

Opisuje jednostkę SKU zestawu skalowania maszyn wirtualnych. UWAGA: Jeśli nowa jednostka SKU maszyny wirtualnej nie jest obecnie obsługiwana na sprzęcie, zestaw skalowania jest obecnie włączony, należy cofnąć przydział maszyn wirtualnych w zestawie skalowania przed zmodyfikowaniem nazwy jednostki SKU.

Nazwa Typ Opis
capacity

integer

Określa liczbę maszyn wirtualnych w zestawie skalowania.

name

string

Nazwa jednostki SKU.

tier

string

Określa warstwę maszyn wirtualnych w zestawie skalowania.

Możliwe wartości:

Standardowa

Podstawowa

StatusLevelTypes

Kod poziomu.

Nazwa Typ Opis
Error

string

Info

string

Warning

string

SubResourceReadOnly

Nazwa Typ Opis
id

string

Identyfikator zasobu