unifiedRoleAssignmentScheduleRequest リソースの種類

[アーティクル]
02/29/2024

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

PIM では、プリンシパルへのアクティブなロールの割り当ての要求を表します。ロールの割り当ては、有効期限の有無にかかわらず永続的にアクティブにすることも、適格な割り当てのアクティブ化後に一時的にアクティブにすることもできます。要求から継承します。

unifiedRoleAssignmentScheduleRequest リソースの種類を使用して定義できる PIM シナリオの詳細については、「特権 ID 管理 (PIM) API を使用したロール管理の概要」を参照してください。

メソッド

メソッド	戻り値の種類	説明
unifiedRoleAssignmentScheduleRequests を一覧表示する	unifiedRoleAssignmentScheduleRequest コレクション	unifiedRoleAssignmentScheduleRequest オブジェクトを介して行われたアクティブなロールの割り当ての要求を取得します。
unifiedRoleAssignmentScheduleRequest を作成する	unifiedRoleAssignmentScheduleRequest	アクティブで永続的なロールの割り当てまたはアクティブ化、非アクティブ化、拡張、または更新の要求を作成します。
unifiedRoleAssignmentScheduleRequest を取得する	unifiedRoleAssignmentScheduleRequest	unifiedRoleAssignmentScheduleRequest オブジェクトを介して行われたアクティブなロールの割り当ての要求を取得します。
取り消す	なし	アクティブなロールの割り当ての要求を取り消します。
filterByCurrentUser	unifiedRoleAssignmentScheduleRequest コレクション	特定のプリンシパルに対するアクティブなロールの割り当ての要求を取得します。

プロパティ

プロパティ	型	説明
action	String	ロールの割り当て要求に対する操作の種類を表します。使用可能な値: `adminAssign`、`adminUpdate`、`adminRemove`、`selfActivate`、`selfDeactivate`、`adminExtend`、`adminRenew`、`selfExtend`、`selfRenew`、`unknownFutureValue`。 `adminAssign`: 管理者がプリンシパルにロールを割り当てる場合。 `adminRemove`: 管理者がロールからプリンシパルを削除する場合。 `adminUpdate`: 管理者が既存のロールの割り当てを変更する場合。 `adminExtend`: 管理者が期限切れの割り当てを延長する場合。 `adminRenew`: 管理者が期限切れの割り当てを更新する場合。 `selfActivate`: プリンシパルが割り当てをアクティブ化する場合。 `selfDeactivate`: プリンシパルがアクティブな割り当てを非アクティブ化する。 `selfExtend`: プリンシパルが期限切れの割り当ての延長を要求する場合。 `selfRenew`: プリンシパルが期限切れの割り当ての更新を要求する場合。
approvalId	String	要求の承認の識別子。要求から継承されます。
appScopeId	String	割り当てがアプリにスコープ設定されている場合のアプリ固有のスコープの識別子。割り当てのスコープによって、プリンシパルにアクセス権が付与されているリソースのセットが決まります。アプリスコープは、このアプリケーションによってのみ定義および理解されるスコープです。テナント全体のアプリスコープに使用 `/` します。 directoryScopeId を使用して、スコープを特定のディレクトリオブジェクト (管理単位など) に制限します。 (`eq`、、`ne`、の値) を`null`サポートします`$filter`。
CompletedDateTime	DateTimeOffset	要求の完了日時。要求から継承されます。
createdBy	identitySet	この要求を作成したプリンシパル。要求から継承されます。読み取り専用です。 (`eq`、、`ne`、の値) を`null`サポートします`$filter`。
createdDateTime	DateTimeOffset	要求の作成日時。要求から継承されます。読み取り専用。
Customdata	String	要求のカスタムデータを定義するフリーテキストフィールド。不使用。要求から継承されます。
directoryScopeId	String	割り当てのスコープを表すディレクトリオブジェクトの識別子。割り当てのスコープによって、プリンシパルにアクセス権が付与されているリソースのセットが決まります。ディレクトリスコープは、複数のアプリケーションによって認識されるディレクトリに格納されている共有スコープです。テナント全体のスコープに使用 `/` します。 appScopeId を使用して、スコープをアプリケーションのみに制限します。 (`eq`、、`ne`、の値) を`null`サポートします`$filter`。
id	String	unifiedRoleAssignmentScheduleRequest オブジェクトの一意識別子。キー。null 許容ではなく、読み取り専用です。エンティティから継承されます。 `$filter` (`eq`、`ne`) をサポートします。
isValidationOnly	ブール型	呼び出しが検証呼び出しか実際の呼び出しかを決定します。アクティブ化が MFA などの追加ルールの対象であるかどうかを実際に要求を送信する前にチェックする場合にのみ、このプロパティを設定します。
正当化	String	unifiedRoleAssignmentScheduleRequest オブジェクトを作成するときに、ユーザーと管理者によって提供されるメッセージ。
principalId	String	割り当てが付与されているプリンシパルの識別子。ユーザー、ロール割り当て可能なグループ、またはサービスプリンシパルを指定できます。 `$filter` (`eq`、`ne`) をサポートします。
roleDefinitionId	String	プリンシパルに割り当てられている unifiedRoleDefinition オブジェクトの識別子。 `$filter` (`eq`、`ne`) をサポートします。
scheduleInfo	requestSchedule	ロールの割り当ての期間。定期的なスケジュールは現在サポートされていません。
status	String	ロールの割り当て要求の状態。要求から継承されます。読み取り専用です。 `$filter` (`eq`、`ne`) をサポートします。
targetScheduleId	String	割り当て要求にリンクされている schedule オブジェクトの識別子。 `$filter` (`eq`、`ne`) をサポートします。
ticketInfo	ticketInfo	チケット番号とチケットシステムの詳細を含む、ロール割り当て要求にリンクされたチケットの詳細。

リレーションシップ

リレーションシップ	型	説明
activatedUsing	unifiedRoleEligibilitySchedule	ロールをアクティブ化する資格のある管理者からの要求の場合、このパラメーターには、そのアクティブ化に関連する適格な割り当てが表示されます。それ以外の場合はです `null`。でを `$expand` サポートし、 `$select` 入れ子に `$expand`しています。
appScope	appScope	割り当てがアプリにスコープ設定されている場合に、アプリ固有のスコープの詳細を含む読み取り専用プロパティ。 Null 許容型です。 `$expand` をサポートします。
directoryScope	directoryObject	割り当てのスコープであるディレクトリオブジェクト。読み取り専用です。 `$expand` をサポートします。
プリンシパル	directoryObject	要求を通じてロールの割り当てを取得しているプリンシパル。 id 専用で `$expand` をサポートし`$select`、`$expand`入れ子にしています。
roleDefinition	unifiedRoleDefinition	roleDefinitionId プロパティを介して参照される unifiedRoleDefinition オブジェクトの詳細情報。でを `$expand` サポートし、 `$select` 入れ子に `$expand`しています。
targetSchedule	unifiedRoleAssignmentSchedule	targetScheduleId プロパティを介して参照される、適格なロールの割り当てのスケジュール。でを `$expand` サポートし、 `$select` 入れ子に `$expand`しています。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "@odata.type": "#microsoft.graph.unifiedRoleAssignmentScheduleRequest",
  "id": "String (identifier)",
  "status": "String",
  "completedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "approvalId": "String",
  "customData": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "action": "String",
  "principalId": "String",
  "roleDefinitionId": "String",
  "directoryScopeId": "String",
  "appScopeId": "String",
  "isValidationOnly": "Boolean",
  "targetScheduleId": "String",
  "justification": "String",
  "scheduleInfo": {
    "@odata.type": "microsoft.graph.requestSchedule"
  },
  "ticketInfo": {
    "@odata.type": "microsoft.graph.ticketInfo"
  }
}