Erstellen einer ÜbertragungCreate a transfer

Gilt für:Applies to:

  • Partner CenterPartner Center

VoraussetzungenPrerequisites

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben.Credentials as described in Partner Center authentication. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen APP-und App-Anmelde Informationen.This scenario supports authentication with both standalone App and App+User credentials.

  • Eine Kunden-ID (customer-tenant-id).A customer ID (customer-tenant-id). Wenn Sie die ID des Kunden nicht kennen, finden Sie diese im Partner Center-Dashboard.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Wählen Sie im Partner Center-Menü CSP und dann Kunden aus.Select CSP from the Partner Center menu, followed by Customers. Wählen Sie den Kunden aus der Kundenliste aus, und wählen Sie dann Konto aus.Select the customer from the customer list, then select Account. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

REST-AnforderungREST request

AnforderungssyntaxRequest syntax

MethodeMethod Anforderungs-URIRequest URI
POSTPOST {baseurl}/v1/Customers/{Customer-ID}/Transfers HTTP/1.1{baseURL}/v1/customers/{customer-id}/transfers HTTP/1.1

URI-ParameterURI parameter

Verwenden Sie zum Identifizieren des Kunden die folgenden Pfadparameter:Use the following path parameter to identify the customer.

NameName typeType ErforderlichRequired BESCHREIBUNGDescription
Kunden-IDcustomer-id Zeichenfolgestring JaYes Eine GUID-formatierte Kunden-ID, die den Kunden identifiziert.A GUID formatted customer-id that identifies the customer.

AnforderungsheaderRequest headers

Weitere Informationen finden Sie unter Partner Center-REST-Header.For more information, see Partner Center REST headers.

AnforderungstextRequest body

In dieser Tabelle werden die transferentity -Eigenschaften im Anforderungs Text beschrieben.This table describes the TransferEntity properties in the request body.

EigenschaftProperty typeType ErforderlichRequired BESCHREIBUNGDescription
idid Zeichenfolgestring NeinNo Ein transferentity-Bezeichner, der bei erfolgreicher Erstellung der transferentity bereitgestellt wird.A transferEntity identifier that is supplied upon successful creation of the transferEntity.
createdTimecreatedTime DatetimeDateTime NeinNo Das Datum, an dem die transferentity erstellt wurde, im Datum/Uhrzeit-Format.The date the transferEntity was created, in date-time format. Wird bei erfolgreicher Erstellung der transferentity angewendet.Applied upon successful creation of the transferEntity.
lastModifiedTimelastModifiedTime DatetimeDateTime NeinNo Das Datum, an dem die transferentity zuletzt aktualisiert wurde, im Datum/Uhrzeit-Format.The date the transferEntity was last updated, in date-time format. Wird bei erfolgreicher Erstellung der transferentity angewendet.Applied upon successful creation of the transferEntity.
lastmodifieduserlastModifiedUser Zeichenfolgestring NeinNo Der Benutzer, der die transferentity zuletzt aktualisiert hat.The user who last updated the transferEntity. Wird bei erfolgreicher Erstellung von transferentity angewendet.Applied upon successful creation of transferEntity.
customerNamecustomerName Zeichenfolgestring NeinNo Optional.Optional. Der Name des Kunden, dessen Abonnements übertragen werden.The name of the customer whose subscriptions are being transferred.
customertenantidcustomerTenantId Zeichenfolgestring NeinNo Eine GUID-formatierte Kunden-ID, die den Kunden identifiziert.A GUID formatted customer-id that identifies the customer. Wird bei erfolgreicher Erstellung der transferentity angewendet.Applied upon successful creation of the transferEntity.
Partner-IDpartnertenantid Zeichenfolgestring NeinNo Eine GUID-formatierte Partner-ID, die den Partner identifiziert.A GUID formatted partner-id that identifies the partner.
sourcepartnernamesourcePartnerName Zeichenfolgestring NeinNo Optional.Optional. Der Name der Organisation des Partners, der die Übertragung initiiert.The name of the partner's organization who is initiating the transfer.
sourcepartnertenantidsourcePartnerTenantId Zeichenfolgestring JaYes Eine GUID-formatierte Partner-ID, die den Partner identifiziert, der die Übertragung initiiert.A GUID formatted partner-id that identifies the partner initiating the transfer.
targetpartnernametargetPartnerName Zeichenfolgestring NeinNo Optional.Optional. Der Name der Organisation des Partners, an die die Übertragung gerichtet ist.The name of the partner's organization to whom the transfer is targeted.
targetpartnertenantidtargetPartnerTenantId Zeichenfolgestring JaYes Eine GUID-formatierte Partner-ID, die den Partner identifiziert, an den die Übertragung gerichtet ist.A GUID formatted partner-id that identifies the partner to whom the transfer is targeted.
lineItemslineItems Array von ObjektenArray of objects JaYes Ein Array von transferlineitem -Ressourcen.An Array of TransferLineItem resources.
statusstatus Zeichenfolgestring NeinNo Der Status der transferentity.The status of the transferEntity. Mögliche Werte sind "aktiv" (kann gelöscht/übermittelt werden) und "abgeschlossen" (wurde bereits abgeschlossen).Possible values are "Active" (can be deleted/submitted) and "Completed" (has already been completed). Wird bei erfolgreicher Erstellung der transferentity angewendet.Applied upon successful creation of the transferEntity.

In dieser Tabelle werden die transferlineitem -Eigenschaften im Anforderungs Text beschrieben.This table describes the TransferLineItem properties in the request body.

EigenschaftProperty typeType ErforderlichRequired BESCHREIBUNGDescription
idid Zeichenfolgestring NeinNo Ein eindeutiger Bezeichner für ein Übertragungs Zeilen Element.A unique identifier for a transfer line item. Wird bei erfolgreicher Erstellung der transferentity angewendet.Applied upon successful creation of the transferEntity.
subscriptionIdsubscriptionId Zeichenfolgestring JaYes Die Abonnement-ID.The subscription identifier.
quantityquantity INTint NeinNo Die Anzahl der Lizenzen oder Instanzen.The number of licenses or instances.
billingCyclebillingCycle ObjectObject NeinNo Der Typ des Abrechnungszyklen, der für den aktuellen Zeitraum festgelegt ist.The type of billing cycle set for the current period.
friendlyNamefriendlyName Zeichenfolgestring NeinNo Optional.Optional. Der Anzeige Name für das Element, das vom Partner definiert wird, um die Eindeutigkeit zu unterstützen.The friendly name for the item defined by the partner to help disambiguate.
partnerIdOnRecordpartnerIdOnRecord Zeichenfolgestring NeinNo PartnerID on Record (mpnid) beim Kauf, der ausgeführt wird, wenn die Übertragung akzeptiert wird.PartnerId on Record (MPNID) on the purchase that happens when the transfer is accepted.
offerIdofferId Zeichenfolgestring NeinNo Die Angebots-IDThe offer identifier.
addonitemsaddonItems Liste der transferlineitem -ObjekteList of TransferLineItem objects NeinNo Eine Auflistung von transferentity-Zeilen Elementen für Addons, die zusammen mit dem übertragenen Basis Abonnement übertragen werden.A collection of transferEntity line items for addons that will be transferred along with the base subscription that is being transferred. Wird bei erfolgreicher Erstellung der transferentity angewendet.Applied upon successful creation of the transferEntity.
ÜbertragungsfehlertransferError Zeichenfolgestring NeinNo Wird angewendet, nachdem transferentity bei einem Fehler akzeptiert wurde.Applied after transferEntity is accepted in case of an error.
statusstatus Zeichenfolgestring NeinNo Der Status des LineItem in der transferentity.The status of the lineitem in the transferEntity.

AnforderungsbeispielRequest 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"
        }
    ]
}

REST-AntwortREST response

Bei erfolgreicher Ausführung gibt diese Methode die aufgefüllte transferenity -Ressource im Antworttext zurück.If successful, this method returns the populated TransferEnity resource in the response body.

Erfolgs- und Fehlercodes der AntwortResponse success and error codes

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen.Use a network trace tool to read this code, error type, and additional parameters. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.For the full list, see Error Codes.

AntwortbeispielResponse 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"
    }
}