Delen via

Een Azure-recht voor een abonnement ophalen

  • Artikel

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

Partners kunnen hun Azure-rechten voor een abonnement weergeven met behulp van deze API, waarmee de abonnements-id voor een klant wordt opgehaald.

Vereisten

  • Referenties zoals beschreven in verificatie in partnercentrum. 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 identificeren voor het Azure-abonnement dat u wilt annuleren.

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} 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 de klant 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

Er is geen aanvraagbody vereist.

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}

HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

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 retourneert het Azure-recht voor een bepaalde klant.

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": “inactive", 
    "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