Compartir vía

API para la automatización de reservas de Azure

  • Artículo

Use las API de Azure para obtener información mediante programación para su organización sobre el servicio de Azure o las reservas de software.

Busque planes de reserva para comprar

Use la API de recomendación de reservas para obtener recomendaciones sobre qué plan de reservas puede comprar según el uso de su organización. Para más información, consulte el artículo en el que se indica cómo obtener recomendaciones de reserva.

También puede analizar el uso de sus recursos mediante el detalle de uso de la API de consumo. Para obtener más información, consulte Usage Details - List For Billing Period By Billing Account (Detalles de uso: lista para el período de facturación en función de la cuenta de facturación). Los recursos de Azure que usa de forma sistemática suelen ser los mejores candidatos para realizar una reserva.

Adquisición de una reserva

Puede comprar reservas de Azure y planes de software mediante programación con las API REST. Para obtener más información, consulte API para pedido de reserva: compra.

A continuación se muestra una solicitud de ejemplo para comprar mediante una API REST:

PUT https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/<GUID>?api-version=2019-04-01

Cuerpo de la solicitud:

{
 "sku": {
    "name": "standard_D1"
  },
 "location": "westus",
 "properties": {
    "reservedResourceType": "VirtualMachines",
    "billingScopeId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "term": "P1Y",
    "quantity": "1",
    "displayName": "TestReservationOrder",
    "appliedScopes": null,
    "appliedScopeType": "Shared",
    "reservedResourceProperties": {
      "instanceFlexibility": "On"
    }
  }
}

También puede comprar una reserva en Azure Portal. Para más información, consulte los siguientes artículos.

Planes de servicio:

Planes de software:

Obtener reservas

Los clientes de Azure con Contrato Enterprise (cliente de EA), pueden obtener las reservas que compró su organización mediante Transacciones de reservas: Lista. Para otras suscripciones, obtenga la lista de reservas que compró y los permisos para verlas mediante la API Reservation Order - List. De forma predeterminada, el propietario de la cuenta o la persona que compró la reserva tiene permisos para verla.

Ver el uso de las reservas

Si es un cliente con contrato Enterprise, puede ver mediante programación cómo se usan las reservas en su organización. Para más información, consulte el artículo sobre Transacciones de reservas: Lista. Para otras suscripciones, use la API Reservations Summaries - List By Reservation Order And Reservation.

Si ve que las reservas de su organización están siendo usadas por debajo de su capacidad:

Dar acceso a las reservas

Obtenga la lista de todas las reservas a las que un usuario tiene acceso mediante Reservation - Operation - List API. Para dar acceso a una reserva mediante programación, consulte uno de los siguientes artículos:

Dividir o combinar una reserva

Si se compran varias instancias de recursos en una reserva, se pueden asignar algunas de las instancias de la reserva a distintas suscripciones. Puede cambiar el ámbito de la reserva para que se aplique a todas las suscripciones dentro del mismo contexto de facturación. Pero si quiere usarla para fines de administración de costos o para presupuestos, le recomendamos que mantenga el ámbito como "suscripción única" y que asigne instancias de reserva a una suscripción específica.

Para dividir una reserva, use la API Reservation - Split. También puede dividir una reserva mediante PowerShell. Para obtener más información, consulte Administrar reservas: división de una reserva única en dos.

Para combinar dos reservas en una reserva, use la API Reservation - Merge.

Cambiar el ámbito de una reserva

El ámbito de una reserva puede ser una suscripción única, un grupo de recursos único o todas las suscripciones del contexto de facturación. Si establece que el ámbito es una suscripción única o un grupo de recursos único, la reserva se corresponderá con los recursos que se ejecuten en la suscripción seleccionada. Si elimina o mueve la suscripción o el grupo de recursos, no se usará la reserva. Si establece que el ámbito es compartido, Azure asociará la reserva con los recursos que se ejecuten en todas las suscripciones dentro del contexto de facturación. El contexto de facturación depende de la suscripción que se usó para comprar la reserva. Puede seleccionar el ámbito en la compra o cambiarlo en cualquier momento después de la misma. Para obtener más información, consulte Administrar reservas: cambio del ámbito.

Para cambiar el ámbito mediante programación, use la API Reservation - Update.

Contenido relacionado