Abrufen einer Azure-Berechtigung für ein Abonnement

  • Artikel

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Partner können ihre Azure-Berechtigung für ein Abonnement mithilfe dieser API anzeigen, die die Berechtigung des Abonnementbezeichners für einen Kunden erhält.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
  • Customer_id.
  • Subscription_id.
  • Entitlement_id.

C#

Um ein Azure-Abonnement zu kündigen, müssen Sie Ihre Kunden-ID, Abonnement-ID und Berechtigungs-ID für das Azure-Abonnement identifizieren, das Sie kündigen möchten.

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

In dieser Tabelle sind die erforderlichen Abfrageparameter aufgeführt, um ein Azure-Abonnement abzubrechen.

Name Art Erforderlich Beschreibung
customer_id String J Der Wert ist eine Zeichenfolge, die den Bezeichner des Kunden angibt.
subscription_id String J Der Wert ist eine Zeichenfolge, die den Bezeichner des Kunden angibt.
entitlement_id String J Der Wert ist eine Zeichenfolge, die den Bezeichner der Azure-Abonnementberechtigung angibt.

Anforderungsheader

Siehe Partner Center-REST-Header.

Anforderungstext

Kein Anforderungstext ist erforderlich.

Beispiel für eine Anfrage

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

Bei erfolgreicher Ausführung gibt die Methode eine Azure-Berechtigung für eine Abonnementressource im Antworttext zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und weitere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

HTTP-Status HTTP-Code Fehlercode Beschreibung
BadRequest 400 900118 Ungültige Kunden-ID.
BadRequest 400 800002 Kunden-ID {0} sollte über ein GUID-Format verfügen (xx-xxxx-xxxx-xxxx-xxxxxx).
BadRequest 400 800002 Die Abonnement-ID ist erforderlich.
BadRequest 400 800002 Berechtigungs-ID ist erforderlich.
BadRequest 400 800002 Der Inhalt der Azure-Berechtigungsabbruchanforderung ist erforderlich.
Verboten 403 900159 Der Partner mit Konto-ID {0} und Organisations-ID {1} hat keine Geschäftsbeziehung mit dem Kunden mit Konto-ID {2} und Organisations-ID {3}.
BadRequest 400 900307 Der Stornierungsgrund '{0} ist ungültig.
NotFound 404 800111 Azure-Berechtigung mit ID {0} wurde nicht gefunden.

Beispielantwort

Die Antwort gibt die Azure-Berechtigung für einen bestimmten Kunden zurück.

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

Nächste Schritte