Access Review Schedule Definitions - List

Service:

Authorization

API Version:

2021-12-01-preview

액세스 검토 일정 정의 가져오기

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/accessReviewScheduleDefinitions?api-version=2021-12-01-preview

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/accessReviewScheduleDefinitions?api-version=2021-12-01-preview&$filter={$filter}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
subscriptionId	path	True	string	대상 구독의 ID입니다.
api-version	query	True	string	HTTP 요청과 함께 사용할 API 버전입니다.
$filter	query		string	작업에 적용할 필터입니다. 표준 필터 외에 하나의 사용자 지정 필터 옵션인 'assignedToMeToReview()'가 지원됩니다. 지정된 $filter=assignedToMeToReview()이면 검토할 호출 사용자에게 할당된 항목만 반환됩니다.

응답

Name	형식	Description
200 OK	AccessReviewScheduleDefinitionListResult	성공적인 작업의 결과를 설명합니다.
Other Status Codes	ErrorDefinition	예기치 않은 오류

보안

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	사용자 계정 가장

정의

Name	Description
AccessReviewActorIdentityType	ID 유형: user/servicePrincipal
AccessReviewInstance	액세스 검토 인스턴스.
AccessReviewInstanceReviewersType	이 필드는 검토에 대한 검토자의 유형을 지정합니다. 일반적으로 검토를 위해 검토자는 명시적으로 할당됩니다. 그러나 경우에 따라 검토자가 할당되지 않고 동적으로 선택될 수 있습니다. 예를 들어 관리자는 검토 또는 자체 검토를 참조하세요.
AccessReviewInstanceStatus	이 읽기 전용 필드는 액세스 검토 instance 상태 지정합니다.
AccessReviewRecurrencePatternType	되풀이 유형: 매주, 매월 등
AccessReviewRecurrenceRangeType	되풀이 범위 형식입니다. 가능한 값은 endDate, noEnd, numbered입니다.
AccessReviewReviewer	검토해야 하는 내용에 대한 설명자
AccessReviewReviewerType	ID 유형: user/servicePrincipal
AccessReviewScheduleDefinition	액세스 검토 일정 정의.
AccessReviewScheduleDefinitionListResult	액세스 검토 일정 정의 목록입니다.
AccessReviewScheduleDefinitionReviewersType	이 필드는 검토에 대한 검토자의 유형을 지정합니다. 일반적으로 검토를 위해 검토자는 명시적으로 할당됩니다. 그러나 경우에 따라 검토자가 할당되지 않고 동적으로 선택될 수 있습니다. 예를 들어 관리자는 검토 또는 자체 검토를 참조하세요.
AccessReviewScheduleDefinitionStatus	이 읽기 전용 필드는 accessReview의 상태 지정합니다.
AccessReviewScopeAssignmentState	검토할 적격/활성 역할 할당 상태
AccessReviewScopePrincipalType	검토할 ID 유형 user/servicePrincipal
DefaultDecisionType	액세스 검토가 완료되면 autoReview 기능에 대한 동작을 지정합니다.
ErrorDefinition	Error
ErrorDefinitionProperties	오류

AccessReviewActorIdentityType

ID 유형: user/servicePrincipal

Name	형식	Description
servicePrincipal	string
user	string

AccessReviewInstance

액세스 검토 인스턴스.

Name	형식	Description
id	string	액세스 검토 instance ID입니다.
name	string	액세스 검토 instance 이름입니다.
properties.backupReviewers	AccessReviewReviewer[]	백업 검토자의 컬렉션입니다.
properties.endDateTime	string	검토 instance 종료하도록 예약된 DateTime입니다.
properties.reviewers	AccessReviewReviewer[]	검토자의 컬렉션입니다.
properties.reviewersType	AccessReviewInstanceReviewersType	이 필드는 검토에 대한 검토자의 유형을 지정합니다. 일반적으로 검토를 위해 검토자는 명시적으로 할당됩니다. 그러나 경우에 따라 검토자가 할당되지 않고 동적으로 선택될 수 있습니다. 예를 들어 관리자는 검토 또는 자체 검토를 참조하세요.
properties.startDateTime	string	검토 instance 시작하도록 예약된 DateTime입니다.
properties.status	AccessReviewInstanceStatus	이 읽기 전용 필드는 액세스 검토 instance 상태 지정합니다.
type	string	리소스 종류입니다.

AccessReviewInstanceReviewersType

이 필드는 검토에 대한 검토자의 유형을 지정합니다. 일반적으로 검토를 위해 검토자는 명시적으로 할당됩니다. 그러나 경우에 따라 검토자가 할당되지 않고 동적으로 선택될 수 있습니다. 예를 들어 관리자는 검토 또는 자체 검토를 참조하세요.

Name	형식	Description
Assigned	string
Managers	string
Self	string

AccessReviewInstanceStatus

이 읽기 전용 필드는 액세스 검토 instance 상태 지정합니다.

Name	형식	Description
Applied	string
Applying	string
AutoReviewed	string
AutoReviewing	string
Completed	string
Completing	string
InProgress	string
Initializing	string
NotStarted	string
Scheduled	string
Starting	string

AccessReviewRecurrencePatternType

되풀이 유형: 매주, 매월 등

Name	형식	Description
absoluteMonthly	string
weekly	string

AccessReviewRecurrenceRangeType

되풀이 범위 형식입니다. 가능한 값은 endDate, noEnd, numbered입니다.

Name	형식	Description
endDate	string
noEnd	string
numbered	string

AccessReviewReviewer

검토해야 하는 내용에 대한 설명자

Name	형식	Description
principalId	string	검토자의 ID(user/servicePrincipal)
principalType	AccessReviewReviewerType	ID 유형: user/servicePrincipal

AccessReviewReviewerType

ID 유형: user/servicePrincipal

Name	형식	Description
servicePrincipal	string
user	string

AccessReviewScheduleDefinition

액세스 검토 일정 정의.

Name	형식	Description
id	string	액세스 검토 일정 정의 ID입니다.
name	string	액세스 검토 일정 정의 고유 ID입니다.
properties.backupReviewers	AccessReviewReviewer[]	백업 검토자의 컬렉션입니다.
properties.createdBy.principalId	string	ID ID
properties.createdBy.principalName	string	ID 표시 이름
properties.createdBy.principalType	AccessReviewActorIdentityType	ID 유형: user/servicePrincipal
properties.createdBy.userPrincipalName	string	사용자 계정 이름(유효한 경우)
properties.descriptionForAdmins	string	액세스 검토 작성자가 제공하고 관리자에게 표시되는 설명입니다.
properties.descriptionForReviewers	string	검토자에게 표시할 액세스 검토 작성자가 제공한 설명입니다.
properties.displayName	string	일정 정의의 표시 이름입니다.
properties.instances	AccessReviewInstance[]	확장할 때 반환되는 인스턴스의 컬렉션입니다.
properties.reviewers	AccessReviewReviewer[]	검토자의 컬렉션입니다.
properties.reviewersType	AccessReviewScheduleDefinitionReviewersType	이 필드는 검토에 대한 검토자의 유형을 지정합니다. 일반적으로 검토를 위해 검토자는 명시적으로 할당됩니다. 그러나 경우에 따라 검토자가 할당되지 않고 동적으로 선택될 수 있습니다. 예를 들어 관리자는 검토 또는 자체 검토를 참조하세요.
properties.scope.assignmentState	AccessReviewScopeAssignmentState	검토할 적격/활성 역할 할당 상태
properties.scope.excludeResourceId	string	제외할 리소스 ID를 나타내는 데 사용됩니다.
properties.scope.excludeRoleDefinitionId	string	제외할 역할 정의 ID를 나타내는 데 사용됩니다.
properties.scope.expandNestedMemberships	boolean	중첩 멤버 자격을 확장할지 여부를 나타내는 플래그입니다.
properties.scope.inactiveDuration	string	기간 사용자가 비활성 상태입니다. 값은 ISO 8601 형식(http://en.wikipedia.org/wiki/ISO_8601#Durations)이어야 합니다. 이 코드를 사용하여 TimeSpan을 유효한 간격 문자열인 XmlConvert.ToString(new TimeSpan(hours, minutes, seconds))으로 변환할 수 있습니다.
properties.scope.includeAccessBelowResource	boolean	중첩 멤버 자격을 확장할지 여부를 나타내는 플래그입니다.
properties.scope.includeInheritedAccess	boolean	중첩 멤버 자격을 확장할지 여부를 나타내는 플래그입니다.
properties.scope.principalType	AccessReviewScopePrincipalType	검토할 ID 유형 user/servicePrincipal
properties.scope.resourceId	string	이 검토를 만드는 ResourceId
properties.scope.roleDefinitionId	string	검토 중인 역할을 나타내는 데 사용됩니다.
properties.settings.autoApplyDecisionsEnabled	boolean	대상 개체 액세스 리소스를 자동으로 변경하는 자동 적용 기능을 사용할 수 있는지 여부를 나타내는 플래그입니다. 사용하도록 설정하지 않은 경우 사용자는 검토가 완료된 후 액세스 검토를 적용해야 합니다.
properties.settings.defaultDecision	DefaultDecisionType	액세스 검토가 완료되면 autoReview 기능에 대한 동작을 지정합니다.
properties.settings.defaultDecisionEnabled	boolean	액세스를 검토할 때 검토자가 근거를 제공해야 하는지 여부를 나타내는 플래그입니다.
properties.settings.instanceDurationInDays	integer	instance 기간(일)입니다.
properties.settings.justificationRequiredOnApproval	boolean	결정을 기록할 때 검토자가 근거를 전달해야 하는지 여부를 나타내는 플래그입니다.
properties.settings.mailNotificationsEnabled	boolean	검토자와 검토 작성자에게 메일을 보낼 수 있는지 여부를 나타내는 플래그입니다.
properties.settings.recommendationLookBackDuration	string	액세스 검토에 대한 권장 사항은 기본적으로 30일의 데이터(검토 시작 날짜 w.r.t)를 다시 확인하여 계산됩니다. 그러나 일부 시나리오에서 고객은 60일, 90일 등을 구성하는 방법을 변경하려고 합니다. 이 설정을 통해 고객은 이 기간을 구성할 수 있습니다. 값은 ISO 8601 형식(http://en.wikipedia.org/wiki/ISO_8601#Durations)이어야 합니다. 이 코드를 사용하여 TimeSpan을 유효한 간격 문자열인 XmlConvert.ToString(new TimeSpan(hours, minutes, seconds))으로 변환할 수 있습니다.
properties.settings.recommendationsEnabled	boolean	검토자에게 권장 사항을 표시할 수 있는지 여부를 나타내는 플래그입니다.
properties.settings.recurrence.pattern.interval	integer	되풀이 간격입니다. 분기별 검토의 경우 형식: absoluteMonthly에 대한 간격은 3입니다.
properties.settings.recurrence.pattern.type	AccessReviewRecurrencePatternType	되풀이 유형: 매주, 매월 등
properties.settings.recurrence.range.endDate	string	검토가 종료되도록 예약된 DateTime입니다. type이 endDate인 경우 필수
properties.settings.recurrence.range.numberOfOccurrences	integer	액세스 검토를 반복할 횟수입니다. 형식에 번호가 매겨진 경우 필수 및 는 양수여야 합니다.
properties.settings.recurrence.range.startDate	string	검토가 시작되도록 예약된 DateTime입니다. 이것은 미래의 날짜가 될 수 있습니다. 만들기에 필요합니다.
properties.settings.recurrence.range.type	AccessReviewRecurrenceRangeType	되풀이 범위 형식입니다. 가능한 값은 endDate, noEnd, numbered입니다.
properties.settings.reminderNotificationsEnabled	boolean	검토자에게 미리 알림 이메일을 보낼 수 있는지 여부를 나타내는 플래그입니다.
properties.status	AccessReviewScheduleDefinitionStatus	이 읽기 전용 필드는 accessReview의 상태 지정합니다.
type	string	리소스 종류입니다.

AccessReviewScheduleDefinitionListResult

액세스 검토 일정 정의 목록입니다.

Name	형식	Description
nextLink	string	다음 결과 집합을 가져오는 데 사용할 URL입니다.
value	AccessReviewScheduleDefinition[]	액세스 검토 일정 정의 목록.

AccessReviewScheduleDefinitionReviewersType

이 필드는 검토에 대한 검토자의 유형을 지정합니다. 일반적으로 검토를 위해 검토자는 명시적으로 할당됩니다. 그러나 경우에 따라 검토자가 할당되지 않고 동적으로 선택될 수 있습니다. 예를 들어 관리자는 검토 또는 자체 검토를 참조하세요.

Name	형식	Description
Assigned	string
Managers	string
Self	string

AccessReviewScheduleDefinitionStatus

이 읽기 전용 필드는 accessReview의 상태 지정합니다.

Name	형식	Description
Applied	string
Applying	string
AutoReviewed	string
AutoReviewing	string
Completed	string
Completing	string
InProgress	string
Initializing	string
NotStarted	string
Scheduled	string
Starting	string

AccessReviewScopeAssignmentState

검토할 적격/활성 역할 할당 상태

Name	형식	Description
active	string
eligible	string

AccessReviewScopePrincipalType

검토할 ID 유형 user/servicePrincipal

Name	형식	Description
guestUser	string
redeemedGuestUser	string
servicePrincipal	string
user	string
user,group	string

DefaultDecisionType

액세스 검토가 완료되면 autoReview 기능에 대한 동작을 지정합니다.

Name	형식	Description
Approve	string
Deny	string
Recommendation	string

ErrorDefinition

Error

Name	형식	Description
error	ErrorDefinitionProperties	Error 목록 게이트웨이 상태 오류입니다.

ErrorDefinitionProperties

오류

Name	형식	Description
code	string	목록 게이트웨이의 오류 코드입니다.
message	string	오류 설명입니다.