Membuat migrasi bisnis 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, kemudian Akun. Pada halaman Akun Pelanggan, temukan ID Microsoft di bagian Info Akun Pelanggan. ID Microsoft sama dengan ID pelanggan (customer-tenant-id).

  • ID langganan saat ini

Batas tarif

Batas API Pembuatan Migrasi adalah 100 panggilan oleh mitra dalam 5 menit. Informasi selengkapnya tentang batas laju dan pembatasan tersedia di panduan pembatasan API .

Permintaan REST

Sintaksis permintaan

Metode Meminta URI
TIANG {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 Jenis Diperlukan Deskripsi
customer-tenant-id (identitas pelanggan-penyewa) tali Ya String berformat GUID yang mengidentifikasi pelanggan.

Header permintaan

Untuk informasi selengkapnya, lihat header REST dari Pusat Mitra.

Isi permintaan

Tabel ini menjelaskan properti Langganan dalam isi permintaan.

Harta benda Jenis Diperlukan Deskripsi
IdLanggananSaatIni tali Ya Pengidentifikasi langganan yang menunjukkan langganan mana yang memerlukan validasi untuk migrasi.
durasiPeriode tali Tidak Durasi jangka waktu dapat diubah setelah migrasi.
Siklus penagihan tali Tidak Siklus penagihan dapat diubah saat migrasi.
membeliJangkaWaktuPenuh bool Tidak Periode baru dapat dimulai di NCE setelah migrasi.
jumlah Int Tidak Kuantitas lisensi untuk langganan dapat ditingkatkan atau dikurangi saat migrasi.
tanggal akhir masa kustom tanggal dan waktu Tidak 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: Ratakan tanggal akhir langganan di Pusat Mitra

Contoh permintaan

Perhatikan, add-on bertingkat (langganan add-on yang memiliki add-on) harus ditulis sebagai daftar datar dalam tubuh permintaan di bagian addOnMigrations, dan tidak disusun bersarang di dalam langganan add-on lainnya dalam permintaan. Lihat contoh permintaan terakhir untuk mengetahui bagaimana add-on dapat ditulis dalam tubuh 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 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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}
  • Last updated on