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.
Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS
Anda dapat menambahkan pesanan untuk pelanggan di keranjang. Untuk informasi selengkapnya tentang apa yang saat ini tersedia untuk dijual, lihat penawaran Mitra di program Penyedia Solusi Cloud.
Nota
Keranjang kedaluwarsa tujuh hari setelah pembuatan awal.
Prasyarat
Kredensial seperti yang dijelaskan dalam Pusat Mitra autentikasi. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.
ID pelanggan (
customer-tenant-id). Jika Anda tidak mengetahui ID pelanggan, Anda dapat mencarinya di Pusat Mitra dengan memilih ruang kerja Pelanggan, kemudian pilih pelanggan dari daftar, lalu Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian Info Akun Pelanggan. ID Microsoft sama dengan ID pelanggan (customer-tenant-id).
C#
Untuk membuat pesanan bagi pelanggan:
Menginstansiasi objek Cart.
Buat daftar objek CartLineItem, dan tetapkan daftar tersebut ke dalam properti LineItems kereta. Setiap item keranjang berisi informasi pembelian untuk satu produk. Anda harus memiliki setidaknya satu item dalam keranjang.
Dapatkan antarmuka pada operasi cart dengan memanggil metode IAggregatePartner.Customers.ById dengan ID pelanggan untuk mengidentifikasi pelanggan, lalu mengambil antarmuka melalui properti Cart.
Panggil metode Create atau CreateAsync untuk membuat keranjang.
Untuk menyelesaikan pengesahan dan menyertakan pengecer lain, lihat sampel Sampel Permintaan dan Respons berikut:
Permintaan sampel
{
"PartnerOnRecordAttestationAccepted":true, "lineItems": [
{
"id": 0,
"catalogItemId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
"quantity": 1,
"billingCycle": "monthly",
"termDuration": "P1M",
"renewsTo": null,
"provisioningContext": {},
"customTermEndDate": "2022-02-19T00:00:00Z"
},
{
"id": 1,
"catalogItemId": "CFQ7TTC0LFLS:0002:CFQ7TTC0KDLJ",
"quantity": 2,
"billingCycle": "monthly",
"termDuration": "P1Y",
"participants": [
{
"key": "transaction_reseller",
"value": "5357564"
},
{
"key": "additional_transaction_reseller",
"value": "517285"
},
{
"key": "additional_transaction_reseller",
"value": "5357563"
}
]
}
]
}
Sampel respons
{
"id": "3e22b548-647d-4223-9675-1fcb6cb57665",
"creationTimestamp": "2021-08-18T17:29:52.3517492Z",
"lastModifiedTimestamp": "2021-08-18T17:29:52.3517553Z",
"expirationTimestamp": "2021-08-25T17:30:11.2406416Z",
"lastModifiedUser": "da62a0dc-35e9-4601-b48e-a047bd3ec7c1",
"status": "Active",
"lineItems": [
{
"id": 0,
"catalogItemId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "monthly",
"termDuration": "P1M",
"customTermEndDate": "2022-02-19T00:00:00Z";
"provisioningContext": {},
"orderGroup": "0"
},
{
"id": 1,
"catalogItemId": "CFQ7TTC0LFLS:0002:CFQ7TTC0KDLJ",
"quantity": 2,
"currencyCode": "USD",
"billingCycle": "monthly",
"termDuration": "P1Y",
"participants": [
{
"key": "transaction_reseller",
"value": "5357564"
},
{
"key": "additional_transaction_reseller",
"value": "517285"
},
{
"key": "additional_transaction_reseller",
"value": "5357563"
}
],
"provisioningContext": {},
"orderGroup": "0"
}
],
"links": {
"self": {
"uri": "/customers/f81d98dd-c2f4-499e-a194-5619e260344e/carts/3e22b548-647d-4223-9675-1fcb6cb57665",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Cart"
}
}
Contoh C#
// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;
var cart = new Cart()
{
LineItems = new List<CartLineItem>()
{
new CartLineItem()
{
/* Microsoft Azure Subscription */
Id = 0,
CatalogItemId = "MS-AZR-0145P",
Quantity = 1,
BillingCycle = BillingCycleType.Monthly,
TermDuration = "P1Y"
},
new CartLineItem()
{
/* Azure Reserved Instance */
Id = 1,
CatalogItemId = "DZH318Z0BQ36:004G:DZH318Z08C0S",
Quantity = 1,
BillingCycle = BillingCycleType.OneTime,
TermDuration = "P1Y",
ProvisioningContext = new Dictionary<string, string>
{
{ "subscriptionId", subscriptionId },
{ "scope", "shared" }
}
},
new CartLineItem()
{
/* Azure Reserved Instance */
Id = 2,
CatalogItemId = "DZH318Z0BQ36:004J:DZH318Z08B8X",
Quantity = 1,
BillingCycle = BillingCycleType.OneTime,
TermDuration = "P3Y",
ProvisioningContext = new Dictionary<string, string>
{
{ "subscriptionId", subscriptionId },
{ "scope", "shared" }
}
},
new CartLineItem()
{
/* Perpetual Software */
Id = 3,
CatalogItemId = "DG7GMGF0DWM3:0002:DG7GMGF0DT1M",
Quantity = 1,
BillingCycle = BillingCycleType.OneTime
},
new CartLineItem()
{
/* SaaS */
Id = 4,
CatalogItemId = "DZH318Z0BXWC:0002:DZH318Z0BMRV",
Quantity = 1,
BillingCycle = BillingCycleType.Monthly,
TermDuration = "P1M"
},
new CartLineItem()
{
/* SaaS Free Trial */
Id = 5,
CatalogItemId = "DZH318Z0C0WF:0001:DZH318Z0BP69",
Quantity = 10,
BillingCycle = BillingCycleType.None,
TermDuration = "P1M",
RenewsTo = new RenewsTo
{
TermDuration = "P1Y"
}
}
}
};
cart = partnerOperations.Customers.ById(customerId).Carts.Create(cart);
Java
Java SDK Pusat Mitra dapat digunakan untuk mengelola sumber daya Pusat Mitra. Ini adalah proyek sumber terbuka yang dikelola oleh komunitas mitra dan tidak didukung secara resmi oleh Microsoft. Anda dapat mendapatkan bantuan dari komunitas atau membuka masalah di GitHub jika Anda mengalami masalah.
Untuk membuat pesanan bagi pelanggan:
Menginstansiasi objek Cart.
Buat daftar objek CartLineItem, dan tetapkan daftar ke item baris keranjang. Setiap item keranjang berisi informasi pembelian untuk satu produk. Anda harus memiliki setidaknya satu item dalam keranjang.
Dapatkan antarmuka untuk operasi keranjang dengan memanggil fungsi IAggregatePartner.getCustomers().byId dengan ID pelanggan untuk mengidentifikasi pelanggan, lalu mengambil antarmuka dari fungsi getCart.
Panggil fungsi buat untuk membuat keranjang.
Contoh Java
// IAggregatePartner partnerOperations;
// String customerId;
// String subscriptionId;
// String catalogItemId;
CartLineItem lineItem = new CartLineItem();
lineItem.setBillingCycle(BillingCycleType.OneTime);
lineItem.setCatalogItemId(catalogItemId);
lineItem.setFriendlyName("Sample RI Purchase");
lineItem.setQuantity(1);
Map<String, String> provisioningContext = new HashMap<String,String>();
provisioningContext.put("duration", "3Years");
provisioningContext.put("scope", "shared");
provisioningContext.put("subscriptionId", subscriptionId);
lineItem.setProvisioningContext(provisioningContext);
List<CartLineItem> lineItemList = new ArrayList<CartLineItem>();
lineItemList.add(lineItem);
Cart cart = new Cart();
cart.setLineItems(lineItemList);
Cart cartCreated = partnerOperations.getCustomers().byId(customerId).getCarts().create(cart);
PowerShell
Modul Partner Center PowerShell dapat digunakan untuk mengelola sumber daya Pusat Mitra. Ini adalah proyek sumber terbuka yang dikelola oleh komunitas mitra dan tidak didukung secara resmi oleh Microsoft. Anda dapat mendapatkan bantuan dari komunitas atau membuka masalah di GitHub jika Anda mengalami masalah.
Untuk membuat pesanan bagi pelanggan:
Menginstansiasi objek Cart.
Buat daftar objek CartLineItem, dan tetapkan daftar ke item baris keranjang. Setiap item keranjang berisi informasi pembelian untuk satu produk. Anda harus memiliki setidaknya satu item dalam keranjang.
Jalankan perintah New-PartnerCustomerCart untuk membuat keranjang.
# $customerId
# $subscriptionId
# $catalogItemId
$lineItem = New-Object -TypeName Microsoft.Store.PartnerCenter.PowerShell.Models.Carts.PSCartLineItem
$lineItem.BillingCycle = 'OneTime'
$lineItem.CatalogItemId = $catalogItemId
$lineItem.FriendlyName = 'Sample RI Purchase'
$lineItem.ProvisioningContext.Add('duration', '1Year')
$lineItem.ProvisioningContext.Add('scope', 'shared')
$lineItem.ProvisioningContext.Add('subscriptionId', $subsciptionId)
$lineItem.Quantity = 10
New-PartnerCustomerCart -CustomerId $customerId -LineItems $lineItem
Permintaan REST
Sintaks permohonan
| Metode | Meminta URI |
|---|---|
| POST | {baseURL}/v1/customers/{customer-id}/carts HTTP/1.1 |
Parameter URI
Gunakan parameter jalur berikut untuk mengidentifikasi pelanggan.
| Nama | Jenis | Diperlukan | Deskripsi |
|---|---|---|---|
| id pelanggan | string | Ya | ID pelanggan berformat GUID yang mengidentifikasi pelanggan. |
Header permintaan
Untuk informasi selengkapnya, lihat header REST Pusat Mitra.
Isi permintaan
Tabel ini menjelaskan properti Cart dalam isi permintaan.
| Harta benda | Jenis | Diperlukan | Deskripsi |
|---|---|---|---|
| Id | string | Tidak | Pengidentifikasi keranjang yang disediakan setelah keranjang berhasil dibuat. |
| cap waktu pembuatan | TanggalWaktu | Tidak | Tanggal keranjang dibuat, dalam format tanggal waktu. Diterapkan setelah pembuatan keranjang yang berhasil. |
| lastModifiedTimeStamp | TanggalWaktu | Tidak | Tanggal terakhir keranjang diperbarui, dalam format tanggal-waktu. Diterapkan setelah pembuatan keranjang yang berhasil. |
| cap waktu kedaluwarsa | TanggalWaktu | Tidak | Tanggal kedaluwarsa keranjang, dalam format tanggal-waktu. Diterapkan setelah keranjang berhasil dibuat. |
| lastModifiedUser | string | Tidak | Pengguna yang terakhir memperbarui keranjang. Diterapkan setelah keranjang berhasil dibuat. |
| lineItems | Array dari objek-objek | Ya | Sekumpulan sumber daya CartLineItem. |
| PernyataanKemitraanDiterima | Boolean | Ya | Konfirmasi penyelesaian Pernyataan |
Tabel ini menjelaskan properti CartLineItem dalam isi permintaan.
Nota
Saat memeriksa keranjang melalui API, barang-barang diproses sesuai urutan mereka dimasukkan ke dalam keranjang. Pesanan dapat memengaruhi kelayakan untuk promosi dengan batasan New To Offer jika ada dua produk dengan jenis yang sama di keranjang, satu dengan ID promo dan yang lainnya tanpa ID promo (misalnya, dengan syarat yang berbeda). Pastikan untuk menempatkan item apa pun yang memenuhi syarat untuk promosi terlebih dahulu di keranjang jika Anda membeli beberapa item.
| Harta benda | Jenis | Diperlukan | Deskripsi |
|---|---|---|---|
| Id | string | Tidak | Pengidentifikasi unik untuk item baris keranjang. Diterapkan setelah keranjang berhasil dibuat. |
| catalogId | string | Ya | Pengidentifikasi item katalog. Pastikan ketersediaan item katalog adalah untuk segmen yang benar. |
| nama yang ramah | string | Tidak | Fakultatif. Nama yang ramah pengguna untuk item yang ditentukan oleh mitra untuk membantu membedakan. |
| promotionId | string | Tidak | Fakultatif. Sebagian besar promosi perdagangan baru diterapkan secara otomatis, namun untuk promosi opsional (seperti Bridge to the Cloud 2) agar dapat diterapkan ke item baris keranjang, mitra perlu menyertakan ID promosi saat menambahkannya ke troli. |
| jumlah | Int | Ya | Jumlah lisensi atau instance. |
| kodeMataUang | string | Tidak | Kode mata uang. |
| billingCycle | Benda | Ya | Jenis siklus penagihan yang ditetapkan untuk periode saat ini. |
| customTermEndDate | TanggalWaktu | Tidak | Tanggal akhir langganan yang sudah ada, yang ingin Anda samakan tanggal akhirnya dengan langganan baru. |
| Peserta | Daftar pasangan Objek String | Tidak | Kumpulan PartnerId on Record (PartnerID) pada pembelian. |
| konteks penyediaan | Kamus<string, string> | Tidak | Informasi yang diperlukan untuk penyediaan beberapa item dalam katalog. Properti provisioningVariables dalam SKU menunjukkan properti mana yang diperlukan untuk item tertentu dalam katalog. |
| kelompok pesanan | string | Tidak | Grup untuk menunjukkan item mana yang dapat ditempatkan bersama-sama. |
| galat | Benda | Tidak | Diterapkan setelah keranjang dibuat jika terjadi kesalahan. |
| diperpanjangKe | Array dari objek-objek | Tidak | Sekumpulan sumber daya yang diperbarui menjadi. |
| Pengesahan Diterima | Boolean | Tidak | Menunjukkan persetujuan atas penawaran atau syarat-syarat sku. Diperlukan hanya untuk penawaran atau SKU di mana SkuAttestationProperties atau OfferAttestationProperties enforceAttestation bernilai True. |
| transaction_reseller | String | Tidak | Ketika penyedia tidak langsung menempatkan pesanan atas nama reseller tidak langsung, isi bidang ini hanya dengan PartnerID dari reseller tidak langsung (jangan pernah ID penyedia tidak langsung). Ini memastikan pengelolaan insentif yang tepat. |
| transaksi_tambahan_penjual_kembali | String | Tidak | Ketika penyedia tidak langsung menempatkan pesanan atas nama distributor tidak langsung, isi bidang ini dengan PartnerID dari hanya distributor tidak langsung tambahan (jangan pernah ID penyedia tidak langsung). Insentif tidak berlaku untuk pengecer lain ini. Hanya maksimal lima Reseller Tidak Langsung yang dapat dimasukkan. Persyaratan ini hanya berlaku mitra yang bertransaksi di negara/wilayah Eropa. |
| scheduledNextTermInstructions | Benda | Tidak | Menentukan instruksi istilah berikutnya untuk langganan uji coba. Mitra dapat menentukan durasi jangka waktu, frekuensi penagihan, dan jumlah yang dimiliki langganan berbayar terkait saat perpanjangan. |
Tabel ini menjelaskan properti RenewsTo di isi permintaan untuk penawaran Microsoft Marketplace.
| Harta benda | Jenis | Diperlukan | Deskripsi |
|---|---|---|---|
| durasiJangkaWaktu | string | Tidak | Representasi ISO 8601 dari durasi jangka waktu perpanjangan. Nilai yang didukung saat ini adalah P1M (1 bulan) dan P1Y (1 tahun). |
ScheduledNextTermInstructions
Tabel ini menjelaskan properti scheduledNextTermInstructions dalam isi permintaan untuk penawaran uji coba berbasis lisensi NCE. Jika tidak ada nilai yang ditentukan, uji coba diperpanjang menjadi langganan berbayar dengan jangka waktu tahunan, penagihan bulanan, dan 25 lisensi.
| Harta benda | Jenis | Diperlukan | Deskripsi |
|---|---|---|---|
| produk | array | Tidak | Array yang menentukan penawaran langganan uji coba diperpanjang ke dalam dan istilah dan frekuensi penagihan yang dimiliki langganan berbayar. |
| jumlah | Int | Tidak | Kuantitas lisensi yang dimiliki langganan berbayar yang sesuai setelah penawaran uji coba diperpanjang. |
Produk
Tabel ini menjelaskan properti productTerm dalam isi permintaan untuk penawaran uji coba berbasis lisensi NCE. Jika tidak ada nilai yang ditentukan dalam array ini, uji coba diperpanjang menjadi langganan berbayar dengan jangka waktu tahunan, tagihan bulanan.
| Harta benda | Jenis | Diperlukan | Deskripsi |
|---|---|---|---|
| ID produk | string | Tidak | GUID yang diformat untuk mewakili produk dari langganan berbayar yang akan diteruskan oleh masa uji coba. |
| skuId | string | Tidak | GUID yang diformat untuk mewakili SKU langganan berbayar ke mana uji coba diperbarui. |
| availabilityId | string | Tidak | GUID yang diformat untuk mewakili ketersediaan langganan berbayar yang akan diperbarui oleh uji coba. |
| billingCycle | string | Tidak | Frekuensi penagihan yang dimiliki langganan berbayar yang sesuai setelah penawaran uji coba diperpanjang. |
| durasiJangkaWaktu | string | Tidak | Jangka waktu langganan berbayar setelah perpanjangan penawaran uji coba. |
Contoh permintaan
POST /v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/carts HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4fa6dad6-a89f-4875-8247-8294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 496
Expect: 100-continue
{
"lineItems": [
{
/* Microsoft Azure Subscription */
"id": 0,
"catalogItemId": "MS-AZR-0145P",
"quantity": 1,
"billingCycle": "monthly",
"termDuration": "P1Y"
},
{
/* Azure Reserved Instance */
"id": 1,
"catalogItemId": "DZH318Z0BQ36:004G:DZH318Z08C0S",
"quantity": 1,
"billingCycle": "one_time",
"termDuration": "P1Y",
"provisioningContext": {
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"scope": "shared"
}
},
{
/* Azure Reserved Instance */
"id": 2,
"catalogItemId": "DZH318Z0BQ36:004J:DZH318Z08B8X",
"quantity": 1,
"billingCycle": "one_time",
"termDuration": "P3Y",
"provisioningContext": {
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"scope": "single"
}
},
{
/* Perpetual Software */
"id": 3,
"catalogItemId": "DG7GMGF0DWTL:0001:DG7GMGF0DSFM",
"quantity": 1,
"billingCycle": "one_time"
},
{
/* SaaS */
"id": 4,
"catalogItemId": "DZH318Z0BXWC:0002:DZH318Z0BMRV",
"quantity": 1,
"billingCycle": "monthly",
"termDuration": "P1M"
},
{
/* SaaS Free Trial */
"id": 5,
"catalogItemId": "DZH318Z0C0WF:0001:DZH318Z0BP69",
"quantity": 10,
"billingCycle": "none",
"termDuration": "P1M",
"renewsTo": {
"termDuration": "P1Y"
}
}
]
}
Penting
Sejak Juni 2023, rilis terbaru dari "Partner Center .NET SDK" versi 3.4.0 telah diarsipkan. Anda dapat mengunduh rilis SDK dari GitHub, bersama dengan berkas readme yang berisi informasi berguna.
Mitra didorong untuk terus menggunakan REST API Partner Center.
Respons REST
Jika berhasil, metode ini mengembalikan sumber daya Keranjang yang telah diisi pada badan respons.
Kode kesalahan dan keberhasilan respons
Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan informasi keberhasilan atau kegagalan dan penelusuran kesalahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter lainnya. Untuk daftar lengkapnya, lihat kode kesalahan .
Contoh respons
HTTP/1.1 201 Created
Content-Length: 764
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 4fa6dad6-a89f-4875-8247-8294a10ae1cf
X-Locale: en-US,en-US
MS-CV: sF/wRa2ih0CzbABc.0
MS-ServerId: 000001
Date: Thu, 15 Mar 2018 17:15:01 GMT
{
"id": "3655b1a0-b1c9-4268-9824-577fdbc4d0be",
"creationTimestamp": "2019-01-16T00:45:41.6062996Z",
"lastModifiedTimestamp": "2019-01-16T00:45:41.6062996Z",
"expirationTimestamp": "2019-01-16T01:00:54.4188497Z",
"lastModifiedUser": "1824b7fc-2fac-4478-b177-66823c40ab75",
"status": "Active",
"lineItems": [
{
"id": 0,
"catalogItemId": "MS-AZR-0145P",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "monthly",
"termDuration": "P1Y",
"orderGroup": "OMS-0"
},
{
"id": 1,
"catalogItemId": "DZH318Z0BQ36:004G:DZH318Z08C0S",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "one_time",
"termDuration": "P1Y",
"provisioningContext": {
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"scope": "shared"
},
"orderGroup": "0"
},
{
"id": 2,
"catalogItemId": "DZH318Z0BQ36:004J:DZH318Z08B8X",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "one_time",
"termDuration": "P3Y",
"provisioningContext": {
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"scope": "shared"
},
"orderGroup": "0"
},
{
"id": 3,
"catalogItemId": "DG7GMGF0DWM3:0002:DG7GMGF0DT1M",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "one_time",
"orderGroup": "0"
},
{
"id": 4,
"catalogItemId": "DZH318Z0BXWC:0002:DZH318Z0BMRV",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "monthly",
"termDuration": "P1M",
"orderGroup": "1"
},
{
"id": 5,
"catalogItemId": "DZH318Z0C0WF:0001:DZH318Z0BP69",
"quantity": 10,
"currencyCode": "USD",
"billingCycle": "none",
"termDuration": "P1M",
"renewsTo": {
"termDuration": "P1Y"
},
"orderGroup": "2"
}
],
"links": {
"self": {
"uri": "/customers/28045616-f6b9-462f-9701-0d89b5e65c44/carts/3655b1a0-b1c9-4268-9824-577fdbc4d0be",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Cart"
}
}
Contoh untuk 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 .
Contoh permintaan
POST /v1/customers/932c4101-dc08-461b-b4c1-75d80e905775/carts HTTP/1.1
Host: api.partnercenter.microsoft.com
Content-Type: application/json
Content-Length: 165
{
"LineItems": [
{
"CatalogItemId":"CFQ7TTC0LFLZ:0002:CFQ7TTC0K4TS",
"Quantity": 1,
"TermDuration": "P1M",
"BillingCycle": "Monthly"
}
]
}
Penting
Paket Azure dan item perangkat lunak abadi tidak mendukung properti termDuration. Hindari menyertakan ini saat mengumpulkan jenis item ini.
// request example where several renewal values for an NCE license-based trial are specified
http
POST /v1/customers/932c4101-dc08-461b-b4c1-75d80e905775/carts HTTP/1.1
Host: api.partnercenter.microsoft.com
Content-Type: application/json
Content-Length: 165
{
"lineItems": [
{
"id": 0,
"catalogItemId": "CFQ7TTC0LCHC:0003:CFQ7TTC0XCQC",
"quantity": 25,
"currencyCode": "USD",
"billingCycle": "none",
"termDuration": "P1M",
"promotionId": null,
"provisioningContext": {},
"customTermEndDate": null,
"scheduledNextTermInstructions": {
"product": {
"billingCycle": "monthly",
"termDuration": "P1M"
}
}
}
],
"partnerOnRecordAttestationAccepted": true
}
Respons REST
Jika berhasil, metode ini mengembalikan sumber daya Keranjang yang telah diisi pada badan respons.
Kode kesalahan dan keberhasilan respons
Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan lainnya. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter lainnya. Untuk daftar lengkapnya, lihat kode kesalahan .
Contoh respons
{
"id": "2517c51b-58cd-4abe-87ed-3ab812401ab4",
"creationTimestamp": "2023-07-11T21:16:11.55149Z",
"lastModifiedTimestamp": "2023-07-11T21:16:11.5515713Z",
"expirationTimestamp": "2023-07-18T21:16:17.2480482Z",
"lastModifiedUser": "9db12087-fbc3-481c-8965-73d44ff88e27",
"status": "Active",
"lineItems": [
{
"id": 0,
"catalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0VZW5",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "monthly",
"termDuration": "P1Y",
"provisioningContext": {},
"orderGroup": "0",
"pricing": {
"listPrice": 30.4,
"discountedPrice": 30.4,
"proratedPrice": 30.4,
"price": 30.4,
"extendedPrice": 364.8
}
}
],
"links": {
"self": {
"uri": "/customers/ebd8b4c2-4069-46a8-bd70-123d6dec3e39/carts/2517c51b-58cd-4abe-87ed-3ab812401ab4",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Cart"
}
}
// response content for an order containing an NCE license-based trial
{
"id": "99d3777b-61da-4c95-aefa-203c248c4180",
"creationTimestamp": "2025-02-04T22:22:36.7924103Z",
"lastModifiedTimestamp": "2025-02-04T22:22:36.7924109Z",
"expirationTimestamp": "2025-02-11T22:23:34.5190698Z",
"lastModifiedUser": "b5109661-56c5-45ed-9447-f67463458a97",
"status": "Active",
"lineItems": [
{
"id": 0,
"catalogItemId": "CFQ7TTC0LCHC:0003:CFQ7TTC0XCQC",
"quantity": 25,
"currencyCode": "USD",
"billingCycle": "none",
"termDuration": "P1M",
"provisioningContext": {},
"orderGroup": "0",
"pricing": {
"listPrice": 0.0,
"discountedPrice": 0.0,
"proratedPrice": 0.0,
"price": 0.0,
"extendedPrice": 0.0
},
"scheduledNextTermInstructions": {
"product": {
"productId": "CFQ7TTC0LCHC",
"skuId": "0002",
"availabilityId": "CFQ7TTC0XL82",
"billingCycle": "monthly",
"termDuration": "P1M"
},
"quantity": 25
}
}
],
"links": {
"self": {
"uri": "/customers/81e78b53-9aa8-44e7-a041-3b15272d8f84/carts/99d3777b-61da-4c95-aefa-203c248c4180",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Cart"
}
}