accessPackageAssignmentPolicy リソースの種類

[アーティクル]
08/11/2023

名前空間: microsoft.graph

Microsoft Entraエンタイトルメント管理では、アクセスパッケージ割り当てポリシーは、サブジェクトがアクセスパッケージの割り当てを介してアクセスパッケージを要求または割り当てることができるポリシーを指定します。アクセスパッケージには、0 個以上のポリシーを含めることができます。サブジェクトからの要求を受信すると、サブジェクトが各ポリシーと照合され、そのサブジェクトを含む requestorSettings を持つポリシー (存在する場合) が見つかります。次に、要求に承認が必要かどうか、アクセスパッケージの割り当ての期間、割り当てに定期的なレビューが必要かどうかを決定します。

アクセスパッケージにユーザーを割り当てるには、アクセスパッケージとアクセスパッケージ割り当てポリシーを参照する accessPackageAssignmentRequest を作成します。

メソッド

メソッド	戻り値の種類	説明
accessPackageAssignmentPolicies の一覧表示	accessPackageAssignmentPolicy コレクション	accessPackageAssignmentPolicy オブジェクトとそのプロパティの一覧を取得します。
accessPackageAssignmentPolicy を作成する	accessPackageAssignmentPolicy	新しい accessPackageAssignmentPolicy オブジェクトを作成します。
accessPackageAssignmentPolicy を取得する	accessPackageAssignmentPolicy	accessPackageAssignmentPolicy オブジェクトのプロパティとリレーションシップを読み取ります。
accessPackageAssignmentPolicy を更新する	accessPackageAssignmentPolicy	accessPackageAssignmentPolicy オブジェクトのプロパティを更新します。
accessPackageAssignmentPolicy を削除する	なし	accessPackageAssignmentPolicy オブジェクトを削除します。

プロパティ

プロパティ	型	説明
allowedTargetScope	allowedTargetScope	このポリシーを使用してアクセスパッケージを割り当てることができるプリンシパル。使用可能な値: `notSpecified`、`specificDirectoryUsers`、`specificConnectedOrganizationUsers`、`specificDirectoryServicePrincipals`、`allMemberUsers`、`allDirectoryUsers`、`allDirectoryServicePrincipals`、`allConfiguredConnectedOrganizationUsers`、`allExternalUsers`、`unknownFutureValue`。
automaticRequestSettings	accessPackageAutomaticRequestSettings	このプロパティは、自動割り当てポリシーにのみ存在します。存在しない場合、これは要求ベースのポリシーです。
createdDateTime	DateTimeOffset	Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。
説明	String	ポリシーの説明。
displayName	String	ポリシーの表示名。
有効期限	expirationPattern	このポリシーで作成された割り当ての有効期限。
id	String	読み取り専用です。
modifiedDateTime	DateTimeOffset	Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。
requestApprovalSettings	accessPackageAssignmentApprovalSettings	このポリシーを使用して、アクセスパッケージの割り当てに対する要求の承認の設定を指定します。たとえば、新しい要求に承認が必要な場合です。
requestorSettings	accessPackageAssignmentRequestorSettings	このポリシーを使用してアクセスパッケージの割り当ての要求を作成できるユーザーと、要求に含めることができるものを選択するための追加の設定を提供します。
reviewSettings	accessPackageAssignmentReviewSettings	このポリシーを使用した割り当てのアクセスレビューの設定。
specificAllowedTargets	subjectSet コレクション	このポリシーを使用してアクセスパッケージからのアクセスを割り当てることができるプリンシパル。

リレーションシップ

リレーションシップ	型	説明
accessPackage	accessPackage	このポリシーを含むアクセスパッケージ。読み取り専用です。 `$expand` をサポートします。
カタログ	accessPackageCatalog	このポリシーを含むアクセスパッケージのカタログ。読み取り専用。
質問	accessPackageQuestion コレクション	要求者に送信される質問。
customExtensionStageSettings	customExtensionStageSetting コレクション	1 つ以上のカスタムアクセスパッケージワークフロー拡張機能を実行するステージのコレクション。 `$expand` をサポートします。

JSON 表記

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

{
  "@odata.type": "#microsoft.graph.accessPackageAssignmentPolicy",
  "allowedTargetScope": "String",
  "automaticRequestSettings": {
    "@odata.type": "microsoft.graph.accessPackageAutomaticRequestSettings"
  },
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "expiration": {
    "@odata.type": "microsoft.graph.expirationPattern"
  },
  "id": "String (identifier)",
  "modifiedDateTime": "String (timestamp)",
  "requestorSettings": {
    "@odata.type": "microsoft.graph.accessPackageAssignmentRequestorSettings"
  },
  "questions": [
    {
      "@odata.type": "microsoft.graph.accessPackageQuestion"
    }
  ],
  "requestApprovalSettings": {
    "@odata.type": "microsoft.graph.accessPackageAssignmentApprovalSettings"
  },
  "reviewSettings": {
    "@odata.type": "microsoft.graph.accessPackageAssignmentReviewSettings"
  },
  "specificAllowedTargets": [
    {
      "@odata.type": "microsoft.graph.singleUser"
    }
  ]
 
}