Obtenir le dépassement
S’applique à
- Espace partenaires
Rôles appropriés
- 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 obtenir le dépassement d’un client donné. 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
).
Demande REST
[GET] /customers/{customer-tenant-id}/subscriptions/overage
Syntaxe de la requête
Method | URI de demande |
---|---|
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 | 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 demande
Aucune
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: aaaa0000-bb11-2222-33cc-444444dddddd
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: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}
}