Mettre à jour 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 mettre à jour une planification de migration de nouveau commerce. Les partenaires peuvent effectuer une mise à jour avant la date cible planifiée.
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 des informations d’identification d’application et d’utilisateur autonomes.
ID du client (
customer-tenant-id
). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace 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
Syntaxe de la requête
Méthode | URI de demande |
---|---|
PUT | {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 | Obligatoire | Description |
---|---|---|---|
customer-tenant-id | string | Oui | Chaîne au format GUID qui identifie le client. |
scheduleID | string | Oui | Chaîne au format GUID qui a identifié la planification |
En-têtes de requête
Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.
Corps de demande
Ce tableau décrit les propriétés d’abonnement dans le corps de la demande.
Propriété | Type | Obligatoire | Description |
---|---|---|---|
currentSubscriptionId | string | Oui | Identificateur d’abonnement qui indique quel abonnement nécessite une validation pour la migration. Non autorisé pour l’opération de mise à jour. |
termDuration | string | Non | La durée du 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 civil sans version d’évaluation 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. Si targetDate est défini pour la date spécifiée, migrationOnRenewal peut être défini sur null ou false. |
migrateOnRenewal | bool | Non | Si l’indicateur a la valeur true pour migrateOnRenewal, il n’est pas nécessaire de spécifique targetDate pour planifier une migration. |
Exemple de requête
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour