Megosztás a következőn keresztül:


Capacity Reservations - Create Or Update

Kapacitásfoglalás létrehozásához vagy frissítéséhez szükséges művelet. Vegye figyelembe, hogy egyes tulajdonságok csak a kapacitásfoglalás létrehozásakor állíthatók be. További részletekért tekintse https://aka.ms/CapacityReservation meg a következőt: .

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

URI-paraméterek

Name In Kötelező Típus Description
capacityReservationGroupName
path True

string

A kapacitásfoglalási csoport neve.

capacityReservationName
path True

string

A kapacitásfoglalás neve.

resourceGroupName
path True

string

Az erőforráscsoport neve.

subscriptionId
path True

string

Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés-azonosító az URI részét képezi minden szolgáltatáshíváshoz.

api-version
query True

string

Client API-verzió.

Kérelem törzse

Name Kötelező Típus Description
location True

string

Erőforrás helye

sku True

Sku

Annak az erőforrásnak a termékváltozata, amelyhez kapacitást kell lefoglalni. A termékváltozat nevét és kapacitását be kell állítani. Jelenleg a "CapacityReservationSupported" nevű képességű virtuálisgép-termékváltozatok támogatottak. A támogatott értékekért tekintse meg a Microsoft.Compute termékváltozatainak listázása egy régióban (https://docs.microsoft.com/rest/api/compute/resourceskus/list) című témakört.

tags

object

Erőforráscímkék

zones

string[]

A kapacitásfoglaláshoz használandó rendelkezésre állási zóna. A zónának egyetlen értéknek kell lennie, és a kapacitásfoglalási csoport létrehozásakor megadott zónák listájának is szerepelnie kell. A zóna csak a létrehozás során rendelhető hozzá. Ha nincs megadva, a foglalás csak a nem zónaszintű üzemelő példányokat támogatja. Ha meg van adva, kényszeríti, hogy a virtuális gép/VMSS ezzel a kapacitásfoglalással ugyanabban a zónában legyen.

Válaszok

Name Típus Description
200 OK

CapacityReservation

OK

201 Created

CapacityReservation

Létrehozva

Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

Create or update a capacity reservation .

Mintakérelem

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

Mintaválasz

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

Definíciók

Name Description
ApiError

API-hiba.

ApiErrorBase

API-hibabázis.

CapacityReservation

Megadja a kapacitásfoglalással kapcsolatos információkat.

CapacityReservationInstanceView

Egy kapacitásfoglalás példánynézete, amely a platform által felügyelt kapacitásfoglalás futásidejű tulajdonságainak pillanatképeként szolgál, és a vezérlősík műveletein kívül változhat.

CapacityReservationUtilization

A kapacitásfoglalás kihasználtságát jelöli a lefoglalt erőforrások tekintetében.

CloudError

Hibaválasz a Compute szolgáltatástól.

InnerError

Belső hiba részletei.

InstanceViewStatus

Példánynézet állapota.

Sku

A virtuálisgép-méretezési csoport termékváltozatát ismerteti. MEGJEGYZÉS: Ha az új virtuálisgép-termékváltozat nem támogatott azon a hardveren, amelyen a méretezési csoport jelenleg működik, a termékváltozat nevének módosítása előtt fel kell szabadítania a virtuális gépeket a méretezési csoportban.

StatusLevelTypes

A szintkód.

SubResourceReadOnly

ApiError

API-hiba.

Name Típus Description
code

string

A hibakód.

details

ApiErrorBase[]

Az API-hiba részletei

innererror

InnerError

Az API belső hibája

message

string

A hibaüzenet.

target

string

Az adott hiba célja.

ApiErrorBase

API-hibabázis.

Name Típus Description
code

string

A hibakód.

message

string

A hibaüzenet.

target

string

Az adott hiba célja.

CapacityReservation

Megadja a kapacitásfoglalással kapcsolatos információkat.

Name Típus Description
id

string

Erőforrás-azonosító

location

string

Erőforrás helye

name

string

Erőforrás neve

properties.instanceView

CapacityReservationInstanceView

A Kapacitásfoglalási példány nézet.

properties.platformFaultDomainCount

integer

Megadja annak a tartalék tartománynak a számát, amelyet a kapacitásfoglalás támogat a kért virtuálisgép-mérethez. Megjegyzés: Az erőforráshoz (például a virtuálisgép-méretezési csoporthoz) megadott tartaléktartomány-számnak ennél az értéknél kisebbnek vagy egyenlőnek kell lennie, ha kapacitásfoglalással helyezi üzembe. Minimális API-verzió: 2022-08-01.

properties.provisioningState

string

A kiépítési állapot, amely csak a válaszban jelenik meg.

properties.provisioningTime

string

A kapacitásfoglalás utolsó frissítésének dátuma.

properties.reservationId

string

A platform által a kapacitásfoglaláshoz létrehozott és hozzárendelt egyedi azonosító, amely nem változik az erőforrás teljes élettartama során.

properties.timeCreated

string

Megadja a kapacitásfoglalási erőforrás létrehozásának időpontját. Minimális API-verzió: 2021-11-01.

properties.virtualMachinesAssociated

SubResourceReadOnly[]

A kapacitásfoglaláshoz társított összes virtuálisgép-erőforrás-azonosító listája.

sku

Sku

Annak az erőforrásnak a termékváltozata, amelyhez kapacitást kell lefoglalni. A termékváltozat nevét és kapacitását be kell állítani. Jelenleg a "CapacityReservationSupported" nevű képességű virtuálisgép-termékváltozatok támogatottak. A támogatott értékekért tekintse meg a Microsoft.Compute termékváltozatainak listázása egy régióban (https://docs.microsoft.com/rest/api/compute/resourceskus/list) című témakört.

tags

object

Erőforráscímkék

type

string

Erőforrás típusa

zones

string[]

A kapacitásfoglaláshoz használandó rendelkezésre állási zóna. A zónának egyetlen értéknek kell lennie, és a kapacitásfoglalási csoport létrehozásakor megadott zónák listájának is szerepelnie kell. A zóna csak a létrehozás során rendelhető hozzá. Ha nincs megadva, a foglalás csak a nem zónaszintű üzemelő példányokat támogatja. Ha meg van adva, kényszeríti, hogy a virtuális gép/VMSS ezzel a kapacitásfoglalással ugyanabban a zónában legyen.

CapacityReservationInstanceView

Egy kapacitásfoglalás példánynézete, amely a platform által felügyelt kapacitásfoglalás futásidejű tulajdonságainak pillanatképeként szolgál, és a vezérlősík műveletein kívül változhat.

Name Típus Description
statuses

InstanceViewStatus[]

Az erőforrás állapotadatai.

utilizationInfo

CapacityReservationUtilization

A kapacitásfoglalás kihasználatlan kapacitása.

CapacityReservationUtilization

A kapacitásfoglalás kihasználtságát jelöli a lefoglalt erőforrások tekintetében.

Name Típus Description
currentCapacity

integer

Az érték a virtuálisgép-méret aktuális kapacitását adja meg, amely sikeresen le lett foglalva, és amelynek számlázása az ügyfél számára történik. Minimális API-verzió: 2022-08-01.

virtualMachinesAllocated

SubResourceReadOnly[]

A kapacitásfoglaláshoz lefoglalt összes virtuális gép erőforrás-azonosítójának listája.

CloudError

Hibaválasz a Compute szolgáltatástól.

Name Típus Description
error

ApiError

API-hiba.

InnerError

Belső hiba részletei.

Name Típus Description
errordetail

string

A belső hibaüzenet vagy kivételkép.

exceptiontype

string

A kivétel típusa.

InstanceViewStatus

Példánynézet állapota.

Name Típus Description
code

string

Az állapotkód.

displayStatus

string

Az állapot rövid honosítható címkéje.

level

StatusLevelTypes

A szintkód.

message

string

A részletes állapotüzenet, beleértve a riasztásokat és a hibaüzeneteket is.

time

string

Az állapot időpontja.

Sku

A virtuálisgép-méretezési csoport termékváltozatát ismerteti. MEGJEGYZÉS: Ha az új virtuálisgép-termékváltozat nem támogatott azon a hardveren, amelyen a méretezési csoport jelenleg működik, a termékváltozat nevének módosítása előtt fel kell szabadítania a virtuális gépeket a méretezési csoportban.

Name Típus Description
capacity

integer

A méretezési csoportban lévő virtuális gépek számát adja meg.

name

string

A termékváltozat neve.

tier

string

Meghatározza a méretezési csoportban lévő virtuális gépek szintjét.

Lehetséges értékek:

Standard

Basic

StatusLevelTypes

A szintkód.

Name Típus Description
Error

string

Info

string

Warning

string

SubResourceReadOnly

Name Típus Description
id

string

Erőforrás-azonosító