agentIdentity 推移的メンバーシップを一覧表示する

名前空間: microsoft.graph

この agentIdentity がメンバーであるグループとディレクトリ ロールを取得します。 この操作は推移的であり、このエージェント ID が入れ子になったメンバーであるすべてのグループが含まれます。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

HTTP 要求

GET /servicePrincipals/{id}/microsoft.graph.agentIdentity/transitiveMemberOf

オプションのクエリ パラメーター

このメソッドは、応答のカスタマイズに役立つ $filter、 $count、 $select、 $search、 $topOData クエリ パラメーター をサポートします。

• OData キャストも有効です。
• $search は displayName プロパティと description プロパティでのみサポートされています。
• 既定のページ サイズと最大ページ サイズはそれぞれ 100 オブジェクトと 999 オブジェクトです。
• この API でのクエリ パラメーターの使用は、高度なクエリ パラメーターでのみサポートされます。 詳細については、「ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。

要求ヘッダー

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドでは 200 OK 応答コードと、応答本文で directoryObject オブジェクトのコレクションを返します。

例

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/beta/servicePrincipals/{id}/microsoft.graph.agentIdentity/transitiveMemberOf

const options = {
	authProvider,
};

const client = Client.init(options);

let transitiveMemberOf = await client.api('/servicePrincipals/{id}/microsoft.graph.agentIdentity/transitiveMemberOf')
	.version('beta')
	.get();

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.group",
      "id": "id-value",
      "createdDateTime": null,
      "description": "All users at the company",
      "displayName": "All Users",
      "groupTypes": [],
      "mailEnabled": false,
      "securityEnabled": true
    }
  ]
}