Získání stavu přímého podepisování zákazníka (přímé přijetí) Smlouva se zákazníkem Microsoftu

  • Článek

Platí pro: Partnerské centrum

Nevztahuje se na: Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Prostředek DirectSignedCustomerAgreementStatus v současné době podporuje Partnerské centrum pouze ve veřejném cloudu Microsoftu.

Tento článek vysvětluje, jak můžete načíst stav přímého přijetí Smlouva se zákazníkem Microsoftu zákazníka.

Požadavky

  • Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze s přihlašovacími údaji aplikace a uživatele.

  • ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

C#

Pokud chcete načíst stav přímého přijetí Smlouva se zákazníkem Microsoftu zákazníka, zavolejte metodu IAggregatePartner.Customers.ById s identifikátorem zákazníka. Pak použijte Vlastnost Agreements k načtení ICustomerAgreementCollection rozhraní. Nakonec zavolejte GetDirectSignedCustomerAgreementStatus() nebo GetDirectSignedCustomerAgreementStatusAsync() načtěte stav.

// IAggregatePartner partnerOperations;
// string customerId;
var customerDirectSigningStatus = partnerOperations.Customers.ById(selectedCustomerId).Agreements.GetDirectSignedCustomerAgreementStatus();

Ukázka: Ukázková aplikace konzoly Projekt: SdkSamples – třída: GetDirectSignedCustomerAgreementStatus.cs

Požadavek REST

Pokud chcete načíst stav přímého přijetí Smlouva se zákazníkem Microsoftu zákazníka, vytvořte požadavek REST na načtení DirectSignedCustomerAgreementStatus pro zákazníka.

Syntaxe požadavku

Použijte následující syntaxi požadavku:

metoda Identifikátor URI žádosti
GET {baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Parametry identifikátoru URI

U požadavku můžete použít následující parametry identifikátoru URI:

Name Type Požadováno Popis
customer-tenant-id Identifikátor GUID Ano Hodnota je IDENTIFIKÁTOR CUSTOMERTenantId formátovaný identifikátorem GUID, který umožňuje zadat ID tenanta zákazníka.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nezaokrouhlovat.

Příklad požadavku

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: ab993325-1605-4cf4-bac4-fb584142a31b

Odpověď REST

Pokud je tato metoda úspěšná, vrátí DirectSignedCustomerAgreementStatus prostředek v těle odpovědi.

Prostředek má vlastnost isSigned , která označuje stav přímého podepisování (přímého přijetí) zákazníka.

  • Hodnota true znamená, že smlouva byla podepsána (přijata) přímo zákazníkem.

  • Hodnota nepravda znamená, že smlouva nebyla podepsána (přijata) přímo zákazníkem.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění.

Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi

HTTP/1.1 200 OK
Content-Length: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

{"isSigned":true}