Membuat migrasi perdagangan baru
Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS
Cara membuat migrasi langganan ke Pengalaman Perdagangan Baru
Prasyarat
Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. 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 , lalu pelanggan dari daftar pelanggan, lalu Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian Info Akun Pelanggan. ID Microsoft sama dengan ID pelanggan (customer-tenant-id
).ID langganan saat ini
Batas tarif
Batas Api Buat Migrasi adalah 100 panggilan oleh mitra dalam 5 menit. Informasi selengkapnya tentang batas laju dan pembatasan tersedia di panduan pembatasan API.
Permintaan REST
Minta sintaks
Metode | URI Permintaan |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1 |
Parameter URI
Tabel ini mencantumkan parameter kueri yang diperlukan untuk membuat migrasi perdagangan baru.
Nama | Tipe | Wajib | Deskripsi |
---|---|---|---|
customer-tenant-id | string | Ya | String berformat GUID yang mengidentifikasi pelanggan. |
Header permintaan
Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.
Isi permintaan
Tabel ini menjelaskan properti Langganan dalam isi permintaan.
Properti | Tipe | Wajib | Deskripsi |
---|---|---|---|
currentSubscriptionId | string | Ya | Pengidentifikasi langganan yang menunjukkan langganan mana yang memerlukan validasi untuk migrasi. |
termDuration | string | No | Durasi jangka waktu dapat diubah setelah migrasi. |
billingCycle | string | No | Siklus penagihan dapat diubah saat migrasi. |
purchaseFullTerm | bool | No | Istilah baru dapat dimulai di NCE saat migrasi. |
kuantitas | int | No | Kuantitas lisensi untuk langganan dapat ditingkatkan atau dikurangi saat migrasi. |
customTermEndDate | datetime | No | Tanggal akhir dapat diatur untuk menyelaraskan dengan langganan atau bulan kalender OnlineServicesNCE nontrial yang ada. Ada informasi selengkapnya tentang menyelaraskan tanggal akhir langganan di sini: Menyelaraskan tanggal akhir langganan di Pusat Mitra |
Contoh permintaan
Perhatikan, add-on berlapis (langganan add-on dengan langganan add-on) harus ditulis dalam isi permintaan sebagai daftar datar dalam addOnMigrations dan tidak disarangkan di dalam langganan add-on lainnya dalam permintaan; lihat contoh permintaan terakhir tentang bagaimana add-on dapat ditulis dalam isi permintaan.
{
"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"
}
{
"currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC",
"termDuration": "P1M",
"billingCycle": "Monthly",
}
{
"currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC",
"purchaseFullTerm": true
}
{
"currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
"quantity": 1,
"billingCycle": "Annual",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"addOnMigrations": [
{
"currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
"quantity": 1,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1M"
},
{
"currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
"quantity": 1,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y"
}
]
}
Respons REST
Jika berhasil, metode ini mengembalikan detail Langganan yang sedang dimigrasikan (objek migrasi) dalam isi respons.
Kode kesalahan dan keberhasilan respons
Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, parameter lainnya. Untuk daftar lengkapnya, lihat Kode kesalahan REST Pusat Mitra.
Contoh respons
{
"addOnMigrations": [
{
"currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
},
{
"currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
},
{
"currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
}
],
"id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
"startedTime": "2022-02-23T13:00:48.4489832Z",
"currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
"status": "Processing",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
}
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk