Créer une migration commerciale

Article
10/28/2024

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

Comment créer une migration d’un abonnement vers New Commerce Experience

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

Limite du taux

La limite de l’API Créer une migration est de 100 appels par un partenaire en 5 minutes. Pour plus d’informations sur les limites de débit et la limitation, consultez les instructions de limitation des API.

Demande REST

Syntaxe de la requête

Méthode	URI de demande
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1

Paramètre d’URI

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

Nom	Type	Requise	Description
customer-tenant-id	string	Oui	Chaîne au format GUID qui identifie le client.

En-têtes de requête

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

Corps de la demande

Ce tableau décrit les propriétés d’abonnement dans le corps de la requête.

Propriété	Type	Requise	Description
currentSubscriptionId	string	Oui	Identificateur d’abonnement qui indique quel abonnement nécessite la validation pour la migration.
termDuration	string	Non	La durée des termes peut être modifiée lors de la migration.
billingCycle	string	Non	Le cycle de facturation peut ê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

Exemple de requête

Notez que les modules complémentaires imbriqués (abonnements de module complémentaire avec des abonnements de module complémentaire) doivent être écrits dans le corps de la requête sous la forme d’une liste plate dans addOnMigrations et ne pas être imbriqués dans d’autres abonnements de module complémentaire dans la demande ; consultez le dernier exemple de requête pour savoir comment les modules complémentaires peuvent être écrits dans le corps de la demande.

{
    "currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"
}

{ 
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "termDuration": "P1M", 
    "billingCycle": "Monthly", 
}

{
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "purchaseFullTerm": true 
}

{
    "currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
    "quantity": 1,
    "billingCycle": "Annual",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M"
        },
        {
            "currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y"
        }
    ]
}

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 et des informations de débogage supplémentaires. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur, d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemples de réponse

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        }
    ],
    "id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
    "startedTime": "2022-02-23T13:00:48.4489832Z",
    "currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
    "status": "Processing",
    "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}

Partager via