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.
| Properti | Tipe | Deskripsi |
|---|---|---|
| id | String | ID untuk produk. |
| title | String | Judul produk. |
| description | String | Deskripsi produk. |
| productType | ItemType | Objek yang menjelaskan kategorisasi jenis produk ini. |
| isMicrosoftProduct | Bool | Menunjukkan apakah produk tersebut adalah produk Microsoft. |
| publisherName | String | Nama penerbit produk jika tersedia. |
| links | ProductLinks | Tautan sumber daya yang terkandung dalam produk. |
ItemType
Mewakili jenis produk.
| Properti | Tipe | Deskripsi |
|---|---|---|
| id | String | Pengidentifikasi jenis. |
| displayName | String | Nama tampilan untuk tipe item. |
| subJenis | ItemType | Opsional. Objek yang menjelaskan kategorisasi subjenis untuk jenis item. |
ProductLinks
Berisi daftar tautan untuk Produk.
| Properti | Tipe | Deskripsi |
|---|---|---|
| Sku | Tautan | Tautan untuk mengakses SKU yang mendasar. |
| links | ResourceLinks | Tautan sumber daya yang terkandung dalam sumber daya. |
SKU
Mewakili Stock Keeping Unit (SKU) yang dapat dibeli di bawah produk.
| Properti | Tipe | Deskripsi |
|---|---|---|
| id | String | ID untuk SKU. ID hanya unik dalam konteks produk induknya. |
| title | String | Judul SKU. |
| description | String | Penjabaran dari SKU. |
| productId | String | ID Produk induk yang berisi SKU. |
| minimumQuantity | Int | Jumlah minimum yang diizinkan untuk pembelian. |
| maximumQuantity | Int | Jumlah maksimum yang diizinkan untuk pembelian. |
| isTrial | Bool | Menunjukkan apakah SKU adalah item uji coba. |
| supportedBillingCycles | Array string | Daftar siklus penagihan yang didukung untuk SKU. Nilai yang didukung adalah nama anggota yang ditemukan di BillingCycleType. |
| purchasePrerequisites | Array 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. |
| inventoryVariables | Array 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 inventaris. Nilai ini harus cocok dengan "ArmRegionName" dari DynamicAttributes SKU. |
| provisioningVariables | Array string | Daftar variabel yang harus disediakan ke dalam konteks provisi item baris kelistrikan saat membeli item. Nilai yang didukung adalah: Cakupan - Cakupan untuk pembelian reservasi Azure: "Tunggal", "Dibagikan". "SubscriptionId" - ID langganan Azure yang akan digunakan untuk pembelian reservasi Azure. "Durasi" - Durasi reservasi Azure: "1Year", "3Year". |
| 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. |
| links | ResourceLinks | Tautan sumber daya yang terkandung dalam SKU. |
| AttestationProperties | AttestationProperties | Properti pengesahan untuk SKU. |
| consumptionType | String | Hanya tersedia jika sku mendukung konsumsi seperti kelebihan pemakaian. |
| specializedOfferProperties | Daftar specializedOfferProperties | Hanya tersedia jika produk adalah subType dari SpecializedOffer. |
| minimumPurchaseCommitment | MinimumPurchaseCommitment | Jumlah tetap yang diterapkan pada layanan komputasi. |
Atribut SKU dinamis
Properti penting yang relevan dengan produk dan layanan berbasis lisensi perdagangan baru.
Catatan
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.
| Properti | Tipe | Deskripsi |
|---|---|---|
| hasConstraints | Boolean | Menjelaskan apakah SKU berisi assetContraints |
| isAddon | Boolean | Menjelaskan apakah SKU adalah add-on |
| prasyaratSkus | array string | Menjelaskan produk dan sku yang dapat digunakan add-on |
| upgradeTargetOffers | array string | Daftar produk dan sku yang dapat ditingkatkan ke item |
| conversionInstructions | Daftar conversionInstructions | Daftar instruksi yang berlaku untuk mengonversi operasi |
specializedOfferProperties
Catatan
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"
| Properti | Tipe | Deskripsi |
|---|---|---|
| startDate | String | ID istilah yang berlaku untuk instruksi |
| endDate | String | Opsi yang menentukan perpanjangan |
| pricingPolicies | Daftar pricingPolicies | Daftar kebijakan yang menentukan jenis dan nilai diskon promosi. |
MinimumPurchaseCommitment
Atribut dari jumlah minimum yang dapat diterapkan pada layanan komputasi.
| Properti | Tipe | Deskripsi |
|---|---|---|
| Butir | String | Periode komitmen pembelian minimum. |
| currencyCode | String Kamus<, String> | "Mata uang" dan "simbol" dari jumlah minimum yang dapat dilakukan. |
| jumlah | Int | Jumlah minimum yang dapat diterapkan pada layanan komputasi. |
PricingPolicies
Jelaskan jenis dan nilai diskon promosi.
| Properti | Tipe | Deskripsi |
|---|---|---|
| jenis | String | Jelaskan apakah diskon didasarkan pada persentase atau diskon tarif tetap. |
| value | String | Menentukan jumlah diskon yang diterapkan. |
Ketersediaan
Mewakili konfigurasi di mana SKU tersedia untuk dibeli (seperti negara/wilayah, mata uang, dan segmen industri).
| Properti | Tipe | Deskripsi |
|---|---|---|
| id | String | ID untuk ketersediaan ini. ID ini hanya unik dalam konteks produk induk dan SKU-nya. Catatan ID Ketersediaan dapat berubah dari waktu ke waktu. Mitra hanya boleh mengandalkan nilai ini dalam rentang waktu singkat setelah mengambilnya. |
| productId | String | ID produk yang berisi ketersediaan ini. |
| skuId | String | ID SKU yang berisi ketersediaan ini. |
| catalogItemId | String | Pengidentifikasi unik untuk item ini dalam katalog. ID ini harus diisi ke dalam 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. |
| defaultCurrency | String | Mata uang default yang didukung untuk ketersediaan ini. |
| segmen | String | Segmen industri untuk ketersediaan ini. Nilai yang didukung adalah: Komersial, Pendidikan, Pemerintah, Nirlasa. |
| negara | String | Negara atau wilayah (dalam format kode negara ISO) tempat ketersediaan ini berlaku. |
| isPurchasable | Bool | Menunjukkan apakah ketersediaan ini dapat dibeli. |
| isRenewable | Bool | Menunjukkan apakah ketersediaan ini dapat diperpanjang. |
| RenewalInstructions | RenewalInstruction | Mewakili instruksi perpanjangan untuk ketersediaan tertentu. |
| product | Produk | Produk yang sesuai dengan ketersediaan ini. |
| sku | Sku | SKU yang sesuai dengan ketersediaan ini. |
| terms | Array sumber daya Istilah | Pengumpulan istilah yang berlaku untuk ketersediaan ini. |
| links | ResourceLinks | Tautan sumber daya yang terkandung dalam ketersediaan. |
Instruksi perpanjangan
Catatan
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.
| Properti | Tipe | Deskripsi |
|---|---|---|
| applicableTermIds | Array string | ID istilah yang berlaku untuk instruksi |
| RenewalOptions | Array of RenewalOption | Opsi yang menentukan perpanjangan |
RenewalOption
Catatan
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.
| Properti | Tipe | Deskripsi |
|---|---|---|
| renewToId | String | Mewakili produk dan sku yang akan diperpanjang |
| isAutoRenewable | Bool | Apakah ketersediaan dapat diperpanjang secara otomatis atau tidak |
Term
Mewakili istilah yang ketersediaannya dapat dibeli.
| Properti | Tipe | Deskripsi |
|---|---|---|
| durasi | String | Representasi ISO 8601 dari durasi istilah. Nilai yang didukung saat ini adalah P1M (satu bulan), P1Y (satu tahun) dan P3Y (tiga tahun). |
| description | String | Penjabaran dari istilah tersebut. |
InventoryCheckRequest
Mewakili permintaan untuk memeriksa inventori terhadap item katalog tertentu.
| Properti | Tipe | Deskripsi |
|---|---|---|
| targetItems | Array InventoryItem | Daftar item katalog yang akan dievaluasi oleh pemeriksaan inventori. |
| inventoryContext | Pasangan nilai/kunci | Kamus nilai konteks yang diperlukan untuk melakukan pemeriksaan inventaris. Setiap SKU produk akan menentukan nilai mana (jika ada) yang diperlukan untuk melakukan operasi ini. |
| links | ResourceLinks | Tautan sumber daya yang terkandung dalam permintaan pemeriksaan inventori. |
InventoryItem
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.
| Properti | Tipe | 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. |
| isRestricted | Bool | Menunjukkan apakah item ini ditemukan memiliki inventori terbatas. |
| Pembatasan | Array InventoryRestriction | Detail batasan apa pun yang ditemukan untuk item ini. Properti ini hanya akan diisi jika isRestricted = "true". |
InventoryRestriction
Mewakili detail pembatasan inventarisi. Detail ini hanya berlaku untuk hasil output pemeriksaan inventori, bukan untuk permintaan input.
| Properti | Tipe | Deskripsi |
|---|---|---|
| reasonCode | String | Kode yang mengidentifikasi alasan pembatasan. |
| description | String | Penjabaran dari pembatasan inventaris. |
| properti | Pasangan nilai/kunci | Kamus properti yang dapat memberikan detail lebih lanjut tentang pembatasan. |
BillingCycleType
[Enum/dotnet/api/system.enum) dengan nilai yang menunjukkan jenis siklus penagihan.
| Value | Position | Deskripsi |
|---|---|---|
| Tidak dikenal | 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 satu kali. |
| Tiap tiga tahun | 5 | Menunjukkan bahwa mitra akan dikenakan biaya setiap tiga tahun. |
AttestationProperties
Mewakili jenis pengesahan dan jika diperlukan untuk pembelian.
| Properti | Tipe | Deskripsi |
|---|---|---|
| attestationType | String | Menunjukkan jenis pengesahan. Produk Windows 365 akan memiliki nilai 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." |
| enforceAttestation | Boolean | Menunjukkan apakah pengesahan diperlukan untuk pembelian. |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk