Vytvoření přenosu

Požadavky

  • Přihlašovací údaje, jak je popsáno Partnerské centrum ověřování. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.

  • ID zákazníka ( customer-tenant-id ). Pokud ID zákazníka neznáme, můžete ho na řídicím panelu Partnerské centrum. V nabídce Partnerské centrum vyberte CSP a pak Zákazníci. V seznamu zákazníků vyberte zákazníka a pak vyberte Účet. Na stránce Účtu zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. Id Microsoftu je stejné jako ID zákazníka ( customer-tenant-id ).

Požadavek REST

Syntaxe požadavku

Metoda Identifikátor URI žádosti
Příspěvek {baseURL}/v1/customers/{ID_zákazníka}/transfers HTTP/1.1

Parametr URI

K identifikaci zákazníka použijte následující parametr cesty.

Název Typ Vyžadováno Popis
id zákazníka řetězec Yes Identifikátor GUID naformátovaný jako customer-id, který identifikuje zákazníka.

Hlavičky požadavku

Další informace najdete v Partnerské centrum REST.

Text požadavku

Tato tabulka popisuje vlastnosti TransferEntity v textu požadavku.

Vlastnost Typ Vyžadováno Popis
id řetězec No Identifikátor transferEntity zadaný po úspěšném vytvoření transferEntity.
čas vytvoření DateTime No Datum vytvoření transferEntity ve formátu data a času. Použije se při úspěšném vytvoření transferEntity.
lastModifiedTime DateTime No Datum poslední aktualizace transferEntity ve formátu data a času. Použije se při úspěšném vytvoření transferEntity.
lastModifiedUser řetězec No Uživatel, který naposledy aktualizoval transferEntity. Použije se při úspěšném vytvoření transferEntity.
customerName řetězec No Nepovinný parametr. Jméno zákazníka, jehož předplatná se převádějí.
customerTenantId řetězec No Identifikátor GUID naformátovaný jako customer-id, který identifikuje zákazníka. Použije se při úspěšném vytvoření transferEntity.
partnertenantid řetězec No Identifikátor GUID naformátovaný jako partner-ID, který identifikuje partnera.
sourcePartnerName řetězec No Nepovinný parametr. Název organizace partnera, která iniciuje převod.
sourcePartnerTenantId řetězec Yes Identifikátor GUID naformátovaný jako partner-ID, který identifikuje partnera, který zahájí převod.
targetPartnerName řetězec No Nepovinný parametr. Název organizace partnera, na kterou se převod cílí.
targetPartnerTenantId řetězec Yes Identifikátor GUID naformátovaný jako partner-ID, který identifikuje partnera, na kterého se přenos cílí.
položky řádku Pole objektů Yes Pole prostředků TransferLineItem.
status řetězec No Stav transferEntity. Možné hodnoty jsou Aktivní (je možné je odstranit nebo odeslat) a Dokončeno (už je hotové). Použije se při úspěšném vytvoření transferEntity.

Tato tabulka popisuje vlastnosti TransferLineItem v textu požadavku.

Vlastnost Typ Vyžadováno Popis
id řetězec No Jedinečný identifikátor pro položku na lince přenosu. Použito po úspěšném vytvoření transferEntity.
subscriptionId řetězec Yes Identifikátor předplatného.
quantity int No Počet licencí nebo instancí.
billingCycle Objekt No Typ fakturačního cyklu nastaveného pro aktuální období.
friendlyName řetězec No Nepovinný parametr. Popisný název položky definované partnerem, který vám umožní určit nejednoznačnost.
partnerIdOnRecord řetězec No PartnerId na záznam (MPN ID) při nákupu, ke kterému dojde při přijetí přenosu.
Hodnotami OfferId řetězec No Identifikátor nabídky
addonItems Seznam objektů TransferLineItem No Kolekce položek řádku transferEntity pro doplňky, které se přenesou spolu se základním předplatným, které se přenáší. Použito po úspěšném vytvoření transferEntity.
transferError řetězec No Používá se po přijetí transferEntity, pokud dojde k chybě.
status řetězec No Stav LineItem v transferEntity.

Příklad požadavku

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

Odpověď REST

V případě úspěchu tato metoda vrátí naplněný prostředek TransferEnity v těle odpovědi.

Úspěšné odpovědi a chybové kódy

Každá odpověď je dodávána se stavovým kódem HTTP, který označuje úspěch nebo selhání a další informace o ladění. Použijte nástroj pro trasování sítě ke čtení tohoto kódu, typu chyby a dalších parametrů. Úplný seznam najdete v tématu kódy chyb.

Příklad odpovědi

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