Mise à jour du dépassement

Article
07/02/2024

S’applique à

Espace partenaires

Rôles appropriés

Administrateur général
Agent administrateur

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Utilisé pour définir le dépassement d’un client donné sur un abonnement consommation. Peut également être utilisé pour supprimer le dépassement en le définissant sur false. Le dépassement permet à un client de continuer à utiliser des services s’il utilise le service au-delà des limites indiquées. Le dépassement définit le dépassement de l’abonnement consommation avec paiement à l’utilisation.

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.
ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace de partenaires en sélectionnant l’espace de travail Clients, puis le client dans la liste des clients, puis compte. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).
Au moins un abonnement de dépassement éligible acheté pour le client.

Demande REST

[PUT] /customers/{customer-tenant-id}/subscriptions/overage

Syntaxe de la requête

Méthode	URI de requête
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

Paramètre d’URI

Utilisez les paramètres de requête suivants pour retourner le dépassement d’un client.

Nom	Type	Requise	Description
id-locataire-client	guid	Y	GUID correspondant au locataire du client.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la demande

Nom	Type	Description
azureEntitlementId	guid	GUID définissant l’abonnement consommation pour le dépassement.
partnerId	guid	PartnerID d’un revendeur indirect. Applicable uniquement pour un modèle à deux niveaux (fournisseur indirect).
overageEnabled	bool	Indiquez si le dépassement doit être activé pour un abonnement de consommation donné.

Exemple de requête

PUT https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "overageEnabled": true
}

Réponse REST

Si elle réussit, cette méthode retourne un dépassement pour un client.

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

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/f62cf10b-8f76-4fc4-9774-c5291f8faf86/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}

Partager via