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


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}