Generate Reservation Details Report - By Billing Account Id

Layanan:

Cost Management

Versi API:

2025-03-01

Menghasilkan laporan detail reservasi untuk rentang tanggal yang disediakan secara asinkron berdasarkan id pendaftaran. Detail penggunaan Reservasi hanya dapat dilihat oleh peran perusahaan tertentu. Untuk detail selengkapnya tentang peran, lihat, 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}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
billingAccountId	path	True	string	PenagihanID Akun
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
endDate	query	True	string	Tanggal Selesai
startDate	query	True	string	Tanggal Mulai

Respons

Nama	Jenis	Deskripsi
200 OK	OperationStatus	Operasi Azure berhasil diselesaikan.
202 Accepted		Operasi sumber daya diterima. Header Location: string
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

ReservationDetails

Permintaan sampel

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

Respon sampel

Kode status:

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

Kode status:

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

Definisi

Nama	Deskripsi
ErrorDetails	Detail kesalahan.
ErrorResponse	Respons kesalahan menunjukkan bahwa layanan tidak dapat memproses permintaan masuk. Alasannya disediakan dalam pesan kesalahan. \n\nBeberapa respons Kesalahan: \n\n * 429 TooManyRequests - Permintaan dibatasi. Coba lagi setelah menunggu waktu yang ditentukan dalam header "x-ms-ratelimit-microsoft.consumption-retry-after". \n\n * 503 ServiceUnavailable - Layanan tidak tersedia untuk sementara. Coba lagi setelah menunggu waktu yang ditentukan di header "Coba Lagi-Setelah".
OperationStatus	Status operasi jangka panjang.
OperationStatusType	Enum mewakili status operasi asinkron.
ReservationReportSchema	File CSV dari tautan blob reportUrl terdiri dari data penggunaan reservasi dengan skema berikut pada granularitas harian

ErrorDetails

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan.
message	string	Pesan kesalahan yang menunjukkan mengapa operasi gagal.

ErrorResponse

Objek

Respons kesalahan menunjukkan bahwa layanan tidak dapat memproses permintaan masuk. Alasannya disediakan dalam pesan kesalahan. \n\nBeberapa respons Kesalahan: \n\n * 429 TooManyRequests - Permintaan dibatasi. Coba lagi setelah menunggu waktu yang ditentukan dalam header "x-ms-ratelimit-microsoft.consumption-retry-after". \n\n * 503 ServiceUnavailable - Layanan tidak tersedia untuk sementara. Coba lagi setelah menunggu waktu yang ditentukan di header "Coba Lagi-Setelah".

Nama	Jenis	Deskripsi
error	ErrorDetails	Detail kesalahan.

OperationStatus

Objek

Status operasi jangka panjang.

Nama	Jenis	Deskripsi
properties.reportUrl	ReservationReportSchema	File CSV dari tautan blob reportUrl terdiri dari data penggunaan reservasi dengan skema berikut pada granularitas harian
properties.validUntil	string (date-time)	Waktu di mana URL laporan menjadi tidak valid.
status	OperationStatusType	Status operasi jangka panjang.

OperationStatusType

Enumerasi

Enum mewakili status operasi asinkron.

Nilai	Deskripsi
Running
Completed
Failed

ReservationReportSchema

Enumerasi

File CSV dari tautan blob reportUrl terdiri dari data penggunaan reservasi dengan skema berikut pada granularitas harian

Nilai	Deskripsi
InstanceFlexibilityGroup
InstanceFlexibilityRatio
InstanceId
Kind
ReservationId
ReservationOrderId
ReservedHours
SkuName
TotalReservedQuantity
UsageDate
UsedHours