Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Sumber daya yang mewakili barang atau layanan yang dapat dibeli. Termasuk sumber daya untuk menjelaskan jenis dan bentuk produk (SKU), dan untuk memeriksa ketersediaan produk dalam inventaris.
Produk
Mewakili kebaikan atau layanan yang dapat dibeli. Produk dengan sendirinya bukan item yang dapat dibeli.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| Id | string | ID untuk produk. |
| titel | string | Judul produk. |
| deskripsi | string | Deskripsi produk. |
| jenisProduk | ItemType | Objek yang menjelaskan kategorisasi jenis produk ini. |
| isMicrosoftProduct | Bool | Menunjukkan apakah produk tersebut adalah produk Microsoft. |
| nama penerbit | string | Nama penerbit produk jika tersedia. |
| tautan | ProductLinks | Tautan sumber daya yang terkandung dalam produk. |
Jenis Barang
Mewakili jenis produk.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| Id | string | Pengidentifikasi jenis. |
| nama tampilan | string | Nama tampilan untuk tipe item. |
| Sub Jenis | ItemType | Fakultatif. Objek yang menjelaskan kategorisasi subjenis untuk jenis item. |
ProductLinks
Berisi daftar tautan untuk Produk .
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| SKU | Tautan | Tautan untuk mengakses SKU yang mendasarinya. |
| tautan | Tautan Sumber Daya | Tautan terkait yang terdapat dalam suatu sumber daya. |
SKU (Kode Barang)
Mewakili Stock Keeping Unit (SKU) yang dapat dibeli yang merupakan bagian dari sebuah produk.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| Id | string | ID untuk SKU. ID hanya unik dalam konteks produk induknya. |
| titel | string | Judul SKU. |
| deskripsi | string | Deskripsi SKU. |
| ID produk | string | ID dari Produk Utama yang berisi SKU. |
| Kuantitas Minimum | Integer | Jumlah minimum yang diizinkan untuk pembelian. |
| kuantitas maksimum | Integer | Jumlah maksimum yang diizinkan untuk pembelian. |
| isTrial | Bool | Menunjukkan apakah SKU adalah item uji coba. |
| siklusPenagihanYangDidukung | Array yang berisi string | Daftar siklus penagihan yang didukung untuk SKU. Nilai yang didukung adalah nama anggota yang ditemukan di BillingCycleType. |
| syarat pembelian | Array yang berisi string | Daftar langkah atau tindakan prasyarat yang diperlukan sebelum membeli item. Nilai yang didukung adalah: "InventoryCheck" - Menunjukkan bahwa inventori item harus dievaluasi sebelum mencoba membeli item. "AzureSubscriptionRegistration" - Menunjukkan bahwa langganan Azure diperlukan dan harus didaftarkan sebelum mencoba membeli item. |
| variabelPersediaan | Array yang berisi string | Daftar variabel yang diperlukan untuk menjalankan pemeriksaan inventori pada item. Nilai yang didukung adalah: "CustomerId" - ID pelanggan tempat pembelian akan dilakukan. "AzureSubscriptionId" - ID langganan Azure yang akan digunakan untuk pembelian reservasi Azure. "ArmRegionName" - Wilayah untuk memverifikasi inventarisi. Nilai ini harus cocok dengan "ArmRegionName" dari atribut dinamis SKU. |
| variabel penyediaan | Array yang berisi string | Daftar variabel yang harus disediakan dalam konteks provisi untuk item dalam baris keranjang saat membeli item. Nilai yang didukung adalah: Cakupan - Cakupan untuk pembelian reservasi Azure: "Tunggal", "Bersama". "SubscriptionId" - ID langganan Azure yang akan digunakan untuk pembelian reservasi Azure. "Durasi" - Durasi reservasi Azure: "1 Tahun", "3 Tahun". |
| dynamicAttributes | pasangan kunci/nilai | Kamus properti dinamis yang berlaku untuk item. Properti dalam kamus bersifat dinamis dan dapat berubah tanpa pemberitahuan. Mitra harus menghindari pembuatan dependensi yang kuat pada kunci tertentu yang ada dalam nilai properti. |
| tautan | Tautan Sumber Daya | Tautan sumber daya yang terkandung dalam SKU. |
| Properti Pengesahan | PropertiPengesahan | Properti atestasi untuk SKU. |
| jenis konsumsi | string | Hanya tersedia jika SKU mendukung konsumsi, seperti pemakaian berlebih. |
| aktivasi manual | Bool | SKU Marketplace saja. Jika false, penagihan langsung dimulai alih-alih menunggu aktivasi layanan oleh ISV di properti ISV. |
| propertiPenawaranKhusus | Daftar Properti Penawaran Khusus | Hanya tersedia jika produk adalah subType dari SpecializedOffer. |
| komitmen pembelian minimum | KomitmenPembelianMinimum | Jumlah tetap yang dialokasikan pada layanan komputasi. |
Atribut SKU dinamis
Properti penting yang relevan dengan produk dan layanan berbasis lisensi perdagangan baru.
Nota
Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat gambaran umum pengalaman perdagangan baru .
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| memiliki batasan | Boolean | Menjelaskan apakah SKU mengandung pembatasan aset |
| adalahAdd-on | Boolean | Menjelaskan apakah SKU adalah tambahan |
| prasyaratSkus | kumpulan string | Menjelaskan produk dan SKU yang kompatibel dengan add-on |
| tingkatkanPenawaranTarget | kumpulan string | Daftar produk dan sku ke mana item dapat ditingkatkan |
| Instruksi Konversi | Daftar instruksi konversi | Daftar instruksi yang berlaku untuk mengonversi operasi |
propertiPenawaranKhusus
Nota
Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat gambaran umum pengalaman perdagangan baru .
Hanya berlaku untuk subJenis produk "SpecializedOffers"
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| tanggalMulai | string | ID istilah yang berlaku untuk instruksi |
| tanggal akhir | string | Opsi yang menentukan perpanjangan |
| kebijakan harga | Daftar Kebijakan Harga | Daftar kebijakan yang menentukan jenis dan nilai diskon promosi. |
Komitmen Pembelian Minimum
Atribut dari jumlah minimum yang dapat diterapkan pada layanan komputasi.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| butir | string | Periode komitmen pembelian minimum. |
| kode mata uang | Kamus<String, String> | "Mata uang" dan "simbol" dari jumlah minimum yang dapat dijanjikan. |
| jumlah | Integer | Jumlah minimum yang dapat diterapkan pada layanan komputasi. |
Kebijakan Harga
Jelaskan jenis dan nilai diskon promosi.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| jenis | string | Jelaskan apakah diskon didasarkan pada persentase atau diskon tarif tetap. |
| nilai | string | Menentukan jumlah diskon yang diterapkan. |
Ketersediaan
Mewakili konfigurasi di mana SKU tersedia untuk dibeli (seperti negara/wilayah, mata uang, dan segmen industri).
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| Id | string | ID untuk ketersediaan ini. ID ini hanya unik dalam konteks produk induknya dan SKU . Catatan ID Ketersediaan bisa berubah seiring waktu. Mitra hanya boleh mengandalkan nilai ini dalam rentang waktu singkat setelah mengambilnya. |
| ID produk | string | ID produk yang mengandung ketersediaan ini. |
| skuId | string | ID dari SKU yang berisi ketersediaan ini adalah. |
| catalogItemId | string | Pengidentifikasi unik untuk item ini dalam katalog. ID ini harus diisi ke properti OrderLineItem.OfferId atau CartLineItem.CatalogItemId saat membeli SKU induk. Catatan ID ini dapat berubah dari waktu ke waktu. Anda hanya boleh mengandalkan nilai ini dalam waktu singkat setelah mengambilnya. Ini hanya boleh diakses dan digunakan pada saat pembelian. |
| mata uang bawaan | string | Mata uang default yang didukung untuk ketersediaan ini. |
| Segmen | string | Segmen industri terkait ketersediaan ini. Nilai yang didukung adalah: Komersial, Pendidikan, Pemerintah, Nirlaba. |
| negara | string | Negara atau wilayah (dalam format kode negara ISO) tempat ketersediaan ini berlaku. |
| dapatDibeli | Bool | Menunjukkan apakah ketersediaan ini dapat dibeli. |
| apakah dapat diperbarui | Bool | Menunjukkan apakah ketersediaan ini dapat diperpanjang. |
| Instruksi Perpanjangan | RenewalInstruction | Mewakili instruksi perpanjangan untuk ketersediaan tertentu. |
| produk | Produk | Ketersediaan ini sesuai dengan produk tersebut. |
| Sku | Sku | SKU yang sesuai dengan ketersediaan ini. |
| ketentuan | Kumpulan sumber daya Istilah | Kumpulan istilah yang dapat diterapkan untuk ketersediaan ini. |
| tautan | Tautan Sumber Daya | Tautan sumber daya yang terdapat dalam bagian ketersediaan. |
Instruksi perpanjangan
Nota
Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat gambaran umum pengalaman perdagangan baru .
Mewakili instruksi perpanjangan untuk ketersediaan tertentu.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| ID Ketentuan Berlaku | Array yang berisi string | ID istilah yang berlaku untuk instruksi |
| Opsi Pembaruan | Deret Opsi Pembaruan | Opsi yang menentukan perpanjangan |
Opsi Pembaruan
Nota
Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat gambaran umum pengalaman perdagangan baru .
Mewakili instruksi perpanjangan untuk ketersediaan tertentu.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| renewToId | string | Mewakili produk dan sku yang akan diperpanjang masa berlakunya |
| dapatDiperbaruiOtomatis | Bool | Apakah ketersediaan dapat diperpanjang secara otomatis atau tidak |
Istilah
Mewakili sebuah istilah yang ketersediaannya dapat dibeli.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| durasi | string | Representasi ISO 8601 dari durasi periode. Nilai yang didukung saat ini adalah P1M (satu bulan), P1Y (satu tahun) dan P3Y (tiga tahun). |
| deskripsi | string | Penjabaran dari istilah tersebut. |
| termLifeCycleState | string | Deskripsi siklus hidup. Nilai-nilai yang didukung termasuk GA (tersedia umum), EndOfSale, dan EndofSaleWithConversions. Properti ini hanya dikembalikan jika includeLifeCycleState diatur ke true saat memanggil get availability by id API. |
Permintaan Pemeriksaan Inventaris
Mewakili permohonan untuk mengecek stok terhadap item spesifik dalam katalog.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| item sasaran | Array dari InventoryItem | Daftar item katalog yang dievaluasi oleh pemeriksaan inventori. |
| Konteks Inventaris | Pasangan kunci/nilai | Kamus nilai konteks yang diperlukan untuk melakukan pemeriksaan inventaris. Setiap SKU produk menentukan nilai mana (jika ada) yang diperlukan untuk melakukan operasi ini. |
| tautan | Tautan Sumber Daya | Tautan sumber daya yang terkandung dalam permintaan pemeriksaan inventori. |
Inventaris Item
Mewakili satu item dalam operasi pemeriksaan inventori. Sumber daya ini digunakan untuk menentukan item target dalam permintaan input dan juga digunakan untuk mewakili hasil output operasi pemeriksaan inventori.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| ID produk | string | (Diperlukan) ID produk . |
| skuId | string | ID SKU. Nilai ini opsional. Jika nilai ini tidak disediakan, maka semua SKU di bawah produk dianggap sebagai item target dari operasi pemeriksaan inventori. |
| dibatasi | Bool | Menunjukkan apakah item ini ditemukan memiliki inventori terbatas. |
| pembatasan | Array InventoryRestriction | Detail batasan apa pun yang ditemukan untuk item ini. Properti ini hanya diisi jika isRestricted = "true". |
Pembatasan Inventaris
Mewakili detail pembatasan inventarisi. Detail ini hanya berlaku untuk hasil output pemeriksaan inventori, bukan untuk permintaan input.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| kode alasan | string | Kode yang mengidentifikasi alasan pembatasan. |
| deskripsi | string | Penjabaran mengenai pembatasan inventaris. |
| Properti | Pasangan kunci/nilai | Kamus properti yang dapat memberikan detail lebih lanjut tentang pembatasan. |
JenisSiklusPenagihan
[Enum/dotnet/api/system.enum) dengan nilai yang menunjukkan jenis siklus penagihan.
| Nilai | Posisi | Deskripsi |
|---|---|---|
| Tidak diketahui | 0 | Penginisialisasi Enum. |
| Bulanan | 1 | Menunjukkan bahwa mitra dikenakan biaya bulanan. |
| Tahunan | 2 | Menunjukkan bahwa mitra dikenakan biaya setiap tahun. |
| Tidak | 3 | Menunjukkan bahwa mitra tidak dikenakan biaya. Nilai ini dapat digunakan untuk item uji coba. |
| OneTime | 4 | Menunjukkan bahwa mitra dibebankan biaya satu kali. |
| Tiga Tahunan | 5 | Menunjukkan bahwa pihak mitra dikenakan biaya setiap tiga tahun sekali. |
Properti Pengesahan
Menunjukkan jenis pengesahan dan apakah diperlukan untuk pembelian.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| jenis atestasi | string | Menunjukkan jenis pengesahan. Produk Windows 365 memiliki manfaat atau nilai yang ditawarkan oleh Windows 365. Teks pengesahan Windows 365 adalah "Saya memahami bahwa setiap orang yang menggunakan Windows 365 Business dengan Windows Hybrid Benefit juga perlu menginstal salinan Windows 10/11 Pro yang valid di perangkat kerja utama mereka." |
| menerapkan Verifikasi | Boolean | Menunjukkan apakah pengesahan diperlukan untuk pembelian. |