Generate Reservation Details Report - By Billing Profile Id

Service:

Cost Management

API Version:

2023-11-01

Gera o relatório de detalhes de reservas para o intervalo de datas fornecido de forma assíncrona pelo perfil de faturação. Os detalhes de utilização da Reserva só podem ser visualizados por determinadas funções empresariais por predefinição. Para obter mais detalhes sobre as funções, veja, 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=2023-11-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 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	Processamento de pedidos concluído.
202 Accepted		Aceite. O pedido será processado. Utilize o cabeçalho Localização para verificar o estado. Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

ReservationDetails

Sample Request

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=2023-11-01

Sample Response

Status code:

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

Status code:

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 consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro. Algumas Respostas de erro: 429 TooManyRequests – o pedido é limitado. Repita 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 após aguardar durante o tempo especificado no cabeçalho “Tentar novamente após”.
OperationStatus	O estado da operação de execução prolongada.
OperationStatusType	O estado da operação de execução prolongada.
ReservationReportSchema	O ficheiro CSV da ligação do blob reportUrl consiste em dados de utilização de reservas com o seguinte esquema na granularidade diária

ErrorDetails

Os detalhes do erro.

Name	Tipo	Description
code	string	Código de erro.
message	string	Mensagem de erro a indicar o motivo pela qual a operação falhou.

ErrorResponse

A resposta de erro indica que o serviço não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro.

Algumas Respostas de erro:

• 429 TooManyRequests – o pedido é limitado. Repita 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 após aguardar durante o tempo especificado no cabeçalho “Tentar novamente após”.

Name	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

OperationStatus

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

Name	Tipo	Description
properties.reportUrl	ReservationReportSchema	O ficheiro CSV da ligação do blob reportUrl consiste em dados de utilização de reservas com o seguinte esquema na granularidade diária
properties.validUntil	string	O momento em que o URL do relatório se torna inválido.
status	OperationStatusType	O estado da operação de execução prolongada.

OperationStatusType

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

Name	Tipo	Description
Completed	string
Failed	string
Running	string

ReservationReportSchema

O ficheiro CSV da ligação do blob reportUrl consiste em dados de utilização de reservas com o seguinte esquema na 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