Assign Role to User

Office 365ユーザーにロールを割り当てます。

注意:

ユーザーにロールを割り当てる（Assign Role to User）カードではカスタムロールはサポートされません。このアクションカードを使ってカスタムロールの割り当てを試みると、Oktaはエラーを返します。

オプション

フィールド定義タイプ必須

フィールド	定義	タイプ	必須
ロールID（Role Id）	指定されたユーザーに割り当てられるOffice 365ロールのIDを識別します。	ドロップダウン	正
ロールテンプレートID（Role Template Id）	特定のユーザーに割り当てられるロールの基盤となっているOffice 365 `directoryRoleTemplate`のIDを識別します。 POST操作を使ってテナントのディレクトリロールをアクティブ化する場合は、このプロパティーを指定する必要があります。ディレクトリロールがアクティブ化されると、このプロパティーは読み取り専用になります。	ドロップダウン	正

ロールID（Role Id）

指定されたユーザーに割り当てられるOffice 365ロールのIDを識別します。

ドロップダウン

正

ロールテンプレートID（Role Template Id）

特定のユーザーに割り当てられるロールの基盤となっているOffice 365 directoryRoleTemplateのIDを識別します。

POST操作を使ってテナントのディレクトリロールをアクティブ化する場合は、このプロパティーを指定する必要があります。ディレクトリロールがアクティブ化されると、このプロパティーは読み取り専用になります。

ドロップダウン

正

入力

フィールド	定義	タイプ	必須
ユーザー（User）
ユーザーIDまたはユーザー名（Id or Username）	Office 365ユーザーのユーザーIDまたはユーザー名。これはユーザーのユーザープリンシパル名（UPN）です。UPNはユーザー名とドメインを`@`区切り文字で組み合わせたものです。たとえば、`john.doe@somedomain.com`です。ユーザーのメールアドレスが考えられますが、常にそうであるとは限りません。このフィールドは、オプション（Options）でロールテンプレートID（Role Template Id）が選択されている場合に表示されます。	テキスト	正
ロールID（Role ID）	ロールの一意のID。このフィールドは、オプション（Options）でロールID（Role Id）が選択されている場合に表示されます。	テキスト	正
ロール（Role）
ID（Id）	このロールの基盤となっている`directoryRoleTemplate`のID。POST操作を使ってテナントのディレクトリロールをアクティブ化する場合は、このプロパティーを指定する必要があります。ディレクトリロールがアクティブ化されると、このプロパティーは読み取り専用になります。このフィールドは、オプション（Options）でロールテンプレートID（Role Template Id）が選択されている場合に表示されます。	テキスト	正

注:

UPN入力の文字列が$で始まるときは、/usersの後のスラッシュ（/）を削除し、UPN値を括弧と単一引用符で囲みます。たとえば、/users('$AdeleVance@contoso.com')です。Microsoft Graphの既知の問題を参照してください。

UPN入力値を使用してB2Bユーザーを検索するには、#文字を%23としてエンコードします。たとえば、/users/AdeleVance_adatum.com%23EXT%23@contoso.comです。

出力

フィールド	定義	タイプ
ステータスコード（Status Code）	操作の結果。コネクターは、カードによって実行されたアクションの成否を示すHTTPステータスコードを返します。例： `201 Created`ステータスコードは、アクションが成功し、新しいリソースが作成されたことを示します。 `403 Forbidden`エラーは、必要な権限が不足していたためにHTTPリクエストが処理されなかったことを示します。発生する可能性があるステータスコードの完全なリストについては、HTTPステータスコードを参照してください。	数値