Sdílet prostřednictvím


Capacity Reservations - Create Or Update

Operace vytvoření nebo aktualizace rezervace kapacity Upozorňujeme, že některé vlastnosti je možné nastavit pouze při vytváření rezervace kapacity. Další podrobnosti najdete v části https://aka.ms/CapacityReservation .

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

Parametry identifikátoru URI

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

string

Název skupiny rezervací kapacity.

capacityReservationName
path True

string

Název rezervace kapacity.

resourceGroupName
path True

string

Název skupiny prostředků.

subscriptionId
path True

string

Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby.

api-version
query True

string

Verze rozhraní API klienta.

Text požadavku

Name Vyžadováno Typ Description
location True

string

Umístění prostředku

sku True

Sku

SKU prostředku, pro který je potřeba rezervovat kapacitu. Je potřeba nastavit název skladové položky a kapacitu. V současné době se podporují skladové položky virtuálních počítačů s funkcí s názvem CapacityReservationSupported nastavenou na hodnotu true. Podporované hodnoty najdete v tématu Výpis skladových položek Microsoft.Compute v oblasti (https://docs.microsoft.com/rest/api/compute/resourceskus/list).

tags

object

Značky prostředků

zones

string[]

Zóna dostupnosti, která se má použít pro tuto rezervaci kapacity. Zóna musí mít jednu hodnotu a také by měla být součástí seznamu zón zadaných při vytváření skupiny rezervací kapacity. Zónu lze přiřadit pouze během vytváření. Pokud není rezervace poskytnuta, podporuje pouze nasazení mimo zónu. Pokud je zadaný, vynutí, aby virtuální počítač nebo škálovací sada virtuálních počítačů používající tuto rezervaci kapacity byla ve stejné zóně.

Odpovědi

Name Typ Description
200 OK

CapacityReservation

OK

201 Created

CapacityReservation

Vytvořeno

Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

Create or update a capacity reservation .

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
ApiError

Chyba rozhraní API

ApiErrorBase

Základ chyb rozhraní API.

CapacityReservation

Určuje informace o rezervaci kapacity.

CapacityReservationInstanceView

Zobrazení instance rezervace kapacity, které poskytuje jako snímek vlastností modulu runtime rezervace kapacity spravované platformou a může se měnit mimo operace řídicí roviny.

CapacityReservationUtilization

Představuje využití rezervace kapacity z hlediska přidělených prostředků.

CloudError

Chybová odpověď ze služby Compute.

InnerError

Podrobnosti o vnitřní chybě.

InstanceViewStatus

Stav zobrazení instance.

Sku

Popisuje skladovou položku škálovací sady virtuálních počítačů. POZNÁMKA: Pokud se nová skladová položka virtuálního počítače nepodporuje na hardwaru, na které se škálovací sada aktuálně nachází, musíte před úpravou názvu skladové položky uvolnit virtuální počítače ve škálovací sadě.

StatusLevelTypes

Kód úrovně.

SubResourceReadOnly

ApiError

Chyba rozhraní API

Name Typ Description
code

string

Kód chyby

details

ApiErrorBase[]

Podrobnosti o chybě rozhraní API

innererror

InnerError

Vnitřní chyba rozhraní API

message

string

Chybová zpráva

target

string

Cíl konkrétní chyby.

ApiErrorBase

Základ chyb rozhraní API.

Name Typ Description
code

string

Kód chyby

message

string

Chybová zpráva

target

string

Cíl konkrétní chyby.

CapacityReservation

Určuje informace o rezervaci kapacity.

Name Typ Description
id

string

ID prostředku

location

string

Umístění prostředku

name

string

Název prostředku

properties.instanceView

CapacityReservationInstanceView

Zobrazení instance rezervace kapacity

properties.platformFaultDomainCount

integer

Určuje hodnotu počtu domén selhání, kterou rezervace kapacity podporuje pro požadovanou velikost virtuálního počítače. Poznámka: Počet domén selhání zadaný pro prostředek (například škálovací sada virtuálních počítačů) musí být menší nebo roven této hodnotě, pokud se nasazuje pomocí rezervace kapacity. Minimální verze api-version: 2022-08-01.

properties.provisioningState

string

Stav zřizování, který se zobrazí pouze v odpovědi.

properties.provisioningTime

string

Datum a čas poslední aktualizace rezervace kapacity.

properties.reservationId

string

Jedinečné ID vygenerované a přiřazené k rezervaci kapacity platformou, které se po celou dobu životnosti prostředku nemění.

properties.timeCreated

string

Určuje čas vytvoření prostředku rezervace kapacity. Minimální verze api:2021-11-01.

properties.virtualMachinesAssociated

SubResourceReadOnly[]

Seznam všech ID prostředků virtuálních počítačů přidružených k rezervaci kapacity.

sku

Sku

SKU prostředku, pro který je potřeba rezervovat kapacitu. Je potřeba nastavit název skladové položky a kapacitu. V současné době se podporují skladové položky virtuálních počítačů s funkcí s názvem CapacityReservationSupported nastavenou na hodnotu true. Podporované hodnoty najdete v tématu Výpis skladových položek Microsoft.Compute v oblasti (https://docs.microsoft.com/rest/api/compute/resourceskus/list).

tags

object

Značky prostředků

type

string

Typ prostředku

zones

string[]

Zóna dostupnosti, která se má použít pro tuto rezervaci kapacity. Zóna musí mít jednu hodnotu a také by měla být součástí seznamu zón zadaných při vytváření skupiny rezervací kapacity. Zónu lze přiřadit pouze během vytváření. Pokud není rezervace poskytnuta, podporuje pouze nasazení mimo zónu. Pokud je zadaný, vynutí, aby virtuální počítač nebo škálovací sada virtuálních počítačů používající tuto rezervaci kapacity byla ve stejné zóně.

CapacityReservationInstanceView

Zobrazení instance rezervace kapacity, které poskytuje jako snímek vlastností modulu runtime rezervace kapacity spravované platformou a může se měnit mimo operace řídicí roviny.

Name Typ Description
statuses

InstanceViewStatus[]

Informace o stavu zdroje.

utilizationInfo

CapacityReservationUtilization

Nevyužitá kapacita rezervace kapacity.

CapacityReservationUtilization

Představuje využití rezervace kapacity z hlediska přidělených prostředků.

Name Typ Description
currentCapacity

integer

Hodnota poskytuje aktuální kapacitu velikosti virtuálního počítače, která byla úspěšně rezervována a za kterou se zákazníkovi účtují poplatky. Minimální verze api-version: 2022-08-01.

virtualMachinesAllocated

SubResourceReadOnly[]

Seznam VŠECH ID prostředků virtuálních počítačů přidělených k rezervaci kapacity.

CloudError

Chybová odpověď ze služby Compute.

Name Typ Description
error

ApiError

Chyba rozhraní API

InnerError

Podrobnosti o vnitřní chybě.

Name Typ Description
errordetail

string

Vnitřní chybová zpráva nebo výpis výjimky.

exceptiontype

string

Typ výjimky.

InstanceViewStatus

Stav zobrazení instance.

Name Typ Description
code

string

Stavový kód.

displayStatus

string

Krátký lokalizovatelný popisek stavu.

level

StatusLevelTypes

Kód úrovně.

message

string

Podrobná stavová zpráva, včetně výstrah a chybových zpráv.

time

string

Čas stavu.

Sku

Popisuje skladovou položku škálovací sady virtuálních počítačů. POZNÁMKA: Pokud se nová skladová položka virtuálního počítače nepodporuje na hardwaru, na které se škálovací sada aktuálně nachází, musíte před úpravou názvu skladové položky uvolnit virtuální počítače ve škálovací sadě.

Name Typ Description
capacity

integer

Určuje počet virtuálních počítačů ve škálovací sadě.

name

string

Název skladové položky.

tier

string

Určuje úroveň virtuálních počítačů ve škálovací sadě.

Možné hodnoty:

Standard

Basic

StatusLevelTypes

Kód úrovně.

Name Typ Description
Error

string

Info

string

Warning

string

SubResourceReadOnly

Name Typ Description
id

string

ID prostředku