Créer une nouvelle migration commerciale

s’applique à: Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires pour Microsoft Cloud pour le gouvernement des États-Unis

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

Conditions préalables

  • Informations d’identification décrites dans l’authentification de l’Espace partenaires. Ce scénario prend en charge l'authentification avec des identifiants d'application autonomes ainsi que des identifiants combinés application+utilisateur.

  • ID du client (customer-tenant-id). Si vous ne connaissez pas l'identifiant du client, vous pouvez le rechercher dans le Centre 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).

  • Un ID d’abonnement actuel

Limite de fréquence

La limite de l’API Create 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 la page Guide sur la limitation de l’API.

Requête REST

Syntaxe de la requête

Méthode URI de la requête
PUBLIER {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 Catégorie Obligatoire Descriptif
identifiant-client-locataire ficelle 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 requête

Ce tableau décrit les propriétés de l’abonnement dans le corps de la demande.

Propriété Catégorie Obligatoire Descriptif
currentSubscriptionId ficelle Oui Identificateur d’abonnement qui indique l’abonnement qui nécessite une validation pour la migration.
termDurée ficelle Non La durée peut être modifiée lors de la migration.
facturationCycle ficelle Non Le cycle de facturation peut être modifié lors de la migration.
purchaseFullTerm Bool Non Un nouveau terme peut être lancé dans NCE lors de la migration.
quantité Int Non La quantité de licences d’un abonnement peut être augmentée ou diminuée lors de la migration.
customTermEndDate date/heure Non Une date de fin peut être définie pour s’aligner sur un abonnement OnlineServicesNCE existant ou sur un mois calendaire. Pour plus d’informations sur l’alignement des dates de fin d’abonnement, consultez la section Aligner les dates de fin d’abonnement dans l’Espace partenaires

Exemple de requête

Remarque, les add-ons imbriqués (abonnements add-on avec abonnements add-on) doivent être écrits dans le corps de la demande sous la forme d’une liste plate dans addOnMigrations et ne pas être imbriqués dans d’autres abonnements add-on de la demande ; Voir le dernier exemple de requête pour savoir comment les add-ons peuvent être écrits dans le corps de la requête.

{
    "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

En cas de réussite, cette méthode renvoie les détails des abonnements en cours de migration (objet de migration) dans le corps de la réponse.

Réussite de la réponse et codes d’erreur

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 traçage 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 Partner Center.

Exemples de réponse

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}
  • Last updated on