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 por perfil de faturamento. Os detalhes de uso da Reserva podem ser visualizados apenas por determinadas funções corporativas 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 do URI

Name	Em	Necessário	Tipo	Description
billingAccountId	path	True	string	ID da conta de faturação
billingProfileId	path	True	string	ID do perfil de faturação.
api-version	query	True	string	A versão da API a ser usada 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	Processamento do pedido concluído.
202 Accepted		Aceito. O pedido será processado. Use o cabeçalho Localização para verificar o status. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Resposta de erro descrevendo por que a operação falhou.

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/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 da amostra

Código de estado:

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 estado:

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

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. Algumas respostas de erro: 429 TooManyRequests - A solicitação está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiçoIndisponível - 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 longa duração.
OperationStatusType	O status da operação de longa duração.
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

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

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 está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiçoIndisponível - O serviço está 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

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	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

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

Name	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 seguinte esquema com granularidade diária

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