Read User Roles（ユーザーロールの読み取り）
Office 365のユーザーに割り当てられているロールを取得します。
Read User Rolesアクションカードは、Office 365テナントでアクティブ化されているロールのみを参照します。
また、このカードはデフォルトのシステムロールのみを参照します。カスタムロールは参照しません。
入力
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
ユーザー |
|||
|
Id or Username（IDまたはユーザー名） |
Office 365ユーザーのユーザーIDまたはユーザー名。これはユーザーのユーザープリンシパル名（UPN）です。UPNは、ユーザー名とドメインを@区切り文字で組み合わせたものです。 たとえば、john.doe@somedomain.comとなります。ユーザーのメールアドレスが考えられますが、常にそうであるとは限りません。 |
テキスト |
TRUE |
UPN入力の文字列が「$」で始まるときは、「/users」の後のスラッシュ（/）を削除し、UPN値を括弧と単一引用符で囲みます。例：/users('$AdeleVance@contoso.com')。「Microsoft Graphの既知の問題」を参照してください。
UPN入力値を使用してB2Bユーザーを検索するには、#文字を%23としてエンコードします。例：/users/AdeleVance_adatum.com%23EXT%23@contoso.com。
出力
| フィールド | 定義 | タイプ |
|---|---|---|
|
ID |
ユーザーの一意識別子。 |
テキスト |
|
Display Name（表示名） |
ディレクトリロールの表示名。 |
テキスト |
|
Description（説明） |
ディレクトリロールの説明。 |
テキスト |
|
Role Template ID（ロールテンプレートID） |
このロールの基盤となっているdirectoryRoleTemplateのID。 POST操作を使ってテナントのディレクトリロールをアクティブ化する場合は、このプロパティーを指定する必要があります。ディレクトリロールがアクティベートされると、このプロパティーは読み取り専用になります。 |
テキスト |
例：
{
"@odata.id": "https://graph.microsoft.com/v2/28d029a7-1d11-4ce0-85f5-d9502f2cd5b1/directoryObjects/06265c7a-1373-4033-8d26-3a9a04226e15/Microsoft.DirectoryServices.DirectoryRole",
"id": "06265c7a-1373-4033-8d26-3a9a04226e15",
"deletedDateTime": null,
"description": "Can reset passwords for non-administrators and Helpdesk Administrators.",
"displayName": "Helpdesk Administrator",
"roleTemplateId": "729827e3-9c14-49f7-bb1b-9608f156bbb8"
}