Obtenir un dépassement
S’applique à
- Espace partenaires
Rôles appropriés
- Administrateur général
- Agent d’administration
Notes
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 obtenir un dépassement pour un client donné. Le dépassement permet à un client de continuer à utiliser les services s’il utilise le service au-delà des limites indiquées. Le dépassement définit le dépassement de l’abonnement de consommation qui sera cumulé avec le 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 des informations d’identification d’application et d’utilisateur autonomes.
ID du client (
customer-tenant-id
). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace 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
).
Demande REST
[GET] /customers/{customer-tenant-id}/subscriptions/overage
Syntaxe de la requête
Méthode | URI de requête |
---|---|
GET | {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 | Obligatoire | Description |
---|---|---|---|
customer-tenant-id | guid | O | 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 demande
None
Exemple de requête
GET 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
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
{
"totalCount": 1,
"items": [
{
"azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
"partnerId": "1234",
"type": "PhoneServices",
"overageEnabled": true,
"links": {
"overage": {
"uri": "/customers/f62cf10b-8f76-4fc4-9774-c5291f8faf86/subscriptions/overage",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Overage"
}
}
],
"attributes": {
"objectType": "Collection"
}
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour