Generate Reservation Details Report - By Billing Account Id

Serviço:

Cost Management

Versão da API:

2025-03-01

Gera o relatório de detalhes de reservas para o intervalo de datas fornecido de forma assíncrona com base na ID de inscrição. Os detalhes de uso da Reserva podem ser visualizados apenas por determinadas funções da empresa. Para mais detalhes sobre as funções, consulte: https://docs.microsoft.com/en-us/azure/cost-management-billing/manage/understand-ea-roles#usage-and-costs-access-by-role

POST https://management.azure.com/providers/microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?api-version=2025-03-01&startDate={startDate}&endDate={endDate}

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
billingAccountId	path	True	string	FaturaçãoID da conta
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.
endDate	query	True	string	Data de fim
startDate	query	True	string	Data de início

Respostas

Name	Tipo	Description
200 OK	OperationStatus	Operação do Azure concluída com êxito.
202 Accepted		Operação de recurso aceita. Cabeçalhos Location: string
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

ReservationDetails

Pedido de amostra

HTTP

POST https://management.azure.com/providers/microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/generateReservationDetailsReport?api-version=2025-03-01&startDate=2020-01-01&endDate=2020-01-30

Resposta da amostra

Código de estado:

200

{
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  },
  "status": "Completed"
}

Código de estado:

202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2019-11-01
Retry-After: 60

Definições

Name	Description
ErrorDetails	Os detalhes do erro.
ErrorResponse	A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro. \n\nAlgumas respostas de erro: \n\n * 429 TooManyRequests - O pedido é limitado. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after". \n\n * 503 ServiçoNão disponível - Serviço temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".
OperationStatus	O status da operação de longa duração.
OperationStatusType	Enum representa o estado de uma operação assíncrona.
ReservationReportSchema	O arquivo CSV do link de blob reportUrl consiste em dados de uso de reserva com o seguinte esquema com granularidade diária

ErrorDetails

Object

Os detalhes do erro.

Name	Tipo	Description
code	string	Código de erro.
message	string	Mensagem de erro indicando por que a operação falhou.

ErrorResponse

Object

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro. \n\nAlgumas respostas de erro: \n\n * 429 TooManyRequests - O pedido é limitado. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after". \n\n * 503 ServiçoNão disponível - Serviço temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".

Name	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

OperationStatus

Object

O status da operação de longa duração.

Name	Tipo	Description
properties.reportUrl	ReservationReportSchema	O arquivo CSV do link de blob reportUrl consiste em dados de uso de reserva com o seguinte esquema com granularidade diária
properties.validUntil	string (date-time)	O momento em que a URL do relatório se torna inválida.
status	OperationStatusType	O status da operação de longa duração.

OperationStatusType

Enumeração

Enum representa o estado de uma operação assíncrona.

Valor	Description
Running
Completed
Failed

ReservationReportSchema

Enumeração

O arquivo CSV do link de blob reportUrl consiste em dados de uso de reserva com o seguinte esquema com granularidade diária

Valor	Description
InstanceFlexibilityGroup
InstanceFlexibilityRatio
InstanceId
Kind
ReservationId
ReservationOrderId
ReservedHours
SkuName
TotalReservedQuantity
UsageDate
UsedHours