Microsoft Cloud 契約に関する顧客の同意の確認を取得するGet confirmation of customer acceptance of Microsoft Cloud Agreement

適用対象Applies To

  • パートナー センターPartner Center

注意

アグリーメントリソースは、現在、Microsoft パブリッククラウドのパートナーセンターでのみサポートされています。The Agreement resource is currently supported by Partner Center in the Microsoft public cloud only. 次の場合には適用されません。It isn't applicable to:

  • 21Vianet が運営するパートナー センターPartner Center operated by 21Vianet
  • Microsoft Cloud ドイツのパートナー センターPartner Center for Microsoft Cloud Germany
  • 米国政府機関向け Microsoft Cloud のパートナー センターPartner Center for Microsoft Cloud for US Government

前提条件Prerequisites

  • パートナーセンター .NET SDK を使用している場合は、バージョン1.9 以降が必要です。If you are using the Partner Center .NET SDK, version 1.9 or newer is required.

  • パートナーセンターの Java SDK を使用している場合は、バージョン1.8 以降が必要です。If you are using the Partner Center Java SDK, version 1.8 or newer is required.

  • パートナー センターの認証に関するページで説明している資格情報。Credentials as described in Partner Center authentication. このシナリオでサポートされるのは、アプリとユーザー認証のみです。This scenario supports only supports app + user authentication.

  • 顧客 ID です (customer-tenant-id)。A customer ID (customer-tenant-id). お客様の ID がわからない場合は、パートナー センターのダッシュボードで検索できます。If you don't know the customer's ID, you can look it up in the Partner Center dashboard. パートナー センター メニューの [CSP] を選択し、 [顧客] を選択します。Select CSP from the Partner Center menu, followed by Customers. 顧客一覧からお客様を選び、 [アカウント] を選択します。Select the customer from the customer list, then select Account. お客様のアカウント ページで、 [顧客のアカウント情報] セクションの Microsoft ID を探します。On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。The Microsoft ID is the same as the customer ID (customer-tenant-id).

.NET (バージョン1.4 以降).NET (version 1.4 or newer)

以前に提供された顧客の同意の確認を取得するには、次のようにします。To retrieve confirmation(s) of customer acceptance that was previously provided:

  • Iaggregatepartner.customersコレクションを使用し、指定された顧客識別子を使用してByIdメソッドを呼び出します。Use the IAggregatePartner.Customers collection and call ById method with the specified customer identifier.

  • ByAgreementTypeメソッドを呼び出して、アグリーメントのプロパティを取得し、結果を Microsoft Cloud agreement にフィルター処理します。Fetch the Agreements property and filter the results to Microsoft Cloud Agreement by calling ByAgreementType method.

  • GetまたはGetAsyncメソッドを呼び出します。Call Get or GetAsync method.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCloudAgreement";

var cloudAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

完全なサンプルは、コンソールテストアプリプロジェクトのget顧客契約クラスにあります。A complete sample can be found in the GetCustomerAgreements class from the console test app project.

.NET (バージョン 1.9-1.13).NET (version 1.9 - 1.13)

以前に提供された顧客の受け入れの確認を取得するには:To retrieve confirmation of customer acceptance provided previously:

Iaggregatepartner.customersコレクションを使用し、指定された顧客の識別子を使用してByIdメソッドを呼び出します。Use the IAggregatePartner.Customers collection and call the ById method with the specified customer's identifier. 次に、 agreement プロパティを取得し、次に get メソッドまたは GetAsync メソッドを呼び出します。Then, get the Agreements property, followed by calling the Get or GetAsync methods.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var agreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Get();

JavaJava

パートナー センター Java SDK は、パートナーが自分のパートナー センター リソースを管理するために一般的に使用されます。The Partner Center Java SDK is commonly used by partners to manage their Partner Center resources. これはパートナー コミュニティによって管理されているオープン ソース プロジェクトです。It's an open-source project maintained by the partner community. このモジュールはパートナー コミュニティによって管理されているため、Microsoft では公式にサポートしていません。Since this module is maintained by the partner community, it isn't officially supported by Microsoft. 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。You can get help from the community or open an issue on GitHub if you experience a problem.

以前に提供された顧客の受け入れの確認を取得するには:To retrieve confirmation of customer acceptance provided previously:

Iaggregatepartner.customers関数を使用し、指定された顧客の識別子を使用してbyId関数を呼び出します。Use the IAggregatePartner.getCustomers function and call the byId function with the specified customer's identifier. 次に、 Getagreements 関数を取得し、次に get 関数を呼び出します。Then, get the getAgreements function, followed by calling the get function.

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

ResourceCollection<Agreement> agreements = partnerOperations.getCustomers().byId(selectedCustomerId).getAgreements().get();

完全なサンプルは、コンソールテストアプリプロジェクトのget顧客契約クラスにあります。A complete sample can be found in the GetCustomerAgreements class from the console test app project.

PowerShellPowerShell

パートナー センター PowerShell モジュールは、パートナーが自分のパートナー センター リソースを管理するために一般的に使用されます。The Partner Center PowerShell module is commonly used by partners to manage their Partner Center resources. これはパートナー コミュニティによって管理されているオープン ソース プロジェクトです。It's an open-source project maintained by the partner community. このモジュールはパートナー コミュニティによって管理されているため、Microsoft では公式にサポートしていません。Since this module is maintained by the partner community, it isn't officially supported by Microsoft. 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。You can get help from the community or open an issue on GitHub if you experience a problem.

以前に提供された顧客の受け入れの確認を取得するには:To retrieve confirmation of customer acceptance provided previously:

Get Partnerの顧客契約コマンドを使用します。Use the Get-PartnerCustomerAgreement command.

Get-PartnerCustomerAgreement -CustomerId '14876998-c0dc-46e6-9d0c-65a57a6c32ec'

REST 要求REST request

以前に提供された顧客の受け入れの確認を取得するには、次の手順を参照してください。To retrieve confirmation of customer acceptance provided previously, see the following instructions.

関連する証明 情報を使用して、新しい契約リソースを作成します。Create a new Agreement resource with the relevant certification information.

要求の構文Request syntax

認証方法Method 要求 URIRequest URI
GETGET {baseURL} /v1/customers/{customer-tenant-id}/agreements HTTP/1.1{baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

URI パラメーターURI parameter

次のクエリパラメーターを使用して、確認する顧客を指定します。Use the following query parameter to specify the customer you are confirming.

名前Name 種類Type 必須Required 説明Description
CustomerTenantIdCustomerTenantId GUIDGUID YY 値は、顧客を指定できるようにする GUID 形式の顧客 tenantid です。The value is a GUID formatted CustomerTenantId that allows you to specify a customer.

要求ヘッダーRequest headers

詳細については、「パートナー センター REST ヘッダー」を参照してください。For more information, see Partner Center REST headers.

[要求本文]Request body

[なし] :None.

要求の例Request example

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

REST 応答REST response

成功した場合、このメソッドは応答本文で アグリーメント リソースのコレクションを返します。If successful, this method returns a collection of Agreement resources in the response body.

応答の成功とエラーのコードResponse success and error codes

各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。Each response comes with an HTTP status code that indicates success or failure and additional debugging information. このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。Use a network trace tool to read this code, error type, and additional parameters. 完全な一覧については、パートナー センターの REST エラーコードに関する記事を参照してください。For the full list, see Partner Center REST error codes.

応答の例Response example

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2018-07-28T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://docs.microsoft.com/partner-center/agreements"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2017-08-01T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://docs.microsoft.com/partner-center/agreements"
        }
    ]
}