Assessments Metadata Subscription - Get

Layanan:

Defender for Cloud

Versi API:

2019-01-01-preview

Mendapatkan informasi metadata tentang jenis penilaian dalam langganan tertentu

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/assessmentMetadata/{assessmentMetadataName}?api-version=2019-01-01-preview

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
assessmentMetadataName	path	True	string	Kunci Penilaian - Kunci unik untuk jenis penilaian
subscriptionId	path	True	string pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$	ID langganan Azure
api-version	query	True	string	Versi API untuk operasi

Respons

Nama	Jenis	Deskripsi
200 OK	SecurityAssessmentMetadata	OKE
Other Status Codes	CloudError	Respons kesalahan yang menjelaskan mengapa operasi gagal.

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 security assessment metadata for subscription

Permintaan sampel

HTTP

GET https://management.azure.com/subscriptions/0980887d-03d6-408c-9566-532f3456804e/providers/Microsoft.Security/assessmentMetadata/21300918-b2e3-0346-785f-c77ff57d243b?api-version=2019-01-01-preview

Respon sampel

Kode status:

200

{
  "id": "/providers/Microsoft.Security/assessmentMetadata/21300918-b2e3-0346-785f-c77ff57d243b",
  "name": "21300918-b2e3-0346-785f-c77ff57d243b",
  "type": "Microsoft.Security/assessmentMetadata",
  "properties": {
    "displayName": "Install endpoint protection solution on virtual machine scale sets",
    "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/26a828e1-e88f-464e-bbb3-c134a282b9de",
    "description": "Install an endpoint protection solution on your virtual machines scale sets, to protect them from threats and vulnerabilities.",
    "remediationDescription": "To install an endpoint protection solution: 1.  <a href=\"https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-faq#how-do-i-turn-on-antimalware-in-my-virtual-machine-scale-set\">Follow the instructions in How do I turn on antimalware in my virtual machine scale set</a>",
    "categories": [
      "Compute"
    ],
    "severity": "Medium",
    "userImpact": "Low",
    "implementationEffort": "Low",
    "threats": [
      "dataExfiltration",
      "dataSpillage",
      "maliciousInsider"
    ],
    "assessmentType": "BuiltIn"
  }
}

Definisi

Nama	Deskripsi
assessmentType	BuiltIn jika penilaian berdasarkan definisi Azure Policy bawaan, Kustom jika penilaian berdasarkan definisi Azure Policy kustom
categories
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.).
CloudErrorBody	Detail kesalahan.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
implementationEffort	Upaya implementasi yang diperlukan untuk memulihkan penilaian ini
SecurityAssessmentMetadata	Metadata penilaian keamanan
severity	Tingkat keparahan penilaian
threats
userImpact	Dampak pengguna dari penilaian

assessmentType

Enumeration

BuiltIn jika penilaian berdasarkan definisi Azure Policy bawaan, Kustom jika penilaian berdasarkan definisi Azure Policy kustom

Nilai	Deskripsi
BuiltIn	Penilaian terkelola Microsoft Defender for Cloud
CustomPolicy	Kebijakan yang ditentukan pengguna yang secara otomatis diserap dari Azure Policy ke Microsoft Defender for Cloud
CustomerManaged	Penilaian pengguna yang didorong langsung oleh pengguna atau pihak ketiga lainnya ke Microsoft Defender for Cloud

categories

Enumeration

Nilai	Deskripsi
Compute
Networking
Data
IdentityAndAccess
IoT

CloudError

Objek

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	CloudErrorBody[]	Detail kesalahan.
error.message	string	Pesan kesalahan.
error.target	string	Target kesalahan.

CloudErrorBody

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	CloudErrorBody[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

implementationEffort

Enumeration

Upaya implementasi yang diperlukan untuk memulihkan penilaian ini

Nilai	Deskripsi
Low
Moderate
High

SecurityAssessmentMetadata

Objek

Metadata penilaian keamanan

Nama	Jenis	Deskripsi
id	string	Id Sumber Daya
name	string	Nama sumber daya
properties.assessmentType	assessmentType	BuiltIn jika penilaian berdasarkan definisi Azure Policy bawaan, Kustom jika penilaian berdasarkan definisi Azure Policy kustom
properties.categories	categories[]	Kategori sumber daya yang berisiko ketika penilaian tidak sehat
properties.description	string	Deskripsi penilaian yang dapat dibaca manusia
properties.displayName	string	Nama tampilan penilaian yang mudah diingat pengguna
properties.implementationEffort	implementationEffort	Upaya implementasi yang diperlukan untuk memulihkan penilaian ini
properties.policyDefinitionId	string	ID sumber daya Azure dari definisi kebijakan yang mengaktifkan perhitungan penilaian ini
properties.preview	boolean	Benar jika penilaian ini dalam status rilis pratinjau
properties.remediationDescription	string	Deskripsi yang dapat dibaca manusia tentang apa yang harus Anda lakukan untuk mengurangi masalah keamanan ini
properties.severity	severity	Tingkat keparahan penilaian
properties.threats	threats[]	Dampak ancaman dari penilaian
properties.userImpact	userImpact	Dampak pengguna dari penilaian
type	string	Jenis sumber daya

severity

Enumeration

Tingkat keparahan penilaian

Nilai	Deskripsi
Low
Medium
High

threats

Enumeration

Nilai	Deskripsi
accountBreach
dataExfiltration
dataSpillage
maliciousInsider
elevationOfPrivilege
threatResistance
missingCoverage
denialOfService

userImpact

Enumeration

Dampak pengguna dari penilaian

Nilai	Deskripsi
Low
Moderate
High