Sumber daya produk
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. |
| Link | Tautan Sumber Daya | Tautan terkait yang terdapat dalam suatu sumber daya. |
Sku
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. |
| productId | String | ID dari Produk Utama yang berisi SKU. |
| Kuantitas Minimum | Int | Jumlah minimum yang diizinkan untuk pembelian. |
| kuantitas maksimum | Int | 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. |
| Link | 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. |
| 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 | array dari string-string | Daftar produk dan sku ke mana item dapat ditingkatkan |
| Instruksi Konversi | Daftar instruksi konversi | Daftar instruksi yang berlaku untuk mengonversi operasi |
atributPenawaranKhusus
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 | Int | 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. |
| productId | 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, Nirlasa. |
| 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. |
| Istilah | Kumpulan sumber daya Istilah | Kumpulan istilah yang dapat diterapkan untuk ketersediaan ini. |
| Link | 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 .
Merupakan 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. |
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 akan dievaluasi oleh pemeriksaan inventori. |
| Konteks Inventaris | Pasangan kunci/nilai | Kamus nilai konteks yang diperlukan untuk melakukan pemeriksaan inventaris. Setiap SKU dari produk akan menentukan nilai apa (jika ada) yang diperlukan untuk menjalankan operasi ini. |
| Link | TautanKeSumberDaya | 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 |
|---|---|---|
| productId | String | (Diperlukan) ID produk . |
| skuId | String | ID SKU. Saat menggunakan sumber daya ini sebagai input ke permintaan inventori, nilai ini bersifat opsional. Jika nilai ini tidak disediakan, maka semua SKU di bawah produk akan 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 akan diisi hanya 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 akan dikenakan biaya bulanan. |
| Tahunan | 2 | Menunjukkan bahwa mitra akan dikenakan biaya setiap tahun. |
| Tidak | 3 | Menunjukkan bahwa mitra tidak akan dikenakan biaya. Nilai ini dapat digunakan untuk item uji coba. |
| OneTime | 4 | Menunjukkan bahwa mitra akan dikenakan biaya sekali. |
| Tiga Tahunan | 5 | Menunjukkan bahwa mitra akan dikenakan biaya setiap tiga tahun. |
Properti Pengesahan
Mewakili jenis pengesahan dan menentukan apakah jenis tersebut diperlukan untuk pembelian.
| Harta benda | Jenis | Deskripsi |
|---|---|---|
| jenis atestasi | String | Menunjukkan jenis pengesahan. Produk Windows 365 akan bernilai seperti 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. |