Assessments - Get

  • Riferimento
Service:
Defender for Cloud
API Version:
2020-01-01

Ottenere una valutazione della sicurezza sulla risorsa analizzata

GET https://management.azure.com/{resourceId}/providers/Microsoft.Security/assessments/{assessmentName}?api-version=2020-01-01
With optional parameters: 
GET https://management.azure.com/{resourceId}/providers/Microsoft.Security/assessments/{assessmentName}?api-version=2020-01-01&$expand={$expand}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
assessmentName
 path True

string

Chiave di valutazione - Chiave univoca per il tipo di valutazione
resourceId
 path True

string

Identificatore della risorsa.
api-version
 query True

string

Versione dell'API per l'operazione
$expand
 query

ExpandEnum

OData espandere. facoltativo.

Risposte

Nome Tipo Descrizione
200 OK

SecurityAssessment

OK
Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Get security recommendation task from security data location
Get security recommendation task from security data location with expand parameter

Get security recommendation task from security data location

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b?api-version=2020-01-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
  "name": "21300918-b2e3-0346-785f-c77ff57d243b",
  "type": "Microsoft.Security/assessments",
  "properties": {
    "resourceDetails": {
      "source": "Azure",
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2"
    },
    "displayName": "Install endpoint protection solution on virtual machine scale sets",
    "status": {
      "code": "NotApplicable",
      "cause": "OffByPolicy",
      "description": "The effective policy for the assessment was evaluated to off - use Microsoft.Authorization/policyAssignments to turn this assessment on"
    },
    "additionalData": {
      "linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
    }
  }
}

Get security recommendation task from security data location with expand parameter

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b?api-version=2020-01-01&$expand=links

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
  "name": "21300918-b2e3-0346-785f-c77ff57d243b",
  "type": "Microsoft.Security/assessments",
  "properties": {
    "resourceDetails": {
      "source": "Azure",
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2"
    },
    "displayName": "Install endpoint protection solution on virtual machine scale sets",
    "status": {
      "code": "NotApplicable",
      "cause": "OffByPolicy",
      "description": "The effective policy for the assessment was evaluated to off - use Microsoft.Authorization/policyAssignments to turn this assessment on"
    },
    "additionalData": {
      "linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
    },
    "links": {
      "azurePortalUri": "https://www.portal.azure.com/?fea#blade/Microsoft_Azure_Security/RecommendationsBlade/assessmentKey/21300918-b2e3-0346-785f-c77ff57d243b"
    }
  }
}

Definizioni

Nome Descrizione
AssessmentLinks

Collegamenti pertinenti alla valutazione
AssessmentStatus

Risultato della valutazione
AssessmentStatusCode

Codice programmatico per lo stato della valutazione
assessmentType

BuiltIn se la valutazione è basata sulla definizione predefinita di Criteri di Azure, personalizzata se la valutazione è basata sulla definizione di Criteri di Azure personalizzata
AzureResourceDetails

Dettagli della risorsa di Azure valutata
categories
CloudError

Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.
CloudErrorBody

Dettagli dell'errore.
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
ExpandEnum

OData espandere. facoltativo.
implementationEffort

L'impegno di implementazione necessario per correggere questa valutazione
OnPremiseResourceDetails

Dettagli della risorsa locale valutata
OnPremiseSqlResourceDetails

Dettagli della risorsa SQL locale valutata
SecurityAssessment

Valutazione della sicurezza in una risorsa
SecurityAssessmentMetadataPartnerData

Descrive il partner che ha creato la valutazione
SecurityAssessmentMetadataProperties

Descrive le proprietà di un metadati di valutazione.
SecurityAssessmentPartnerData

Dati relativi all'integrazione di partner di terze parti
severity

Livello di gravità della valutazione
threats
userImpact

Impatto dell'utente della valutazione

Collegamenti pertinenti alla valutazione

Nome Tipo Descrizione
azurePortalUri

string

Collegamento alla valutazione nel portale di Azure

AssessmentStatus

Risultato della valutazione

Nome Tipo Descrizione
cause

string

Codice programmatico per la causa dello stato della valutazione
code

AssessmentStatusCode

Codice programmatico per lo stato della valutazione
description

string

Descrizione leggibile dello stato di valutazione

AssessmentStatusCode

Codice programmatico per lo stato della valutazione

Nome Tipo Descrizione
Healthy

string

La risorsa è integra
NotApplicable

string

La valutazione per questa risorsa non è stata eseguita
Unhealthy

string

La risorsa presenta un problema di sicurezza che deve essere risolto

assessmentType

BuiltIn se la valutazione è basata sulla definizione predefinita di Criteri di Azure, personalizzata se la valutazione è basata sulla definizione di Criteri di Azure personalizzata

Nome Tipo Descrizione
BuiltIn

string

Microsoft Defender per le valutazioni gestite dal cloud
CustomPolicy

string

Criteri definiti dall'utente inseriti automaticamente da Criteri di Azure a Microsoft Defender for Cloud
CustomerManaged

string

Valutazioni degli utenti effettuate direttamente dall'utente o da altre terze parti per Microsoft Defender for Cloud
VerifiedPartner

string

Valutazione creata da una terza parte verificata se l'utente l'ha connessa al Centro sicurezza di Azure

AzureResourceDetails

Dettagli della risorsa di Azure valutata

Nome Tipo Descrizione
id

string

ID risorsa di Azure della risorsa valutata
source string:

Azure

Piattaforma in cui risiede la risorsa valutata

categories

Nome Tipo Descrizione
Compute

string

Data

string

IdentityAndAccess

string

IoT

string

Networking

string

CloudError

Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.

Nome Tipo Descrizione
error.additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
error.code

string

Codice di errore.
error.details

CloudErrorBody[]

Dettagli dell'errore.
error.message

string

Messaggio di errore.
error.target

string

Destinazione dell'errore.

CloudErrorBody

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
code

string

Codice di errore.
details

CloudErrorBody[]

Dettagli dell'errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

ExpandEnum

OData espandere. facoltativo.

Nome Tipo Descrizione
links

string

Tutti i collegamenti associati a una valutazione
metadata

string

Metadati di valutazione

implementationEffort

L'impegno di implementazione necessario per correggere questa valutazione

Nome Tipo Descrizione
High

string

Low

string

Moderate

string

OnPremiseResourceDetails

Dettagli della risorsa locale valutata

Nome Tipo Descrizione
machineName

string

Nome del computer
source string:

OnPremise

Piattaforma in cui risiede la risorsa valutata
sourceComputerId

string

ID agente oms installato nel computer
vmuuid

string

ID univoco del computer
workspaceId

string

ID risorsa di Azure dell'area di lavoro a cui è collegato il computer

OnPremiseSqlResourceDetails

Dettagli della risorsa SQL locale valutata

Nome Tipo Descrizione
databaseName

string

Nome del database Sql installato nel computer
machineName

string

Nome del computer
serverName

string

Nome sql server installato nel computer
source string:

OnPremiseSql

Piattaforma in cui risiede la risorsa valutata
sourceComputerId

string

ID agente oms installato nel computer
vmuuid

string

ID univoco del computer
workspaceId

string

ID risorsa di Azure dell'area di lavoro a cui è collegato il computer

SecurityAssessment

Valutazione della sicurezza in una risorsa

Nome Tipo Descrizione
id

string

ID risorsa
name

string

Nome risorsa
properties.additionalData

object

Dati aggiuntivi relativi alla valutazione
properties.displayName

string

Nome visualizzato descrittivo della valutazione
properties.links

AssessmentLinks

Collegamenti pertinenti alla valutazione
properties.metadata

SecurityAssessmentMetadataProperties

Descrive le proprietà di un metadati di valutazione.
properties.partnersData

SecurityAssessmentPartnerData

Dati relativi all'integrazione di partner di terze parti
properties.resourceDetails ResourceDetails:

Dettagli della risorsa valutata
properties.status

AssessmentStatus

Risultato della valutazione
type

string

Tipo di risorsa

SecurityAssessmentMetadataPartnerData

Descrive il partner che ha creato la valutazione

Nome Tipo Descrizione
partnerName

string

Nome della società del partner
productName

string

Nome del prodotto del partner che ha creato la valutazione
secret

string

Segreto per autenticare il partner e verificarne la creazione: solo scrittura

SecurityAssessmentMetadataProperties

Descrive le proprietà di un metadati di valutazione.

Nome Tipo Descrizione
assessmentType

assessmentType

BuiltIn se la valutazione è basata sulla definizione predefinita di Criteri di Azure, personalizzata se la valutazione è basata sulla definizione di Criteri di Azure personalizzata
categories

categories[]

Categorie di risorse a rischio quando la valutazione non è integra
description

string

Descrizione leggibile della valutazione
displayName

string

Nome visualizzato descrittivo della valutazione
implementationEffort

implementationEffort

L'impegno di implementazione necessario per correggere questa valutazione
partnerData

SecurityAssessmentMetadataPartnerData

Descrive il partner che ha creato la valutazione
policyDefinitionId

string

ID risorsa di Azure della definizione dei criteri che attiva il calcolo della valutazione
preview

boolean

True se la valutazione è in stato di versione di anteprima
remediationDescription

string

Descrizione leggibile delle operazioni da eseguire per attenuare questo problema di sicurezza
severity

severity

Livello di gravità della valutazione
threats

threats[]

Impatto sulle minacce della valutazione
userImpact

userImpact

Impatto dell'utente della valutazione

SecurityAssessmentPartnerData

Dati relativi all'integrazione di partner di terze parti

Nome Tipo Descrizione
partnerName

string

Nome della società del partner
secret

string

segreto per autenticare il partner : solo scrittura

severity

Livello di gravità della valutazione

Nome Tipo Descrizione
High

string

Low

string

Medium

string

threats

Nome Tipo Descrizione
accountBreach

string

dataExfiltration

string

dataSpillage

string

denialOfService

string

elevationOfPrivilege

string

maliciousInsider

string

missingCoverage

string

threatResistance

string

userImpact

Impatto dell'utente della valutazione

Nome Tipo Descrizione
High

string

Low

string

Moderate

string