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 onderbreken, moeten ze de bestaande BESCHIKBARE API gebruiken, een abonnement bijwerken op id.

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

Partners moeten globale beheerders zijn met beheerdersagentrollen om te annuleren.

Vereisten

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

  • Customer_id.

  • Subscription_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 Type Vereist Beschrijving
klant_id String J De waarde is een tekenreeks die de id van de klant aangeeft.
subscription_id String J De waarde is een tekenreeks die de id van het abonnement aangeeft.
entitlement_id String J De waarde is een tekenreeks die de id van het Azure-abonnementsrecht aangeeft.

Aanvraagheaders

Zie REST-headers voor Partnercentrum.

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 dat het succes of de fout optreedt en meer informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

HTTP-status HTTP-code Foutcode Beschrijving
BadRequest 400 900118 Ongeldige klant-id.
BadRequest 400 800002 Klant-id {0} moet de GUID-indeling hebben (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
BadRequest 400 800002 Abonnements-id is vereist.
BadRequest 400 800002 De rechten-id is vereist.
BadRequest 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}.
BadRequest 400 900307 Annuleringsreden '{0} is ongeldig.
NotFound 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 gezegd, actief voor 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