Partilhar via


APIs para automatização de reservas do Azure

Utilize as APIs do Azure para obter informações para a sua organização sobre as reservas de software ou serviço do Azure de forma programática.

Localizar planos de reservas para comprar

Utilize a API de Recomendação de reservas para obter recomendações sobre quais os planos de reservas a comprar com base na utilização da sua organização. Para obter mais informações, consulte Recomendações de reserva.

Também pode analisar a utilização de recursos com os Detalhes de Utilização da API de Consumo. Para obter mais informações, veja Usage Details - List For Billing Period By Billing Account (Detalhes de Utilização – Lista do Período de Faturação por Conta de Faturação). Os recursos do Azure que utiliza consistentemente são geralmente o melhor candidato para uma reserva.

Comprar uma reserva

Pode utilizar APIs REST para comprar reservas do Azure e planos de software de forma programática. Para saber mais, veja Reservation Order - Purchase API (Encomenda de Reservas – API de Compras).

Segue-se um exemplo de pedido para comprar com a API REST:

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

Corpo do pedido:

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

Também pode 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 for um cliente do Azure com um Enterprise Agreement (cliente EA), pode obter as reservas que a sua organização comprou utilizando a Lista de Transações de Reserva. Para outras subscrições, obtenha a lista de reservas que comprou e para as quais tem permissões de visualização com a API de Encomenda de Reserva – Lista. Por predefinição, o proprietário da conta ou a pessoa que comprou a reserva tem permissões para visualizar a reserva.

Ver utilização da reserva

Se for um cliente EA, poderá visualizar de forma programática a forma como as reservas na sua organização estão a ser utilizadas. Para obter mais informações, consulte Transações de reserva - Lista. Para outras subscrições, utilize a API de Resumos de Reservas – Lista por Encomenda de Reserva e Reserva.

Se observar que as reservas da sua organização estão a ser pouco utilizadas:

Conceder acesso às reservas

Obtenha a lista de todas as reservas às quais um utilizador tem acesso com a API Reserva – Operação – Lista. Para conceder acesso a uma reserva de forma programática, veja um dos seguintes artigos:

Dividir ou unir a reserva

Depois de comprar mais do que uma instância de recursos numa reserva, talvez queira atribuir instâncias nessa reserva a subscrições diferentes. Pode alterar o âmbito da reserva para que se aplique a todas as subscrições no mesmo contexto de faturação. Contudo, para fins de gestão de custo ou orçamento, talvez queira manter o âmbito como “subscrição individual” e atribuir instâncias de reserva a uma subscrição específica.

Para dividir uma reserva, utilize a API Reserva – Dividir. Também pode dividir uma reserva com o PowerShell. Para obter mais informações, veja Gerir reservas – Dividir a reserva em duas reservas.

Para unir duas reservas numa reserva, utilize a API Reserva – Unir.

Alterar o âmbito de uma reserva

O âmbito de uma reserva pode ser uma subscrição individual, um grupo de recursos individual ou todas as subscrições no seu contexto de faturação. Se definir o âmbito como uma subscrição individual ou grupo de recursos individual, será feita a correspondência da reserva para executar recursos na subscrição selecionada. Se eliminar ou mover a subscrição ou o grupo de recursos, a reserva não vai ser utilizada. Se definir o âmbito como partilhado, o Azure fará a correspondência da reserva com os recursos que são executados em todas as subscrições no contexto de faturação. O contexto de faturação depende da subscrição que utilizou para comprar a reserva. Pode selecionar o âmbito na compra ou alterá-lo em qualquer momento após a compra. Para obter mais informações, veja Gerir reservas – Alterar o âmbito.

Para alterar o âmbito de forma programática, utilize a API Reserva – Atualização.