Mendapatkan jadwal migrasi perdagangan baru
Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS
Artikel ini menjelaskan cara mendapatkan jadwal migrasi perdagangan baru.
Penting
API ini saat ini hanya tersedia di penyewa Sandbox.
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
Permintaan REST
Ada dua cara berbeda yang dapat dikueri mitra.
- Untuk Mengkueri jadwal tertentu
- Mendapatkan daftar jadwal untuk kriteria tertentu
Minta sintaks
Metode | URI Permintaan |
---|---|
DAPATKAN | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID} |
Parameter URI
Tabel ini mencantumkan parameter kueri yang diperlukan untuk membuat migrasi perdagangan baru.
Nama | Jenis | Diperlukan | Keterangan |
---|---|---|---|
customer-tenant-id | string | Ya | String berformat GUID yang mengidentifikasi pelanggan. |
Metode | URI Permintaan |
---|---|
DAPATKAN | {baseURL}/v1/migrations/newcommerce/schedules? CustomerTenantId={customer-tenant-id} |
Parameter URI
Tabel ini mencantumkan parameter kueri yang diperlukan untuk membuat migrasi perdagangan baru. Siapa pun dari parameter kueri dapat digunakan.
Nama | Jenis | Keterangan |
---|---|---|
customerTenantId | string | String berformat GUID yang mengidentifikasi pelanggan. |
currentSubscriptionID | string | String berformat GUID yang mengidentifikasi ID Langganan saat ini |
externalReferenceID | string | String berformat GUID yang mengidentifikasi batch migrasi |
Header permintaan
Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.
Isi respons
Tabel ini menjelaskan properti langganan dalam respons.
Properti | Jenis | Diperlukan | Keterangan |
---|---|---|---|
currentSubscriptionId | string | Ya | Pengidentifikasi langganan yang menunjukkan langganan mana yang memerlukan validasi untuk migrasi. |
termDuration | string | No | Durasi jangka waktu dapat ditentukan untuk diubah saat migrasi. |
billingCycle | string | No | Siklus penagihan dapat ditentukan untuk 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 agar selaras dengan langganan atau bulan kalender OnlineServicesNCE non-uji coba yang sudah ada. Ada informasi selengkapnya tentang menyelaraskan tanggal akhir langganan di sini: Menyelaraskan tanggal akhir langganan di Pusat Mitra |
targetDate | datetime | No | Tanggal Target kapan harus menjadwalkan migrasi. |
migrateOnRenewal | bool | No | Menunjukkan apakah jadwal perlu terjadi pada perpanjangan |
status | string | No | Status migrasi jadwal |
createdTime | datetime | No | Ketika jadwal dibuat |
lastModifiedTime | datetime | No | Kapan jadwal terakhir diubah |
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, dan parameter tambahan. Untuk daftar lengkapnya, lihat Kode kesalahan REST Pusat Mitra.
Contoh respons
[
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}
]