Partilhar via

Managed Database Vulnerability Assessment Scans - List By Database

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

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-11-01

Parâmetros do URI

Name Em Necessá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 da API do Azure Resource Manager ou do portal.
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

VulnerabilityAssessmentScanRecordListResult

Recuperados 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 o armazenamento é inválido especificado nas configurações.

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

  • 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 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated - Não foi possível executar a operação de Avaliação de Vulnerabilidade porque o banco de dados está pausado. Por favor, 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 de avaliação de vulnerabilidades já está em andamento.

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

Exemplos

Gets the list of a database vulnerability assessment scan records

Pedido de amostra

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-11-01

Resposta da amostra

Código de estado:
200 
{
  "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

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

Enumeração

O nome da avaliação de vulnerabilidade.

Valor Description
default

VulnerabilityAssessmentScanError

Object

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

Name Tipo Description
code

string

O código de erro.
message

string

A mensagem de erro.

VulnerabilityAssessmentScanRecord

Object

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

Name Tipo Description
id

string

ID do recurso.
name

string

Nome do recurso.
properties.endTime

string (date-time)

A hora de fim da verificação (UTC).
properties.errors

VulnerabilityAssessmentScanError[]

Os erros de verificação.
properties.numberOfFailedSecurityChecks

integer (int32)

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

string

O ID da digitalização.
properties.startTime

string (date-time)

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

VulnerabilityAssessmentScanState

O status da verificação.
properties.storageContainerPath

string

A verificação resulta do caminho do contêiner de armazenamento.
properties.triggerType

VulnerabilityAssessmentScanTriggerType

O tipo de gatilho de verificação.
type

string

Tipo de recurso.

VulnerabilityAssessmentScanRecordListResult

Object

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

Name Tipo Description
nextLink

string

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

VulnerabilityAssessmentScanRecord[]

Matriz de resultados.

VulnerabilityAssessmentScanState

Enumeração

O status da verificação.

Valor Description
Failed
FailedToRun
InProgress
Passed

VulnerabilityAssessmentScanTriggerType

Enumeração

O tipo de gatilho de verificação.

Valor Description
OnDemand
Recurring