Partager via


Obtenir un droit Azure pour un abonnement

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

Les partenaires peuvent afficher leur droit Azure pour un abonnement à l’aide de cette API, qui obtient le droit de l’identificateur d’abonnement pour un client.

Prérequis

  • Informations d’identification, comme décrit dans Authentification auprès 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 l’abonnement Azure que vous souhaitez annuler.

Demande REST

Syntaxe de la requête

Méthode URI de demande
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} 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 du client.
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

Aucun corps de la requête n’est requis.

Exemple de requête

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

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 retourne le droit Azure pour un client donné.

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