Freigeben über

Kündigen eines Azure-Abonnements

  • Artikel

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

Wenn sie kompromittiert oder missbraucht werden, können Partner mit Azure-Kundenabonnements die Abonnements direkt über das Partner Center-Portal oder über die API kündigen und verdächtige Aktivitäten herunterfahren, die in ihren Azure-Planabonnements entdeckt wurden.

Diese API bricht ein Azure-Abonnement ab. Wenn Partner mehrere Abonnements kündigen möchten, müssen sie die API separat aufrufen, um die einzelnen Abonnements abzubrechen.

Wenn Partner ihren Azure-Plan aussetzen möchten, sollten sie die vorhandene verfügbare API verwenden, ein Abonnement nach ID aktualisieren.

Das Abbrechen des Azure-Plans wird von der folgenden API nicht unterstützt.

Partner müssen globale Administratoren mit Administrator-Agent-Rollen sein, um den Vorgang abzubrechen.

Voraussetzungen

  • Anmeldeinformationen, wie in der 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 dieses Abonnement identifizieren.

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel 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 Abonnements angibt.
entitlement_id String Y Der Wert ist eine Zeichenfolge, die den Bezeichner der Azure-Abonnementberechtigung angibt.

Anforderungsheader

Siehe Partner Center-REST-Header.

Anforderungstext

HTTP
{ "cancellationReason": "compromise" }

Anforderungsbeispiel

POST
[https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel](https://api.partnercenter.microsoft.com/v1/customers/%7bcustomer_id%7d/subscriptions/%7bsubscription_id%7d/azureEntitlements/%7bentitlement_id%7d/cancel)
HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
 "id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "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": []
   }
  }
}

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 zum Kündigen eines Abonnements enthält den Berechtigungsstatus. Erwarten Sie ca. 10 Minuten, bis der Status widerzuspiegeln ist (d. a. aktiv für inaktiv).

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

Zugehöriger Inhalt