APIs para a automação de reserva do Azure

  • Artigo

Use as APIs do Azure para obter programaticamente informações para sua organização sobre reservas de software ou serviço do Azure.

Localizar os planos de reserva para comprar

Use a API de recomendação de Reserva para obter recomendações sobre quais reservas você planeja comprar com base no uso da sua organização. Para obter mais informações, confira Recomendações de reserva.

Você também pode analisar o uso de recursos usando os Detalhes de Uso de API de Consumo. Para obter mais informações, confira Detalhes de uso – lista para período de cobrança por conta de cobrança. Os recursos do Azure que você usa consistentemente geralmente são os melhores candidatos para uma reserva.

Comprar uma reserva

É possível comprar planos de software e reservas do Azure programaticamente usando APIs REST. Para obter mais informações, confira Pedido de Reserva – API de Compra.

Veja um exemplo de solicitação para comprar usando a API REST:

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

Corpo da solicitação:

{
 "sku": {
    "name": "standard_D1"
  },
 "location": "westus",
 "properties": {
    "reservedResourceType": "VirtualMachines",
    "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
    "term": "P1Y",
    "quantity": "1",
    "displayName": "TestReservationOrder",
    "appliedScopes": null,
    "appliedScopeType": "Shared",
    "reservedResourceProperties": {
      "instanceFlexibility": "On"
    }
  }
}

Também é possível comprar uma reserva no portal do Azure. Para obter mais informações, consulte os seguintes artigos:

Planos de serviço:

Planos de software:

Obter reservas

Se você é cliente do Azure com um Contrato Enterprise (cliente EA), obtenha as reservas que a organização comprou usando Transações de reserva – Listar. Para outras assinaturas, obtenha a lista de reservas que você comprou e tem permissões para exibir usando a API Pedido de Reserva – Lista. Por padrão, o proprietário da conta ou a pessoa que comprou a reserva tem permissões para exibir a reserva.

Confira o uso de reserva

Se você for um cliente EA, poderá exibir programaticamente como as reservas em sua organização estão sendo usadas. Para obter mais informações, confira Transações de reserva – Listar. Para outras assinaturas, use a API Resumos de reservas – lista por reserva e ordem de reserva.

Se você descobrir que as reservas de sua organização estiverem sendo subutilizadas:

Dar acesso às reservas

Obtenha a lista de todas as reservas às quais um usuário tem acesso usando a API Reserva – Operação – Lista. Para conceder acesso a uma reserva de modo programático, leia um dos seguintes artigos:

Dividir ou mesclar reserva

Depois de comprar mais de uma instância de recurso em uma reserva, é recomendável atribuir instâncias nessa reserva a assinaturas diferentes. Você pode alterar o escopo da reserva de modo que ela se aplique a todas as assinaturas no mesmo contexto de cobrança. Porém, para fins de gerenciamento de custos ou orçamento, você talvez queira manter o escopo como "assinatura única" e atribuir as instâncias de reserva a uma assinatura específica.

Para dividir uma reserva, use a API Reserva – Dividir. Você também pode dividir uma reserva usando o PowerShell. Para obter mais informações, confira Gerenciar reservas – dividir reserva em duas reservas.

Para mesclar duas reservas em uma reserva, use a API Reserva – Mesclagem.

Alterar o escopo de uma reserva

O escopo de uma reserva pode ser a assinatura única, grupo de recursos único ou todas as assinaturas de seu contexto de cobrança. Se você definir o escopo como assinatura única ou grupo de recursos único, a reserva será correspondida aos recursos em execução na assinatura selecionada. Se você excluir ou mover a assinatura ou o grupo de recursos, a reserva não será utilizada. Se você definir o escopo compartilhado, o Azure corresponderá a reserva de recursos que são executados em todas as assinaturas no contexto de cobrança. O contexto de cobrança depende da assinatura usada para comprar a reserva. É possível selecionar o escopo na compra ou alterá-lo a qualquer momento após a compra. Para obter mais informações, confira Gerenciar Reservas – Alterar o escopo.

Para alterar o escopo de modo programático, use a API Reserva – Atualização.

Conteúdo relacionado