Créer un transfertCreate a transfer

S’applique à :Applies to:

  • Espace partenairesPartner Center

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application autonome et de l’application + utilisateur.This scenario supports authentication with both standalone App and App+User credentials.

  • ID du client (customer-tenant-id).A customer ID (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans le tableau de bord de l’Espace partenaires.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Sélectionnez CSP dans le menu Espace partenaires, puis Clients.Select CSP from the Partner Center menu, followed by Customers. Sélectionnez le client dans la liste des clients, puis Compte.Select the customer from the customer list, then select Account. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
POSTPOST {baseURL}/v1/Customers/{Customer-ID}/Transfers http/1.1{baseURL}/v1/customers/{customer-id}/transfers HTTP/1.1

Paramètre d’URIURI parameter

Utilisez le paramètre de chemin d’accès suivant pour identifier le client.Use the following path parameter to identify the customer.

NomName TypeType ObligatoireRequired DescriptionDescription
ID clientcustomer-id stringstring OuiYes ID client au format GUID qui identifie le client.A GUID formatted customer-id that identifies the customer.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Ce tableau décrit les propriétés TransferEntity dans le corps de la demande.This table describes the TransferEntity properties in the request body.

PropriétéProperty TypeType ObligatoireRequired DescriptionDescription
idid stringstring NoNo Identificateur transferEntity qui est fourni lors de la création réussie du transferEntity.A transferEntity identifier that is supplied upon successful creation of the transferEntity.
createdTimecreatedTime DateTimeDateTime NoNo Date à laquelle le transferEntity a été créé, au format date/heure.The date the transferEntity was created, in date-time format. Appliqué en cas de création réussie du transferEntity.Applied upon successful creation of the transferEntity.
lastModifiedTimelastModifiedTime DateTimeDateTime NoNo Date à laquelle le transferEntity a été mis à jour pour la dernière fois au format date-heure.The date the transferEntity was last updated, in date-time format. Appliqué en cas de création réussie du transferEntity.Applied upon successful creation of the transferEntity.
lastModifiedUserlastModifiedUser stringstring NoNo Utilisateur qui a mis à jour la transferEntity.The user who last updated the transferEntity. Appliqué en cas de réussite de la création de transferEntity.Applied upon successful creation of transferEntity.
customerNamecustomerName stringstring NonNo facultatif.Optional. Nom du client dont les abonnements sont en cours de transfert.The name of the customer whose subscriptions are being transferred.
customerTenantIdcustomerTenantId stringstring NoNo ID client au format GUID qui identifie le client.A GUID formatted customer-id that identifies the customer. Appliqué en cas de création réussie du transferEntity.Applied upon successful creation of the transferEntity.
partnertenantidpartnertenantid stringstring NoNo Identificateur de partenaire au format GUID qui identifie le partenaire.A GUID formatted partner-id that identifies the partner.
sourcePartnerNamesourcePartnerName stringstring NonNo facultatif.Optional. Nom de l’organisation partenaire qui lance le transfert.The name of the partner's organization who is initiating the transfer.
sourcePartnerTenantIdsourcePartnerTenantId stringstring OuiYes Un ID de partenaire au format GUID qui identifie le partenaire qui lance le transfert.A GUID formatted partner-id that identifies the partner initiating the transfer.
targetPartnerNametargetPartnerName stringstring NonNo facultatif.Optional. Nom de l’organisation du partenaire à laquelle le transfert est destiné.The name of the partner's organization to whom the transfer is targeted.
targetPartnerTenantIdtargetPartnerTenantId stringstring OuiYes Un ID de partenaire au format GUID qui identifie le partenaire auquel le transfert est destiné.A GUID formatted partner-id that identifies the partner to whom the transfer is targeted.
lineItemslineItems Tableau d’objetsArray of objects YesYes Tableau de ressources TransferLineItem .An Array of TransferLineItem resources.
statusstatus stringstring NoNo État du transferEntity.The status of the transferEntity. Les valeurs possibles sont « active » (peut être supprimée/envoyée) et « Completed » (a déjà été effectué).Possible values are "Active" (can be deleted/submitted) and "Completed" (has already been completed). Appliqué en cas de création réussie du transferEntity.Applied upon successful creation of the transferEntity.

Ce tableau décrit les propriétés TransferLineItem dans le corps de la demande.This table describes the TransferLineItem properties in the request body.

PropriétéProperty TypeType ObligatoireRequired DescriptionDescription
idid stringstring NoNo Identificateur unique pour un élément de ligne de transfert.A unique identifier for a transfer line item. Appliqué en cas de création réussie du transferEntity.Applied upon successful creation of the transferEntity.
subscriptionIdsubscriptionId stringstring OuiYes Identificateur de l’abonnement.The subscription identifier.
quantitéquantity intint NonNo Nombre de licences ou d’instances.The number of licenses or instances.
billingCyclebillingCycle ObjectObject Non No Type de cycle de facturation défini pour la période actuelle.The type of billing cycle set for the current period.
friendlyNamefriendlyName stringstring NoNo facultatif.Optional. Nom convivial de l’élément défini par le partenaire pour aider à lever toute ambiguïté.The friendly name for the item defined by the partner to help disambiguate.
partnerIdOnRecordpartnerIdOnRecord stringstring NoNo Partenaire sur l’enregistrement (MPNID) de l’achat qui se produit lorsque le transfert est accepté.PartnerId on Record (MPNID) on the purchase that happens when the transfer is accepted.
offerIdofferId stringstring NoNo Identificateur de l’offre.The offer identifier.
addonItemsaddonItems Liste d’objets TransferLineItemList of TransferLineItem objects NoNo Collection d’éléments de ligne transferEntity pour les modules complémentaires qui seront transférés avec l’abonnement de base en cours de transfert.A collection of transferEntity line items for addons that will be transferred along with the base subscription that is being transferred. Appliqué en cas de création réussie du transferEntity.Applied upon successful creation of the transferEntity.
transferErrortransferError stringstring NoNo Appliqué après l’acceptation de transferEntity en cas d’erreur.Applied after transferEntity is accepted in case of an error.
statusstatus stringstring NoNo État de l’LineItem dans transferEntity.The status of the lineitem in the transferEntity.

Exemple de requêteRequest example

POST /v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/transfers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: 0e93c70c-977c-4a88-9580-7cf084c73286
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Expect: 100-continue

{
    "sourcePartnerTenantId": "da6c51b5-1246-4a42-b4ab-cbf38df54537",
    "targetPartnerTenantId": "656218b1-80c9-40b2-83ae-3a2703b55271",
    "lineItems": [
        {
            "subscriptionId": "7291BFBF-1772-4C5B-A624-18B6152CD8CB",
            "partnerIdOnRecord": "517285"
        },
        {
            "subscriptionId": "6C0B221B-8DF9-4F4A-A5BB-4C9CBB7B27B0",
            "partnerIdOnRecord": "517285"
        }
    ]
}

Réponse RESTREST response

En cas de réussite, cette méthode retourne la ressource TransferEnity remplie dans le corps de la réponse.If successful, this method returns the populated TransferEnity resource in the response body.

Codes d’erreur et de réussite de la réponseResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur.For the full list, see Error Codes.

Exemple de réponseResponse example

HTTP/1.1 201 Created
Content-Length: 138
Content-Type: application/json; charset=utf-8
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: 0e93c70c-977c-4a88-9580-7cf084c73286
X-Locale: en-US,en-US
{
    "id": "67c5b05b-09b5-47ba-9047-5056fe2afa4f",
    "status": "Active",
    "createdTime": "2020-03-24T20:44:14.9602781Z",
    "lastModifiedTime": "2020-03-24T20:44:15Z",
    "customerTenantId": "823c6c3f-9259-4d51-bae2-5dd06743177f",
    "partnertenantid": "da6c51b5-1246-4a42-b4ab-cbf38df54537",
    "sourcePartnerTenantId": "da6c51b5-1246-4a42-b4ab-cbf38df54537",
    "targetPartnerTenantId": "656218b1-80c9-40b2-83ae-3a2703b55271",
    "lastModifiedUser": "d0648481-b615-45c9-8cd1-ff87940dbdc4",
    "lineItems": [
        {
            "id": 0,
            "subscriptionId": "7291BFBF-1772-4C5B-A624-18B6152CD8CB",
            "offerId": "50E9A47A-7B4D-4970-9D90-CAE927F53753",
            "billingCycle": "annual",
            "friendlyName": "Dynamics 365 for Sales Enterprise Attach to Qualifying Dynamics 365 Base Offer",
            "quantity": 1,
            "addonItems": [
                {
                    "id": 0,
                    "subscriptionId": "D738C6C9-DDBD-46E9-B316-65F9D9B3ECB4",
                    "offerId": "2BCF9FE8-8B65-4FCF-9240-419203FB8CF4",
                    "billingCycle": "annual",
                    "friendlyName": "Dynamics 365 - Additional Production Instance (Qualified Offer)",
                    "quantity": 4
                }
            ]
        },
        {
            "id": 0,
            "subscriptionId": "6C0B221B-8DF9-4F4A-A5BB-4C9CBB7B27B0",
            "offerId": "455DDD41-32ED-4E2D-B3A2-BBCB22CAA467",
            "billingCycle": "annual",
            "friendlyName": "Dynamics 365 Customer Engagement Plan Patch",
            "quantity": 8,
            "addonItems": []
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/823c6c3f-9259-4d51-bae2-5dd06743177f/transfers/67c5b05b-09b5-47ba-9047-5056fe2afa4f",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "TransferEntity"
    }
}