顧客組織を取得する

[アーティクル]
08/12/2023

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

顧客組織リソースを取得します。

前提条件

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

重要

この API を呼び出すには GDAP ロールが必要です。 DAP はサポートされていません。パートナー認証は引き続き必要です (AdminAgent/HelpDeskAgent/SalesAgent)

GDAP ロール

次の GDAP ロールのうち少なくとも 1 つが必要です。

全体管理者
ディレクトリライター
グローバル閲覧者

REST 要求

要求の構文

認証方法	要求 URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/organization HTTP/1.1

URI パラメーター

特定の顧客に対して次のクエリパラメーターを使用します。

名前	種類	必須	説明
customer-tenant-id	guid	Y	この値は、リセラーがリセラーに属する特定の顧客の結果をフィルター処理できるようにする、GUID 形式の customer-tenant-id です。

要求ヘッダー

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

要求本文

[なし] :

要求の例

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/organization HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

REST 応答

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

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

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

応答の例

HTTP/1.1 200 OK
Content-Length: 1530
Content-Type: application/json; charset=utf-8
MS-CorrelationId: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

[
  {
    "street": "1 Microsoft Way",
    "countryLetterCode": "US",
    "postalCode": "98052-8300",
    "city": "Redmond",
    "state": "WA",
    "displayName": "Contoso",
    "technicalNotificationMails": [
      "test@contoso.com"
    ]
  }
]

次のステップ

顧客のカスタムドメインを取得する

次の方法で共有