ユーザーの読み取り

Office 365のユーザーに割り当てられているロールを取得します。

注意

ユーザーロールの読み取りアクションカードは、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 ユーザーの一意識別子。 文字列
表示名 ディレクトリロールの表示名。 文字列
説明 ディレクトリロールの説明。 文字列
ロールテンプレート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"
}

関連項目

Office 365 Adminコネクター

Workflowsの要素

Office 365 Adminコネクターに関するガイダンス

Office 365 Admin Management APIの概要