名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
注意
Azure リソースのこのバージョンのPrivileged Identity Management (PIM) API は非推奨となり、2026 年 10 月 28 日にデータの返しを停止します。 Azure リソース ロールに新しい Azure REST PIM API を使用します。
governanceRoleAssignments のコレクションを取得します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
次の表は、サポートされている各リソースの種類でこの API を呼び出すために必要な最小特権のアクセス許可またはアクセス許可を示しています。 ベスト プラクティスに従って、最小限の特権のアクセス許可を要求します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| サポートされているリソース | 委任 (職場または学校のアカウント) | 委任 (個人用 Microsoft アカウント) | アプリケーション |
|---|---|---|---|
| Microsoft Entra ID | PrivilegedAccess.ReadWrite.AzureAD | サポートされていません。 | PrivilegedAccess.Read.AzureAD |
| Azure リソース | PrivilegedAccess.ReadWrite.AzureResources | サポートされていません。 | PrivilegedAccess.Read.AzureResources |
| group | PrivilegedAccess.ReadWrite.AzureADGroup | サポートされていません。 | PrivilegedAccess.Read.AzureADGroup |
要求者は、リソースに対して少なくとも 1 つのロール割り当てを持っている必要もあります。
HTTP 要求
リソースの governanceRoleAssignments の コレクションを一覧表示します。
GET /privilegedAccess/azureResources/resources/{resourceId}/roleAssignments
GET /privilegedAccess/azureResources/roleAssignments?$filter=resourceId+eq+'{resourceId}'
サインインしているユーザーの governanceRoleAssignments の コレクションを一覧表示します。
GET /privilegedAccess/azureResources/roleAssignments?$filter=subjectId+eq+'{myId}'
オプションのクエリ パラメーター
このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文の governanceRoleAssignment オブジェクトのコレクションを返します。
例
この例では、サブスクリプション Wingtip Toys - Prod でロールの割り当てを取得する方法を示します。
要求
GET https://graph.microsoft.com/beta/privilegedAccess/azureResources/roleAssignments?$filter=subjectId+eq+'918e54be-12c4-4f4c-a6d3-2ee0e3661c51'
応答
HTTP/1.1 200 OK
Content-type: application/json
Content-Length: 2062
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#governanceRoleAssignments",
"value": [
{
"id": "20f4157d-5837-4356-9630-ebd3a832f227",
"resourceId": "fb016e3a-c3ed-4d9d-96b6-a54cd4f0b735",
"roleDefinitionId": "bc75b4e6-7403-4243-bf2f-d1f6990be122",
"subjectId": "918e54be-12c4-4f4c-a6d3-2ee0e3661c51",
"linkedEligibleRoleAssignmentId": null,
"externalId": null,
"startDateTime": "2018-03-13T01:19:08.59Z",
"endDateTime": "2018-06-11T01:18:37.08Z",
"memberType": "Direct",
"assignmentState": "Eligible",
"status": "Provisioned"
},
{
"id": "e327f4be-42a0-47a2-8579-0a39b025b394",
"resourceId": "e5e7d29d-5465-45ac-885f-4716a5ee74b5",
"roleDefinitionId": "8b4d1d51-08e9-4254-b0a6-b16177aae376",
"subjectId": "918e54be-12c4-4f4c-a6d3-2ee0e3661c51",
"linkedEligibleRoleAssignmentId": null,
"externalId": null,
"startDateTime": "2018-03-28T16:56:48.243Z",
"endDateTime": "2018-09-24T16:56:30.547Z",
"memberType": "Direct",
"assignmentState": "Eligible",
"status": "Provisioned"
},
...
]
}