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
assessmentName
path True

string

pattern: ^[-\w\._\(\)]+$

Kunci penilaian penugasan tata kelola.

assignmentKey
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

GovernanceAssignment

Operasi Azure berhasil diselesaikan.

Other Status Codes

Common.CloudError

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.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.).

Common.CloudErrorBody

Detail kesalahan.

createdByType

Jenis identitas yang membuat sumber daya.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

GovernanceAssignment

Penetapan tata kelola atas cakupan tertentu

GovernanceAssignmentAdditionalData

Menjelaskan data tambahan penetapan tata kelola - opsional

GovernanceEmailNotification

Konfigurasi pemberitahuan mingguan email tata kelola.

RemediationEta

ETA (perkiraan waktu kedatangan) untuk remediasi

systemData

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

ErrorAdditionalInfo[]

Info tambahan kesalahan.

error.code

string

Kode kesalahan.

error.details

Common.CloudErrorBody[]

Detail kesalahan.

error.message

string

Pesan kesalahan.

error.target

string

Target kesalahan.

Common.CloudErrorBody

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

Common.CloudErrorBody[]

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

GovernanceAssignmentAdditionalData

Data tambahan untuk penetapan tata kelola - misalnya tautan ke tiket (opsional), lihat contoh

properties.governanceEmailNotification

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

RemediationEta

ETA (perkiraan waktu kedatangan) untuk remediasi (opsional), lihat contoh

systemData

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

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

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.