A Microsoft Ügyfélszerződés szerződési metaadatainak lekérése
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:
- Ellenőrizze, hogy egy ügyfél elfogadta-e a Microsoft Ügyfélszerződés
- A Microsoft Ügyfélszerződés-sablon letöltési hivatkozásának lekérése
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.
.NET (1.14-es vagy újabb verzió)
A szerződés metaadatainak lekérése Microsoft Ügyfélszerződés:
Először kérje le az IAggregatePartner.AgreementDetails gyűjteményt .
Hívja meg a ByAgreementType metódust a gyűjtemény Microsoft Ügyfélszerződés szűréséhez.
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:
Hozzon létre egy REST-kérést a AgreementMetaData gyűjtemény lekéréséhez.
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: aaaa0000-bb11-2222-33cc-444444dddddd
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: aaaa0000-bb11-2222-33cc-444444dddddd
{
"totalCount": 1,
"items": [
{
"templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
"agreementType": "MicrosoftCustomerAgreement",
"agreementLink": "https://aka.ms/customeragreement",
"versionRank": 0
}
],
"attributes": {
"objectType": "Collection"
}
}