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

Článek
03/05/2024

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

{"isSigned":true}

Sdílet prostřednictvím