Bagikan melalui

Membatalkan langganan Azure

  • Artikel

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

Jika penyusupan atau penyalahgunaan, mitra dengan langganan pelanggan Azure dapat membatalkan langganan langsung dari portal Pusat Mitra atau dengan API, mematikan aktivitas mencurigakan yang ditemukan dalam langganan paket Azure mereka.

API ini akan membatalkan langganan Azure. Jika mitra ingin membatalkan lebih dari satu langganan, mereka perlu secara terpisah memanggil API untuk membatalkan masing-masing langganan.

Jika mitra ingin menangguhkan paket Azure mereka, mereka harus menggunakan API yang ada yang tersedia, Memperbarui langganan berdasarkan ID.

Membatalkan paket Azure tidak didukung oleh API berikut.

Mitra harus administrator global dengan peran Agen Admin untuk membatalkan.

Prasyarat

  • Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.

  • Customer_id.

  • Subscription_id.

  • Entitlement_id.

C#

Untuk membatalkan langganan Azure, Anda perlu mengidentifikasi ID pelanggan, ID langganan, dan ID pemberian izin untuk langganan tersebut.

Permintaan REST

Minta sintaks

Metode URI Permintaan
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1

Parameter URI

Tabel ini mencantumkan parameter kueri yang diperlukan untuk membatalkan langganan Azure.

Nama Jenis Diperlukan Keterangan
customer_id String Y Nilainya adalah string yang menunjukkan pengidentifikasi pelanggan.
subscription_id String Y Nilai adalah string yang menunjukkan pengidentifikasi langganan.
entitlement_id String Y Nilainya adalah string yang menunjukkan pengidentifikasi pemberian izin langganan Azure.

Header permintaan

Lihat Header REST Pusat Mitra.

Isi permintaan

HTTP
{ "cancellationReason": "compromise" }

Contoh permintaan

POST
[https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel](https://api.partnercenter.microsoft.com/v1/customers/%7bcustomer_id%7d/subscriptions/%7bsubscription_id%7d/azureEntitlements/%7bentitlement_id%7d/cancel)
HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
 "id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
 "links": {
  "self": {
  "uri":
  "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
  "method": "GET",
"headers": []
   }
  }
}

Respons REST

Jika berhasil, metode ini mengembalikan pemberian izin Azure untuk sumber daya langganan dalam isi respons.

Kode kesalahan dan keberhasilan respons

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

HTTP Status Kode HTTP Kode Galat Keterangan
BadRequest 400 900118 ID pelanggan tidak valid.
BadRequest 400 800002 ID {0} Pelanggan harus memiliki format GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxx).
BadRequest 400 800002 ID langganan diperlukan.
BadRequest 400 800002 ID pemberian hak diperlukan.
BadRequest 400 800002 Konten permintaan pembatalan pemberian hak Azure diperlukan.
Terlarang 403 900159 Mitra dengan ID {0} akun dan ID {1} organisasi tidak memiliki hubungan perdagangan dengan pelanggan dengan ID {2} akun dan ID {3}organisasi .
BadRequest 400 900307 Alasan pembatalan '{0} tidak valid.
NotFound 404 800111 Pemberian izin Azure dengan ID {0} tidak ditemukan.

Contoh tanggapan

Respons untuk membatalkan langganan menyertakan status pemberian izin. Harapkan sekitar 10 menit agar status tercermin (yaitu, aktif hingga tidak aktif).

HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT
{
"id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"friendlyName": " Cancel_Azure_Subscription",
"status": "active",
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"links": {
"self": {
"uri":
"/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"method": "GET",
"headers": []
 }
}

Konten terkait