フィードバック 編集

accessReviewHistoryDefinition を取得する

  • [アーティクル]

名前空間: microsoft.graph

識別子を使用して accessReviewHistoryDefinition オブジェクトを取得します。 アクセス レビュー履歴定義オブジェクトのすべてのプロパティが返されます。 定義が 30 日以上の場合は、 404 Not Found エラーが返されます。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) AccessReview.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション AccessReview.ReadWrite.All

また、サインインしているユーザーは、関連付けられたレビュー履歴定義の作成者、グローバル管理者ディレクトリ ロール メンバー、または定義を取得するグローバル リーダー ディレクトリ ロール メンバーである必要があります。

HTTP 要求

GET /identityGovernance/accessReviews/historyDefinitions/{definition-id}

オプションのクエリ パラメーター

このメソッドは、応答のカスタマイズに $select 役立つ OData クエリ パラメーターと $expand OData クエリ パラメーターをサポートします。 含めると ?$expand=instances 、 accessReviewHistoryDefinition オブジェクトに関連付けられているインスタンスが応答オブジェクトに含まれます。 一般的な情報については、「OData クエリ パラメーター」を参照してください。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。必須。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと応答本文の accessReviewHistoryDefinition オブジェクトを返します。

例

要求

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.accessReviewHistoryDefinition",
  "id": "b2cb022f-b7e1-40f3-9854-c65a40861c38",
  "displayName": "Last quarter's group reviews April 2021",
  "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
  "reviewHistoryPeriodEndDateTime": "2021-04-05T00:00:00Z",
  "decisions": [
    "approve",
    "deny",
    "dontKnow",
    "notReviewed",
    "notNotified"
  ],
  "status": "done",
  "createdDateTime": "2021-04-14T00:22:48.9392594Z",
  "createdBy": {
    "id": "957f1027-c0ee-460d-9269-b8444459e0fe",
    "displayName": "MOD Administrator",
    "userPrincipalName": "admin@contoso.com"
  },
  "scopes": [
    {
      "@odata.type": "#microsoft.graph.accessReviewQueryScope",
      "queryType": "MicrosoftGraph",     
      "query": "/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, 'accessPackageAssignments')",
      "queryRoot": null
    },  
    {
      "@odata.type": "#microsoft.graph.accessReviewQueryScope",
      "queryType": "MicrosoftGraph",     
      "query": "/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, '/groups')",
      "queryRoot": null
    }
  ]
}