Delen via

Een Azure-toewijzing 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-toewijzing voor een abonnement bekijken met behulp van deze API, die de abonnementsidentificatie voor een klant ophaalt.

Voorwaarden

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

REST-aanvraag

Aanvraagsyntaxis

methode verzoek-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
customer_id Snaar Y De waarde is een tekenreeks die de id van de klant aangeeft.
abonnements_id Snaar Y De waarde is een tekenreeks die de id van de klant aangeeft.
toekennings_id Snaar Y De waarde is een tekenreeks die de id van het Azure-abonnementsrecht aangeeft.

Aanvraagheaders

Zie REST-koppen van het Partnercentrum.

Verzoektekst

Er is geen verzoekinhoud 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 resource van een abonnement in de antwoordtekst.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of het succesvol of mislukt is, met meer informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Partnercentrum REST-foutcodesvoor de volledige lijst.

HTTP-status HTTP-code foutcode beschrijving
Ongeldig Verzoek 400 900118 Ongeldige klant-id.
Ongeldig Verzoek 400 800002 Klant-ID {0} moet de GUID-formaat hebben (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
Ongeldig Verzoek 400 800002 Abonnements-id is vereist.
Ongeldig Verzoek 400 800002 De Entitlement-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 De reden voor annulering '{0} is ongeldig.
NietGevonden 404 800111 Azure-aanspraak met id {0} niet gevonden.

Voorbeeld van antwoord

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

Verwante inhoud