Azure aboneliğini iptal etme
Ş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öneticiler 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ğeri, aboneliğin 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: 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/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"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: 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/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"method": "GET",
"headers": []
}
}