Access Review Schedule Definitions - List

Mendapatkan definisi jadwal tinjauan akses

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

Parameter URI

Name In Required Type Description
subscriptionId
path True
  • string

ID langganan target.

api-version
query True
  • string

Versi API yang akan digunakan dengan permintaan HTTP.

$filter
query
  • string

Filter yang akan diterapkan pada operasi. Selain filter standar, satu opsi filter kustom didukung: 'assignedToMeToReview()'. Ketika yang ditentukan $filter=assignedToMeToReview(), hanya item yang ditetapkan untuk pengguna panggilan yang akan ditinjau yang dikembalikan

Respons

Name Type Description
200 OK

Menjelaskan hasil operasi yang berhasil.

Other Status Codes

Kesalahan tidak terduga

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

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

Scopes

Name Description
user_impersonation meniru akun pengguna Anda

Contoh

GetAccessReviews

Sample Request

GET https://management.azure.com/subscriptions/fa73e90b-5bf1-45fd-a182-35ce5fc0674d/providers/Microsoft.Authorization/accessReviewScheduleDefinitions?api-version=2021-07-01-preview

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/fa73e90b-5bf1-45fd-a182-35ce5fc0674d/providers/Microsoft.Authorization/accessReviewScheduleDefinitions/fa73e90b-5bf1-45fd-a182-35ce5fc0674d",
      "type": "Microsoft.Authorization/accessReviewScheduleDefinitions",
      "name": "fa73e90b-5bf1-45fd-a182-35ce5fc0674d",
      "properties": {
        "displayName": "Hello world",
        "status": "InProgress",
        "descriptionForAdmins": "asdfasdf",
        "descriptionForReviewers": "asdfasdf",
        "createdBy": {
          "principalType": "user",
          "principalId": "a6c7aecb-cbfd-4763-87ef-e91b4bd509d9",
          "principalName": "Shubham Gupta",
          "userPrincipalName": "shugup@microsoft.com"
        },
        "scope": {
          "resourceId": "/subscriptions/fa73e90b-5bf1-45fd-a182-35ce5fc0674d",
          "roleDefinitionId": "/subscriptions/fa73e90b-5bf1-45fd-a182-35ce5fc0674d/providers/Microsoft.Authorization/roleDefinitions/b225c7ff-4338-4cdc-a790-6b34d987f7cd"
        },
        "reviewers": [
          {
            "principalId": "fa73e90b-5bf1-45fd-a182-35ce5fc0674d ",
            "principalType": "user"
          }
        ],
        "reviewersType": "Assigned",
        "settings": {
          "mailNotificationsEnabled": true,
          "reminderNotificationsEnabled": true,
          "justificationRequiredOnApproval": true,
          "recommendationsEnabled": true,
          "instanceDurationInDays": 30,
          "recurrence": {
            "range": {
              "type": "endDate",
              "numberOfOccurrences": 1,
              "startDate": "2018-08-03T21:02:30.667Z",
              "endDate": "2018-08-03T21:17:30.513Z"
            }
          },
          "defaultDecisionEnabled": true,
          "defaultDecision": "Approve",
          "autoApplyDecisionsEnabled": true
        }
      }
    }
  ]
}

Definisi

AccessReviewActorIdentityType

Jenis identitas : user/servicePrincipal

AccessReviewInstance

Instans Tinjauan Akses.

AccessReviewInstanceReviewersType

Bidang ini menentukan jenis peninjau untuk ditinjau. Biasanya untuk peninjauan, peninjau secara eksplisit ditetapkan. Namun, dalam beberapa kasus, peninjau mungkin tidak ditetapkan dan sebaliknya dipilih secara dinamis. Misalnya manajer meninjau atau meninjau sendiri.

AccessReviewInstanceStatus

Bidang baca-saja ini menentukan status instans tinjauan akses.

AccessReviewRecurrencePatternType

Jenis pengulangan : mingguan, bulanan, dll.

AccessReviewRecurrenceRangeType

Jenis rentang pengulangan. Nilai yang mungkin adalah: endDate, noEnd, numbered.

AccessReviewReviewer

Deskriptor untuk apa yang perlu ditinjau

AccessReviewReviewerType

Jenis identitas : user/servicePrincipal

AccessReviewScheduleDefinition

Definisi Jadwal Tinjauan Akses.

AccessReviewScheduleDefinitionListResult

Daftar Definisi Jadwal Tinjauan Akses.

AccessReviewScheduleDefinitionReviewersType

Bidang ini menentukan jenis peninjau untuk ditinjau. Biasanya untuk peninjauan, peninjau secara eksplisit ditetapkan. Namun, dalam beberapa kasus, peninjau mungkin tidak ditetapkan dan sebaliknya dipilih secara dinamis. Misalnya manajer meninjau atau meninjau sendiri.

AccessReviewScheduleDefinitionStatus

Bidang baca-saja ini menentukan status accessReview.

AccessReviewScopeAssignmentState

Status penetapan peran memenuhi syarat/aktif untuk ditinjau

AccessReviewScopePrincipalType

Jenis identitas pengguna/servicePrincipal untuk ditinjau

DefaultDecisionType

Ini menentukan perilaku untuk fitur autoReview saat tinjauan akses selesai.

ErrorDefinition

Kesalahan

ErrorDefinitionProperties

Kesalahan

AccessReviewActorIdentityType

Jenis identitas : user/servicePrincipal

Name Type Description
servicePrincipal
  • string
user
  • string

AccessReviewInstance

Instans Tinjauan Akses.

Name Type Description
id
  • string

Id instans tinjauan akses.

name
  • string

Nama instans tinjauan akses.

properties.backupReviewers

Ini adalah kumpulan peninjau cadangan.

properties.endDateTime
  • string

DateTime saat instans peninjauan dijadwalkan berakhir.

properties.reviewers

Ini adalah kumpulan peninjau.

properties.reviewersType

Bidang ini menentukan jenis peninjau untuk ditinjau. Biasanya untuk peninjauan, peninjau secara eksplisit ditetapkan. Namun, dalam beberapa kasus, peninjau mungkin tidak ditetapkan dan sebaliknya dipilih secara dinamis. Misalnya manajer meninjau atau meninjau sendiri.

properties.startDateTime
  • string

DateTime saat instans peninjauan dijadwalkan untuk dimulai.

properties.status

Bidang baca-saja ini menentukan status instans tinjauan akses.

type
  • string

Jenis sumber daya.

AccessReviewInstanceReviewersType

Bidang ini menentukan jenis peninjau untuk ditinjau. Biasanya untuk peninjauan, peninjau secara eksplisit ditetapkan. Namun, dalam beberapa kasus, peninjau mungkin tidak ditetapkan dan sebaliknya dipilih secara dinamis. Misalnya manajer meninjau atau meninjau sendiri.

Name Type Description
Assigned
  • string
Managers
  • string
Self
  • string

AccessReviewInstanceStatus

Bidang baca-saja ini menentukan status instans tinjauan akses.

Name Type Description
Applied
  • string
Applying
  • string
AutoReviewed
  • string
AutoReviewing
  • string
Completed
  • string
Completing
  • string
InProgress
  • string
Initializing
  • string
NotStarted
  • string
Scheduled
  • string
Starting
  • string

AccessReviewRecurrencePatternType

Jenis pengulangan : mingguan, bulanan, dll.

Name Type Description
absoluteMonthly
  • string
weekly
  • string

AccessReviewRecurrenceRangeType

Jenis rentang pengulangan. Nilai yang mungkin adalah: endDate, noEnd, numbered.

Name Type Description
endDate
  • string
noEnd
  • string
numbered
  • string

AccessReviewReviewer

Deskriptor untuk apa yang perlu ditinjau

Name Type Description
principalId
  • string

Id peninjau (user/servicePrincipal)

principalType

Jenis identitas : user/servicePrincipal

AccessReviewReviewerType

Jenis identitas : user/servicePrincipal

Name Type Description
servicePrincipal
  • string
user
  • string

AccessReviewScheduleDefinition

Definisi Jadwal Tinjauan Akses.

Name Type Description
id
  • string

Id definisi jadwal tinjauan akses.

name
  • string

Id unik definisi jadwal tinjauan akses.

properties.backupReviewers

Ini adalah kumpulan peninjau cadangan.

properties.createdBy.principalId
  • string

Id identitas

properties.createdBy.principalName
  • string

Nama tampilan identitas

properties.createdBy.principalType

Jenis identitas : user/servicePrincipal

properties.createdBy.userPrincipalName
  • string

Nama prinsipal pengguna(jika valid)

properties.descriptionForAdmins
  • string

Deskripsi yang disediakan oleh pembuat tinjauan akses dan terlihat oleh admin.

properties.descriptionForReviewers
  • string

Deskripsi yang diberikan oleh pembuat tinjauan akses untuk ditampilkan kepada peninjau.

properties.displayName
  • string

Nama tampilan untuk definisi jadwal.

properties.instances

Ini adalah kumpulan instans yang dikembalikan ketika seseorang melakukan perluasan di atasnya.

properties.reviewers

Ini adalah kumpulan peninjau.

properties.reviewersType

Bidang ini menentukan jenis peninjau untuk ditinjau. Biasanya untuk peninjauan, peninjau secara eksplisit ditetapkan. Namun, dalam beberapa kasus, peninjau mungkin tidak ditetapkan dan sebaliknya dipilih secara dinamis. Misalnya manajer meninjau atau meninjau sendiri.

properties.scope.assignmentState

Status penetapan peran memenuhi syarat/aktif untuk ditinjau

properties.scope.expandNestedMemberships
  • boolean

Bendera untuk menunjukkan apakah akan memperluas keanggotaan berlapis atau tidak.

properties.scope.inactiveDuration
  • string

Durasi pengguna tidak aktif untuk. Nilai harus dalam format ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). Kode ini dapat digunakan untuk mengonversi TimeSpan ke string interval yang valid: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds))

properties.scope.principalType

Jenis identitas pengguna/servicePrincipal untuk ditinjau

properties.scope.resourceId
  • string

ResourceId tempat tinjauan ini dibuat

properties.scope.roleDefinitionId
  • string

Ini digunakan untuk menunjukkan peran yang sedang ditinjau

properties.settings.autoApplyDecisionsEnabled
  • boolean

Bendera untuk menunjukkan apakah kemampuan penerapan otomatis, untuk secara otomatis mengubah sumber daya akses objek target, diaktifkan. Jika tidak diaktifkan, pengguna harus, setelah peninjauan selesai, terapkan tinjauan akses.

properties.settings.defaultDecision

Ini menentukan perilaku untuk fitur autoReview saat tinjauan akses selesai.

properties.settings.defaultDecisionEnabled
  • boolean

Bendera untuk menunjukkan apakah peninjau diperlukan untuk memberikan pembenaran saat meninjau akses.

properties.settings.instanceDurationInDays
  • integer

Durasi dalam hari untuk instans.

properties.settings.justificationRequiredOnApproval
  • boolean

Bendera untuk menunjukkan apakah peninjau diperlukan untuk meneruskan pembenaran saat merekam keputusan.

properties.settings.mailNotificationsEnabled
  • boolean

Bendera untuk menunjukkan apakah mengirim email ke peninjau dan pembuat tinjauan diaktifkan.

properties.settings.recommendationLookBackDuration
  • string

Rekomendasi untuk tinjauan akses dihitung dengan melihat kembali data 30 hari (w.r.t tanggal mulai tinjauan) secara default. Namun, dalam beberapa skenario, pelanggan ingin mengubah seberapa jauh ke belakang untuk melihat dan ingin mengonfigurasi 60 hari, 90 hari, dll sebagai gantinya. Pengaturan ini memungkinkan pelanggan untuk mengonfigurasi durasi ini. Nilai harus dalam format ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). Kode ini dapat digunakan untuk mengonversi TimeSpan ke string interval yang valid: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds))

properties.settings.recommendationsEnabled
  • boolean

Bendera untuk menunjukkan apakah menampilkan rekomendasi kepada peninjau diaktifkan.

properties.settings.recurrence.pattern.interval
  • integer

Interval untuk pengulangan. Untuk tinjauan triwulanan, intervalnya adalah 3 untuk jenis : absoluteMonthly.

properties.settings.recurrence.pattern.type

Jenis pengulangan : mingguan, bulanan, dll.

properties.settings.recurrence.range.endDate
  • string

DateTime saat peninjauan dijadwalkan berakhir. Diperlukan jika jenis endDate

properties.settings.recurrence.range.numberOfOccurrences
  • integer

Berapa kali mengulangi tinjauan akses. Diperlukan dan harus positif jika jenis diberi nomor.

properties.settings.recurrence.range.startDate
  • string

DateTime saat peninjauan dijadwalkan dimulai. Ini bisa menjadi tanggal di masa depan. Diperlukan untuk membuat.

properties.settings.recurrence.range.type

Jenis rentang pengulangan. Nilai yang mungkin adalah: endDate, noEnd, numbered.

properties.settings.reminderNotificationsEnabled
  • boolean

Bendera untuk menunjukkan apakah mengirim email pengingat ke peninjau diaktifkan.

properties.status

Bidang baca-saja ini menentukan status accessReview.

type
  • string

Jenis sumber daya.

AccessReviewScheduleDefinitionListResult

Daftar Definisi Jadwal Tinjauan Akses.

Name Type Description
nextLink
  • string

URL yang digunakan untuk mendapatkan serangkaian hasil berikutnya.

value

Daftar Definisi Jadwal Tinjauan Akses.

AccessReviewScheduleDefinitionReviewersType

Bidang ini menentukan jenis peninjau untuk ditinjau. Biasanya untuk peninjauan, peninjau secara eksplisit ditetapkan. Namun, dalam beberapa kasus, peninjau mungkin tidak ditetapkan dan sebaliknya dipilih secara dinamis. Misalnya manajer meninjau atau meninjau sendiri.

Name Type Description
Assigned
  • string
Managers
  • string
Self
  • string

AccessReviewScheduleDefinitionStatus

Bidang baca-saja ini menentukan status accessReview.

Name Type Description
Applied
  • string
Applying
  • string
AutoReviewed
  • string
AutoReviewing
  • string
Completed
  • string
Completing
  • string
InProgress
  • string
Initializing
  • string
NotStarted
  • string
Scheduled
  • string
Starting
  • string

AccessReviewScopeAssignmentState

Status penetapan peran memenuhi syarat/aktif untuk ditinjau

Name Type Description
active
  • string
eligible
  • string

AccessReviewScopePrincipalType

Jenis identitas pengguna/servicePrincipal untuk ditinjau

Name Type Description
guestUser
  • string
redeemedGuestUser
  • string
servicePrincipal
  • string
user
  • string
user,group
  • string

DefaultDecisionType

Ini menentukan perilaku untuk fitur autoReview saat tinjauan akses selesai.

Name Type Description
Approve
  • string
Deny
  • string
Recommendation
  • string

ErrorDefinition

Kesalahan

Name Type Description
error

Kesalahan
Kesalahan status gateway daftar.

ErrorDefinitionProperties

Kesalahan

Name Type Description
code
  • string

Kode kesalahan gateway daftar.

message
  • string

Deskripsi kesalahan.