Generate Reservation Details Report - By Billing Profile Id

Serviço:

Cost Management

Versão da API:

2024-08-01

Gera o relatório de detalhes de reservas para o intervalo de datas fornecido de forma assíncrona pelo perfil de cobrança. Os detalhes de uso da Reserva podem ser exibidos apenas por determinadas funções empresariais por padrão. Para obter mais detalhes sobre as funções, consulte https://docs.microsoft.com/en-us/azure/cost-management-billing/reservations/reservation-utilization#view-utilization-in-the-azure-portal-with-azure-rbac-access

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2024-08-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
billingAccountId	path	True	string	ID da conta de cobrança
billingProfileId	path	True	string	ID do perfil de cobrança.
api-version	query	True	string	A versão da API a ser usada para esta operação.
endDate	query	True	string	Data de Término
startDate	query	True	string	Data de Início

Respostas

Nome	Tipo	Description
200 OK	OperationStatus	Processamento de solicitação concluído.
202 Accepted		Aceitado. A solicitação será processada. Use o cabeçalho Local para verificar o status. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

ReservationDetails

Solicitação de exemplo

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000/billingProfiles/CZSFR-SDFXC-DSDF/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate=2020-01-01&endDate=2020-01-30&api-version=2024-08-01

Resposta de exemplo

Código de status:

202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000/billingProfiles/CZSFR-SDFXC-DSDF/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2019-11-01
Retry-After: 60

Código de status:

200

{
  "status": "Completed",
  "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"
  }
}

Definições

Nome	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. Algumas respostas de erro: 429 TooManyRequests – A solicitação é limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable – O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".
OperationStatus	O status da operação de execução prolongada.
OperationStatusType	O status da operação de execução prolongada.
ReservationReportSchema	O arquivo CSV do link de blob reportUrl consiste em dados de uso de reserva com o esquema a seguir na granularidade diária

ErrorDetails

Os detalhes do erro.

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

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.

Algumas respostas de erro:

• 429 TooManyRequests – A solicitação é limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiceUnavailable – O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".

Nome	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

OperationStatus

O status da operação de execução prolongada.

Nome	Tipo	Description
properties.reportUrl	ReservationReportSchema	O arquivo CSV do link de blob reportUrl consiste em dados de uso de reserva com o esquema a seguir na granularidade diária
properties.validUntil	string	O momento em que a URL do relatório se torna inválida.
status	OperationStatusType	O status da operação de execução prolongada.

OperationStatusType

O status da operação de execução prolongada.

Nome	Tipo	Description
Completed	string
Failed	string
Running	string

ReservationReportSchema

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

Nome	Tipo	Description
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string