Udostępnij za pośrednictwem

Anulowanie subskrypcji platformy Azure

  • Artykuł

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

W przypadku naruszenia zabezpieczeń lub nadużyć partnerzy z subskrypcjami klienta platformy Azure mogą anulować subskrypcje bezpośrednio z portalu Centrum partnerskiego lub za pomocą interfejsu API, zamykając podejrzane działania wykryte w subskrypcjach planu platformy Azure.

Ten interfejs API anuluje subskrypcję platformy Azure. Jeśli partnerzy chcą anulować więcej niż jedną subskrypcję, muszą oddzielnie wywołać interfejs API, aby anulować każdy z nich.

Jeśli partnerzy chcą zawiesić swój plan platformy Azure, powinni użyć istniejącego dostępnego interfejsu API, zaktualizuj subskrypcję według identyfikatora.

Anulowanie planu platformy Azure nie jest obsługiwane przez następujący interfejs API.

Aby anulować, partnerzy muszą być administratorami globalnymi z rolami agenta administracyjnego.

Wymagania wstępne

  • Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.

  • Customer_id.

  • Subscription_id.

  • Entitlement_id.

C#

Aby anulować subskrypcję platformy Azure, musisz zidentyfikować identyfikator klienta, identyfikator subskrypcji i identyfikator uprawnień dla tej subskrypcji.

Żądanie REST

Składnia żądania

Metoda Identyfikator URI żądania
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1

Parametr identyfikatora URI

W tej tabeli wymieniono wymagane parametry zapytania w celu anulowania subskrypcji platformy Azure.

Nazwa/nazwisko Type Wymagane Opis
customer_id String Y Wartość jest ciągiem, który określa identyfikator klienta.
subscription_id String Y Wartość jest ciągiem, który określa identyfikator subskrypcji.
entitlement_id String Y Wartość jest ciągiem, który określa identyfikator uprawnienia subskrypcji platformy Azure.

Nagłówki żądań

Zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

HTTP
{ "cancellationReason": "compromise" }

Przykład żądania

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": []
   }
  }
}

Odpowiedź REST

Jeśli ta metoda powiedzie się, ta metoda zwraca uprawnienie platformy Azure dla zasobu subskrypcji w treści odpowiedzi.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i więcej informacji o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Stan HTTP Kod HTTP Kod błędu Opis
BadRequest 400 900118 Nieprawidłowy identyfikator klienta.
BadRequest 400 800002 Identyfikator {0} klienta powinien mieć format GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
BadRequest 400 800002 Wymagany jest identyfikator subskrypcji.
BadRequest 400 800002 Wymagany jest identyfikator upoważnienia.
BadRequest 400 800002 Wymagana jest zawartość żądania anulowania uprawnień platformy Azure.
Dostęp zabroniony 403 900159 Partner z identyfikatorem {0} konta i identyfikatorem {1} organizacji nie ma relacji handlowych z klientem z identyfikatorem konta i identyfikatorem {2} {3}organizacji.
BadRequest 400 900307 Przyczyna anulowania "{0} jest nieprawidłowa.
Nie znaleziono 404 800111 Nie można odnaleźć uprawnień platformy Azure o identyfikatorze {0} .

Przykład odpowiedzi

Odpowiedź na anulowanie subskrypcji zawiera stan uprawnień. Spodziewaj się około 10 minut, aby stan został odzwierciedlony (czyli aktywny do nieaktywnego).

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": []
 }
}

Powiązana zawartość