Migrasi dari Enterprise Agreement ke Microsoft Customer Agreement APIs
Artikel ini membantu Anda memahami struktur data, API, dan perbedaan integrasi sistem lainnya antara akun Perjanjian Perusahaan (EA) dan Perjanjian Pelanggan Microsoft (MCA). Cost Management mendukung API untuk kedua jenis akun. Tinjau artikel Penyiapan akun penagihan untuk Perjanjian Pelanggan Microsoft sebelum melanjutkan.
Organisasi dengan akun EA yang ada harus meninjau artikel ini bersamaan dengan menyiapkan akun MCA. Sebelumnya, memperbarui akun EA memerlukan beberapa pekerjaan minimal untuk berpindah dari pendaftaran lama ke yang baru. Namun, melakukan migrasi ke akun MCA membutuhkan upaya tambahan. Upaya tambahan adalah karena perubahan dalam subsistem penagihan yang mendasarinya, yang memengaruhi semua API dan penawaran layanan terkait biaya.
API MCA dan integrasi
API MCA dan integrasi baru memungkinkan Anda:
- Memiliki ketersediaan API yang lengkap melalui API Azure asli.
- Mengonfigurasi beberapa faktur dalam satu akun penagihan.
- Mengakses API gabungan dengan penggunaan layanan Azure, penggunaan Marketplace pihak ketiga, dan pembelian Marketplace.
- Melihat biaya di seluruh profil penagihan (sama dengan pendaftaran) menggunakan Azure Cost Management.
- Akses API baru untuk menampilkan biaya, mendapatkan pemberitahuan ketika biaya melebihi ambang batas yang telah ditentukan, dan mengekspor data mentah secara otomatis.
Daftar periksa migrasi
Item berikut ini membantu Anda beralih ke API MCA.
- Biasakan diri Anda dengan akun penagihan Perjanjian Pelanggan Microsoft yang baru.
- Tentukan API mana yang Anda gunakan dan lihat API mana yang diganti di bagian berikut.
- Biasakan diri Anda dengan Azure Resource Manager REST API.
- Jika Anda belum menggunakan API Azure Resource Manager, daftarkan aplikasi klien dengan Azure AD.
- Berikan akses baca aplikasi yang dibuat selama pendaftaran aplikasi Azure Active Directory ke akun penagihan menggunakan Kontrol akses (IAM).
- Perbarui kode pemrograman apa pun untuk menggunakan autentikasi Azure AD.
- Perbarui kode pemrograman apa pun untuk mengganti panggilan API EA dengan panggilan API MCA.
- Perbarui penanganan kesalahan untuk menggunakan kode kesalahan baru.
- Tinjau penawaran integrasi tambahan seperti Power BI untuk tindakan lain yang diperlukan.
API EA diganti dengan API MCA
API EA menggunakan kunci API untuk autentikasi dan otorisasi. API MCA menggunakan autentikasi Azure AD.
| Tujuan | API EA | API MCA |
|---|---|---|
| Saldo dan kredit | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Penggunaan (JSON) | /usagedetails/usagedetailsbycustomdate | Microsoft.Consumption/usageDetails1 |
| Penggunaan (CSV) | /usagedetails/download/usagedetails/submit | Microsoft.Consumption/usageDetails/download1 |
| Penggunaan Marketplace (CSV) | /marketplacecharges/marketplacechargesbycustomdate | Microsoft.Consumption/usageDetails/download1 |
| Periode penagihan | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Lembar harga | /pricesheet | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json|csv Microsoft.Billing/billingAccounts/…/billingProfiles/…/invoices/… /pricesheet/default/download format=json|csv Microsoft.Billing/billingAccounts/../billingProfiles/../providers/Microsoft.Consumption/pricesheets/download |
| Pembelian reservasi | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| Rekomendasi reservasi | /SharedReservationRecommendations/SingleReservationRecommendations | Microsoft.Consumption/reservationRecommendations |
| Penggunaan reservasi | /reservationdetails/reservationsummaries | Microsoft.Consumption/reservationDetailsMicrosoft.Consumption/reservationSummaries |
1 Layanan Azure dan penggunaan Marketplace pihak ketiga tersedia dengan API Detail Penggunaan.
API berikut tersedia untuk akun penagihan MCA:
| Tujuan | API Perjanjian Pelanggan Microsoft (MCA) |
|---|---|
| Akun penagihan2 | Microsoft.Billing/billingAccounts |
| Profil penagihan2 | Microsoft.Billing/billingAccounts/billingProfiles |
| Bagian faktur2 | Microsoft.Billing/billingAccounts/invoiceSections |
| Faktur | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Langganan penagihan | {scope}/billingSubscriptions |
2 API mengembalikan daftar objek, yang merupakan cakupan, tempat pengalaman Cost Management di portal Microsoft Azure dan API beroperasi. Untuk informasi selengkapnya tentang cakupan Cost Management, lihat Memahami dan bekerja dengan lingkup.
Jika Anda menggunakan API EA yang ada, Anda perlu memperbaruinya untuk mendukung akun penagihan MCA. Tabel berikut ini memperlihatkan perubahan integrasi lainnya:
| Tujuan | Penawaran lama | Penawaran baru |
|---|---|---|
| Power BI | Paket dan konektor kontenMicrosoft Consumption Insights | Konektor Azure Consumption Insights |
API untuk mendapatkan saldo dan kredit
API Dapatkan Ringkasan Saldo memberi Anda ringkasan bulanan tentang:
- Balances
- Pembelian baru
- Biaya layanan Azure Marketplace
- Penyesuaian
- Biaya kelebihan layanan
Semua API Konsumsi digantikan oleh API Azure asli yang menggunakan Azure AD untuk autentikasi dan otorisasi. Untuk informasi selengkapnya tentang memanggil Azure REST API, lihat Mulai menggunakan REST.
API Dapatkan Ringkasan Saldo digantikan oleh Microsoft.Billing/billingAccounts/billingProfiles/availableBalance API.
Untuk mendapatkan saldo yang tersedia dengan API Saldo yang Tersedia:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
API untuk mendapatkan biaya dan penggunaan
Dapatkan perincian harian biaya dari penggunaan layanan Azure, penggunaan Marketplace pihak ketiga, dan pembelian Marketplace lainnya dengan API berikut. API terpisah berikut ini digabungkan untuk layanan Azure dan penggunaan Marketplace pihak ketiga. API lama digantikan oleh API Microsoft.Consumption/usageDetails. Ini menambahkan pembelian Marketplace, yang sebelumnya hanya ditampilkan dalam ringkasan saldo hingga saat ini.
- Dapatkan detail penggunaan/download
- Dapatkan detail penggunaan/submit
- Dapatkan detail penggunaan/usagedetails
- Dapatkan detail penggunaan/usagedetailsbycustomdate
- Dapatkan biaya toko marketplace/marketplacecharges
- Dapatkan biaya toko marketplace/marketplacechargesbycustomdate
Semua API Konsumsi digantikan oleh API Azure asli yang menggunakan Azure AD untuk autentikasi dan otorisasi. Untuk informasi selengkapnya tentang memanggil Azure REST API, lihat Mulai menggunakan REST.
Semua API sebelumnya digantikan oleh API Detail Konsumsi/Penggunaan.
Untuk mendapatkan detail penggunaan dengan API Detail Penggunaan:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2019-01-01 |
API Detail Penggunaan, seperti semua Cost Management API, tersedia di beberapa cakupan. Untuk biaya yang ditagih, seperti yang akan Anda terima secara tradisional pada tingkat pendaftaran, gunakan cakupan profil penagihan. Untuk informasi selengkapnya tentang cakupan Cost Management, lihat Memahami dan bekerja dengan lingkup.
| Jenis | Format ID |
|---|---|
| Akun tagihan | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Profil tagihan | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Langganan | /subscriptions/{subscriptionId} |
| Grup sumber daya | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
Gunakan parameter querystring berikut untuk memperbarui kode pemrograman apa pun.
| Parameter lama | Parameter baru |
|---|---|
billingPeriod={billingPeriod} |
Tidak didukung |
endTime=yyyy-MM-dd |
endDate=yyyy-MM-dd |
startTime=yyyy-MM-dd |
startDate=yyyy-MM-dd |
Isi respon juga berubah.
Isi respons lama:
{
"id": "string",
"data": [{...}, ...],
"nextLink": "string"
}
Isi respons baru:
{
"value": [{
"id": "{scope}/providers/Microsoft.Consumption/usageDetails/###",
"name": "###",
"type": "Microsoft.Consumption/usageDetails",
"tags": {...},
"properties": [{...}, ...],
"nextLink": "string"
}, ...]
}
Nama properti yang berisi array catatan penggunaan berubah dari data menjadi nilai. Setiap catatan digunakan untuk memiliki daftar biaya properti terperinci. Namun, setiap catatan sekarang semua detail sekarang berada di properti bertumpuk bernama properti, kecuali untuk tag. Struktur baru konsisten dengan API Azure lainnya. Beberapa nama properti telah berubah. Tabel berikut ini memperlihatkan properti terkait.
| Properti lama | Properti baru | Catatan |
|---|---|---|
| AccountId | T/A | Pembuat langganan tidak dilacak. Gunakan invoiceSectionId (sama dengan departmentId). |
| AccountNameAccountOwnerId dan AccountOwnerEmail | T/A | Pembuat langganan tidak dilacak. Gunakan invoiceSectionName (sama dengan departmentName). |
| AdditionalInfo | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | Perhatikan bahwa properti ini berlawanan. Jika IsAzureCreditEnabled benar, ChargesBilledSeparately akan salah. |
| ConsumedQuantity | quantity | |
| ConsumedService | consumedService | Nilai string yang tepat mungkin berbeda. |
| ConsumedServiceId | Tidak ada | |
| PusatBiaya | costCenter | |
| Tanggal dan UsageStartDate | tanggal | |
| Hari | Tidak ada | Menguraikan hari dari tanggal. |
| DepartmentId | invoiceSectionId | Nilai yang tepat berbeda. |
| NamaDepartemen | invoiceSectionName | Nilai string yang tepat mungkin berbeda. Konfigurasikan bagian faktur agar sesuai dengan departemen, jika diperlukan. |
| ExtendedCost dan Biaya | costInBillingCurrency | |
| InstanceId | resourceId | |
| Biaya Berulang | Tidak ada | |
| Lokasi | lokasi | |
| MeterCategory | meterCategory | Nilai string yang tepat mungkin berbeda. |
| MeterId | meterId | Nilai string yang tepat berbeda. |
| MeterName | meterName | Nilai string yang tepat mungkin berbeda. |
| MeterRegion | meterRegion | Nilai string yang tepat mungkin berbeda. |
| MeterSubCategory | meterSubCategory | Nilai string yang tepat mungkin berbeda. |
| Bulan | Tidak ada | Menguraikan bulan dari tanggal. |
| Nama Penawaran | Tidak ada | Gunakan publisherName dan productOrderName. |
| OfferId | Tidak ada | |
| Nomor Pesanan | Tidak ada | |
| PartNumber | Tidak ada | Gunakan meterId dan productOrderName untuk mengidentifikasi harga secara unik. |
| Nama Paket | productOrderName | |
| Produk | Produk | |
| ProductId | productId | Nilai string yang tepat berbeda. |
| Nama Penerbit | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | Nilai string yang tepat berbeda. |
| ResourceLocation | resourceLocation | |
| ResourceLocationId | Tidak ada | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | T/A | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | Nilai string yang tepat mungkin berbeda. |
| ServiceTier | meterSubCategory | Nilai string yang tepat mungkin berbeda. |
| StoreServiceIdentifier | T/A | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Tag | tag | Properti tag berlaku untuk objek akar, bukan ke properti bertumpuk. |
| UnitOfMeasure | unitOfMeasure | Nilai string yang tepat berbeda. |
| usageEndDate | tanggal | |
| Tahun | Tidak ada | Menguraikan tahun dari tanggal. |
| (baru) | billingCurrency | Mata uang yang digunakan untuk biaya. |
| (baru) | billingProfileID | ID unik untuk profil penagihan (sama dengan pendaftaran). |
| (baru) | billingProfileName | Nama profil penagihan (sama dengan pendaftaran). |
| (baru) | chargeType | Gunakan untuk membedakan penggunaan layanan Azure, penggunaan Marketplace, dan pembelian. |
| (baru) | invoiceId | ID unik untuk faktur. Kosong untuk bulan terbuka saat ini. |
| (baru) | publisherType | Jenis penerbit untuk pembelian. Kosong untuk digunakan. |
| (baru) | serviceFamily | Jenis pembelian. Kosong untuk digunakan. |
| (baru) | servicePeriodEndDate | Tanggal berakhir untuk layanan yang dibeli. |
| (baru) | servicePeriodStartDate | Tanggal mulai untuk layanan yang dibeli. |
API Periode Penagihan digantikan oleh API Faktur
Akun penagihan MCA tidak menggunakan periode penagihan. Sebaliknya, akun tersebut menggunakan faktur untuk memasukkan biaya ke periode penagihan tertentu. API Periode Penagihan digantikan oleh API Faktur. Semua API Konsumsi digantikan oleh API Azure asli yang menggunakan Azure AD untuk autentikasi dan otorisasi. Untuk informasi selengkapnya tentang memanggil Azure REST API, lihat Mulai menggunakan REST.
Untuk mendapatkan faktur dengan API Faktur:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
API Lembar Harga
Bagian ini membahas API Lembar Harga yang ada dan memberikan rekomendasi untuk berpindah ke API Lembar Harga untuk Perjanjian Pelanggan Microsoft. Bagian ini juga membahas API Lembar Harga untuk Perjanjian Pelanggan Microsoft dan menjelaskan bidang dalam lembar harga. API Dapatkan lembar harga Perusahaan dan Dapatkan periode penagihan Perusahaan digantikan oleh API Lembar Harga untuk Perjanjian Pelanggan Microsoft (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). API baru mendukung format JSON dan CSV, dalam format REST asinkron. Semua API Konsumsi digantikan oleh API Azure asli yang menggunakan Azure AD untuk autentikasi dan otorisasi. Untuk informasi selengkapnya tentang memanggil Azure REST API, lihat Mulai menggunakan REST.
API Perusahaan Penagihan
Anda menggunakan API Perusahaan Penagihan dengan pendaftaran Perusahaan untuk mendapatkan informasi harga dan periode penagihan. Autentikasi dan otorisasi menggunakan token web Azure Active Directory.
Untuk mendapatkan harga yang berlaku untuk Pendaftaran Perusahaan yang ditentukan dengan API Lembar Harga dan Periode Penagihan:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| DAPATKAN | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
API Lembar Harga untuk Perjanjian Pelanggan Microsoft
Gunakan API Lembar Harga untuk Perjanjian Pelanggan Microsoft untuk melihat harga untuk semua layanan konsumsi Azure Consumption dan Marketplace. Harga yang ditampilkan untuk profil penagihan berlaku untuk semua langganan yang termasuk dalam profil penagihan.
Gunakan API Lembar Harga untuk melihat semua data Lembar Harga layanan Azure Consumption dalam format CSV:
| Metode | URI Permintaan |
|---|---|
| KIRIM | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv |
Gunakan API Lembar Harga untuk melihat semua data Lembar Harga layanan Azure Consumption dalam format JSON:
| Metode | URI Permintaan |
|---|---|
| KIRIM | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json |
Menggunakan API mengembalikan lembar harga untuk seluruh akun. Namun, Anda juga bisa mendapatkan versi ringkas dari lembar harga dalam format PDF. Ringkasan ini mencakup layanan konsumsi Azure Consumption dan Marketplace yang ditagihkan untuk faktur tertentu. Faktur diidentifikasi oleh {invoiceId}, yang sama dengan Nomor Faktur yang diperlihatkan dalam file PDF Ringkasan Faktur. Berikut contohnya.
Untuk melihat informasi faktur dengan API Lembar Harga dalam format CSV:
| Metode | URI Permintaan |
|---|---|
| KIRIM | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Untuk melihat informasi faktur dengan API Lembar Harga dalam format JSON:
| Metode | URI Permintaan |
|---|---|
| KIRIM | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
Anda juga dapat melihat perkiraan harga untuk setiap layanan konsumsi Azure Consumption atau Marketplace dalam siklus penagihan terbuka atau periode layanan saat ini.
Untuk melihat perkiraan harga untuk layanan konsumsi dengan API Lembar Harga dalam format CSV:
| Metode | URI Permintaan |
|---|---|
| KIRIM | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Untuk melihat perkiraan harga untuk layanan konsumsi dengan API Lembar Harga dalam format JSON:
| Metode | URI Permintaan |
|---|---|
| KIRIM | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
API Lembar Harga Perjanjian Pelanggan Microsoft adalah API REST yang asinkron. Respons untuk API berubah dari API sinkron yang lebih lama. Isi respon API juga berubah.
Isi respons lama
Berikut adalah contoh respons REST API yang sinkron:
[
{
"id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
"billingPeriodId": "201704",
"meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
"meterName": "A1 VM",
"unitOfMeasure": "100 Hours",
"includedQuantity": 0,
"partNumber": "N7H-00015",
"unitPrice": 0.00,
"currencyCode": "USD"
},
{
]
Isi respons baru
API mendukung format asinkron Azure REST. Hubungi API menggunakan GET dan Anda akan menerima respons berikut:
No Response Body
HTTP Status 202 Accepted
Header berikut dikirim dengan lokasi output:
Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Retry-After: 10
OData-EntityId: {operationId}
Lakukan panggilan GET lain ke lokasi. Respons terhadap panggilan GET sama sampai operasi mencapai status penyelesaian atau kegagalan. Setelah selesai, respons terhadap lokasi panggilan GET mengembalikan URL unduhan. Sama seperti jika operasi dieksekusi pada saat yang sama. Berikut contohnya:
HTTP Status 200
{
"id": "providers/Microsoft.Consumption/operationresults/{operationId}",
"name": {operationId},
"type": “Microsoft.Consumption/operationResults",
"properties" : {
"downloadUrl": {urltoblob},
"validTill": "Date"
}
}
Klien juga dapat melakukan panggilan GET untuk Azure-AsyncOperation. Titik akhir mengembalikan status untuk operasi.
Tabel berikut ini memperlihatkan bidang di API Dapatkan lembar harga Perusahaan. Ini termasuk bidang yang sesuai dalam lembar harga baru untuk Perjanjian Pelanggan Microsoft:
| Properti lama | Properti baru | Catatan |
|---|---|---|
| billingPeriodId | Tidak berlaku | Tidak dapat diterapkan. Untuk Perjanjian Pelanggan Microsoft, faktur dan lembar harga terkait menggantikan konsep billingPeriodId. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | Nilai string yang tepat mungkin berbeda. |
| includedQuantity | includedQuantity | Tidak berlaku untuk layanan dalam Perjanjian Pelanggan Microsoft. |
| partNumber | Tidak berlaku | Sebagai gantinya, gunakan kombinasi produkOrderName (sama dengan offerID) dan meterID. |
| unitPrice | unitPrice | Harga satuan berlaku untuk layanan yang dikonsumsi dalam Perjanjian Pelanggan Microsoft. |
| currencyCode | pricingCurrency | Perjanjian Pelanggan Microsoft memiliki gambaran harga dalam mata uang harga dan mata uang penagihan. CurrencyCode sesuai dengan pricingCurrency dalam Perjanjian Pelanggan Microsoft. |
| offerID | productOrderName | Daripada OfferID, Anda dapat menggunakan productOrderName tetapi tidak sama dengan OfferID. Namun, productOrderName dan meteran menentukan harga dalam Perjanjian Pelanggan Microsoft terkait dengan meterId dan OfferID dalam pendaftaran lama. |
Operasi API Lembar Harga Konsumsi
Untuk Perjanjian Perusahaan, Anda menggunakan operasi API Lembar Harga Konsumsi Dapatkan dan Dapatkan Berdasarkan Periode Penagihan untuk cakupan berdasarkan subscriptionId atau periode penagihan. API menggunakan autentikasi Azure Resource Management.
Untuk mendapatkan informasi Lembar Harga untuk cakupan dengan API Lembar Harga:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Untuk mendapatkan informasi Lembar Harga dengan periode penagihan dengan API Lembar Harga:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Alih-alih titik akhir API di atas, gunakan yang berikut untuk Perjanjian Pelanggan Microsoft:
API Lembar Harga untuk Perjanjian Pelanggan Microsoft (API REST asinkron)
API ini untuk Perjanjian Pelanggan Microsoft dan menyediakan atribut tambahan.
Lembar Harga untuk cakupan Profil Penagihan di Akun Penagihan
API ini adalah API yang ada. Diperbarui untuk memberikan lembar harga untuk profil penagihan di akun penagihan.
Lembar Harga untuk cakupan menurut akun penagihan
Autentikasi Azure Resource Manager digunakan saat Anda mendapatkan Lembar Harga di cakupan pendaftaran di akun penagihan.
Untuk mendapatkan Lembar Harga di akun pendaftaran di akun penagihan:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Untuk Perjanjian Pelanggan Microsoft, gunakan informasi di bagian berikut. Ini menyediakan properti bidang yang digunakan untuk perjanjian Pelanggan Microsoft.
Lembar Harga untuk cakupan profil penagihan di akun penagihan
Lembar Harga yang diperbarui dengan API akun penagihan mendapatkan Lembar Harga dalam format CSV. Untuk mendapatkan Lembar Harga di cakupan profil penagihan untuk MCA:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | /providers/Microsoft.Billing/billingAccounts/28ae4b7f-41bb-581e-9fa4-8270c857aa5f/billingProfiles/ef37facb-cd6f-437a-9261-65df15b673f9/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Di cakupan pendaftaran EA, respons dan properti API identik. Properti sesuai dengan properti MCA yang sama.
Properti lama untuk API Lembar Harga Azure Resource Manager dan properti baru yang sama berada dalam tabel berikut.
| Properti API Lembar Harga Azure Resource Manager Lama | Properti API Lembar Harga Perjanjian Pelanggan Microsoft baru | Deskripsi |
|---|---|---|
| ID Meteran | meterId | Pengidentifikasi unik untuk meteran. Sama seperti meterID. |
| Nama meteran | meterName | Nama meterannya. Meteran mewakili sumber daya yang dapat disebarkan layanan Azure. |
| Kategori meteran | layanan | Nama kategori klasifikasi untuk meteran. Sama seperti layanan di Lembar Harga Perjanjian Pelanggan Microsoft. Nilai string yang tepat berbeda. |
| Subkategori meteran | meterSubCategory | Nama kategori subklasifikasi meteran. Berdasarkan klasifikasi diferensiasi set fitur tingkat tinggi dalam layanan. Misalnya, DB SQL Dasar vs DB SQL Standar. |
| Wilayah meteran | meterRegion | |
| Unit | Tidak berlaku | Dapat diuraikan dari unitOfMeasure. |
| Satuan ukuran | unitOfMeasure | |
| Nomor bagian | Tidak berlaku | Alih-alih nomor bagian, gunakan productOrderName dan MeterID untuk mengidentifikasi harga untuk profil penagihan secara unik. Bidang tercantum pada faktur MCA alih-alih nomor bagian dalam faktur MCA. |
| Harga satuan | unitPrice | Harga satuan Perjanjian Pelanggan Microsoft. |
| Kode mata uang | pricingCurrency | Perjanjian Pelanggan Microsoft menunjukkan harga dalam mata uang harga dan mata uang penagihan. Kode mata uang sama dengan pricingCurrency dalam Perjanjian Pelanggan Microsoft. |
| Jumlah yang disertakan | includedQuantity | Tidak berlaku untuk layanan dalam Perjanjian Pelanggan Microsoft. Tunjukkan dengan nilai nol. |
| ID penawaran | productOrderName | Alih-alih OfferID, gunakan productOrderName. Tidak sama dengan OfferID, namun produkOrderName dan meteran menentukan harga dalam Perjanjian Pelanggan Microsoft. Terkait dengan meterId dan OfferID dalam pendaftaran lama. |
Harga untuk Perjanjian Pelanggan Microsoft didefinisikan berbeda dari perjanjian Perusahaan. Harga untuk layanan dalam pendaftaran Perusahaan unik untuk produk, nomor bagian, meteran, dan penawaran. Nomor bagian tidak digunakan dalam Perjanjian Pelanggan Microsoft.
Harga layanan Azure Consumption yang merupakan bagian dari Perjanjian Pelanggan Microsoft unik untuk productOrderName dan meterID. Nilai tersebut mewakili meteran layanan dan rencana produk.
Untuk menyesuaikan antara lembar harga dan penggunaan di API Detail Penggunaan, Anda dapat menggunakan productOrderName dan meterID.
Pengguna yang memiliki hak pemilik profil penagihan, kontributor, pembaca, dan pengelola faktur dapat mengunduh lembar harga.
Lembar harga termasuk harga untuk layanan yang harganya didasarkan pada penggunaan. Layanan ini mencakup konsumsi Azure dan konsumsi Marketplace. Harga terbaru pada akhir setiap periode layanan dikunci dan diterapkan pada penggunaan dalam satu periode layanan. Untuk layanan konsumsi Azure, periode layanan biasanya adalah bulan kalender.
Bidang API Lembar Harga yang Dihentikan
Bidang berikut ini tidak tersedia di API Lembar Harga Perjanjian Pelanggan Microsoft atau memiliki bidang yang sama.
| Bidang yang dihentikan | Deskripsi |
|---|---|
| billingPeriodId | Tidak berlaku. Sesuai dengan InvoiceId untuk MCA. |
| offerID | Tidak dapat diterapkan. Sesuai dengan productOrderName di MCA. |
| meterCategory | Tidak dapat diterapkan. Sesuai dengan Layanan di MCA. |
| unit | Tidak dapat diterapkan. Dapat diuraikan dari unitOfMeasure. |
| currencyCode | Sama seperti pricingCurrency di MCA. |
| meterLocation | Sama seperti meterRegion di MCA. |
| partNumber partnumber | Tidak berlaku karena nomor bagian tidak tercantum dalam faktur MCA. Alih-alih nomor bagian, gunakan kombinasi meterId dan productOrderName untuk mengidentifikasi harga secara unik. |
| totalIncludedQuantity | Tidak dapat diterapkan. |
| pretaxStandardRate | Tidak dapat diterapkan. |
API Biaya Instans Reservasi diganti
Anda bisa mendapatkan transaksi penagihan untuk pembelian reservasi dengan API Biaya Instans yang Dipesan. API baru mencakup semua pembelian, termasuk penawaran Marketplace pihak ketiga. Semua API Konsumsi digantikan oleh API Azure asli yang menggunakan Azure AD untuk autentikasi dan otorisasi. Untuk informasi selengkapnya tentang memanggil Azure REST API, lihat Mulai menggunakan REST. API Biaya Instans yang Telah Dipesan digantikan oleh API Transaksi.
Untuk mendapatkan transaksi pembelian reservasi dengan API Transaksi:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
API Rekomendasi diganti
API Rekomendasi Pembelian Instans yang Telah Dipesan menyediakan penggunaan komputer virtual selama 7, 30, atau 60 hari terakhir. API juga memberikan rekomendasi pembelian reservasi. Dukungan tersebut termasuk:
- API Rekomendasi Instans yang Telah Dipesan Bersama
- API Rekomendasi Instans yang Telah Dipesan Tunggal
Semua API Konsumsi digantikan oleh API Azure asli yang menggunakan Azure AD untuk autentikasi dan otorisasi. Untuk informasi selengkapnya tentang memanggil Azure REST API, lihat Mulai menggunakan REST. API rekomendasi reservasi yang tercantum sebelumnya digantikan oleh API Microsoft.Consumption/reservationRecommendations.
Untuk mendapatkan rekomendasi reservasi dengan API Rekomendasi Reservasi:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
API Penggunaan Reservasi diganti
Anda bisa mendapatkan penggunaan reservasi dalam pendaftaran dengan API Penggunaan Instans yang Telah Dipesan. Jika ada lebih dari satu instans yang dipesan dalam pendaftaran, Anda juga bisa mendapatkan penggunaan semua pembelian instans yang dipesan menggunakan API ini.
Dukungan tersebut termasuk:
Semua API Konsumsi digantikan oleh API Azure asli yang menggunakan Azure AD untuk autentikasi dan otorisasi. Untuk informasi selengkapnya tentang memanggil Azure REST API, lihat Mulai menggunakan REST. API rekomendasi reservasi yang tercantum sebelumnya digantikan oleh API Microsoft.Consumption/reservationDetails dan Microsoft.Consumption/reservationSummaries.
Untuk mendapatkan detail reservasi dengan API Detail Reservasi:
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Untuk mendapatkan ringkasan reservasi dengan API Ringkasan Reservasi:
| Metode | URI Permintaan |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Integrasi Power BI
Anda juga bisa menggunakan Power BI untuk pelaporan biaya. Konektor Cost Management untuk Power BI Desktop dapat digunakan untuk membuat laporan yang kuat dan disesuaikan yang membantu Anda lebih memahami pengeluaran Azure. Konektor Cost Management saat ini mendukung pelanggan dengan Perjanjian Pelanggan Microsoft atau Perjanjian Perusahaan (EA).
Langkah berikutnya
- Baca dokumentasi Cost Management untuk mempelajari cara memantau dan mengontrol pengeluaran Azure. Atau, jika Anda ingin mengoptimalkan penggunaan sumber daya dengan Cost Management.