Mise à jour du 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 fournisseurs de solutions Cloud. 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.

Le groupe de ressources est toujours M365. Les partenaires peuvent ajouter des étiquettes et des emplacements au groupe de ressources, mais ne peuvent pas les modifier.

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

Method 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 Obligatoire. GUID définissant l’abonnement consommation pour le dépassement.
azureResourceGroup objet Optional. Valeur de nom des balises et emplacement du groupe de ressources.
partnerId guid Applicable uniquement pour un modèle à deux niveaux (fournisseur indirect). PartnerID d’un revendeur indirect.
overageEnabled bool Obligatoire. 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: 00000000-0000-0000-0000-000000000000
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
X-Locale: en-US

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
  },
    "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: 00000000-0000-0000-0000-000000000000
MS-RequestId: 00000000-0000-0000-0000-000000000000
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
    },
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/00000000-0000-0000-0000-000000000000/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}
  • Last updated on