Azure aboneliğini iptal etme

Makale
02/12/2024

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Risk altında veya uygunsuz kullanım durumunda, Azure müşteri aboneliklerine sahip iş ortakları abonelikleri doğrudan İş Ortağı Merkezi portalından veya API ile iptal ederek Azure planı aboneliklerinde bulunan şüpheli etkinlikleri kapatabilir.

Bu API bir Azure aboneliğini iptal eder. birden fazla aboneliği iptal etmek isteyen iş ortaklarının her birini iptal etmek için API'yi ayrı ayrı çağırmaları gerekir.

İş ortakları Azure planlarını askıya almak isterse mevcut API'yi (Aboneliği kimlikle güncelleştir) kullanmalıdır.

Azure planının iptali aşağıdaki API tarafından desteklenmez.

İş ortaklarının iptal etmek için Yönetici Aracısı rollerine sahip Genel Yönetici istratörler olması gerekir.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri Bu senaryo hem tek başına Uygulama hem de App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Customer_id.
Subscription_id.
Entitlement_id.

C#

Bir Azure aboneliğini iptal etmek için bu aboneliğin müşteri kimliğinizi, abonelik kimliğinizi ve yetkilendirme kimliğinizi tanımlamanız gerekir.

Müşteri almak için, daha fazla yardım için Kimliğe göre müşteri alma ve Müşteri kimliğine göre müşteri alma - REST API'ye bakın.
Abonelik almak için, daha fazla yardım için Kimliğe göre abonelik alma ve Kimliğe göre abonelik alma - REST API'si konularına bakın.
Yetkilendirme almak için bkz . Abonelik için Azure yetkilendirmesi alma - REST API.

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
POST	{baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1

URI parametresi

Bu tabloda, Bir Azure aboneliğini iptal etmek için gerekli sorgu parametreleri listelenir.

Ad	Tür	Zorunlu	Açıklama
customer_id	String	Y	Değer, müşterinin tanımlayıcısını belirten bir dizedir.
subscription_id	String	Y	Değer, müşterinin tanımlayıcısını belirten bir dizedir.
entitlement_id	String	Y	Değeri, Azure aboneliği yetkilendirmesinin tanımlayıcısını belirten bir dizedir.

İstek üst bilgileri

Bkz. İş Ortağı Merkezi REST üst bilgileri.

Request body

HTTP
{ "cancellationReason": "compromise" }

İstek örneği

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: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
{
 "id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1",
 "links": {
  "self": {
  "uri":
  "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
  "method": "GET",
"headers": []
   }
  }
}

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesindeki bir abonelik kaynağı için bir Azure yetkilendirmesi döndürür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve daha fazla hata ayıklama bilgisi ile birlikte gelir. Bu kodu, hata türünü ve diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST hata kodları.

HTTP Durumu	HTTP Kodu	Hata Kodu	Açıklama
BadRequest	400	900118	Geçersiz müşteri kimliği.
BadRequest	400	800002	Müşteri kimliği {0} GUID biçimine sahip olmalıdır (xxxxxxxx-xxxx-xxxx-xxxx-xxxxx).
BadRequest	400	800002	Abonelik kimliği gereklidir.
BadRequest	400	800002	Yetkilendirme kimliği gereklidir.
BadRequest	400	800002	Azure yetkilendirme iptal isteği içeriği gereklidir.
Yasak	Kategori 403	900159	Hesap kimliği ve kuruluş kimliğine {0}{1} sahip iş ortağının, hesap kimliği ve kuruluş kimliği {2}{3}olan müşteriyle ticari ilişkisi yoktur.
BadRequest	400	900307	İptal nedeni '{0} geçersiz.
NotFound	404	800111	Kimlikli {0} Azure yetkilendirmesi bulunamadı.

Yanıt örneği

Aboneliği iptal etme yanıtı yetkilendirme durumunu içerir. Durumun yansıtılması için yaklaşık 10 dakika bekleme (etkinden etkin olmayana kadar).

HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6eacec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT
{
"id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"friendlyName": " Cancel_Azure_Subscription",
"status": "active",
"subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1",
"links": {
"self": {
"uri":
"/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"method": "GET",
"headers": []
 }
}

Aracılığıyla paylaş