Memvalidasi langganan untuk migrasi

Artikel
07/02/2024

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

Cara memvalidasi langganan untuk migrasi 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 Validasi Migrasi adalah 450 panggilan per kombinasi mitra-pelanggan 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/validate HTTP/1.1

Parameter URI

Tabel ini mencantumkan parameter kueri yang diperlukan untuk memvalidasi langganan untuk migrasi.

Nama	Tipe	Wajib	Deskripsi
customer-tenant-id	string	Ya	String berformat GUID yang mengidentifikasi pelanggan.
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

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.

Contoh permintaan

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

Respons REST

Jika berhasil, metode ini mengembalikan boolean "isEligible" dalam isi respons, yang menunjukkan apakah langganan saat ini memenuhi syarat untuk migrasi ke perdagangan baru. Perhatikan, API Validasi Migrasi tidak memberikan informasi mengenai kelayakan langganan untuk promosi di Perdagangan Baru.

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan ekstra. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter lainnya. Untuk daftar lengkapnya, lihat Kode kesalahan REST Pusat Mitra.

Contoh respons

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }

Bagikan melalui