Compartilhar via

Generate Reservation Details Report - By Billing Profile Id

  • Referência
Serviço:
Cost Management
Versão da API:
2023-11-01

Gera o relatório de detalhes de reservas para o intervalo de datas fornecido de forma assíncrona por perfil de cobrança. Os detalhes de uso da reserva podem ser exibidos 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=2023-11-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

Aceita. A solicitação será processada. Use o cabeçalho Local para marcar 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

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

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. Repita 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 do 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. Repita 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

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