Megosztás a következőn keresztül:

A Microsoft Ügyfélszerződés ügyfél általi elfogadási megerősítésének lekérése

  • Cikk

A következőre vonatkozik: Partnerközpont

Nem vonatkozik a 21Vianet által üzemeltetett Partnerközpontra | Partnerközpont a Microsoft Cloud for US Government számára

A Szerződés erőforrást a Partnerközpont jelenleg csak a Microsoft nyilvános felhőjében támogatja.

Ez a cikk bemutatja, hogyan kérhető le az ügyfél által a Microsoft Ügyfélszerződés elfogadásának visszaigazolása(i).

Előfeltételek

  • Ha a Partnerközpont .NET SDK-t használja, az 1.14-es vagy újabb verzióra van szükség.

    Fontos

    2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. Az SDK-kiadást letöltheti a GitHubról, valamint egy hasznos információkat tartalmazó olvasófájlt.

    A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak az App+User hitelesítést támogatja.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

.NET

A korábban megadott ügyfél-elfogadási visszaigazolás(ok) lekérése:

  • Használja az IAggregatePartner.Customers gyűjteményt, és hívja meg a ById metódust a megadott ügyfélazonosítóval.

  • A ByAgreementType metódus meghívásával kérje le a Agreements tulajdonságot, és szűrje az eredményeket Microsoft Ügyfélszerződés.

  • Hívja meg a Get vagy a GetAsync metódust.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Teljes minta található a GetCustomerAgreements osztályban a konzoltesztelési alkalmazás projektjéből.

REST-kérés

A korábban megadott ügyfél-elfogadás megerősítésének lekérése:

  1. Hozzon létre egy REST-kérést az ügyfél szerződésgyűjteményének lekéréséhez.

  2. A agreementType lekérdezési paraméterrel az eredményeket csak a Microsoft Ügyfélszerződés hatókörébe lehet korlátozni.

Kérés szintaxisa

Használja a következő kérés szintaxisát:

Metódus Kérés URI-ja
KAP {baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

URI-paraméterek

A kéréshez a következő URI-paramétereket használhatja:

Név Típus Kötelező Leírás
ügyfél-bérlő-azonosító GUID Igen Az érték egy GUID formátumú CustomerTenantId , amely lehetővé teszi egy ügyfél megadását.
szerződéstípus húr Nem Ez a paraméter az összes szerződés metaadatát visszaadja. Ezzel a paraméterrel hatókörbe adhatja a lekérdezési választ egy adott szerződéstípusra. A támogatott értékek a következők:

MicrosoftCloudAgreement, amely csak a MicrosoftCloudAgreement típusú szerződés metaadatait tartalmazza.

MicrosoftCustomerAgreement, amely csak a MicrosoftCustomerAgreement típusú szerződés metaadatait tartalmazza.

* amely az összes szerződés metaadatát visszaadja. (Csak akkor használja * , ha a kód rendelkezik a váratlan szerződéstípusok kezeléséhez szükséges logikával.)

Megjegyzés: Ha az URI paraméter nincs megadva, a lekérdezés alapértelmezés szerint a MicrosoftCloudAgreement lesz a visszamenőleges kompatibilitás érdekében. A Microsoft bármikor bevezetheti a szerződés metaadatait új szerződéstípusokkal.

Kérésfejlécek

További információ: Partnerközpont – REST fejlécek.

Kérés törzse

Nincs.

Példa kérése

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

REST-válasz

Ha ez a módszer sikeres, a válasz törzsében a Szerződés erőforrásainak gyűjteményét adja vissza.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint egyéb hibakeresési információkat.

A kód, hibatípus és egyéb paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont REST-hibakódjaiban találja.

Példa válaszra

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}