Obtenir un calendrier de migration vers la nouvelle expérience commerciale
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.
- Les partenaires peuvent interroger pour obtenir une planification particulière
- Les partenaires peuvent interroger pour obtenir la liste des planifications pour des critères spécifiques
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 | Durée de terme appliquée à la migration. |
| billingCycle | string | Non | Cycle de facturation appliqué à la migration. |
| purchaseFullTerm | bool | Non | Indique si la migration démarre un nouveau terme ou non. |
| 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 fournie avec un code d’état HTTP qui indique la réussite ou l’échec avec d’autres informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. 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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"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"
}
]