Avbryta en Azure-prenumeration
Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government
Om du komprometterar eller missbrukar kan partner med Azure-kundprenumerationer avbryta prenumerationerna direkt från Partnercenter-portalen eller via API och stänga av misstänkt aktivitet som identifierats i deras Prenumerationer på Azure-abonnemang.
Det här API:et avbryter en Azure-prenumeration. Om partner vill avbryta fler än en prenumeration måste de anropa API:et separat för att avbryta var och en.
Om partner vill pausa sin Azure-plan bör de använda det befintliga API:et som är tillgängligt, Uppdatera en prenumeration efter ID.
Att avbryta Azure-planen stöds inte av följande API.
Partner måste vara globala administratörer med administratörsagentroller för att avbryta.
Förutsättningar
Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Kund.
Subscription_id.
Entitlement_id.
C#
Om du vill avbryta en Azure-prenumeration måste du identifiera ditt kund-ID, prenumerations-ID och berättigande-ID för den prenumerationen.
Om du vill få en kund kan du läsa Hämta en kund efter ID och Hämta kund efter kund-ID – REST API för mer hjälp.
Om du vill få en prenumeration kan du läsa Hämta en prenumeration efter ID och Hämta prenumeration efter ID – REST API för mer hjälp.
Information om hur du hämtar en rättighet finns i Hämta en Azure-berättigande för en prenumeration – REST API.
REST-begäran
Syntax för begäran
Metod | Begärande-URI |
---|---|
POST | {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1 |
URI-parameter
Den här tabellen visar de frågeparametrar som krävs för att avbryta en Azure-prenumeration.
Namn | Typ | Obligatoriskt | Beskrivning |
---|---|---|---|
customer_id | String | Y | Värdet är en sträng som anger kundens identifierare. |
subscription_id | String | Y | Värdet är en sträng som anger kundens identifierare. |
entitlement_id | String | Y | Värdet är en sträng som anger identifieraren för Azure-prenumerationens berättigande. |
Begärandehuvuden
Se REST-huvuden för Partnercenter.
Begärandetext
HTTP
{ "cancellationReason": "compromise" }
Exempel på begäran
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-svar
Om det lyckas returnerar den här metoden en Azure-berättigande för en prenumerationsresurs i svarstexten.
Svarsframgång och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och mer felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.
HTTP-status | HTTP-kod | Felkod | Beskrivning |
---|---|---|---|
BadRequest | 400 | 900118 | Ogiltigt kund-ID. |
BadRequest | 400 | 800002 | Kund-ID {0} ska ha GUID-format (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx). |
BadRequest | 400 | 800002 | Prenumerations-ID krävs. |
BadRequest | 400 | 800002 | Berättigande-ID krävs. |
BadRequest | 400 | 800002 | Innehållet i begäran om annullering av Azure-berättigande krävs. |
Förbjudet | 403 | 900159 | Partnern med konto-ID {0} och organisations-ID {1} har ingen handelsrelation med kunden med konto-ID {2} och organisations-ID {3}. |
BadRequest | 400 | 900307 | Annulleringsorsaken är{0} ogiltig. |
NotFound | 404 | 800111 | Azure-berättigande med ID {0} hittades inte. |
Svarsexempel
Svaret för att avbryta en prenumeration innehåller berättigandestatus. Förvänta dig cirka 10 minuter för att statusen ska återspeglas (det vill: aktiv till inaktiv).
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": []
}
}
Nästa steg
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för