Interroger de nouvelles migrations commerciales
S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government
Comment interroger des abonnements migrés en fonction de l’ID client, de l’ID d’abonnement actuel ou de l’ID de référence externe
Rôles appropriés : Administrateur général | Agent d’administration | Commercial
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.
Cette API peut filtrer en fonction des chaînes de requête sélectionnées par le partenaire. Les chaînes de requête sélectionnées peuvent être l’une des trois options suivantes :
A CustomerTenantId. 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 Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est identique à l’ID client.
CurrentSubscriptionId (ID hérité d’un abonnement migré)
ExternalReferenceId (ID de lot retourné par l’outil de migration Batch disponible en téléchargement via le Kit de développement logiciel (SDK) de l’Espace partenaires)
Demande REST
Syntaxe de la requête
Méthode | URI de demande |
---|---|
GET | {baseURL}/v1/migrations/newcommerce HTTP/1.1 |
Chaînes de requête
Ce tableau répertorie les chaînes de requête nécessaires pour filtrer et récupérer de nouvelles migrations commerciales. Au moins l’un des trois ID est nécessaire pour interroger correctement les migrations. La saisie de plusieurs ID à interroger est acceptée, mais n’est pas obligatoire.
Nom | Description |
---|---|
CustomerTenantId | Chaîne au format GUID qui identifie le client. |
CurrentSubscriptionId | Chaîne au format GUID qui identifie un abonnement hérité migré. |
ExternalReferenceId | 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. La réponse de l’API retourne un maximum de 300 enregistrements de page. Si plus de 300 enregistrements sont retournés dans une requête entrée, un jeton de continuation est fourni dans l’en-tête de réponse. Le jeton de continuation peut être entré dans l’en-tête d’une requête suivante pour retourner des enregistrements de page supplémentaires interrogés.
Corps de la demande
Aucune
Réponse REST
Si elle réussit, 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.
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 et 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 d’URL de requête
baseurl/v1/migrations/newcommerce?CustomerTenantId=83c51838-fed5-44a4-a275-afa201d53699&CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833&ExternalReferenceId=9ab61899-0b2b-4320-bd6d-8196c53607d6
baseurl/v1/migrations/newcommerce?CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833
Exemples de réponse
[
{
"addOnMigrations": [],
"id": "8ce7115e-0324-41b1-8ca3-7c7ae3b64f75",
"startedTime": "2022-02-24T23:50:30.4384819Z",
"completedTime": "2022-02-24T23:53:14.0813711Z",
"currentSubscriptionId": "9E289691-2FF3-419D-B39B-26B3E5A817FB",
"status": "Completed",
"customerTenantId": "ce6fcc21-c276-447b-9605-874decb9024b",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"newCommerceSubscriptionId": "f2d6534b-9e30-4cf5-c7b0-5d6393dbf12d",
"newCommerceOrderId": "09714c93092a",
"subscriptionEndDate": "2023-02-14T00:00:00Z",
"quantity": 2,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"externalReferenceId": "771317a4-275d-47d9-9724-3eefa4a168ad"
}
]
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour