Managed Database Vulnerability Assessment Scans - List By Database

Lista as verificações 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?api-version=2021-08-01-preview

Parâmetros de URI

Name In Required Type 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.

subscriptionId
path True
  • string

A ID de assinatura que identifica uma assinatura do Azure.

vulnerabilityAssessmentName
path True

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 Type Description
200 OK

Recuperou com êxito os registros 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 armazenamento inválido especificado nas configurações.

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

  • 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath – Armazenamento caminho de contêiner deve ser fornecido se 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 de 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 the list of a database vulnerability assessment scan records

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?api-version=2021-08-01-preview

Sample Response

{
  "value": [
    {
      "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
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan002",
      "name": "scan002",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan002",
        "triggerType": "Recurring",
        "state": "Failed",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 9
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan003",
      "name": "scan003",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan003",
        "triggerType": "Recurring",
        "state": "FailedToRun",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [
          {
            "code": "StorageNotFound",
            "message": "Storage not found"
          }
        ],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 0
      }
    }
  ]
}

Definições

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.

VulnerabilityAssessmentScanRecordListResult

Uma lista de registros de verificação de avaliação de vulnerabilidade.

VulnerabilityAssessmentScanState

O status da verificação.

VulnerabilityAssessmentScanTriggerType

O tipo de gatilho de verificação.

VulnerabilityAssessmentName

O nome da avaliação de vulnerabilidade.

Name Type Description
default
  • string

VulnerabilityAssessmentScanError

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

Name Type 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.

Name Type 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

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

O status da verificação.

properties.storageContainerPath
  • string

O caminho do contêiner de armazenamento de resultados de verificação.

properties.triggerType

O tipo de gatilho de verificação.

type
  • string

Tipo de recurso.

VulnerabilityAssessmentScanRecordListResult

Uma lista de registros de verificação de avaliação de vulnerabilidade.

Name Type Description
nextLink
  • string

Link para recuperar a próxima página de resultados.

value

Matriz de resultados.

VulnerabilityAssessmentScanState

O status da verificação.

Name Type Description
Failed
  • string
FailedToRun
  • string
InProgress
  • string
Passed
  • string

VulnerabilityAssessmentScanTriggerType

O tipo de gatilho de verificação.

Name Type Description
OnDemand
  • string
Recurring
  • string