Menampilkan transisi

Artikel
03/07/2025

Berlaku untuk

Pusat Mitra

Peran yang sesuai

Agen admin

Catatan

Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat ikhtisar pengalaman perdagangan baru.

Digunakan untuk mendapatkan riwayat transisi untuk pelanggan dan langganan tertentu. Riwayat mencakup semua peristiwa yang diproses untuk transisi. Ini hanya mendukung transisi langganan berbasis lisensi perdagangan baru.

Prasyarat

Kredensial seperti yang diuraikan dalam Pusat Otentikasi 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 Partner Center dengan memilih Ruang Kerja Pelanggan, lalu pelanggan dari daftar pelanggan, kemudian Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian Info Akun Pelanggan. ID Microsoft sama dengan ID pelanggan (customer-tenant-id).
Satu ID langganan untuk langganan yang ditransfer.

Permintaan REST

[GET] pelanggan/{customer-tenant-id}/langganan/{subscription-id}/transisi

Sintaks permintaan

Metode	URI Permintaan
DAPATKAN	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

Parameter URI

Gunakan parameter kueri berikut untuk mengembalikan transisi yang memenuhi syarat.

Nama	Tipe	Wajib	Deskripsi
customer-tenant-id	Panduan	Y	GUID yang sesuai dengan penyewa (tenant) pelanggan.
id langganan	Guid	Y	GUID yang berhubungan dengan langganan awal.
operation-id	Panduan	N	GUID untuk mengidentifikasi Transisi secara unik dan melacak statusnya.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tidak

Contoh permintaan

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

Respons REST

Jika berhasil, ini akan mengembalikan riwayat transisi pada langganan yang diberikan.

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 lengkap, lihat kode kesalahan.

Contoh tanggapan

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "transition": [
        {
        "operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c", 
        "FromCatalogItemId": "CFQ7TTC0LDPB:0001:CFQ7TTC0LGNT",
        "ToCatalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0K9G9",
        "quantity": 1,
        "transitionType": "transition_with_license_transfer",
        "Events": [
           {
               "name": "Conversion",
               "status": "Started ",
               "timestamp": "2021-01-08T18:01:14.7488618Z",
               "attributes":
                     {
                          "objectType": "TransitionEvent"
                     }
           }, 
           {
               "name": "Conversion",
               "status": "Completed",
               "timestamp": "2021-01-08T18:37:41.591855Z",
               "attributes":
                     {
                          "objectType": "TransitionEvent"
                     }
            }
        ],
        "attributes":
               {
                     "objectType": "Transition"
               }
        }
    ],
    "attributes":
        {
               "objectType": "Collection"
        }
}

Bagikan melalui