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

A Microsoft Ügyfélszerződés szerződési metaadatainak 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 Microsoft Ügyfélszerződés szerződési metaadatait a Partnerközpont jelenleg csak a Microsoft nyilvános felhőjében támogatja.

A szerződés metaadatait le kell kérnie a Microsoft Ügyfélszerződés, mielőtt a következőt teheti:

Előfeltételek

.NET (1.14-es vagy újabb verzió)

A szerződés metaadatainak lekérése Microsoft Ügyfélszerződés:

  1. Először kérje le az IAggregatePartner.AgreementDetails gyűjteményt .

  2. Hívja meg a ByAgreementType metódust a gyűjtemény Microsoft Ügyfélszerződés szűréséhez.

  3. Végül hívja meg a Get vagy a GetAsync metódust .

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();

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

REST-kérés

A szerződés metaadatainak lekérése Microsoft Ügyfélszerződés:

  1. Hozzon létre egy REST-kérést a AgreementMetaData gyűjtemény lekéréséhez.

  2. A agreementType lekérdezési paraméterrel az eredményt csak a Microsoft Ügyfélszerződés hatókörébe hatja.

Kérés szintaxisa

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

URI-paraméterek

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

Név Típus Kötelező Leírás
szerződéstípus húr Nem 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 nem ismert szerződéstípusok kezeléséhez szükséges futtatókörnyezeti logikával, mert a Microsoft bármikor új szerződéstípusokkal is bevezetheti a szerződés metaadatait.)

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.

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/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 lévő AgreementMetaData-erőforrások 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": 1,
    "items": [
        {
            "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
            "agreementType": "MicrosoftCustomerAgreement",
            "agreementLink": "https://aka.ms/customeragreement",
            "versionRank": 0
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}