Server Vulnerability Assessments - List By Server

Listas as políticas de avaliação de vulnerabilidades associadas a um servidor.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/vulnerabilityAssessments?api-version=2021-11-01

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

O ID da subscrição que identifica uma subscrição do Azure.

api-version
query True

string

A versão da API a utilizar para o pedido.

Respostas

Name Tipo Description
200 OK

ServerVulnerabilityAssessmentListResult

As políticas de avaliação de vulnerabilidades do servidor foram obtidas com êxito.

Other Status Codes

Respostas de Erro: ***

  • 400 InvalidStorageAccountName – a conta de armazenamento fornecida não é válida ou não existe.

  • 400 InvalidStorageAccountCredentials – a assinatura de acesso partilhado da conta de armazenamento fornecida ou a chave de armazenamento da conta não é válida.

  • 400 VulnerabilityAssessmentUnsupportedStorageAccount – a conta de armazenamento fornecida não é suportada.

  • 400 VulnerabilityAssessmentADSIsDisabled – o Advanced Data Security deve ser ativado para utilizar a Avaliação de Vulnerabilidades.

  • 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed – a conta de armazenamento não está na lista de Regras de Firewall de Saída.

  • 400 VulnerabilityAssessmentInsufficientStorageAccountPermissions – Permissões insuficientes na conta de armazenamento fornecida.

  • 400 VulnerabilityAssessmentStorageAccountIsDisabled – a conta de armazenamento fornecida está desativada.

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

Exemplos

Get a server's vulnerability assessment policies

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments?api-version=2021-11-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/",
      "name": "default",
      "type": "Microsoft.Sql/servers/vulnerabilityAssessments",
      "properties": {
        "recurringScans": {
          "isEnabled": true,
          "emailSubscriptionAdmins": true,
          "emails": [
            "email1@mail.com",
            "email2@mail.com"
          ]
        }
      }
    }
  ]
}

Definições

Name Description
ServerVulnerabilityAssessment

Uma avaliação de vulnerabilidades do servidor.

ServerVulnerabilityAssessmentListResult

Uma lista das avaliações de vulnerabilidades do servidor.

VulnerabilityAssessmentRecurringScansProperties

Propriedades de uma Análise periódica da Avaliação de Vulnerabilidades.

ServerVulnerabilityAssessment

Uma avaliação de vulnerabilidades do servidor.

Name Tipo Description
id

string

ID do Recurso.

name

string

Nome do recurso.

properties.recurringScans

VulnerabilityAssessmentRecurringScansProperties

As definições de análises periódicas

properties.storageAccountAccessKey

string

Especifica a chave de identificador da conta de armazenamento para os resultados da análise da avaliação de vulnerabilidades. Se "StorageContainerSasKey" não for especificado, é necessário storageAccountAccessKey. Aplica-se apenas se a conta de armazenamento não estiver protegida por uma VNet ou uma firewall

properties.storageContainerPath

string

Um caminho de contentor de armazenamento de blobs para conter os resultados da análise (por exemplo, https://myStorage.blob.core.windows.net/VaScans/).

properties.storageContainerSasKey

string

Uma assinatura de acesso partilhado (Chave SAS) que tem acesso de escrita ao contentor de blobs especificado no parâmetro "storageContainerPath". Se "storageAccountAccessKey" não for especificado, é necessário StorageContainerSasKey. Aplica-se apenas se a conta de armazenamento não estiver protegida por uma VNet ou uma firewall

type

string

Tipo de recurso.

ServerVulnerabilityAssessmentListResult

Uma lista das avaliações de vulnerabilidades do servidor.

Name Tipo Description
nextLink

string

Ligação para obter a página seguinte dos resultados.

value

ServerVulnerabilityAssessment[]

Matriz de resultados.

VulnerabilityAssessmentRecurringScansProperties

Propriedades de uma Análise periódica da Avaliação de Vulnerabilidades.

Name Tipo Valor Predefinido Description
emailSubscriptionAdmins

boolean

True

Especifica que a notificação de análise de agenda será enviada para os administradores da subscrição.

emails

string[]

Especifica uma matriz de endereços de e-mail para os quais a notificação de análise é enviada.

isEnabled

boolean

Estado das análises periódicas.