Capacity Reservations - Get

Servicio:: Compute

Versión de la API:: 2026-03-01

Operación que recupera información sobre la reserva de capacidad.

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

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
capacityReservationGroupName	path	True	string	Nombre del grupo de reserva de capacidad.
capacityReservationName	path	True	string	Nombre de la reserva de capacidad.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.
$expand	query		CapacityReservationInstanceViewTypes	Expresión expand que se va a aplicar en la operación. "InstanceView" recupera una instantánea de las propiedades en tiempo de ejecución de la reserva de capacidad administrada por la plataforma y puede cambiar fuera de las operaciones del plano de control.

Respuestas

Nombre	Tipo	Description
200 OK	CapacityReservation	La operación de Azure se completó correctamente.
Other Status Codes	CloudError	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar su cuenta de usuario

Ejemplos

Get a block capacity reservation.

Get a capacity reservation.

Get a targeted capacity reservation.

Get a block capacity reservation.

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python block_capacity_reservation_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.capacity_reservations.get(
        resource_group_name="myResourceGroup",
        capacity_reservation_group_name="blockCapacityReservationGroup",
        capacity_reservation_name="blockCapacityReservation",
    )
    print(response)


# x-ms-original-file: 2026-03-01/capacityReservationExamples/BlockCapacityReservation_Get.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:: 200

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

Solicitud de ejemplo

HTTP
Python

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python capacity_reservation_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.capacity_reservations.get(
        resource_group_name="myResourceGroup",
        capacity_reservation_group_name="myCapacityReservationGroup",
        capacity_reservation_name="myCapacityReservation",
    )
    print(response)


# x-ms-original-file: 2026-03-01/capacityReservationExamples/CapacityReservation_Get.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:: 200

{
  "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 targeted capacity reservation.

Solicitud de ejemplo

HTTP
Python

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python targeted_capacity_reservation_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.capacity_reservations.get(
        resource_group_name="myResourceGroup",
        capacity_reservation_group_name="targetedCapacityReservationGroup",
        capacity_reservation_name="targetedCapacityReservation",
    )
    print(response)


# x-ms-original-file: 2026-03-01/capacityReservationExamples/TargetedCapacityReservation_Get.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:: 200

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

Definiciones

Nombre	Description
ApiError	Error de API.
ApiErrorBase	Base de errores de api.
CapacityReservation	Especifica información sobre la reserva de capacidad.
CapacityReservationInstanceView	Vista de instancia de una reserva de capacidad que proporciona como instantánea de las propiedades en tiempo de ejecución de la reserva de capacidad administrada por la plataforma y puede cambiar fuera de las operaciones del plano de control.
CapacityReservationInstanceViewTypes
CapacityReservationUtilization	Representa el uso de la reserva de capacidad en términos de recursos asignados.
CloudError	Respuesta de error del servicio Compute.
createdByType	Tipo de identidad que creó el recurso.
InnerError	Detalles del error interno.
InstanceViewStatus	Estado de la vista de instancia.
ScheduleProfile	Define la programación de las reservas de capacidad de tipo bloque. Especifica la programación durante la cual la reserva de capacidad está activa y la máquina virtual o el recurso VMSS se pueden asignar mediante la reserva. Esta propiedad es necesaria y solo se admite cuando el tipo de grupo de reserva de capacidad es "Bloquear". Los campos scheduleProfile, start y end son inmutables después de la creación. Versión mínima de la API: 2025-04-01. Consulte https://aka.ms/blockcapacityreservation para obtener más información.
Sku	Describe una SKU del conjunto de escalado de máquinas virtuales. NOTA: Si la nueva SKU de máquina virtual no se admite en el hardware en el que se encuentra actualmente el conjunto de escalado, debe desasignar las máquinas virtuales del conjunto de escalado antes de modificar el nombre de la SKU.
StatusLevelTypes	Código de nivel.
SubResourceReadOnly
systemData	Metadatos relativos a la creación y última modificación del recurso.

ApiError

Objeto

Error de API.

Nombre	Tipo	Description
code	string	Código de error.
details	ApiErrorBase[]	Detalles del error de api
innererror	InnerError	Error interno de api
message	string	El mensaje de error.
target	string	Destino del error concreto.

ApiErrorBase

Objeto

Base de errores de api.

Nombre	Tipo	Description
code	string	Código de error.
message	string	El mensaje de error.
target	string	Destino del error concreto.

CapacityReservation

Objeto

Especifica información sobre la reserva de capacidad.

Nombre	Tipo	Description
id	string	Identificador completamente cualificado del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso.
properties.instanceView	CapacityReservationInstanceView	Vista de instancia de reserva de capacidad.
properties.platformFaultDomainCount	integer (int32)	Especifica el valor del recuento de dominios de error que admite la reserva de capacidad para el tamaño de máquina virtual solicitado. Nota: El recuento de dominios de error especificado para un recurso (como el conjunto de escalado de máquinas virtuales) debe ser menor o igual que este valor si se implementa mediante la reserva de capacidad. Versión mínima de api: 2022-08-01.
properties.provisioningState	string	Estado de aprovisionamiento, que solo aparece en la respuesta.
properties.provisioningTime	string (date-time)	Fecha y hora en que se actualizó por última vez la reserva de capacidad.
properties.reservationId	string	Identificador único generado y asignado a la reserva de capacidad por la plataforma que no cambia durante toda la vigencia del recurso.
properties.scheduleProfile	ScheduleProfile	Define la programación de las reservas de capacidad de tipo bloque. Especifica la programación durante la cual la reserva de capacidad está activa y la máquina virtual o el recurso VMSS se pueden asignar mediante la reserva. Esta propiedad es necesaria y solo se admite cuando el tipo de grupo de reserva de capacidad es "Bloquear". Los campos scheduleProfile, start y end son inmutables después de la creación. Versión mínima de la API: 2025-04-01. Consulte https://aka.ms/blockcapacityreservation para obtener más información.
properties.timeCreated	string (date-time)	Especifica la hora en la que se creó el recurso de reserva de capacidad. Versión mínima de api: 2021-11-01.
properties.virtualMachinesAssociated	SubResourceReadOnly[]	Lista de todos los identificadores de recursos de máquina virtual asociados a la reserva de capacidad.
sku	Sku	SKU del recurso para el que se debe reservar la capacidad. Es necesario establecer el nombre y la capacidad de la SKU. Para las reservas de capacidad de bloque, sku.capacity solo puede aceptar los valores 1, 2, 4, 8, 16, 32, 64. Actualmente, se admiten las Sku de máquina virtual con la funcionalidad "CapacityReservationSupported" establecida en true. Cuando "CapacityReservationSupported" es true, la funcionalidad de SKU también especifica "SupportedCapacityReservationTypes", que enumera los tipos de reservas de capacidad (como Targeted o Block) que admite la SKU. Consulte Lista de SKU de Microsoft.Compute en una región (https://docs.microsoft.com/rest/api/compute/resourceskus/list) para conocer los valores admitidos.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"
zones	string[]	Zonas de disponibilidad.

CapacityReservationInstanceView

Objeto

Vista de instancia de una reserva de capacidad que proporciona como instantánea de las propiedades en tiempo de ejecución de la reserva de capacidad administrada por la plataforma y puede cambiar fuera de las operaciones del plano de control.

Nombre	Tipo	Description
statuses	InstanceViewStatus[]	Información de estado del recurso.
utilizationInfo	CapacityReservationUtilization	Capacidad no utilizada de la reserva de capacidad.

CapacityReservationInstanceViewTypes

Enumeración

Valor	Description
instanceView

CapacityReservationUtilization

Objeto

Representa el uso de la reserva de capacidad en términos de recursos asignados.

Nombre	Tipo	Description
currentCapacity	integer (int32)	El valor proporciona la capacidad actual del tamaño de la máquina virtual que se reservó correctamente y para el que se factura al cliente. Versión mínima de api: 2022-08-01.
virtualMachinesAllocated	SubResourceReadOnly[]	Lista de todos los identificadores de recursos de máquinas virtuales asignados a la reserva de capacidad.

CloudError

Objeto

Respuesta de error del servicio Compute.

Nombre	Tipo	Description
error	ApiError	Error de API.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

InnerError

Objeto

Detalles del error interno.

Nombre	Tipo	Description
errordetail	string	Mensaje de error interno o volcado de memoria de excepciones.
exceptiontype	string	Tipo de la excepción.

InstanceViewStatus

Objeto

Estado de la vista de instancia.

Nombre	Tipo	Description
code	string	Código de estado.
displayStatus	string	Etiqueta localizable corta para el estado.
level	StatusLevelTypes	Código de nivel.
message	string	Mensaje de estado detallado, incluido para alertas y mensajes de error.
time	string (date-time)	Hora del estado.

ScheduleProfile

Objeto

Define la programación de las reservas de capacidad de tipo bloque. Especifica la programación durante la cual la reserva de capacidad está activa y la máquina virtual o el recurso VMSS se pueden asignar mediante la reserva. Esta propiedad es necesaria y solo se admite cuando el tipo de grupo de reserva de capacidad es "Bloquear". Los campos scheduleProfile, start y end son inmutables después de la creación. Versión mínima de la API: 2025-04-01. Consulte https://aka.ms/blockcapacityreservation para obtener más información.

Nombre	Tipo	Description
end	string	La fecha de finalización requerida para las reservas de capacidad de bloque. Debe ser posterior a la fecha de inicio, con una duración de 1 a 14 días completos o de 3 a 26 semanas completas. Ejemplo: 2025-06-28.
start	string	La fecha de inicio requerida para las reservas de capacidad de bloque. Debe ser hoy o dentro de los 56 días en el futuro. Para la programación en el mismo día, las solicitudes deben enviarse antes de las 11:30 a. m. UTC. Ejemplo: 2025-06-27.

Sku

Objeto

Describe una SKU del conjunto de escalado de máquinas virtuales. NOTA: Si la nueva SKU de máquina virtual no se admite en el hardware en el que se encuentra actualmente el conjunto de escalado, debe desasignar las máquinas virtuales del conjunto de escalado antes de modificar el nombre de la SKU.

Nombre	Tipo	Description
capacity	integer (int64)	Especifica el número de máquinas virtuales del conjunto de escalado.
name	string	El nombre de la SKU.
tier	string	Especifica el nivel de máquinas virtuales de un conjunto de escalado. Valores posibles: Standard Basic

StatusLevelTypes

Enumeración

Código de nivel.

Valor	Description
Info
Warning
Error

SubResourceReadOnly

Objeto

Nombre	Tipo	Description
id	string	Identificador de recurso

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	La identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	La identidad que modificó el recurso por última vez.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.