Delen via

Een Azure-abonnement annuleren

  • Artikel

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Als er inbreuk op of misbruik wordt gemaakt, kunnen partners met Azure-klantabonnementen de abonnementen rechtstreeks vanuit de Partnercentrum-portal of via DE API annuleren, waarbij verdachte activiteiten worden afgesloten die zijn gedetecteerd in hun Azure-abonnementsabonnementen.

Met deze API wordt een Azure-abonnement geannuleerd. Als partners meer dan één abonnement willen annuleren, moeten ze de API afzonderlijk aanroepen om elk abonnement te annuleren.

Als partners hun Azure-abonnement willen pauzeren, moeten ze de bestaande beschikbare API gebruiken, een abonnement bijwerken op basis van ID.

Annuleren van Het Azure-plan wordt niet ondersteund door de volgende API.

Partners moeten Global Administrator zijn en Admin Agent-rollen hebben om te annuleren.

Vereisten

  • Referenties zoals beschreven in Partnercentrum-verificatie . Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

  • Klant_id.

  • Abonnement_id.

  • Entitlement_id.

C#

Als u een Azure-abonnement wilt annuleren, moet u uw klant-id, abonnements-id en rechten-id voor dat abonnement identificeren.

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1

URI-parameter

Deze tabel bevat de vereiste queryparameters om een Azure-abonnement te annuleren.

Naam Typ Vereist Beschrijving
klant-id String Y De waarde is een tekenreeks die de id van de klant aangeeft.
abonnements_id String Y De waarde is een tekenreeks die de id van het abonnement aangeeft.
toekennings_id String Y De waarde is een tekenreeks die de id van het Azure-abonnementsrecht aangeeft.

Aanvraagheaders

Zie Partnercentrum REST-headers.

Aanvraagtekst

HTTP
{ "cancellationReason": "compromise" }

Aanvraagvoorbeeld

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-antwoord

Als dit lukt, retourneert deze methode een Azure-recht voor een abonnementsresource in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of er sprake is van succes of falen, en bevat meer informatie voor foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Partner Center REST-foutcodes voor de volledige lijst.

HTTP-status HTTP-code Foutcode Beschrijving
Onjuiste aanvraag 400 900118 Ongeldige klant-id.
Ongeldig verzoek 400 800002 Klant-ID {0} moet het GUID-formaat hebben (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
Ongeldig verzoek 400 800002 Abonnements-id is vereist.
Ongeldig verzoek 400 800002 De rechten-id is vereist.
Ongeldig verzoek 400 800002 De inhoud van de annuleringsaanvraag voor Azure-rechten is vereist.
Verboden 403 900159 De partner met account-id {0} en organisatie-id {1} heeft geen handelsrelatie met de klant met account-id {2} en organisatie-id {3}.
Ongeldig verzoek 400 900307 Annuleringsreden '{0} is ongeldig.
Niet Gevonden 404 800111 Azure-rechten met id {0} zijn niet gevonden.

Responsvoorbeeld

Het antwoord voor het annuleren van een abonnement bevat de rechtenstatus. Verwacht ongeveer 10 minuten voordat de status wordt weerspiegeld (dat wil zeggen, van actief naar inactief).

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

Gerelateerde inhoud