承認待ちの accessReviewInstanceDecisionItems を一覧表示する (非推奨)
名前空間: microsoft.graph
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
注:
このメソッドは非推奨となり、2023 年 5 月 19 日にデータの返しを停止します。 これは filterByCurrentUser に置き換えられました。
呼び出し元ユーザーによる特定の accessReviewInstance 保留中の承認の accessReviewInstanceDecisionItem オブジェクトを取得します。 入れ子になったすべてのプロパティを含む、0 個以上の accessReviewInstanceDecisionItem オブジェクトの一覧が返されます。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
---|---|---|
委任 (職場または学校のアカウント) | AccessReview.Read.All | AccessReview.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
アプリケーション | サポートされていません。 | サポートされていません。 |
サインインしたユーザーには、その決定のインスタンスの accessReviewScheduleDefinition でレビュー担当者が割り当てられている決定のみが表示されます。
HTTP 要求
GET /me/pendingAccessReviewInstances/{instance-id}/decisions
オプションのクエリ パラメーター
このメソッドでは、応答の $skip
カスタマイズに役立つ OData クエリ パラメーターと $top
OData クエリ パラメーターがサポートされています。 一般的な情報については、「OData クエリ パラメーター」を参照してください。
この API の既定のページ サイズは 100 accessReviewInstanceDecisionItem オブジェクトです。 効率を向上させ、大きな結果セットによるタイムアウトを回避するには、 パラメーターと $top
クエリ パラメーターを使用して改ページ処理を$skip
適用します。 詳細については、アプリで Microsoft Graph データをページングするを参照してください。
要求ヘッダー
なし。
要求本文
要求本文を指定しないでください。
応答
成功した場合、このメソッドは応答コードと、応答本文の accessReviewInstanceDecisionItem オブジェクトの配列を返200 OK
します。
例
要求
次の例は、呼び出し元ユーザーの承認を保留しているアクセス レビューのインスタンスに関するすべての決定を取得する要求を示しています。
GET https://graph.microsoft.com/beta/me/pendingAccessReviewInstances/70a68410-67f3-4d4c-b946-6989e050be19/decisions?$top=100&$skip=0
応答
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.count": 2,
"value": [
{
"id": "654b34e7-b48f-4772-a2d4-08f1d0dd014c",
"accessReviewId": "70a68410-67f3-4d4c-b946-6989e050be19",
"reviewedDateTime": null,
"decision": "NotReviewed",
"justification": "",
"appliedDateTime": null,
"applyResult": "New",
"recommendation": "Approve",
"reviewedBy": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "",
"userPrincipalName": ""
},
"appliedBy": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "",
"userPrincipalName": ""
},
"target": {
"@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItemUserTarget",
"userId": "7eae986b-d425-48b2-adf2-3c777f6256f3",
"userDisplayName": "Adele Vance",
"userPrincipalName": "AdeleV@contoso.com"
}
},
{
"id": "0311dba4-c60c-412e-ac77-14e1da23daf1",
"accessReviewId": "70a68410-67f3-4d4c-b946-6989e050be19",
"reviewedDateTime": null,
"decision": "NotReviewed",
"justification": "",
"appliedDateTime": null,
"applyResult": "New",
"recommendation": "Approve",
"reviewedBy": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "",
"userPrincipalName": ""
},
"appliedBy": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "",
"userPrincipalName": ""
},
"target": {
"@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItemUserTarget",
"userId": "957f1027-c0ee-460d-9269-b8828e59e0fe",
"userDisplayName": "MOD Administrator",
"userPrincipalName": "admin@contoso.com"
}
}
]
}