サブスクリプションのサポート連絡先情報を取得する

[アーティクル]
11/28/2023

適用対象: パートナーセンター | Microsoft Cloud for US Government のパートナーセンター

サブスクリプションのサポート連絡先を取得する方法。

Note

指定されたサポート連絡先の割り当てと更新は、新しいコマースではサポートされていません。その結果、 パートナーセンターポータルと API 内の新しいコマースサブスクリプションの [指定されたサポート連絡先 ] セクションは表示されません。

前提条件

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

C#

サブスクリプションのサポート連絡先を取得するには、まず、顧客 ID を指定して IAggregatePartner.Customers.ById メソッドを使用して顧客を識別します。次に、サブスクリプション ID を使用して Subscriptions.ById メソッドを呼び出して、サブスクリプション操作へのインターフェイスを取得します。次に、SupportContact プロパティを使用して連絡先操作をサポートするインターフェイスを取得し、Get メソッドまたは GetAsync メソッドを呼び出して SupportContact オブジェクトを取得します。

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Retrieve subscription's support contact.
var supportContact = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId).SupportContact.Get();

サンプル: コンソールテストアプリ。 プロジェクト: パートナーセンター SDK サンプル クラス: GetSubscriptionSupportContact.cs

REST 要求

要求の構文

認証方法	要求 URI
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/supportcontact HTTP/1.1

URI パラメーター

顧客とサブスクリプションを識別するには、次のパスパラメーターを使用します。

名前	タイプ	Required	説明
customer-id	string	はい	顧客を識別する GUID 形式の文字列。
subscription-id	string	はい	試用版サブスクリプションを識別する GUID 形式の文字列。

要求ヘッダー

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

要求本文

なし。

要求の例

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/supportcontact HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: d052776c-e8fd-4803-b6a3-1659055ac3c4
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST 応答

成功した場合、応答本文には SupportContact リソースが含まれます。

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

各応答には、成功または失敗を示す HTTP ステータスコードと、追加のデバッグ情報が付属しています。このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワークトレースツールを使用します。完全な一覧については、パートナーセンターのエラーコードを参照してください。

応答の例

HTTP/1.1 200 OK
Content-Length: 328
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: d052776c-e8fd-4803-b6a3-1659055ac3c4
MS-CV: bLbUhqy0+ESOX1v4.0
MS-ServerId: 201022015
Date: Tue, 20 Jun 2017 19:30:19 GMT

{
    "supportTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "supportMpnId": "4391507",
    "name": "Trey Research",
    "links": {
        "self": {
            "uri": "/customers/0C39D6D5-C70D-4C55-BC02-F620844F3FD1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/supportcontact",
            "method": "Get",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SupportContact"
    }
}

次の方法で共有