Az ügyfél közvetlen aláírásának (közvetlen elfogadásának) állapotának lekérése Microsoft Ügyfélszerződés
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 DirectSignedCustomerAgreementStatus erőforrást a Partnerközpont jelenleg csak a Microsoft nyilvános felhőjében támogatja.
Ez a cikk azt ismerteti, hogyan kérdezheti le az ügyfél közvetlen elfogadásának állapotát a Microsoft Ügyfélszerződés.
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak app+felhasználói hitelesítő adatokkal támogatja a hitelesítést.
Ü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
).
C#
A Microsoft Ügyfélszerződés ügyfél általi közvetlen elfogadásának állapotának lekéréséhez hívja meg az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval. Ezután használja a Agreements tulajdonságot egy ICustomerAgreementCollection felület lekéréséhez. Végül hívja meg GetDirectSignedCustomerAgreementStatus()
vagy GetDirectSignedCustomerAgreementStatusAsync()
kérje le az állapotot.
// IAggregatePartner partnerOperations;
// string customerId;
var customerDirectSigningStatus = partnerOperations.Customers.ById(selectedCustomerId).Agreements.GetDirectSignedCustomerAgreementStatus();
Minta: Konzol mintaalkalmazás. Projekt: SdkSamples osztály: GetDirectSignedCustomerAgreementStatus.cs
REST-kérés
Az ügyfél Microsoft Ügyfélszerződés közvetlen elfogadásának állapotának lekéréséhez hozzon létre egy REST-kérést az ügyfél DirectSignedCustomerAgreementStatusának lekéréséhez.
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}/directSignedMicrosoftCustomerAgreementStatus 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 az ügyfél bérlőazonosítójának megadását. |
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/directSignedMicrosoftCustomerAgreementStatus 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 sikeres, ez a metódus egy DirectSignedCustomerAgreementStatus erőforrást ad vissza a válasz törzsében.
Az erőforrás rendelkezik egy isSigned tulajdonságával, amely az ügyfél közvetlen aláírási (közvetlen elfogadási) állapotát jelzi.
Az igaz érték azt jelzi, hogy a szerződést közvetlenül az ügyfél írta alá (elfogadta).
A hamis érték azt jelzi, hogy a szerződést nem írta alá (fogadta el) közvetlenül az ügyfél.
Válasz sikeresség és hibakódok
Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikerességet vagy a hibát, valamint további 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: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{"isSigned":true}