Skip to main content

access_review_history_definition_instances

Creates, updates, deletes, gets or lists an access_review_history_definition_instances resource.

Overview

Nameaccess_review_history_definition_instances
TypeResource
Idazure.authorization.access_review_history_definition_instances

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe access review history definition instance id.
namestringThe access review history definition instance unique id.
displayNamestringThe display name for the parent history definition.
downloadUristringUri which can be used to retrieve review history data. To generate this Uri, generateDownloadUri() must be called for a specific accessReviewHistoryDefinitionInstance. The link expires after a 24 hour period. Callers can see the expiration date time by looking at the 'se' parameter in the generated uri.
expirationstring (date-time)Date time when history data report expires and the associated data is deleted.
fulfilledDateTimestring (date-time)Date time when the history data report is scheduled to be generated.
reviewHistoryPeriodEndDateTimestring (date-time)Date time used when selecting review data, all reviews included in data end on or before this date. For use only with one-time/non-recurring reports.
reviewHistoryPeriodStartDateTimestring (date-time)Date time used when selecting review data, all reviews included in data start on or after this date. For use only with one-time/non-recurring reports.
runDateTimestring (date-time)Date time when the history data report is scheduled to be generated.
statusstringStatus of the requested review history instance data. This is either requested, in-progress, done or error. The state transitions are as follows - Requested -> InProgress -> Done -> Expired. Known values are: "Requested", "InProgress", "Done", and "Error". (Requested, InProgress, Done, Error)
typestringThe resource type.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselecthistory_definition_id, subscription_idGet access review history definition instances by definition Id.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
history_definition_idstringThe id of the access review history definition. Required.
subscription_idstring

SELECT examples

Get access review history definition instances by definition Id.

SELECT
id,
name,
displayName,
downloadUri,
expiration,
fulfilledDateTime,
reviewHistoryPeriodEndDateTime,
reviewHistoryPeriodStartDateTime,
runDateTime,
status,
type
FROM azure.authorization.access_review_history_definition_instances
WHERE history_definition_id = '{{ history_definition_id }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;