Avaliações do Microsoft.Security 2019-01-01-preview

• última
• 2021-06-01
• 2020-01-01
• 2019-01-01-preview

Definição de recurso do Bicep

O tipo de recurso de avaliações pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Security/assessments, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Security/assessments@2019-01-01-preview' = {
  scope: resourceSymbolicName or scope
  name: 'string'
  properties: {
    additionalData: {
      {customized property}: 'string'
    }
    resourceDetails: {
      source: 'string'
      // For remaining properties, see ResourceDetails objects
    }
    status: {
      cause: 'string'
      code: 'string'
      description: 'string'
    }
  }
}

Objetos ResourceDetails

Defina a propriedade de origem para especificar o tipo de objeto.

Para do Azure, use:

{
  source: 'Azure'
}

Para OnPremiseSql, use:

{
  databaseName: 'string'
  machineName: 'string'
  serverName: 'string'
  source: 'OnPremiseSql'
  sourceComputerId: 'string'
  vmuuid: 'string'
  workspaceId: 'string'
}

Valores de propriedade

AssessmentStatus

Nome	Descrição	Valor
causa	Código programático para a causa do status da avaliação	corda
código	Código programático para o status da avaliação	'Íntegro' 'NotApplicable' 'Não íntegro' (obrigatório)
descrição	Descrição legível humana do status da avaliação	corda

AzureResourceDetails

Nome	Descrição	Valor
fonte	A plataforma em que o recurso avaliado reside	'Azure' (obrigatório)

Microsoft.Security/assessments

Nome	Descrição	Valor
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Descreve as propriedades de uma avaliação.	securityAssessmentProperties
âmbito	Use ao criar um recurso em um escopo diferente do escopo de implantação.	Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .

OnPremiseSqlResourceDetails

Nome	Descrição	Valor
databaseName	O nome do banco de dados Sql instalado no computador	cadeia de caracteres (obrigatório)
machineName	O nome do computador	cadeia de caracteres (obrigatório)
serverName	O nome do Sql Server instalado no computador	cadeia de caracteres (obrigatório)
fonte	A plataforma em que o recurso avaliado reside	'OnPremiseSql' (obrigatório)
sourceComputerId	A ID do agente oms instalada no computador	cadeia de caracteres (obrigatório)
vmuuid	A ID exclusiva do computador	cadeia de caracteres (obrigatório)
workspaceId	ID de recurso do Azure do workspace ao qual o computador está anexado	cadeia de caracteres (obrigatório)

ResourceDetails

Nome	Descrição	Valor
fonte	Defina como 'Azure' para o tipo AzureResourceDetails. Defina como 'OnPremiseSql' para o tipo OnPremiseSqlResourceDetails.	'Azure' 'OnPremiseSql' (obrigatório)

SecurityAssessmentProperties

Nome	Descrição	Valor
additionalData	Dados adicionais sobre a avaliação	securityAssessmentPropertiesAdditionalData
resourceDetails	Detalhes do recurso que foi avaliado	ResourceDetails (obrigatório)
estado	O resultado da avaliação	AssessmentStatus (obrigatório)

SecurityAssessmentPropertiesAdditionalData

Nome	Descrição	Valor

Definição de recurso de modelo do ARM

O tipo de recurso de avaliações pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Security/assessments, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Security/assessments",
  "apiVersion": "2019-01-01-preview",
  "name": "string",
  "properties": {
    "additionalData": {
      "{customized property}": "string"
    },
    "resourceDetails": {
      "source": "string"
      // For remaining properties, see ResourceDetails objects
    },
    "status": {
      "cause": "string",
      "code": "string",
      "description": "string"
    }
  }
}

Objetos ResourceDetails

Defina a propriedade de origem para especificar o tipo de objeto.

Para do Azure, use:

{
  "source": "Azure"
}

Para OnPremiseSql, use:

{
  "databaseName": "string",
  "machineName": "string",
  "serverName": "string",
  "source": "OnPremiseSql",
  "sourceComputerId": "string",
  "vmuuid": "string",
  "workspaceId": "string"
}

Valores de propriedade

AssessmentStatus

Nome	Descrição	Valor
causa	Código programático para a causa do status da avaliação	corda
código	Código programático para o status da avaliação	'Íntegro' 'NotApplicable' 'Não íntegro' (obrigatório)
descrição	Descrição legível humana do status da avaliação	corda

AzureResourceDetails

Nome	Descrição	Valor
fonte	A plataforma em que o recurso avaliado reside	'Azure' (obrigatório)

Microsoft.Security/assessments

Nome	Descrição	Valor
apiVersion	A versão da API	'2019-01-01-preview'
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Descreve as propriedades de uma avaliação.	securityAssessmentProperties
tipo	O tipo de recurso	'Microsoft.Security/assessments'

OnPremiseSqlResourceDetails

Nome	Descrição	Valor
databaseName	O nome do banco de dados Sql instalado no computador	cadeia de caracteres (obrigatório)
machineName	O nome do computador	cadeia de caracteres (obrigatório)
serverName	O nome do Sql Server instalado no computador	cadeia de caracteres (obrigatório)
fonte	A plataforma em que o recurso avaliado reside	'OnPremiseSql' (obrigatório)
sourceComputerId	A ID do agente oms instalada no computador	cadeia de caracteres (obrigatório)
vmuuid	A ID exclusiva do computador	cadeia de caracteres (obrigatório)
workspaceId	ID de recurso do Azure do workspace ao qual o computador está anexado	cadeia de caracteres (obrigatório)

ResourceDetails

Nome	Descrição	Valor
fonte	Defina como 'Azure' para o tipo AzureResourceDetails. Defina como 'OnPremiseSql' para o tipo OnPremiseSqlResourceDetails.	'Azure' 'OnPremiseSql' (obrigatório)

SecurityAssessmentProperties

Nome	Descrição	Valor
additionalData	Dados adicionais sobre a avaliação	securityAssessmentPropertiesAdditionalData
resourceDetails	Detalhes do recurso que foi avaliado	ResourceDetails (obrigatório)
estado	O resultado da avaliação	AssessmentStatus (obrigatório)

SecurityAssessmentPropertiesAdditionalData

Nome	Descrição	Valor

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de avaliações pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Security/assessments, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Security/assessments@2019-01-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      additionalData = {
        {customized property} = "string"
      }
      resourceDetails = {
        source = "string"
        // For remaining properties, see ResourceDetails objects
      }
      status = {
        cause = "string"
        code = "string"
        description = "string"
      }
    }
  })
}

Objetos ResourceDetails

Defina a propriedade de origem para especificar o tipo de objeto.

Para do Azure, use:

{
  source = "Azure"
}

Para OnPremiseSql, use:

{
  databaseName = "string"
  machineName = "string"
  serverName = "string"
  source = "OnPremiseSql"
  sourceComputerId = "string"
  vmuuid = "string"
  workspaceId = "string"
}

Valores de propriedade

AssessmentStatus

Nome	Descrição	Valor
causa	Código programático para a causa do status da avaliação	corda
código	Código programático para o status da avaliação	'Íntegro' 'NotApplicable' 'Não íntegro' (obrigatório)
descrição	Descrição legível humana do status da avaliação	corda

AzureResourceDetails

Nome	Descrição	Valor
fonte	A plataforma em que o recurso avaliado reside	'Azure' (obrigatório)

Microsoft.Security/assessments

Nome	Descrição	Valor
nome	O nome do recurso	cadeia de caracteres (obrigatório)
parent_id	A ID do recurso ao qual aplicar esse recurso de extensão.	cadeia de caracteres (obrigatório)
Propriedades	Descreve as propriedades de uma avaliação.	securityAssessmentProperties
tipo	O tipo de recurso	"Microsoft.Security/assessments@2019-01-01-preview"

OnPremiseSqlResourceDetails

Nome	Descrição	Valor
databaseName	O nome do banco de dados Sql instalado no computador	cadeia de caracteres (obrigatório)
machineName	O nome do computador	cadeia de caracteres (obrigatório)
serverName	O nome do Sql Server instalado no computador	cadeia de caracteres (obrigatório)
fonte	A plataforma em que o recurso avaliado reside	'OnPremiseSql' (obrigatório)
sourceComputerId	A ID do agente oms instalada no computador	cadeia de caracteres (obrigatório)
vmuuid	A ID exclusiva do computador	cadeia de caracteres (obrigatório)
workspaceId	ID de recurso do Azure do workspace ao qual o computador está anexado	cadeia de caracteres (obrigatório)

ResourceDetails

Nome	Descrição	Valor
fonte	Defina como 'Azure' para o tipo AzureResourceDetails. Defina como 'OnPremiseSql' para o tipo OnPremiseSqlResourceDetails.	'Azure' 'OnPremiseSql' (obrigatório)

SecurityAssessmentProperties

Nome	Descrição	Valor
additionalData	Dados adicionais sobre a avaliação	securityAssessmentPropertiesAdditionalData
resourceDetails	Detalhes do recurso que foi avaliado	ResourceDetails (obrigatório)
estado	O resultado da avaliação	AssessmentStatus (obrigatório)

SecurityAssessmentPropertiesAdditionalData

Nome	Descrição	Valor