Partager via

Obtenir des dates de fin de période personnalisées

s’applique à: Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires pour Microsoft Cloud pour le gouvernement des États-Unis

Les partenaires peuvent afficher les dates de fin de période personnalisées autorisées pour les abonnements basés sur une licence NCE qu’ils achètent pour leurs clients. Les partenaires peuvent afficher les dates de fin qui correspondent à la fin du mois civil ou qui coïncident avec les abonnements clients existants.

Les API prennent uniquement en charge le calcul de dates de fin de mandat personnalisées pour l’achat de nouveaux abonnements et non pour le renouvellement d’abonnements existants.

Conditions préalables

  • Informations d’identification décrites dans l’authentification de l’Espace partenaires. Ce scénario prend en charge l'authentification avec des identifiants d'application autonomes ainsi que des identifiants combinés application+utilisateur.

  • Un CustomerTenantId. Si vous ne connaissez pas l'identifiant du client, vous pouvez le rechercher dans le Centre de Partenaires en sélectionnant l'espace de travail Clients, puis le client dans la liste des clients, puis Compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est identique à l’ID client.

Requête REST

Syntaxe de la requête

Méthode URI de la requête
AVOIR {baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Chaînes de requête

Ce tableau répertorie les chaînes de requête nécessaires pour filtrer et récupérer les dates de fin de trimestre personnalisées.

Nom : Requis : Description :
term_duration Oui Une représentation ISO 8601 de la durée du terme. Les valeurs actuellement prises en charge sont P1M (1 mois), P1Y (1 an) et P3Y (3 ans).
term_start_date Non La date d’achat prévue. Cela ne peut pas être dans le passé.
target_coterm_subscription_id Non Chaîne au format GUID qui identifie l’abonnement avec lequel coterme.

Note

Les durées de terme de P1M ou de termes mensuels passés à l’API retournent des résultats de co-terme qui peuvent ne pas être utilisés pour l’alignement des termes. Les alignements mensuels ne peuvent pas être utilisés avec un abonnement se terminant le 28, le 29 ou le 30e du mois, sauf si cette date est le dernier jour du mois.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires. La réponse de l’API renvoie un maximum de 300 enregistrements de page. Si plus de 300 enregistrements sont renvoyés dans une requête saisie, un jeton de continuation est fourni dans l’en-tête de réponse. Le jeton de continuation peut être saisi dans l’en-tête d’une demande suivante pour renvoyer des enregistrements de page supplémentaires interrogés.

Corps de la requête

Aucun.

Réponse REST

En cas de réussite, cette méthode retourne les détails des abonnements qui ont été migrés (objet de migration) dans le corps de la réponse. Cela inclut l’ID de migration.

Réussite de la réponse et codes d’erreur

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 suivi réseau pour lire ce code, le type d’erreur et les paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de Partner Center.

Exemples d’URL de demande

baseurl/v1/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M

Exemples de réponse

 {​
    "totalCount": 2,​
    "items": [​
        {​
            "allowedCustomTermEndDateType": "calendarMonthAligned",​
            "allowedCustomTermEndDate": "2023-07-31T00:00:00"​
        },​
        {​
            "allowedCustomTermEndDateType": "subscriptionAligned",​
            "cotermSubscriptionIds": [​
               "5fcf618b-1daa-4604-da99-cc3e1c9ee422",​
               "d30a9ff9-713e-4546-c97e-f06b9dcf6ef6"​
            ],​
            "allowedCustomTermEndDate": "2023-08-01T00:00:00"​
        }​
    ],​
    "links": {​
        "self": {​
            "uri": "/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M",​
            "method": "GET",​
            "headers": []​
        }​
    },​
    "attributes": {​
        "objectType": "Collection"​
    }​
 }
  • Last updated on