Hämta en Azure-berättigande för en prenumeration

Artikel
02/05/2024

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Partner kan visa sin Azure-berättigande för en prenumeration med hjälp av det här API:et, som hämtar behörigheten för prenumerationsidentifieraren för en kund.

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.
Kund.
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 Azure-prenumeration som du vill avbryta.

Om du vill få en kund kan du läsa Hämta en kund efter ID och Hämta kund efter kund-ID – REST API för mer hjälp.
Om du vill få en prenumeration kan du läsa Hämta en prenumeration efter ID och Hämta prenumeration efter ID – REST API för mer hjälp.
Information om hur du hämtar en rättighet finns i Hämta en Azure-berättigande för en prenumeration – REST API.

REST-begäran

Syntax för begäran

Metod	Begärande-URI
POST	{baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} 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 kundens 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

Ingen begärandetext krävs.

Exempel på begäran

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: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd

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 returnerar Azure-berättigandet för en viss kund.

HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6eacec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT

{ 
    "id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383", 
    "friendlyName": " Cancel_Azure_Subscription", 
    "status": “inactive", 
    "subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1", 
    "links": { 
        "self": { 
            "uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383", 
            "method": "GET", 
            "headers": [] 
        } 
    }

Dela via