Share via

Microsoft.Security assessments 2019-01-01-preview

  • Artykuł

Definicja zasobu Bicep

Typ zasobu oceny to zasób rozszerzenia, co oznacza, że można go zastosować do innego zasobu.

scope Użyj właściwości tego zasobu, aby ustawić zakres dla tego zasobu. Zobacz Ustawianie zakresu dla zasobów rozszerzeń w środowisku Bicep.

Typ zasobu oceny można wdrożyć za pomocą operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Security/assessments, dodaj następujący kod Bicep do szablonu.

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

Obiekty ResourceDetails

Ustaw właściwość źródłową , aby określić typ obiektu.

W przypadku platformy Azure użyj:

  source: 'Azure'

W przypadku polecenia OnPremiseSql użyj:

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

Wartości właściwości

oceny

Nazwa Opis Wartość
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–260

Prawidłowe znaki:
Alfanumeryczne, podkreślenia i łączniki.
scope Użyj polecenia podczas tworzenia zasobu rozszerzenia w zakresie innym niż zakres wdrożenia. Zasób docelowy

W przypadku elementu Bicep ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
properties Opisuje właściwości oceny. SecurityAssessmentProperties

SecurityAssessmentProperties

Nazwa Opis Wartość
additionalData Dodatkowe dane dotyczące oceny SecurityAssessmentPropertiesAdditionalData
resourceDetails Szczegóły zasobu, który został oceniony ResourceDetails (wymagane)
status Wynik oceny AssessmentStatus (wymagane)

SecurityAssessmentPropertiesAdditionalData

Nazwa Opis Wartość
{niestandardowa właściwość} ciąg

ResourceDetails

Nazwa Opis Wartość
source Ustawianie typu obiektu Azure
OnPremiseSql (wymagane)

AzureResourceDetails

Nazwa Opis Wartość
source Platforma, na której znajduje się oceniony zasób "Azure" (wymagane)

OnPremiseSqlResourceDetails

Nazwa Opis Wartość
source Platforma, na której znajduje się oceniony zasób "OnPremiseSql" (wymagane)
databaseName Nazwa bazy danych Sql zainstalowana na maszynie ciąg (wymagany)
Machinename Nazwa maszyny ciąg (wymagany)
serverName Nazwa serwera SQL zainstalowana na maszynie ciąg (wymagany)
sourceComputerId Identyfikator agenta pakietu oms zainstalowany na maszynie ciąg (wymagany)
vmuuid Unikatowy identyfikator maszyny ciąg (wymagany)
workspaceId Identyfikator zasobu platformy Azure obszaru roboczego, do których jest dołączona maszyna ciąg (wymagany)

AssessmentStatus

Nazwa Opis Wartość
Spowodować Kod programowy przyczyny stanu oceny ciąg
kod Kod programowy stanu oceny "Zdrowe"
"NotApplicable"
"W złej kondycji" (wymagane)
description (opis) Czytelny opis stanu oceny przez człowieka ciąg

Definicja zasobu szablonu usługi ARM

Typ zasobu oceny to zasób rozszerzenia, co oznacza, że można go zastosować do innego zasobu.

scope Użyj właściwości tego zasobu, aby ustawić zakres dla tego zasobu. Zobacz Ustawianie zakresu dla zasobów rozszerzeń w szablonach usługi ARM.

Typ zasobu oceny można wdrożyć za pomocą operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Security/assessments, dodaj następujący kod JSON do szablonu.

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

Obiekty ResourceDetails

Ustaw właściwość źródłową , aby określić typ obiektu.

W przypadku platformy Azure użyj:

  "source": "Azure"

W przypadku polecenia OnPremiseSql użyj:

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

Wartości właściwości

oceny

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Security/assessments"
apiVersion Wersja interfejsu API zasobów "2019-01-01-preview"
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–260

Prawidłowe znaki:
Alfanumeryczne, podkreślenia i łączniki.
scope Użyj polecenia podczas tworzenia zasobu rozszerzenia w zakresie innym niż zakres wdrożenia. Zasób docelowy

W przypadku formatu JSON ustaw wartość na pełną nazwę zasobu, aby zastosować zasób rozszerzenia do.
properties Opisuje właściwości oceny. SecurityAssessmentProperties

SecurityAssessmentProperties

Nazwa Opis Wartość
additionalData Dodatkowe dane dotyczące oceny SecurityAssessmentPropertiesAdditionalData
resourceDetails Szczegóły zasobu, który został oceniony ResourceDetails (wymagane)
status Wynik oceny AssessmentStatus (wymagane)

SecurityAssessmentPropertiesAdditionalData

Nazwa Opis Wartość
{niestandardowa właściwość} ciąg

ResourceDetails

Nazwa Opis Wartość
source Ustawianie typu obiektu Azure
OnPremiseSql (wymagane)

AzureResourceDetails

Nazwa Opis Wartość
source Platforma, na której znajduje się oceniony zasób "Azure" (wymagane)

OnPremiseSqlResourceDetails

Nazwa Opis Wartość
source Platforma, na której znajduje się oceniony zasób "OnPremiseSql" (wymagane)
databaseName Nazwa bazy danych Sql zainstalowana na maszynie ciąg (wymagany)
Machinename Nazwa maszyny ciąg (wymagany)
serverName Nazwa serwera SQL zainstalowana na maszynie ciąg (wymagany)
sourceComputerId Identyfikator agenta pakietu oms zainstalowany na maszynie ciąg (wymagany)
vmuuid Unikatowy identyfikator maszyny ciąg (wymagany)
workspaceId Identyfikator zasobu platformy Azure obszaru roboczego, do który jest dołączony komputer ciąg (wymagany)

AssessmentStatus

Nazwa Opis Wartość
Spowodować Kod programowy przyczyny stanu oceny ciąg
kod Kod programowy stanu oceny "W dobrej kondycji"
"NotApplicable"
"W złej kondycji" (wymagane)
description (opis) Czytelny opis stanu oceny przez człowieka ciąg

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu oceny to zasób rozszerzenia, co oznacza, że można zastosować go do innego zasobu.

parent_id Użyj właściwości w tym zasobie, aby ustawić zakres dla tego zasobu.

Typ zasobu oceny można wdrożyć z operacjami docelowymi:

  • Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Security/assessments, dodaj następujący element Terraform do szablonu.

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

Obiekty ResourceDetails

Ustaw właściwość źródłową , aby określić typ obiektu.

W przypadku platformy Azure użyj:

  source = "Azure"

W przypadku onPremiseSql użyj:

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

Wartości właściwości

oceny

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Security/assessments@2019-01-01-preview"
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–260

Prawidłowe znaki:
Alfanumeryczne, podkreślenia i łączniki.
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
properties Opisuje właściwości oceny. SecurityAssessmentProperties

SecurityAssessmentProperties

Nazwa Opis Wartość
additionalData Dodatkowe dane dotyczące oceny SecurityAssessmentPropertiesAdditionalData
resourceDetails Szczegóły zasobu, który został oceniony ResourceDetails (wymagane)
status Wynik oceny AssessmentStatus (wymagany)

SecurityAssessmentPropertiesAdditionalData

Nazwa Opis Wartość
{niestandardowa właściwość} ciąg

ResourceDetails

Nazwa Opis Wartość
source Ustawianie typu obiektu Azure
OnPremiseSql (wymagane)

AzureResourceDetails

Nazwa Opis Wartość
source Platforma, na której znajduje się oceniony zasób "Azure" (wymagane)

OnPremiseSqlResourceDetails

Nazwa Opis Wartość
source Platforma, na której znajduje się oceniony zasób "OnPremiseSql" (wymagane)
databaseName Nazwa bazy danych Sql zainstalowana na maszynie ciąg (wymagany)
Machinename Nazwa maszyny ciąg (wymagany)
serverName Nazwa serwera SQL zainstalowana na maszynie ciąg (wymagany)
sourceComputerId Identyfikator agenta pakietu oms zainstalowany na maszynie ciąg (wymagany)
vmuuid Unikatowy identyfikator maszyny ciąg (wymagany)
workspaceId Identyfikator zasobu platformy Azure obszaru roboczego, do których jest dołączona maszyna ciąg (wymagany)

AssessmentStatus

Nazwa Opis Wartość
Spowodować Kod programowy przyczyny stanu oceny ciąg
kod Kod programowy stanu oceny "W dobrej kondycji"
"NotApplicable"
"W złej kondycji" (wymagane)
description (opis) Czytelny opis stanu oceny przez człowieka ciąg