Mendapatkan status pendaftaran langganan

Artikel
02/05/2024

Cara mendapatkan status pendaftaran langganan untuk langganan pelanggan yang telah diaktifkan untuk membeli Azure Reserved VM Instances.

Untuk membeli Instans Azure Reserved VM menggunakan API Pusat Mitra, Anda harus memiliki setidaknya satu langganan CSP Azure yang sudah ada. Metode Daftarkan langganan memungkinkan Anda mendaftarkan langganan CSP Azure yang ada, memungkinkannya untuk membeli Instans VM Cadangan Azure. Metode ini memungkinkan Anda untuk mengambil status pendaftaran tersebut.

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.

C#

Untuk mendapatkan status pendaftaran langganan, mulailah dengan menggunakan metode IAggregatePartner.Customers.ById dengan ID pelanggan untuk mengidentifikasi pelanggan. Kemudian, dapatkan antarmuka ke operasi langganan dengan memanggil metode Subscription.ById() dengan ID langganan untuk mengidentifikasi langganan. Selanjutnya, gunakan properti RegistrationStatus untuk mendapatkan antarmuka ke operasi status pendaftaran langganan saat ini, dan panggil metode Get atau GetAsync untuk mengambil objek SubscriptionRegistrationStatus .

// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;

// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();

Permintaan REST

Minta sintaks

Metode	URI Permintaan
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus HTTP/1.1

Parameter URI

Gunakan parameter jalur berikut untuk mengidentifikasi pelanggan dan langganan.

Nama	Jenis	Diperlukan	Deskripsi
id pelanggan	string	Ya	String berformat GUID yang mengidentifikasi pelanggan.
subscription-id	string	Ya	String berformat GUID yang mengidentifikasi langganan.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tidak ada.

Contoh permintaan

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

Respons REST

Jika berhasil, isi respons berisi sumber daya SubscriptionRegistrationStatus .

Respons keberhasilan dan kode kesalahan

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.

Contoh respons

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

{
    "subscriptionId":"<subscription-id>",
    "status":"NotRegistered",
    "attributes":{
        "objectType":"SubscriptionRegistrationStatus"
    }
}

Bagikan melalui