Reservation Transactions - List
Daftar transaksi untuk instans yang dipesan pada cakupan akun penagihan. Catatan: Transaksi pengembalian dana diposting bersama dengan transaksi pembeliannya (yaitu pada bulan penagihan pembelian). Misalnya, pengembalian dana diminta pada Mei 2021. Transaksi pengembalian dana ini akan memiliki tanggal peristiwa pada Mei 2021 tetapi bulan penagihan sebagai April 2020 ketika pembelian reservasi dilakukan. Catatan: ARM memiliki batas ukuran payload 12MB, sehingga saat ini pemanggil mendapatkan 400 ketika ukuran respons melebihi batas ARM. Dalam kasus seperti itu, panggilan API harus dilakukan dengan rentang tanggal yang lebih kecil.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions?api-version=2023-05-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions?$filter={$filter}&api-version=2023-05-01&useMarkupIfPartner={useMarkupIfPartner}&previewMarkupPercentage={previewMarkupPercentage}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
billing
|
path | True |
string |
BillingAccount ID |
api-version
|
query | True |
string |
Versi API yang akan digunakan dengan permintaan klien. Versi saat ini adalah 2023-03-01. |
$filter
|
query |
string |
Memfilter transaksi reservasi menurut rentang tanggal. Properti/EventDate untuk tanggal mulai dan tanggal selesai. Filter mendukung 'le' dan 'ge'. Catatan: API mengembalikan data untuk seluruh tanggal mulai dan bulan penagihan tanggal selesai. Misalnya, properti filter/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29 akan menyertakan data untuk seluruh bulan Desember 2020 (yaitu akan berisi rekaman untuk tanggal 30 dan 31 Desember) |
|
preview
|
query |
number decimal |
Pratinjau persentase markup yang akan diterapkan. |
|
use
|
query |
boolean |
Menerapkan mark up ke transaksi jika penelepon adalah mitra. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK. Permintaan telah berhasil. |
|
Other Status Codes |
Respons kesalahan yang menjelaskan mengapa operasi gagal. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nama | Deskripsi |
---|---|
user_impersonation | meniru akun pengguna Anda |
Contoh
ReservationTransactionsByEnrollmentNumber
Sample Request
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/reservationTransactions?$filter=properties/eventDate+ge+2020-05-20+AND+properties/eventDate+le+2020-05-30&api-version=2023-05-01&useMarkupIfPartner=True&previewMarkupPercentage=15.5
Sample Response
{
"value": [
{
"id": "/billingAccounts/123456/providers/Microsoft.Consumption/reservationtransactions/201909091919",
"name": "201909091919",
"type": "Microsoft.Consumption/reservationTransactions",
"tags": [],
"properties": {
"eventDate": "2019-09-09T19:19:04Z",
"reservationOrderId": "00000000-0000-0000-0000-000000000000",
"description": "Standard_DS1_v2 westus 1 Year",
"eventType": "Refund",
"quantity": 1,
"amount": -21,
"currency": "USD",
"reservationOrderName": "Transaction-DS1_v2",
"purchasingEnrollment": "123456",
"armSkuName": "Standard_DS1_v2",
"term": "P1Y",
"region": "westus",
"purchasingSubscriptionGuid": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
"purchasingSubscriptionName": "Infrastructure Subscription",
"accountName": "Microsoft Infrastructure",
"accountOwnerEmail": "admin@microsoft.com",
"departmentName": "Unassigned",
"costCenter": "",
"currentEnrollment": "123456",
"billingFrequency": "recurring",
"billingMonth": 20190901,
"monetaryCommitment": 523123.9,
"overage": 23234.49
}
},
{
"id": "/billingAccounts/123456/providers/Microsoft.Consumption/reservationtransactions/201909091919",
"name": "201909091919",
"type": "Microsoft.Consumption/reservationTransactions",
"tags": [],
"properties": {
"eventDate": "2019-09-09T19:19:04Z",
"reservationOrderId": "00000000-0000-0000-0000-000000000000",
"description": "Standard_DS1_v2 westus 1 Year",
"eventType": "Purchase",
"quantity": 1,
"amount": 21,
"currency": "USD",
"reservationOrderName": "Transaction-DS1_v2",
"purchasingEnrollment": "123456",
"armSkuName": "Standard_DS1_v2",
"term": "P1Y",
"region": "westus",
"purchasingSubscriptionGuid": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
"purchasingSubscriptionName": "Infrastructure Subscription",
"accountName": "Microsoft Infrastructure",
"accountOwnerEmail": "admin@microsoft.com",
"departmentName": "Unassigned",
"costCenter": "",
"currentEnrollment": "123456",
"billingFrequency": "recurring",
"billingMonth": 20190901,
"monetaryCommitment": 523123.9,
"overage": 23234.49
}
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Error |
Detail kesalahan. |
Error |
Respons kesalahan menunjukkan bahwa layanan tidak dapat memproses permintaan masuk. Alasannya disediakan dalam pesan kesalahan. Beberapa respons Kesalahan:
|
Reservation |
Sumber daya transaksi reservasi. |
Reservation |
Hasil daftar rekomendasi reservasi. |
ErrorDetails
Detail kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Kode Kesalahan. |
message |
string |
Pesan kesalahan yang menunjukkan mengapa operasi gagal. |
ErrorResponse
Respons kesalahan menunjukkan bahwa layanan tidak dapat memproses permintaan masuk. Alasannya disediakan dalam pesan kesalahan.
Beberapa respons Kesalahan:
429 TooManyRequests - Permintaan dibatasi. Coba lagi setelah menunggu waktu yang ditentukan di header "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable - Layanan untuk sementara tidak tersedia. Coba lagi setelah menunggu selama waktu yang ditentukan di header "Coba Lagi Setelah".
Nama | Jenis | Deskripsi |
---|---|---|
error |
Detail kesalahan. |
ReservationTransaction
Sumber daya transaksi reservasi.
Nama | Jenis | Deskripsi |
---|---|---|
id |
string |
Id Sumber Daya. |
name |
string |
Nama sumber daya. |
properties.accountName |
string |
Nama akun yang melakukan transaksi. |
properties.accountOwnerEmail |
string |
Email pemilik akun yang melakukan transaksi. |
properties.amount |
number |
Biaya transaksi. |
properties.armSkuName |
string |
Ini adalah nama ARM Sku. Ini dapat digunakan untuk bergabung dengan bidang serviceType dalam info tambahan dalam rekaman penggunaan. |
properties.billingFrequency |
string |
Frekuensi penagihan, yang dapat berupa satu kali atau berulang. |
properties.billingMonth |
integer |
Bulan penagihan (yyyyMMdd), tempat acara dimulai. |
properties.costCenter |
string |
Pusat biaya departemen ini jika merupakan departemen dan pusat biaya disediakan. |
properties.currency |
string |
Mata uang ISO tempat transaksi ditagih, misalnya, USD. |
properties.currentEnrollment |
string |
Pendaftaran saat ini. |
properties.departmentName |
string |
Nama departemen. |
properties.description |
string |
Deskripsi transaksi. |
properties.eventDate |
string |
Tanggal transaksi |
properties.eventType |
string |
Jenis transaksi (Pembelian, Pembatalan, atau Pengembalian Dana). |
properties.monetaryCommitment |
number |
Jumlah komitmen moneter pada cakupan pendaftaran. |
properties.overage |
number |
Jumlah kelebihan penggunaan pada cakupan pendaftaran. |
properties.purchasingEnrollment |
string |
Pendaftaran pembelian. |
properties.purchasingSubscriptionGuid |
string |
Panduan langganan yang melakukan transaksi. |
properties.purchasingSubscriptionName |
string |
Nama langganan yang membuat transaksi. |
properties.quantity |
number |
Kuantitas transaksi. |
properties.region |
string |
Wilayah transaksi. |
properties.reservationOrderId |
string |
ID pesanan reservasi adalah pengidentifikasi untuk pembelian reservasi. Setiap ID pesanan reservasi mewakili satu transaksi pembelian. Pesanan reservasi berisi reservasi. Pesanan reservasi menentukan ukuran dan wilayah VM untuk reservasi. |
properties.reservationOrderName |
string |
Nama pesanan reservasi. |
properties.term |
string |
Ini adalah jangka waktu transaksi. |
tags |
string[] |
Tag sumber daya. |
type |
string |
Jenis sumber daya |
ReservationTransactionsListResult
Hasil daftar rekomendasi reservasi.
Nama | Jenis | Deskripsi |
---|---|---|
nextLink |
string |
Tautan (url) ke halaman hasil berikutnya. |
value |
Daftar rekomendasi reservasi. |