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.
Aby uzyskać klienta, zobacz Uzyskiwanie klienta według identyfikatora i Uzyskiwanie klienta według identyfikatora klienta — interfejs API REST, aby uzyskać więcej pomocy.
Aby uzyskać subskrypcję, zobacz Uzyskiwanie subskrypcji według identyfikatora i Uzyskiwanie subskrypcji według identyfikatora — interfejs API REST, aby uzyskać więcej pomocy.
Aby uzyskać uprawnienie, skorzystaj z dokumentu Uzyskaj uprawnienie platformy Azure dla subskrypcji - REST API.
Żą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": []
}
}
Powiązana zawartość
- Plan platformy Azure — zarządzanie subskrypcjami i zasobami
- Wydatki na platformę Azure — anulowanie uprawnień platformy Azure — interfejs API REST
- Uzyskaj uprawnienia platformy Azure dla subskrypcji — deweloper aplikacji w Centrum partnerskim
- Wydatki na platformę Azure — uzyskiwanie uprawnień platformy Azure dla subskrypcji — interfejs API REST