Dela via

Avbryta en Azure-prenumeration

  • Artikel

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.

  • Customer_id.

  • 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.

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

Relaterat innehåll