次の方法で共有

Microsoft 顧客契約の顧客の直接署名 (直接同意) の状態を取得する

  • [アーティクル]

に適用: パートナー センター

はには適用されません: 21Vianet が運営するパートナー センター |Microsoft Cloud for US Government のパートナー センター

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

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

前提 条件

  • パートナー センター認証で説明されている資格情報。 このシナリオでは、App+User 資格情報のみを使用した認証がサポートされます。

  • 顧客 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 パラメーターを使用できます。

名前 型 必須 説明
カスタマー・テナント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: aaaa0000-bb11-2222-33cc-444444dddddd

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

{"isSigned":true}