Udostępnij za pośrednictwem


Anulowanie subskrypcji platformy Azure

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ć 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 oraz mieć przypisane role agenta administracyjnego.

Wymagania wstępne

  • Poświadczenia, jak opisano w Uwierzytelnianiu w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu samodzielnej aplikacji, jak i aplikacji połączonej z użytkownikiem.

  • Identyfikator_klienta.

  • Identyfikator_subskrypcji.

  • Identyfikator uprawnień

C#

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

Żądanie REST

Składnia żądania

Metoda 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 Typ Wymagane Opis
identyfikator_klienta String Y Wartość jest ciągiem, który określa identyfikator klienta.
identyfikator_subskrypcji String Y Wartość jest ciągiem, który określa identyfikator subskrypcji.
identyfikator uprawnienia String Y Wartość jest ciągiem, który określa identyfikator uprawnienia subskrypcji platformy Azure.

Nagłówki żądań

Zobacz Nagłówki REST Centrum Partnerów.

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

W przypadku powodzenia, ta metoda zwraca uprawnienie platformy Azure dla zasobu subskrypcji w treści odpowiedzi.

Kody sukcesu 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 w Centrum partnerskim.

Status HTTP Kod HTTP Kod błędu Opis
Nieprawidłowe Żądanie 400 900118 Nieprawidłowy identyfikator klienta.
Nieprawidłowe Żądanie 400 800002 Identyfikator {0} klienta powinien mieć format GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
Nieprawidłowe Żądanie 400 800002 Wymagany jest identyfikator subskrypcji.
Nieprawidłowe Żądanie 400 800002 Wymagany jest identyfikator upoważnienia.
Nieprawidłowe Żądanie 400 800002 Wymagana jest zawartość żądania anulowania uprawnień platformy Azure.
Dostęp zabroniony 403 900159 Partner z identyfikatorem konta {0} i identyfikatorem organizacji {1} nie ma relacji handlowych z klientem z identyfikatorem konta {2} i identyfikatorem organizacji {3}.
Nieprawidłowe Żądanie 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ń. Oczekuj, że odzwierciedlenie zmiany stanu zajmie około 10 minut (czyli z aktywnego na nieaktywny).

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