Microsoft 顧客契約の顧客の直接署名 (直接受け入れ) の状態を取得する

[アーティクル]
03/05/2024

適用対象: パートナーセンター

適用対象外: 21Vianet が運営するパートナーセンター | Microsoft Cloud for US Government のパートナーセンター

DirectSignedCustomerAgreementStatus リソースは、現在、Microsoft パブリッククラウドのパートナーセンターでのみサポートされています。

この記事では、Microsoft 顧客契約に対する顧客の直接の同意の状態を取得する方法について説明します。

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。
顧客 ID です (customer-tenant-id)。顧客の ID がわからない場合は、パートナーセンターで [顧客] ワークスペースを選び、顧客一覧から顧客を選び、[アカウント] を選んで調べることができます。顧客の [アカウント] ページの [顧客のアカウント情報] セクションで Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。

C#

Microsoft 顧客契約に対する顧客の直接の同意の状態を取得するには、顧客識別子を使用して IAggregatePartner.Customers.ById メソッドを呼び出します。次に、Agreements プロパティを使用して ICustomerAgreementCollection インターフェイスを取得します。最後に、状態を呼び出 GetDirectSignedCustomerAgreementStatus() すか GetDirectSignedCustomerAgreementStatusAsync() 取得します。

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

サンプル: コンソールサンプルアプリ。 プロジェクト: SdkSamples クラス: GetDirectSignedCustomerAgreementStatus.cs

REST 要求

顧客がMicrosoft 顧客契約に直接同意した状態を取得するには、顧客の DirectSignedCustomerAgreementStatus を取得する REST 要求を作成します。

要求の構文

次の要求構文を使用します。

メソッド	要求 URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

URI パラメーター

要求では、次の URI パラメーターを使用できます。

名前	タイプ	Required	説明
customer-tenant-id	GUID	はい	値は、顧客のテナント ID を指定できる GUID 形式の CustomerTenantId です。

要求ヘッダー

詳細については、「パートナーセンター REST ヘッダー」を参照してください。

要求本文

なし。

要求の例

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

REST 応答

成功した場合、このメソッドは応答本文で DirectSignedCustomerAgreementStatus リソースを返します。

リソースには、顧客の 直接署名 (直接受け入れ) 状態を示す isSigned プロパティがあります。

値が true の場合は、契約が顧客によって直接署名 (受け入れ) されたことを示します。
false の値は、契約が顧客によって直接署名 (受け入れ) されていないことを示します。

応答の成功とエラーのコード

各応答には、成功または失敗とより多くのデバッグ情報を示す HTTP 状態コードが付属しています。

ネットワークトレースツールを使用して、このコード、エラーの種類、およびその他のパラメーターを読み取ります。完全な一覧については、パートナーセンターの REST エラーコードに関する記事を参照してください。

応答の例

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}