Freigeben über

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 Y Der Wert ist eine Zeichenfolge, die den Bezeichner des Kunden angibt.
subscription_id String Y Der Wert ist eine Zeichenfolge, die den Bezeichner des Kunden angibt.
entitlement_id String Y Der Wert ist eine Zeichenfolge, die den Bezeichner der Azure-Abonnementberechtigung angibt.

Anforderungsheader

Siehe Partner Center-REST-Header.

Anforderungstext

Kein Anforderungstext ist erforderlich.

Anforderungsbeispiel

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-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: 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/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
            "method": "GET", 
            "headers": [] 
        } 
    }

Zugehöriger Inhalt