Capacity Reservations - Get

Der Vorgang, der Informationen zur Kapazitätsreservierung abruft.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}/capacityReservations/{capacityReservationName}?api-version=2026-04-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}/capacityReservations/{capacityReservationName}?api-version=2026-04-01&$expand=instanceView

URI-Parameter

Name In Erforderlich Typ Beschreibung
capacityReservationGroupName
path True

string

Der Name der Kapazitätsreservierungsgruppe.

capacityReservationName
path True

string

Der Name der Kapazitätsreservierung.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

minLength: 1

Die ID des Zielabonnements.

api-version
query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

$expand
query

CapacityReservationInstanceViewTypes

Der erweiterungsausdruck, der für den Vorgang angewendet werden soll. "InstanceView" ruft eine Momentaufnahme der Laufzeiteigenschaften der Kapazitätsreservierung ab, die von der Plattform verwaltet wird, und kann sich außerhalb der Steuerungsebenenvorgänge ändern.

Antworten

Name Typ Beschreibung
200 OK

CapacityReservation

Der Azure-Vorgang wurde erfolgreich abgeschlossen.

Other Status Codes

CloudError

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Sich als Ihr Benutzerkonto ausgeben

Beispiele

Get a block capacity reservation.
Get a capacity reservation.
Get a Future capacity reservation.
Get a targeted capacity reservation.
Get an open capacity reservation with instance view.

Get a block capacity reservation.

Beispielanforderung

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/blockCapacityReservationGroup/capacityReservations/blockCapacityReservation?api-version=2026-04-01&$expand=instanceView

Beispiel für eine Antwort

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/blockCapacityReservationGroup/capacityReservations/blockCapacityReservation",
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00",
    "virtualMachinesAssociated": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
      },
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
      },
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM3"
      }
    ],
    "provisioningState": "Succeeded",
    "instanceView": {
      "utilizationInfo": {
        "currentCapacity": 5,
        "virtualMachinesAllocated": [
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
          },
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
          }
        ]
      },
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded"
        }
      ]
    },
    "scheduleProfile": {
      "start": "2025-08-01T12:00:00Z",
      "end": "2025-08-02T11:30:00Z"
    },
    "timeCreated": "2021-06-27T01:02:38.3138469+00:00"
  },
  "location": "westus",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_ND96isr_H100_v5",
    "capacity": 1
  },
  "zones": [
    "1"
  ],
  "name": "blockCapacityReservation"
}

Get a capacity reservation.

Beispielanforderung

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation?api-version=2026-04-01&$expand=instanceView

Beispiel für eine Antwort

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00",
    "virtualMachinesAssociated": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
      },
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
      },
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM3"
      }
    ],
    "provisioningState": "Succeeded",
    "instanceView": {
      "utilizationInfo": {
        "currentCapacity": 5,
        "virtualMachinesAllocated": [
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
          },
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
          }
        ]
      },
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded"
        }
      ]
    },
    "timeCreated": "2021-06-27T01:02:38.3138469+00:00"
  },
  "location": "westus",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "name": "myCapacityReservation"
}

Get a Future capacity reservation.

Beispielanforderung

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/futureCapacityReservationGroup/capacityReservations/futureCapacityReservation?api-version=2026-04-01&$expand=instanceView

Beispiel für eine Antwort

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/futureCapacityReservationGroup/capacityReservations/futureCapacityReservation",
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00",
    "virtualMachinesAssociated": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
      },
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
      },
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM3"
      }
    ],
    "provisioningState": "Succeeded",
    "instanceView": {
      "utilizationInfo": {
        "currentCapacity": 4,
        "virtualMachinesAllocated": [
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
          },
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
          }
        ]
      },
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded"
        }
      ],
      "reservationStateInfo": {
        "reservationState": "Live"
      }
    },
    "scheduleProfile": {
      "start": "2026-08-01T12:00:00Z",
      "minimumCommitmentDays": 30,
      "modifiableUntil": "2026-06-06T12:00:00Z"
    },
    "timeCreated": "2021-06-27T01:02:38.3138469+00:00"
  },
  "location": "westus",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "name": "futureCapacityReservation"
}

Get a targeted capacity reservation.

Beispielanforderung

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/targetedCapacityReservationGroup/capacityReservations/targetedCapacityReservation?api-version=2026-04-01&$expand=instanceView

Beispiel für eine Antwort

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/targetedCapacityReservationGroup/capacityReservations/targetedCapacityReservation",
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00",
    "virtualMachinesAssociated": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
      },
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
      },
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM3"
      }
    ],
    "provisioningState": "Succeeded",
    "instanceView": {
      "utilizationInfo": {
        "currentCapacity": 5,
        "virtualMachinesAllocated": [
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
          },
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
          }
        ]
      },
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded"
        }
      ]
    },
    "timeCreated": "2021-06-27T01:02:38.3138469+00:00"
  },
  "location": "westus",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "name": "targetedCapacityReservation"
}

Get an open capacity reservation with instance view.

Beispielanforderung

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/openCapacityReservationGroup/capacityReservations/openCapacityReservation?api-version=2026-04-01&$expand=instanceView

Beispiel für eine Antwort

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/openCapacityReservationGroup/capacityReservations/openCapacityReservation",
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00",
    "provisioningState": "Succeeded",
    "instanceView": {
      "utilizationInfo": {
        "currentCapacity": 10,
        "usedReservedCountBySubscription": {
          "{subscription-id1}": 3,
          "{subscription-id2}": 2
        }
      },
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded"
        }
      ]
    },
    "timeCreated": "2021-06-27T01:02:38.3138469+00:00"
  },
  "location": "westus",
  "tags": {
    "{tagName}": "{tagValue}"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 10
  },
  "zones": [
    "1"
  ],
  "name": "openCapacityReservation"
}

Definitionen

Name Beschreibung
ApiError

API-Fehler.

ApiErrorBase

API-Fehlerbasis.

CapacityReservation

Gibt Informationen zur Kapazitätsreservierung an.

CapacityReservationInstanceView

Die Instanzansicht einer Kapazitätsreservierung, die als Momentaufnahme der Laufzeiteigenschaften der Kapazitätsreservierung bereitgestellt wird, die von der Plattform verwaltet wird, und kann sich außerhalb der Steuerungsebenenvorgänge ändern.

CapacityReservationInstanceViewTypes
CapacityReservationStateInfo

Details zum aktuellen Zustand einer zukünftigen Kapazitätsreservierung.

CapacityReservationUtilization

Stellt die Kapazitätsreservierungsauslastung in Bezug auf zugeordnete Ressourcen dar.

CloudError

Eine Fehlerantwort vom Compute-Dienst.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

InnerError

Innere Fehlerdetails.

InstanceViewStatus

Instanzansichtsstatus.

ReservationState

Der aktuelle Stand einer Future-Kapazitätsreservierung.

ScheduleProfile

Legt den Zeitplan für Block- und Future-Kapazitätsreservierungen fest. Gibt den Zeitplan an, während dessen die Kapazitätsreservierung aktiv ist und eine VM oder VMSS-Ressource mithilfe der Reservierung zugeordnet werden kann. Für Blockkapazitätsreservierungen sind die Felder scheduleProfile, Start und End nach der Erstellung unveränderlich. Weitere Informationen finden Sie unter https://aka.ms/blockcapacityreservation. Mindest-API-Version für Blockkapazitätsreservierungen: 01.04.2025. Zukünftige Kapazitätsreservierungen müssen diese Eigenschaft nur mit einer Startzeit nutzen, die bis zur 'modifiableUntil'-Zeit geändert werden kann. Weitere Informationen finden Sie unter https://aka.ms/futurecapacityreservation. Mindest-API-Version für zukünftige Kapazitätsreservierungen: 01.04.2026.

Sku

Beschreibt eine VM-Skalierungssatz-SKU. HINWEIS: Wenn die neue VM-SKU auf der Hardware, auf der der Skalierungssatz derzeit installiert ist, nicht unterstützt wird, müssen Sie die virtuellen Computer im Skalierungssatz umstellen, bevor Sie den SKU-Namen ändern.

StatusLevelTypes

Der Ebenencode.

SubResourceReadOnly
systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

ApiError

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

ApiErrorBase[]

Die Details zum API-Fehler

innererror

InnerError

Der innere API-Fehler

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

CapacityReservation

Gibt Informationen zur Kapazitätsreservierung an.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Der geografische Standort, an dem sich die Ressource befindet

name

string

Der Name der Ressource

properties.instanceView

CapacityReservationInstanceView

Die Ansicht der Kapazitätsreservierungsinstanz.

properties.platformFaultDomainCount

integer (int32)

Gibt den Wert der Fehlerdomänenanzahl an, die die Kapazitätsreservierung für die angeforderte VM-Größe unterstützt. Hinweis: Die für eine Ressource angegebene Fehlerdomänenanzahl (z. B. skalierungssatz virtueller Computer) muss kleiner oder gleich diesem Wert sein, wenn er mithilfe der Kapazitätsreservierung bereitgestellt wird. Mindest-API-Version: 2022-08-01.

properties.provisioningState

string

Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.

properties.provisioningTime

string (date-time)

Datum, zu dem die Kapazitätsreservierung zuletzt aktualisiert wurde.

properties.reservationId

string

Eine eindeutige ID, die von der Plattform generiert und der Kapazitätsreservierung zugewiesen wird, die sich während der gesamten Lebensdauer der Ressource nicht ändert.

properties.scheduleProfile

ScheduleProfile

Legt den Zeitplan für Block- und Future-Kapazitätsreservierungen fest. Gibt den Zeitplan an, während dessen die Kapazitätsreservierung aktiv ist und eine VM oder VMSS-Ressource mithilfe der Reservierung zugeordnet werden kann. Für Blockkapazitätsreservierungen sind die Felder scheduleProfile, Start und End nach der Erstellung unveränderlich. Weitere Informationen finden Sie unter https://aka.ms/blockcapacityreservation. Mindest-API-Version für Blockkapazitätsreservierungen: 01.04.2025. Zukünftige Kapazitätsreservierungen müssen diese Eigenschaft nur mit einer Startzeit nutzen, die bis zur 'modifiableUntil'-Zeit geändert werden kann. Weitere Informationen finden Sie unter https://aka.ms/futurecapacityreservation. Mindest-API-Version für zukünftige Kapazitätsreservierungen: 01.04.2026.

properties.timeCreated

string (date-time)

Gibt den Zeitpunkt an, zu dem die Kapazitätsreservierungsressource erstellt wurde. Mindest-API-Version: 2021-11-01.

properties.virtualMachinesAssociated

SubResourceReadOnly[]

Eine Liste aller RESSOURCEN-IDs des virtuellen Computers, die der Kapazitätsreservierung zugeordnet sind.

sku

Sku

SKU der Ressource, für die Kapazität reserviert werden muss. Der SKU-Name und die Kapazität müssen festgelegt werden. Für Blockkapazitätsreservierungen kann sku.capacity nur die Werte 1, 2, 4, 8, 16, 32, 64 akzeptieren. Derzeit werden VM-Skus mit der Funktion "CapacityReservationSupported" auf "true" festgelegt. Wenn "CapacityReservationSupported" auf "true" festgelegt ist, gibt die SKU-Funktion auch "SupportedCapacityReservationTypes" an, in dem die Typen von Kapazitätsreservierungen (z. B. "Targeting" oder "Block") aufgeführt sind, die von der SKU unterstützt werden. Informationen zu unterstützten Werten finden Sie unter "Auflisten von Microsoft.Compute-SKUs in einer Region (https://docs.microsoft.com/rest/api/compute/resourceskus/list).

systemData

systemData

Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.

tags

object

Ressourcenkennzeichnungen.

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

zones

string[]

Die Verfügbarkeitszonen.

CapacityReservationInstanceView

Die Instanzansicht einer Kapazitätsreservierung, die als Momentaufnahme der Laufzeiteigenschaften der Kapazitätsreservierung bereitgestellt wird, die von der Plattform verwaltet wird, und kann sich außerhalb der Steuerungsebenenvorgänge ändern.

Name Typ Beschreibung
reservationStateInfo

CapacityReservationStateInfo

Die Informationen zum Reservierungsstatus für eine Kapazitätsreservierung sind hauptsächlich für zukünftige Kapazitätsreservierungen bereitgestellt. Minimale API-Version: 01.04.2026.

statuses

InstanceViewStatus[]

Die Ressourcenstatusinformationen.

utilizationInfo

CapacityReservationUtilization

Nicht genutzte Kapazität der Kapazitätsreservierung.

CapacityReservationInstanceViewTypes

Wert Beschreibung
instanceView

CapacityReservationStateInfo

Details zum aktuellen Zustand einer zukünftigen Kapazitätsreservierung.

Name Typ Beschreibung
reservationState

ReservationState

Der aktuelle Stand der Kapazitätsreservierung.

CapacityReservationUtilization

Stellt die Kapazitätsreservierungsauslastung in Bezug auf zugeordnete Ressourcen dar.

Name Typ Beschreibung
currentCapacity

integer (int32)

Der Wert stellt die aktuelle Kapazität der VM-Größe bereit, die erfolgreich reserviert wurde und für die der Kunde in Rechnung gestellt wird. Mindest-API-Version: 2022-08-01.

usedReservedCountBySubscription

object

Für offene Kapazitätsreservierungen liefert dies eine Abbildung der Anzahl der genutzten reservierten Kapazitäten, die durch die Abonnement-ID (eine GUID), die die Kapazität verbraucht, verschlüsselt wird, d. h. jeder Eintrag ordnet eine verbrauchende Abonnement-ID der aktuell genutzten Kapazität zu. Diese wird nur für offene Kapazitätsreservierungen ausgefüllt und nicht für gezielte und Blockkapazitätsreservierungen gemeldet, die stattdessen die Zuweisung über virtualMachinesAlallocated melden. Minimale API-Version: 01.04.2026.

virtualMachinesAllocated

SubResourceReadOnly[]

Eine Liste aller ressourcen-IDs aller virtuellen Computer, die der Kapazitätsreservierung zugeordnet sind.

CloudError

Eine Fehlerantwort vom Compute-Dienst.

Name Typ Beschreibung
error

ApiError

API-Fehler.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
User
Application
ManagedIdentity
Key

InnerError

Innere Fehlerdetails.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder der Ausnahmedump.

exceptiontype

string

Der Ausnahmetyp.

InstanceViewStatus

Instanzansichtsstatus.

Name Typ Beschreibung
code

string

Der Statuscode.

displayStatus

string

Die kurze lokalisierbare Bezeichnung für den Status.

level

StatusLevelTypes

Der Ebenencode.

message

string

Die detaillierte Statusmeldung, einschließlich warnungen und Fehlermeldungen.

time

string (date-time)

Die Uhrzeit des Status.

ReservationState

Der aktuelle Stand einer Future-Kapazitätsreservierung.

Wert Beschreibung
Pending

Der Antrag auf Kapazitätsreservierung wurde eingereicht und wartet auf eine Bewertung.

Declined

Die Anfrage zur Kapazitätsreservierung wurde abgelehnt und wird ohne Nutzeraktion nicht erneut geändert.

Approved

Die Kapazitätsreservierungsanfrage wurde von Azure genehmigt und wartet auf ihre Erfüllung.

FulfillmentFailed

Beim Versuch, die Kapazitätsreservierungsanfrage zu erfüllen, trat ein Fehler auf.

Committed

Die Kapazitätsreservierung ist gesperrt und kann vor dem Start nicht aktualisiert oder gelöscht werden.

Live

Die Kapazitätsreservierung ist aktiv und kann verwendet werden und kann erst geändert oder gelöscht werden, wenn die Mindestverpflichtungsfrist abgelaufen ist.

PartiallyFulfilled

Azure konnte nur einen Teil der geforderten Kapazität liefern. Die Kapazitätsreservierung kann nicht geändert oder gelöscht werden, bis die Mindestverpflichtungsfrist abgelaufen ist. Der Anteil der erfüllten Kapazität kann durch die Inspektion der Kapazitätsreservierungs-Instanzansicht angezeigt werden, die in der Nutzungsinformation als currentCapacity angezeigt wird.

ScheduleProfile

Legt den Zeitplan für Block- und Future-Kapazitätsreservierungen fest. Gibt den Zeitplan an, während dessen die Kapazitätsreservierung aktiv ist und eine VM oder VMSS-Ressource mithilfe der Reservierung zugeordnet werden kann. Für Blockkapazitätsreservierungen sind die Felder scheduleProfile, Start und End nach der Erstellung unveränderlich. Weitere Informationen finden Sie unter https://aka.ms/blockcapacityreservation. Mindest-API-Version für Blockkapazitätsreservierungen: 01.04.2025. Zukünftige Kapazitätsreservierungen müssen diese Eigenschaft nur mit einer Startzeit nutzen, die bis zur 'modifiableUntil'-Zeit geändert werden kann. Weitere Informationen finden Sie unter https://aka.ms/futurecapacityreservation. Mindest-API-Version für zukünftige Kapazitätsreservierungen: 01.04.2026.

Name Typ Beschreibung
end

string

Das erforderliche Enddatum für Blockkapazitätsreservierungen. Muss nach dem Startdatum liegen, mit einer Dauer von entweder 1-14 ganzen Tagen oder 3-26 ganzen Wochen. Beispiel: 28.06.2025.

minimumCommitmentDays

integer (int32)

Die Mindestanzahl der Tage, die nach dem Startdatum vergehen müssen, bevor eine Future Capacity-Reservierung aktualisiert oder gelöscht werden kann, sobald sie festgelegt wurde. Wird mit einem Standardwert gefüllt, falls nicht angegeben.

modifiableUntil

string (date-time)

Das Datum/Uhrzeit, bis zu dem eine Reservierung für zukünftige Kapazitäten aktualisiert oder gelöscht werden kann. Schreibgeschützt

start

string

Das erforderliche Startdatum für Block- oder Future-Kapazitätsreservierungen. Blockkapazitätsreservierungen: Muss heute oder innerhalb von 56 Tagen erfolgen. Für die Planung am selben Tag müssen Anfragen vor 11:30 Uhr UTC eingereicht werden. Reservierungen für zukünftige Kapazitäten: Müssen mindestens 7 Tage in der Zukunft liegen und maximal 6 Monate in der Zukunft. Mindest-API-Version für zukünftige Kapazitätsreservierungen: 01.04.2026. Beispiel: 27.06.2025, gilt sowohl für Block- als auch für zukünftige Kapazitätsreservierungen.

Sku

Beschreibt eine VM-Skalierungssatz-SKU. HINWEIS: Wenn die neue VM-SKU auf der Hardware, auf der der Skalierungssatz derzeit installiert ist, nicht unterstützt wird, müssen Sie die virtuellen Computer im Skalierungssatz umstellen, bevor Sie den SKU-Namen ändern.

Name Typ Beschreibung
capacity

integer (int64)

Gibt die Anzahl der virtuellen Computer im Skalierungssatz an.

name

string

Der Sku-Name.

tier

string

Gibt die Ebene der virtuellen Computer in einem Skalierungssatz an.

Mögliche Werte:

Standard

Basic

StatusLevelTypes

Der Ebenencode.

Wert Beschreibung
Info
Warning
Error

SubResourceReadOnly

Name Typ Beschreibung
id

string

Ressourcen-ID

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Typ Beschreibung
createdAt

string (date-time)

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string (date-time)

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.