Assessments - Get

Referens

Service:: Defender for Cloud

API Version:: 2020-01-01

Hämta en säkerhetsutvärdering av den genomsökda resursen

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}

URI-parametrar

Name	I	Obligatorisk	Typ	Description
assessmentName	path	True	string	Utvärderingsnyckeln – unik nyckel för utvärderingstypen
resourceId	path	True	string	Resursens identifierare.
api-version	query	True	string	API-version för åtgärden
$expand	query		ExpandEnum	OData expanderar. Valfritt.

Svar

Name	Typ	Description
200 OK	SecurityAssessment	OK
Other Status Codes	CloudError	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

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

HTTP

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

HTTP

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"
    }
  }
}

Definitioner

Name	Description
AssessmentLinks	Länkar som är relevanta för utvärderingen
AssessmentStatus	Resultatet av utvärderingen
AssessmentStatusCode	Programmatisk kod för utvärderingens status
assessmentType	BuiltIn om utvärderingen baseras på inbyggd Azure Policy definition, Anpassad om utvärderingen baseras på anpassad Azure Policy definition
AzureResourceDetails	Information om Azure-resursen som utvärderades
categories
CloudError	Vanliga felsvar för alla Azure Resource Manager API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även OData-felsvarsformatet.).
CloudErrorBody	Felinformationen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ExpandEnum	OData expanderar. Valfritt.
implementationEffort	Den implementeringsinsats som krävs för att åtgärda den här utvärderingen
OnPremiseResourceDetails	Information om den lokala resurs som utvärderades
OnPremiseSqlResourceDetails	Information om den lokala Sql-resursen som utvärderades
SecurityAssessment	Säkerhetsbedömning för en resurs
SecurityAssessmentMetadataPartnerData	Beskriver partnern som skapade utvärderingen
SecurityAssessmentMetadataProperties	Beskriver egenskaperna för en utvärderingsmetadata.
SecurityAssessmentPartnerData	Data om partnerintegrering från tredje part
severity	Utvärderingens allvarlighetsgrad
threats
userImpact	Användarpåverkan av utvärderingen

AssessmentLinks

Länkar som är relevanta för utvärderingen

Name	Typ	Description
azurePortalUri	string	Länk till utvärdering i Azure-portalen

AssessmentStatus

Resultatet av utvärderingen

Name	Typ	Description
cause	string	Programmatisk kod för orsaken till utvärderingsstatusen
code	AssessmentStatusCode	Programmatisk kod för utvärderingens status
description	string	Mänsklig läsbar beskrivning av utvärderingsstatusen

AssessmentStatusCode

Programmatisk kod för utvärderingens status

Name	Typ	Description
Healthy	string	Resursen är felfri
NotApplicable	string	Utvärdering för den här resursen har inte inträffar
Unhealthy	string	Resursen har ett säkerhetsproblem som måste åtgärdas

assessmentType

BuiltIn om utvärderingen baseras på inbyggd Azure Policy definition, Anpassad om utvärderingen baseras på anpassad Azure Policy definition

Name	Typ	Description
BuiltIn	string	Microsoft Defender för molnhanterade utvärderingar
CustomPolicy	string	Användardefinierade principer som matas in automatiskt från Azure Policy till Microsoft Defender för molnet
CustomerManaged	string	Användarutvärderingar som skickas direkt av användaren eller någon annan tredje part för att Microsoft Defender för molnet
VerifiedPartner	string	En utvärdering som skapades av en verifierad tredje part om användaren anslöt den till ASC

AzureResourceDetails

Information om Azure-resursen som utvärderades

Name	Typ	Description
id	string	Azure-resurs-ID för den utvärderade resursen
source	string: Azure	Plattformen där den utvärderade resursen finns

Name	Typ	Description
Compute	string
Data	string
IdentityAndAccess	string
IoT	string
Networking	string

CloudError

Vanliga felsvar för alla Azure Resource Manager API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även OData-felsvarsformatet.).

Name	Typ	Description
error.additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
error.code	string	Felkoden.
error.details	CloudErrorBody[]	Felinformationen.
error.message	string	Felmeddelandet.
error.target	string	Felmålet.

CloudErrorBody

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	CloudErrorBody[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Den ytterligare informationstypen.

ExpandEnum

OData expanderar. Valfritt.

Name	Typ	Description
links	string	Alla länkar som är associerade med en utvärdering
metadata	string	Utvärderingsmetadata

implementationEffort

Den implementeringsinsats som krävs för att åtgärda den här utvärderingen

Name	Typ	Description
High	string
Low	string
Moderate	string

OnPremiseResourceDetails

Information om den lokala resurs som utvärderades

Name	Typ	Description
machineName	string	Namnet på datorn
source	string: OnPremise	Plattformen där den utvärderade resursen finns
sourceComputerId	string	Oms-agent-ID:t som är installerat på datorn
vmuuid	string	Datorns unika ID
workspaceId	string	Azure-resurs-ID för arbetsytan som datorn är ansluten till

OnPremiseSqlResourceDetails

Information om den lokala Sql-resursen som utvärderades

Name	Typ	Description
databaseName	string	Sql-databasnamnet som är installerat på datorn
machineName	string	Namnet på datorn
serverName	string	Sql Server-namnet installerat på datorn
source	string: OnPremiseSql	Plattformen där den utvärderade resursen finns
sourceComputerId	string	Oms-agent-ID:t som är installerat på datorn
vmuuid	string	Datorns unika ID
workspaceId	string	Azure-resurs-ID för arbetsytan som datorn är ansluten till

SecurityAssessment

Säkerhetsbedömning för en resurs

Name	Typ	Description
id	string	Resurs-ID
name	string	Resursnamn
properties.additionalData	object	Ytterligare data om utvärderingen
properties.displayName	string	Användarvänligt visningsnamn för utvärderingen
properties.links	AssessmentLinks	Länkar som är relevanta för utvärderingen
properties.metadata	SecurityAssessmentMetadataProperties	Beskriver egenskaperna för en utvärderingsmetadata.
properties.partnersData	SecurityAssessmentPartnerData	Data om partnerintegrering från tredje part
properties.resourceDetails	ResourceDetails: AzureResourceDetails OnPremiseResourceDetails OnPremiseSqlResourceDetails	Information om resursen som utvärderades
properties.status	AssessmentStatus	Resultatet av utvärderingen
type	string	Resurstyp

SecurityAssessmentMetadataPartnerData

Beskriver partnern som skapade utvärderingen

Name	Typ	Description
partnerName	string	Namnet på partnerns företag
productName	string	Namnet på produkten för partnern som skapade utvärderingen
secret	string	Hemlighet för att autentisera partnern och verifiera att den skapade utvärderingen – skriv endast

SecurityAssessmentMetadataProperties

Beskriver egenskaperna för en utvärderingsmetadata.

Name	Typ	Description
assessmentType	assessmentType	BuiltIn om utvärderingen baseras på inbyggd Azure Policy definition, Anpassad om utvärderingen baseras på anpassad Azure Policy definition
categories	categories[]	De resurskategorier som är i riskzonen när utvärderingen inte är felfri
description	string	Mänsklig läsbar beskrivning av utvärderingen
displayName	string	Användarvänligt visningsnamn för utvärderingen
implementationEffort	implementationEffort	Den implementeringsinsats som krävs för att åtgärda den här utvärderingen
partnerData	SecurityAssessmentMetadataPartnerData	Beskriver partnern som skapade utvärderingen
policyDefinitionId	string	Azure-resurs-ID för principdefinitionen som aktiverar den här utvärderingsberäkningen
preview	boolean	Sant om den här utvärderingen är i förhandsversionsstatus
remediationDescription	string	Mänsklig läsbar beskrivning av vad du bör göra för att åtgärda det här säkerhetsproblemet
severity	severity	Utvärderingens allvarlighetsgrad
threats	threats[]	Hotpåverkan av utvärderingen
userImpact	userImpact	Användarpåverkan av utvärderingen

SecurityAssessmentPartnerData

Data om partnerintegrering från tredje part

Name	Typ	Description
partnerName	string	Namnet på partnerns företag
secret	string	hemlighet för att autentisera partnern – skriv endast

severity

Utvärderingens allvarlighetsgrad

Name	Typ	Description
High	string
Low	string
Medium	string

threats

Name	Typ	Description
accountBreach	string
dataExfiltration	string
dataSpillage	string
denialOfService	string
elevationOfPrivilege	string
maliciousInsider	string
missingCoverage	string
threatResistance	string

userImpact

Användarpåverkan av utvärderingen

Name	Typ	Description
High	string
Low	string
Moderate	string

Assessments - Get

URI-parametrar

Svar

Säkerhet

azure_auth

Scopes

Exempel

Get security recommendation task from security data location

Sample Request

Sample Response

Get security recommendation task from security data location with expand parameter

Sample Request

Sample Response

Definitioner

AssessmentLinks

AssessmentStatus

AssessmentStatusCode

assessmentType

AzureResourceDetails

categories

CloudError

CloudErrorBody

ErrorAdditionalInfo

ExpandEnum

implementationEffort

OnPremiseResourceDetails

OnPremiseSqlResourceDetails

SecurityAssessment

SecurityAssessmentMetadataPartnerData

SecurityAssessmentMetadataProperties

SecurityAssessmentPartnerData

severity

threats

userImpact

Ytterligare resurser