Partilhar via

Database Vulnerability Assessments - Get

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Obtém a avaliação de vulnerabilidade do banco de dados.

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

Parâmetros do URI

Name Em Necessário Tipo Description
databaseName
 path True

string

O nome do banco de dados para o qual a avaliação de vulnerabilidade está definida.
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal.
serverName
 path True

string

O nome do servidor.
subscriptionId
 path True

string

A ID de assinatura que identifica uma assinatura do Azure.
vulnerabilityAssessmentName
 path True

VulnerabilityAssessmentName

O nome da avaliação de vulnerabilidade.
api-version
 query True

string

A versão da API a ser usada para a solicitação.

Respostas

Name Tipo Description
200 OK

DatabaseVulnerabilityAssessment

Recuperada com êxito a avaliação de vulnerabilidade do banco de dados.
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 compartilhado da conta de armazenamento fornecida ou a chave de armazenamento da conta não é válida.

  • 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath - O caminho do contêiner de armazenamento deve ser fornecido se não estiver definido na política de nível de servidor

  • 400 VulnerabilityAssessmentUnsupportedStorageAccount - A conta de armazenamento fornecida não é suportada.

  • 400 VulnerabilityAssessmentADSIsDisabled - Advanced Data Security deve ser ativado para usar a Avaliação de Vulnerabilidade.

  • 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 solicitado não foi encontrado

  • 404 SourceDatabaseNotFound - O banco de dados de origem não existe.

  • 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância do servidor.

  • 500 DatabaseIsUnavailable - Falha ao carregar. Tente novamente mais tarde.

Exemplos

Get a database's vulnerability assessment

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
DatabaseVulnerabilityAssessment

Uma avaliação da vulnerabilidade da base de dados.
VulnerabilityAssessmentName

O nome da avaliação de vulnerabilidade.
VulnerabilityAssessmentRecurringScansProperties

Propriedades de uma verificação recorrente de Avaliação de vulnerabilidade.

DatabaseVulnerabilityAssessment

Object

Uma avaliação da vulnerabilidade da base de dados.

Name Tipo Description
id

string

ID do recurso.
name

string

Nome do recurso.
properties.recurringScans

VulnerabilityAssessmentRecurringScansProperties

As configurações de varreduras recorrentes
properties.storageAccountAccessKey

string

Especifica a chave identificador da conta de armazenamento para os resultados da verificação de avaliação de vulnerabilidade. Se 'StorageContainerSasKey' não for especificado, storageAccountAccessKey será necessário. Aplica-se somente se a conta de armazenamento não estiver atrás de uma Vnet ou de um firewall
properties.storageContainerPath

string

Um caminho de contêiner de armazenamento de blob para armazenar os resultados da verificação (por exemplo, https://myStorage.blob.core.windows.net/VaScans/). É necessário se a política de avaliação de vulnerabilidades no nível do servidor não definir
properties.storageContainerSasKey

string

Uma assinatura de acesso compartilhado (chave SAS) que tem acesso de gravação ao contêiner de blob especificado no parâmetro 'storageContainerPath'. Se 'storageAccountAccessKey' não for especificado, StorageContainerSasKey será necessário. Aplica-se somente se a conta de armazenamento não estiver atrás de uma Vnet ou de um firewall
type

string

Tipo de recurso.

VulnerabilityAssessmentName

Enumeração

O nome da avaliação de vulnerabilidade.

Valor Description
default

VulnerabilityAssessmentRecurringScansProperties

Object

Propriedades de uma verificação recorrente de Avaliação de vulnerabilidade.

Name Tipo Default value Description
emailSubscriptionAdmins

boolean

True

Especifica que a notificação de verificação de agendamento será enviada aos administradores de assinatura.
emails

string[]

Especifica uma matriz de endereços de email para os quais a notificação de verificação é enviada.
isEnabled

boolean

Estado das verificações recorrentes.