Partager via

Obtenir un calendrier de migration vers la nouvelle expérience commerciale

  • Article

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Cet article explique comment obtenir une nouvelle planification de migration commerciale.

Important

Cette API est actuellement disponible uniquement dans le locataire sandbox.

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).

  • ID d’abonnement actuel

Demande REST

Il existe deux façons différentes pour les partenaires de interroger.

  • Pour interroger une planification particulière
  • Obtenir la liste des planifications pour un critère donné

Syntaxe de la requête

Méthode URI de demande
GET {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID}

Paramètre d’URI

Ce tableau répertorie les paramètres de requête requis pour créer une migration commerciale.

Nom Type Requis Description
customer-tenant-id string Oui Chaîne au format GUID qui identifie le client.
Méthode URI de demande
GET {baseURL}/v1/migrations/newcommerce/schedules ? CustomerTenantId={customer-tenant-id}

Paramètre d’URI

Ce tableau répertorie les paramètres de requête requis pour créer une migration commerciale. Tout le monde du paramètre de requête peut être utilisé.

Nom Type Description
customerTenantId string Chaîne au format GUID qui identifie le client.
currentSubscriptionID string Chaîne au format GUID qui identifie l’ID d’abonnement actuel
externalReferenceID string Chaîne au format GUID qui identifie le lot de migration

En-têtes de requête

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

Corps de réponse

Ce tableau décrit les propriétés d’abonnement dans la réponse.

Propriété Type Requis Description
currentSubscriptionId string Oui Identificateur d’abonnement qui indique quel abonnement nécessite la validation pour la migration.
termDuration string Non La durée de terme peut être spécifiée pour être modifiée lors de la migration.
billingCycle string Non Le cycle de facturation peut être spécifié pour être modifié lors de la migration.
purchaseFullTerm bool Non Un nouveau terme peut être démarré dans NCE lors de la migration.
quantité int Non La quantité de licences d’un abonnement peut être augmentée ou réduite lors de la migration.
customTermEndDate DATETIME Non Une date de fin peut être définie pour s’aligner sur un abonnement OnlineServicesNCE ou un mois calendaire existant. Vous trouverez plus d’informations sur l’alignement des dates de fin d’abonnement ici : Aligner les dates de fin d’abonnement dans l’Espace partenaires
targetDate DATETIME Non Date cible à laquelle planifier la migration.
migrateOnRenewal bool Non Indique si la planification doit se produire lors du renouvellement
statut string Non État de la migration planifiée
createdTime DATETIME Non Lors de la création de la planification
lastModifiedTime DATETIME Non Lorsque la planification a été modifiée pour la dernière fois

Réponse REST

Si elle réussit, cette méthode retourne les détails des abonnements en cours de migration (objet de migration) dans le corps de la réponse.

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 REST de l’Espace partenaires.

Exemples de réponse

[
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}
]

Voir aussi