名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Entra Entitlement Management では、アクセス パッケージの割り当て要求は、アクセス パッケージの割り当てを取得するユーザーまたはそのユーザーに代わって作成されます。 要求が成功し、必要な承認が完了すると、ユーザーはアクセス パッケージの割り当てを受け取り、その結果として得られるアクセス パッケージの割り当ての主体になります。 Microsoft Entra ID では、アクセスの削除を追跡するために、アクセス パッケージの割り当て要求も自動的に作成されます。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List | accessPackageAssignmentRequest コレクション | accesspackageassignmentrequest オブジェクトのリストを取得します。 |
| Create | accessPackageAssignmentRequest | 新しい accessPackageAssignmentRequest を作成します。 |
| Get | accessPackageAssignmentRequest | accessPackageAssignmentRequest オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Delete | なし | accessPackageAssignmentRequest を削除します。 |
| Cancel | accessPackageAssignmentRequest コレクション | キャンセル可能な状態の accessPackageAssignmentRequest オブジェクトを取り消します。 |
| 現在のユーザーでフィルター処理する | accessPackageAssignmentRequest コレクション | サインインしたユーザーでフィルター処理された accessPackageAssignmentRequest オブジェクトのリストを取得します。 |
| 再処理 | なし | アクセス パッケージへのアクセスに対するユーザーの要求を自動的に再試行します。 |
| Resume | なし | カスタム拡張機能からのコールバックを待機した後、ユーザーのアクセス パッケージ要求を再開します。 |
| 一覧 (非推奨) | accessPackageAssignmentRequest コレクション | accesspackageassignmentrequest オブジェクトのリストを取得します。 この API はまもなく廃止されます。 代わりに List assignmentRequests API を使用してください。 |
| 作成 (非推奨) | accessPackageAssignmentRequest | 新しい accessPackageAssignmentRequest を作成します。 この API はまもなく廃止されます。 代わりに Create accessPackageAssignmentRequest API を使用してください。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| 回答 | accessPackageAnswer コレクション | リクエスト時に質問された accessPackageQuestions に対してリクエスト者によって提供された回答。 |
| completedDate | DateTimeOffset | 要求の処理が成功または失敗して終了した日付。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。 |
| createdDateTime | DateTimeOffset | Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。 |
| customExtensionCalloutInstances | customExtensionCalloutInstance コレクション | アクセス パッケージの割り当て要求ワークフロー中に行われたすべてのカスタム内線番号呼び出しに関する情報。 |
| customExtensionHandlerInstances | customExtensionHandlerInstance コレクション | 割り当て要求で実行されている カスタム ワークフロー拡張機能 インスタンスのコレクション。 読み取り専用です。 |
| expirationDateTime | DateTimeOffset | Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| id | String | 読み取り専用です。 |
| isValidationOnly | ブール型 | 要求が割り当てのために処理されない場合は true。 |
| 正当な理由 | 文字列 | 要求元が指定した正当な理由。 |
| parameters | accessPackageAssignmentRequestParameters | アクセス パッケージ ポリシーで構成されている承認要件をバイパスするなど、要求の処理方法を制御する追加のパラメーター。 |
| requestState | 文字列 |
PendingApproval、Canceled、Denied、Delivering、Delivered、PartiallyDelivered、DeliveryFailed、Submitted、Scheduled のいずれかです。 読み取り専用です。 |
| requestStatus | 文字列 | 要求の処理状態に関する詳細情報。 読み取り専用です。 |
| requestType | 文字列 |
UserAdd、UserExtend、UserUpdate、UserRemove、AdminAdd、AdminRemove、ApproverRemove、SystemRemove のいずれかです。 ユーザーからの要求の requestType が UserAdd、 UserUpdate、または UserRemove を持っている。 読み取り専用です。 |
| schedule | requestSchedule | アクセスが要求者に割り当てられる日付の範囲。 読み取り専用です。 |
| verifiedCredentialsData | verifiedCredentialData collection | 発行者や要求など、要求元が提示した検証可能な資格情報の詳細。 読み取り専用です。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| accessPackage | accessPackage | accessPackageAssignmentRequest に関連付けられているアクセス パッケージ。 アクセス パッケージは、リソース ロールのコレクションと、1 人以上のユーザーがそれらのリソースにアクセスする方法に関するポリシーを定義します。 読み取り専用です。 Null 許容型。
$expand をサポートします。 |
| accessPackageAssignment | accessPackageAssignment | requestType が UserAdd または AdminAdd の場合、アクセス パッケージの割り当ての作成が要求されました。 requestType が UserRemove、AdminRemove、ApproverRemove、または SystemRemove の場合、このプロパティには削除される既存の割り当てのid プロパティがあります。
$expand をサポートします。 |
| 要求元 | accessPackageSubject | 要求したサブジェクト、または直接割り当てられたサブジェクト。 読み取り専用です。 Null 許容型。
$expand をサポートします。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.accessPackageAssignmentRequest",
"id": "String (identifier)",
"requestType": "String",
"requestState": "String",
"requestStatus": "String",
"isValidationOnly": "Boolean",
"createdDateTime": "String (timestamp)",
"completedDate": "String (timestamp)",
"expirationDateTime": "String (timestamp)",
"justification": "String",
"parameters": {"@odata.type": "microsoft.graph.accessPackageAssignmentRequestParameters"},
"schedule": {
"@odata.type": "microsoft.graph.requestSchedule"
},
"answers": [
{
"@odata.type": "microsoft.graph.accessPackageAnswerString"
}
],
"customExtensionHandlerInstances": [
{
"@odata.type": "microsoft.graph.customExtensionHandlerInstance"
}
],
"customExtensionCalloutInstances": [
{
"@odata.type": "microsoft.graph.customExtensionCalloutInstance"
}
],
"verifiedCredentialsData": [
{
"@odata.type": "microsoft.graph.verifiedCredentialData"
}
]
}