Governance Assignments - Get
Mendapatkan governanceAssignment tertentu untuk cakupan yang diminta oleh AssignmentKey
GET https://management.azure.com/{scope}/providers/Microsoft.Security/assessments/{assessmentName}/governanceAssignments/{assignmentKey}?api-version=2022-01-01-preview
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
assessment
|
path | True |
string pattern: ^[-\w\._\(\)]+$ |
Kunci penilaian penugasan tata kelola. |
|
assignment
|
path | True |
string |
Kunci penugasan tata kelola. |
|
scope
|
path | True |
string |
Ruang lingkup penugasan tata kelola. |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang akan digunakan untuk operasi ini. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Operasi Azure berhasil diselesaikan. |
|
| Other Status Codes |
Respons kesalahan tak terduga. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
| Nama | Deskripsi |
|---|---|
| user_impersonation | meniru akun pengguna Anda |
Contoh
Get governanceAssignment by specific governanceAssignmentKey
Permintaan sampel
GET https://management.azure.com/subscriptions/c32e05d9-7207-4e22-bdf4-4f7d9c72e5fd/resourceGroups/compute_servers/providers/Microsoft.Compute/virtualMachines/win2012/providers/Microsoft.Security/assessments/6b9421dd-5555-2251-9b3d-2be58e2f82cd/governanceAssignments/6634ff9f-127b-4bf2-8e6e-b1737f5e789c?api-version=2022-01-01-preview
Respon sampel
{
"name": "6634ff9f-127b-4bf2-8e6e-b1737f5e789c",
"type": "Microsoft.Security/assessments/governanceAssignments",
"id": "/subscriptions/c32e05d9-7207-4e22-bdf4-4f7d9c72e5fd/resourceGroups/compute_servers/providers/Microsoft.Compute/virtualMachines/win2012/providers/Microsoft.Security/assessments/6b9421dd-5555-2251-9b3d-2be58e2f82cd/governanceAssignments/6634ff9f-127b-4bf2-8e6e-b1737f5e789c",
"properties": {
"additionalData": {
"ticketLink": "https://snow.com",
"ticketNumber": 123123,
"ticketStatus": "Active"
},
"governanceEmailNotification": {
"disableManagerEmailNotification": false,
"disableOwnerEmailNotification": false
},
"isGracePeriod": true,
"owner": "user@contoso.com",
"remediationDueDate": "2022-01-07T13:00:00.0000000Z",
"remediationEta": {
"eta": "2022-01-08T13:00:00.0000000Z",
"justification": "Justification of ETA"
}
}
}
Definisi
| Nama | Deskripsi |
|---|---|
|
Common. |
Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.). |
|
Common. |
Detail kesalahan. |
|
created |
Jenis identitas yang membuat sumber daya. |
|
Error |
Info tambahan kesalahan manajemen sumber daya. |
|
Governance |
Penetapan tata kelola atas cakupan tertentu |
|
Governance |
Menjelaskan data tambahan penetapan tata kelola - opsional |
|
Governance |
Konfigurasi pemberitahuan mingguan email tata kelola. |
|
Remediation |
ETA (perkiraan waktu kedatangan) untuk remediasi |
|
system |
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya. |
Common.CloudError
Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).
| Nama | Jenis | Deskripsi |
|---|---|---|
| error.additionalInfo |
Info tambahan kesalahan. |
|
| error.code |
string |
Kode kesalahan. |
| error.details |
Detail kesalahan. |
|
| error.message |
string |
Pesan kesalahan. |
| error.target |
string |
Target kesalahan. |
Common.CloudErrorBody
Detail kesalahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| additionalInfo |
Info tambahan kesalahan. |
|
| code |
string |
Kode kesalahan. |
| details |
Detail kesalahan. |
|
| message |
string |
Pesan kesalahan. |
| target |
string |
Target kesalahan. |
createdByType
Jenis identitas yang membuat sumber daya.
| Nilai | Deskripsi |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| info |
object |
Info tambahan. |
| type |
string |
Jenis info tambahan. |
GovernanceAssignment
Penetapan tata kelola atas cakupan tertentu
| Nama | Jenis | Deskripsi |
|---|---|---|
| id |
string (arm-id) |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nama sumber daya |
| properties.additionalData |
Data tambahan untuk penetapan tata kelola - misalnya tautan ke tiket (opsional), lihat contoh |
|
| properties.governanceEmailNotification |
Pengaturan pemberitahuan email untuk aturan tata kelola, menyatakan apakah akan menonaktifkan pemberitahuan untuk manger dan pemilik |
|
| properties.isGracePeriod |
boolean |
Menentukan apakah ada masa tenggang pada penetapan tata kelola |
| properties.owner |
string |
Pemilik untuk penetapan tata kelola - misalnya user@contoso.com - lihat contoh |
| properties.remediationDueDate |
string (date-time) |
Tanggal jatuh tempo remediasi - setelah tanggal ini Skor Aman akan terpengaruh (jika terjadi masa tenggang aktif) |
| properties.remediationEta |
ETA (perkiraan waktu kedatangan) untuk remediasi (opsional), lihat contoh |
|
| systemData |
Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy. |
|
| type |
string |
Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts" |
GovernanceAssignmentAdditionalData
Menjelaskan data tambahan penetapan tata kelola - opsional
| Nama | Jenis | Deskripsi |
|---|---|---|
| ticketLink |
string |
Tautan tiket yang terkait dengan penetapan tata kelola ini - misalnya: https://snow.com |
| ticketNumber |
integer (int32) minimum: 0 |
Nomor tiket yang terkait dengan penetapan tata kelola ini |
| ticketStatus |
string |
Status tiket yang terkait dengan penetapan tata kelola ini - misalnya: Aktif |
GovernanceEmailNotification
Konfigurasi pemberitahuan mingguan email tata kelola.
| Nama | Jenis | Deskripsi |
|---|---|---|
| disableManagerEmailNotification |
boolean |
Kecualikan manajer dari pemberitahuan email mingguan. |
| disableOwnerEmailNotification |
boolean |
Kecualikan pemilik dari pemberitahuan email mingguan. |
RemediationEta
ETA (perkiraan waktu kedatangan) untuk remediasi
| Nama | Jenis | Deskripsi |
|---|---|---|
| eta |
string (date-time) |
ETA untuk remediasi. |
| justification |
string |
Pembenaran untuk perubahan Eta. |
systemData
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| createdAt |
string (date-time) |
Tanda waktu pembuatan sumber daya (UTC). |
| createdBy |
string |
Identitas yang membuat sumber daya. |
| createdByType |
Jenis identitas yang membuat sumber daya. |
|
| lastModifiedAt |
string (date-time) |
Stempel waktu modifikasi terakhir sumber daya (UTC) |
| lastModifiedBy |
string |
Identitas yang terakhir mengubah sumber daya. |
| lastModifiedByType |
Jenis identitas yang terakhir memodifikasi sumber daya. |