unifiedRoleEligibilityScheduleRequest リソースの種類

[アーティクル]
07/01/2022

名前空間: microsoft.graph

重要

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

PIM を介してプリンシパルに対するロールの適格性に対する要求を表します。ロールの適格性は、有効期限なしで、または有効期限が設定された一時的な資格なしで永続的に資格を得ることができます。要求から継承します。

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

メソッド

メソッド	戻り値の種類	説明
リスト unifiedRoleEligibilityScheduleRequests	unifiedRoleEligibilityScheduleRequest コレクション	unifiedRoleEligibilityScheduleRequest オブジェクトを使用して行われたプリンシパルに対するロールの適格性の要求を取得します。
unifiedRoleEligibilityScheduleRequest を作成する	unifiedRoleEligibilityScheduleRequest	unifiedRoleEligibilityScheduleRequest オブジェクトを使用してプリンシパルのロールの適格性を要求します。
unifiedRoleEligibilityScheduleRequest を取得する	unifiedRoleEligibilityScheduleRequest	unifiedRoleEligibilityScheduleRequest オブジェクトを介して行われたロール適格性要求の要求の詳細を読み取ります。
filterByCurrentUser	unifiedRoleEligibilityScheduleRequest コレクション	PIM で、特定のプリンシパルに対するロールの適格性に対する要求を取得します。プリンシパルは、unifiedRoleEligibilityScheduleRequest オブジェクトの作成者または承認者であるか、ロールの適格性のターゲットにすることができます。
取り消す	なし	状態が 30 日後にシステムによって自動的に削除される unifiedRoleEligibilityScheduleRequest オブジェクトを直ちに取り消します。`Granted`

プロパティ

プロパティ	型	説明
action	String	ロールの適格性要求に対する操作の種類を表します。値は次のいずれかです。 `AdminAssign`: 管理者がプリンシパルに適格なロールを割り当てる場合。 `AdminRemove`: 管理者がプリンシパルから適格なロールを削除する場合。 `AdminUpdate`: 管理者が既存のロールの資格を変更する場合。 `AdminExtend`: 管理者が期限切れのロールの資格を拡張する場合。 `AdminRenew`: 管理者が期限切れの資格を更新する場合。 `UserAdd`: ユーザーが対象の割り当てをアクティブ化するため。 `UserRemove`: ユーザーがアクティブな適格な割り当てを非アクティブ化する場合。 `UserExtend`: 期限切れの対象となる割り当ての延長を要求するユーザー。 `UserRenew`: 期限切れの対象となる割り当ての更新をユーザーが要求する場合。
approvalId	String	要求の承認の識別子。要求から継承されます。
appScopeId	String	ロールの適格性がアプリにスコープされている場合のアプリ固有のスコープの識別子。ロールの適格性のスコープによって、プリンシパルがアクセスできるリソースのセットが決まります。アプリスコープは、このアプリケーションによってのみ定義され、理解されるスコープです。テナント全体のアプリスコープに使用 `/` します。 directoryScopeId を使用して、スコープを特定のディレクトリオブジェクト (管理単位など) に制限します。 (`eq`値、および`ne`値に対して`null`) サポート`$filter`されます。
CompletedDateTime	DateTimeOffset	要求の完了日時。要求から継承されます。
createdBy	identitySet	この要求を作成したプリンシパル。要求から継承されます。
createdDateTime	DateTimeOffset	要求の作成日時。要求から継承されます。
Customdata	String	要求のカスタムデータを定義するフリーテキストフィールド。不使用。要求から継承されます。
directoryScopeId	String	ロールの適格性のスコープを表すディレクトリオブジェクトの識別子。ロールの適格性のスコープによって、プリンシパルにアクセスが許可されているリソースのセットが決まります。ディレクトリスコープは、複数のアプリケーションによって認識されるディレクトリに格納されている共有スコープです。テナント全体のスコープに使用 `/` します。 appScopeId を使用して、スコープをアプリケーションのみに制限します。 (`eq`値、および`ne`値に対して`null`) サポート`$filter`されます。
id	String	unifiedRoleEligibilityScheduleRequest オブジェクトの一意の識別子。キー(null 許容ではなく、読み取り専用)。エンティティから継承されます。
isValidationOnly	ブール型	呼び出しが検証か実際の呼び出しかを決定します。このプロパティは、実際に要求を送信する前に、アクティブ化が MFA などの追加規則の対象かどうかを確認する場合にのみ設定します。
正当化	String	ユーザーと管理者が unifiedRoleEligibilityScheduleRequest オブジェクトを作成するときに提供されるメッセージ。
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	チケット番号とチケットシステムの詳細を含む、ロールの適格性要求にリンクされたチケットの詳細。省略可能。

リレーションシップ

リレーションシップ	型	説明
appScope	appScope	ロールの適格性がアプリにスコープ指定されている場合に、アプリ固有のスコープの詳細を含む読み取り専用プロパティ。 Null 許容型。 `$expand` をサポートします。
directoryScope	directoryObject	ロールの適格性のスコープであるディレクトリオブジェクト。読み取り専用です。 `$expand` をサポートしています。
プリンシパル	directoryObject	要求を通じてロールの適格性を取得しているプリンシパル。 `$expand` をサポートします。
roleDefinition	unifiedRoleDefinition	roleDefinitionId プロパティを使用して参照される unifiedRoleDefinition オブジェクトの詳細情報。 `$expand` をサポートします。
targetSchedule	unifiedRoleEligibilitySchedule	targetScheduleId プロパティを介して参照されるロールの適格性のスケジュール。 `$expand` をサポートします。

JSON 表記

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

{
  "id": "String (identifier)",
  "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"
  }
}

unifiedRoleEligibilityScheduleRequest リソースの種類

メソッド

プロパティ

リレーションシップ

JSON 表記

フィードバック