Partager via


Annuler un abonnement Azure

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

En cas de compromission ou d’abus, les partenaires avec des abonnements clients Azure peuvent annuler les abonnements directement à partir du portail de l’Espace partenaires ou par API, arrêtant l’activité suspecte détectée dans leurs abonnements de plan Azure.

Cette API annule un abonnement Azure. Si les partenaires souhaitent annuler plusieurs abonnements, ils doivent appeler séparément l’API pour annuler chacun d’eux.

Si les partenaires souhaitent suspendre leur plan Azure, ils doivent utiliser l’API existante disponible, mettre à jour un abonnement par ID.

L’annulation d’un plan Azure n’est pas prise en charge par l’API suivante.

Les partenaires doivent être des administrateurs généraux avec des rôles d’agent d’administration à annuler.

Prérequis

  • Informations d’identification décrites dans l’authentification de l’Espace partenaires Ce scénario prend en charge l’authentification avec les informations d’identification d’application et d’application+utilisateur autonomes.

  • Customer_id.

  • Subscription_id.

  • Entitlement_id.

C#

Pour annuler un abonnement Azure, vous devez identifier votre ID client, votre ID d’abonnement et votre ID de droit d’utilisation pour cet abonnement.

Demande REST

Syntaxe de la requête

Méthode URI de demande
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1

Paramètre d’URI

Ce tableau répertorie les paramètres de requête requis pour annuler un abonnement Azure.

Nom Type Requis Description
customer_id Chaîne Y La valeur est une chaîne qui désigne l’identificateur du client.
subscription_id Chaîne Y La valeur est une chaîne qui désigne l’identificateur de l’abonnement.
entitlement_id Chaîne Y La valeur est une chaîne qui désigne l’identificateur du droit d’abonnement Azure.

En-têtes de requête

Consultez les en-têtes REST de l’Espace partenaires.

Corps de la demande

HTTP
{ "cancellationReason": "compromise" }

Exemple de requête

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

Réponse REST

Si elle réussit, cette méthode retourne un droit Azure pour une ressource d’abonnement dans le corps de la réponse.

Codes d’erreur et de réussite de la réponse

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et plus d’informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

État HTTP HTTP Code Code de l’erreur Description
BadRequest 400 900118 ID client non valide.
BadRequest 400 800002 L’ID {0} client doit avoir le format GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
BadRequest 400 800002 L’ID d’abonnement est requis.
BadRequest 400 800002 L’ID de droit est requis.
BadRequest 400 800002 Le contenu de la demande d’annulation de droits d’utilisation Azure est requis.
Interdit 403 900159 Le partenaire avec l’ID de compte et l’ID {0} d’organisation {1} n’a aucune relation commerciale avec le client avec l’ID de compte et l’ID {2} d’organisation {3}.
BadRequest 400 900307 La raison de l’annulation n’est{0} pas valide.
NotFound 404 800111 Le droit Azure avec l’ID {0} est introuvable.

Exemple de réponse

La réponse pour l’annulation d’un abonnement inclut l’état du droit d’utilisation. Attendez-vous à environ 10 minutes pour que l’état soit reflété (c’est-à-dire actif à inactif).

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