Share via

Managed Database Vulnerability Assessment Scans - Get

  • Referência
Service:
SQL Database
API Version:
2021-11-01

Obtém um registro de verificação de avaliação de vulnerabilidade de um banco de dados.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
databaseName
 path True

string

O nome do banco de dados.
managedInstanceName
 path True

string

O nome da instância gerenciada.
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
scanId
 path True

string

A ID de verificação de avaliação de vulnerabilidade da verificação a ser recuperada.
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

Nome Tipo Description
200 OK

VulnerabilityAssessmentScanRecord

Recuperou com êxito o registro de verificação de 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 VulnerabilityAssessmentInvalidPolicy – As configurações de Avaliação de Vulnerabilidade não existem ou o armazenamento inválido especificado nas configurações.

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

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

  • 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated – Não foi possível executar a operação de Avaliação de Vulnerabilidade porque o banco de dados está em pausa. Retome-o.

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

  • 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.

  • 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – A verificação da Avaliação de Vulnerabilidades já está em andamento.

  • 500 DatabaseIsUnavailable – Falha no carregamento. Tente novamente mais tarde.

Exemplos

Gets a database vulnerability assessment scan record by scan ID

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6411/databases/testdb/vulnerabilityAssessments/default/scans/scan001?api-version=2021-11-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan001",
  "name": "scan001",
  "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
  "properties": {
    "scanId": "scan001",
    "triggerType": "OnDemand",
    "state": "Passed",
    "startTime": "2017-12-12T17:45:06Z",
    "endTime": "2017-12-12T17:47:06Z",
    "errors": [],
    "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
    "numberOfFailedSecurityChecks": 9
  }
}

Definições

Nome Description
VulnerabilityAssessmentName

O nome da avaliação de vulnerabilidade.
VulnerabilityAssessmentScanError

Propriedades de um erro de verificação de avaliação de vulnerabilidade.
VulnerabilityAssessmentScanRecord

Um registro de verificação de avaliação de vulnerabilidade.
VulnerabilityAssessmentScanState

O status de verificação.
VulnerabilityAssessmentScanTriggerType

O tipo de gatilho de verificação.

VulnerabilityAssessmentName

O nome da avaliação de vulnerabilidade.

Nome Tipo Description
default

string

VulnerabilityAssessmentScanError

Propriedades de um erro de verificação de avaliação de vulnerabilidade.

Nome Tipo Description
code

string

O código de erro.
message

string

A mensagem de erro.

VulnerabilityAssessmentScanRecord

Um registro de verificação de avaliação de vulnerabilidade.

Nome Tipo Description
id

string

ID do recurso.
name

string

Nome do recurso.
properties.endTime

string

A hora de término da verificação (UTC).
properties.errors

VulnerabilityAssessmentScanError[]

Os erros de verificação.
properties.numberOfFailedSecurityChecks

integer

O número de verificações de segurança com falha.
properties.scanId

string

A ID da verificação.
properties.startTime

string

A hora de início da verificação (UTC).
properties.state

VulnerabilityAssessmentScanState

O status de verificação.
properties.storageContainerPath

string

O caminho do contêiner de armazenamento dos resultados da verificação.
properties.triggerType

VulnerabilityAssessmentScanTriggerType

O tipo de gatilho de verificação.
type

string

Tipo de recurso.

VulnerabilityAssessmentScanState

O status de verificação.

Nome Tipo Description
Failed

string

FailedToRun

string

InProgress

string

Passed

string

VulnerabilityAssessmentScanTriggerType

O tipo de gatilho de verificação.

Nome Tipo Description
OnDemand

string

Recurring

string