Memperbarui jadwal migrasi perdagangan baru

Artikel
07/02/2024

Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS

Artikel ini menjelaskan cara memperbarui jadwal migrasi perdagangan baru. Mitra dapat memperbarui sebelum tanggal target terjadwal.

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

Minta sintaks

Metode	URI Permintaan
TARUH	{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.
scheduleID	string	Ya	String berformat GUID yang mengidentifikasi jadwal

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tabel ini menjelaskan properti langganan dalam isi permintaan.

Properti	Jenis	Diperlukan	Keterangan
currentSubscriptionId	string	Ya	Pengidentifikasi langganan yang menunjukkan langganan mana yang memerlukan validasi untuk migrasi. Tidak diizinkan untuk operasi pembaruan.
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. Jika targetDate diatur untuk tanggal yang ditentukan, migrationOnRenewal dapat diatur ke null atau false.
migrateOnRenewal	bool	No	Jika bendera diatur true untuk migrasiOnRenewal, tidak perlu spesifik targetDate untuk menjadwalkan migrasi.

Contoh permintaan

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}

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"
}

Bagikan melalui