Share via


AccessReviewScheduleDefinition interface

Access Review Schedule Definition.

Properties

assignmentState

The role assignment state eligible/active to review NOTE: This property will not be serialized. It can only be populated by the server.

autoApplyDecisionsEnabled

Flag to indicate whether auto-apply capability, to automatically change the target object access resource, is enabled. If not enabled, a user must, after the review completes, apply the access review.

backupReviewers

This is the collection of backup reviewers.

defaultDecision

This specifies the behavior for the autoReview feature when an access review completes.

defaultDecisionEnabled

Flag to indicate whether reviewers are required to provide a justification when reviewing access.

descriptionForAdmins

The description provided by the access review creator and visible to admins.

descriptionForReviewers

The description provided by the access review creator to be shown to reviewers.

displayName

The display name for the schedule definition.

endDate

The DateTime when the review is scheduled to end. Required if type is endDate

excludeResourceId

This is used to indicate the resource id(s) to exclude

excludeRoleDefinitionId

This is used to indicate the role definition id(s) to exclude

expandNestedMemberships

Flag to indicate whether to expand nested memberships or not.

id

The access review schedule definition id. NOTE: This property will not be serialized. It can only be populated by the server.

inactiveDuration

Duration users are inactive for. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations).This code can be used to convert TimeSpan to a valid interval string: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds))

includeAccessBelowResource

Flag to indicate whether to expand nested memberships or not.

includeInheritedAccess

Flag to indicate whether to expand nested memberships or not.

instanceDurationInDays

The duration in days for an instance.

instances

This is the collection of instances returned when one does an expand on it.

interval

The interval for recurrence. For a quarterly review, the interval is 3 for type : absoluteMonthly.

justificationRequiredOnApproval

Flag to indicate whether the reviewer is required to pass justification when recording a decision.

mailNotificationsEnabled

Flag to indicate whether sending mails to reviewers and the review creator is enabled.

name

The access review schedule definition unique id. NOTE: This property will not be serialized. It can only be populated by the server.

numberOfOccurrences

The number of times to repeat the access review. Required and must be positive if type is numbered.

principalId

The identity id NOTE: This property will not be serialized. It can only be populated by the server.

principalName

The identity display name NOTE: This property will not be serialized. It can only be populated by the server.

principalTypePropertiesCreatedByPrincipalType

The identity type : user/servicePrincipal NOTE: This property will not be serialized. It can only be populated by the server.

principalTypePropertiesScopePrincipalType

The identity type user/servicePrincipal to review NOTE: This property will not be serialized. It can only be populated by the server.

recommendationLookBackDuration

Recommendations for access reviews are calculated by looking back at 30 days of data(w.r.t the start date of the review) by default. However, in some scenarios, customers want to change how far back to look at and want to configure 60 days, 90 days, etc. instead. This setting allows customers to configure this duration. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations).This code can be used to convert TimeSpan to a valid interval string: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds))

recommendationsEnabled

Flag to indicate whether showing recommendations to reviewers is enabled.

reminderNotificationsEnabled

Flag to indicate whether sending reminder emails to reviewers are enabled.

resourceId

ResourceId in which this review is getting created NOTE: This property will not be serialized. It can only be populated by the server.

reviewers

This is the collection of reviewers.

reviewersType

This field specifies the type of reviewers for a review. Usually for a review, reviewers are explicitly assigned. However, in some cases, the reviewers may not be assigned and instead be chosen dynamically. For example managers review or self review. NOTE: This property will not be serialized. It can only be populated by the server.

roleDefinitionId

This is used to indicate the role being reviewed NOTE: This property will not be serialized. It can only be populated by the server.

startDate

The DateTime when the review is scheduled to be start. This could be a date in the future. Required on create.

status

This read-only field specifies the status of an accessReview. NOTE: This property will not be serialized. It can only be populated by the server.

type

The resource type. NOTE: This property will not be serialized. It can only be populated by the server.

typePropertiesSettingsRecurrencePatternType

The recurrence type : weekly, monthly, etc.

typePropertiesSettingsRecurrenceRangeType

The recurrence range type. The possible values are: endDate, noEnd, numbered.

userPrincipalName

The user principal name(if valid) NOTE: This property will not be serialized. It can only be populated by the server.

Property Details

assignmentState

The role assignment state eligible/active to review NOTE: This property will not be serialized. It can only be populated by the server.

assignmentState?: string

Property Value

string

autoApplyDecisionsEnabled

Flag to indicate whether auto-apply capability, to automatically change the target object access resource, is enabled. If not enabled, a user must, after the review completes, apply the access review.

autoApplyDecisionsEnabled?: boolean

Property Value

boolean

backupReviewers

This is the collection of backup reviewers.

backupReviewers?: AccessReviewReviewer[]

Property Value

defaultDecision

This specifies the behavior for the autoReview feature when an access review completes.

defaultDecision?: string

Property Value

string

defaultDecisionEnabled

Flag to indicate whether reviewers are required to provide a justification when reviewing access.

defaultDecisionEnabled?: boolean

Property Value

boolean

descriptionForAdmins

The description provided by the access review creator and visible to admins.

descriptionForAdmins?: string

Property Value

string

descriptionForReviewers

The description provided by the access review creator to be shown to reviewers.

descriptionForReviewers?: string

Property Value

string

displayName

The display name for the schedule definition.

displayName?: string

Property Value

string

endDate

The DateTime when the review is scheduled to end. Required if type is endDate

endDate?: Date

Property Value

Date

excludeResourceId

This is used to indicate the resource id(s) to exclude

excludeResourceId?: string

Property Value

string

excludeRoleDefinitionId

This is used to indicate the role definition id(s) to exclude

excludeRoleDefinitionId?: string

Property Value

string

expandNestedMemberships

Flag to indicate whether to expand nested memberships or not.

expandNestedMemberships?: boolean

Property Value

boolean

id

The access review schedule definition id. NOTE: This property will not be serialized. It can only be populated by the server.

id?: string

Property Value

string

inactiveDuration

Duration users are inactive for. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations).This code can be used to convert TimeSpan to a valid interval string: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds))

inactiveDuration?: string

Property Value

string

includeAccessBelowResource

Flag to indicate whether to expand nested memberships or not.

includeAccessBelowResource?: boolean

Property Value

boolean

includeInheritedAccess

Flag to indicate whether to expand nested memberships or not.

includeInheritedAccess?: boolean

Property Value

boolean

instanceDurationInDays

The duration in days for an instance.

instanceDurationInDays?: number

Property Value

number

instances

This is the collection of instances returned when one does an expand on it.

instances?: AccessReviewInstance[]

Property Value

interval

The interval for recurrence. For a quarterly review, the interval is 3 for type : absoluteMonthly.

interval?: number

Property Value

number

justificationRequiredOnApproval

Flag to indicate whether the reviewer is required to pass justification when recording a decision.

justificationRequiredOnApproval?: boolean

Property Value

boolean

mailNotificationsEnabled

Flag to indicate whether sending mails to reviewers and the review creator is enabled.

mailNotificationsEnabled?: boolean

Property Value

boolean

name

The access review schedule definition unique id. NOTE: This property will not be serialized. It can only be populated by the server.

name?: string

Property Value

string

numberOfOccurrences

The number of times to repeat the access review. Required and must be positive if type is numbered.

numberOfOccurrences?: number

Property Value

number

principalId

The identity id NOTE: This property will not be serialized. It can only be populated by the server.

principalId?: string

Property Value

string

principalName

The identity display name NOTE: This property will not be serialized. It can only be populated by the server.

principalName?: string

Property Value

string

principalTypePropertiesCreatedByPrincipalType

The identity type : user/servicePrincipal NOTE: This property will not be serialized. It can only be populated by the server.

principalTypePropertiesCreatedByPrincipalType?: string

Property Value

string

principalTypePropertiesScopePrincipalType

The identity type user/servicePrincipal to review NOTE: This property will not be serialized. It can only be populated by the server.

principalTypePropertiesScopePrincipalType?: string

Property Value

string

recommendationLookBackDuration

Recommendations for access reviews are calculated by looking back at 30 days of data(w.r.t the start date of the review) by default. However, in some scenarios, customers want to change how far back to look at and want to configure 60 days, 90 days, etc. instead. This setting allows customers to configure this duration. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations).This code can be used to convert TimeSpan to a valid interval string: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds))

recommendationLookBackDuration?: string

Property Value

string

recommendationsEnabled

Flag to indicate whether showing recommendations to reviewers is enabled.

recommendationsEnabled?: boolean

Property Value

boolean

reminderNotificationsEnabled

Flag to indicate whether sending reminder emails to reviewers are enabled.

reminderNotificationsEnabled?: boolean

Property Value

boolean

resourceId

ResourceId in which this review is getting created NOTE: This property will not be serialized. It can only be populated by the server.

resourceId?: string

Property Value

string

reviewers

This is the collection of reviewers.

reviewers?: AccessReviewReviewer[]

Property Value

reviewersType

This field specifies the type of reviewers for a review. Usually for a review, reviewers are explicitly assigned. However, in some cases, the reviewers may not be assigned and instead be chosen dynamically. For example managers review or self review. NOTE: This property will not be serialized. It can only be populated by the server.

reviewersType?: string

Property Value

string

roleDefinitionId

This is used to indicate the role being reviewed NOTE: This property will not be serialized. It can only be populated by the server.

roleDefinitionId?: string

Property Value

string

startDate

The DateTime when the review is scheduled to be start. This could be a date in the future. Required on create.

startDate?: Date

Property Value

Date

status

This read-only field specifies the status of an accessReview. NOTE: This property will not be serialized. It can only be populated by the server.

status?: string

Property Value

string

type

The resource type. NOTE: This property will not be serialized. It can only be populated by the server.

type?: string

Property Value

string

typePropertiesSettingsRecurrencePatternType

The recurrence type : weekly, monthly, etc.

typePropertiesSettingsRecurrencePatternType?: string

Property Value

string

typePropertiesSettingsRecurrenceRangeType

The recurrence range type. The possible values are: endDate, noEnd, numbered.

typePropertiesSettingsRecurrenceRangeType?: string

Property Value

string

userPrincipalName

The user principal name(if valid) NOTE: This property will not be serialized. It can only be populated by the server.

userPrincipalName?: string

Property Value

string