Database Vulnerability Assessment Scans - List By Database

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Listas as análises de avaliação de vulnerabilidades de uma base de dados.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/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 da base de dados.
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.
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	O nome da avaliação de vulnerabilidades.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Respostas

Name	Tipo	Description
200 OK	VulnerabilityAssessmentScanRecordListResult	Os registos de análise da avaliação de vulnerabilidades da base de dados foram obtidos 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 VulnerabilityAssessmentInvalidPolicy – as definições de Avaliação de Vulnerabilidades não existem ou o armazenamento inválido especificado nas definições. 400 VulnerabilityAssessmentADSIsDisabled – o Advanced Data Security deve ser ativado para utilizar a Avaliação de Vulnerabilidades. 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath – o caminho do contentor de armazenamento tem de ser fornecido se não estiver definido na política ao nível do servidor 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated – não foi possível executar a operação de Avaliação de Vulnerabilidades porque a base 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 pedido não foi encontrado 404 SourceDatabaseNotFound – a base de dados de origem não existe. 404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – A análise da Avaliação de Vulnerabilidades já está em curso. 500 DatabaseIsUnavailable – O carregamento falhou. Tente novamente mais tarde.

Name

Tipo

Description

200 OK

VulnerabilityAssessmentScanRecordListResult

Os registos de análise da avaliação de vulnerabilidades da base de dados foram obtidos 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 VulnerabilityAssessmentInvalidPolicy – as definições de Avaliação de Vulnerabilidades não existem ou o armazenamento inválido especificado nas definições.
400 VulnerabilityAssessmentADSIsDisabled – o Advanced Data Security deve ser ativado para utilizar a Avaliação de Vulnerabilidades.
400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath – o caminho do contentor de armazenamento tem de ser fornecido se não estiver definido na política ao nível do servidor
400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated – não foi possível executar a operação de Avaliação de Vulnerabilidades porque a base 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 pedido não foi encontrado
404 SourceDatabaseNotFound – a base de dados de origem não existe.
404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor.
409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – A análise da Avaliação de Vulnerabilidades já está em curso.
500 DatabaseIsUnavailable – O carregamento falhou. Tente novamente mais tarde.

Exemplos

Gets the list of a database vulnerability assessment scan records

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


import com.azure.resourcemanager.sql.models.VulnerabilityAssessmentName;

/**
 * Samples for DatabaseVulnerabilityAssessmentScans ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * DatabaseVulnerabilityAssessmentScanRecordsListByDatabase.json
     */
    /**
     * Sample code: Gets the list of a database vulnerability assessment scan records.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsTheListOfADatabaseVulnerabilityAssessmentScanRecords(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseVulnerabilityAssessmentScans().listByDatabase(
            "vulnerabilityassessmenttest-4711", "vulnerabilityassessmenttest-6411", "testdb",
            VulnerabilityAssessmentName.DEFAULT, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta da amostra

Código de estado:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/servers/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/servers/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/servers/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 vulnerabilidades.
VulnerabilityAssessmentScanError	Propriedades de um erro de análise de avaliação de vulnerabilidades.
VulnerabilityAssessmentScanRecord	Um registo de análise de avaliação de vulnerabilidades.
VulnerabilityAssessmentScanRecordListResult	Uma lista de registos de análise de avaliação de vulnerabilidades.
VulnerabilityAssessmentScanState	O estado da análise.
VulnerabilityAssessmentScanTriggerType	O tipo de acionador de análise.

VulnerabilityAssessmentName

Enumeration

O nome da avaliação de vulnerabilidades.

Valor	Description
default

VulnerabilityAssessmentScanError

Object

Propriedades de um erro de análise de avaliação de vulnerabilidades.

Name	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.

VulnerabilityAssessmentScanRecord

Object

Um registo de análise de avaliação de vulnerabilidades.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.endTime	string	A hora de fim da análise (UTC).
properties.errors	VulnerabilityAssessmentScanError[]	Os erros de análise.
properties.numberOfFailedSecurityChecks	integer	O número de verificações de segurança falhadas.
properties.scanId	string	O ID da análise.
properties.startTime	string	A hora de início da análise (UTC).
properties.state	VulnerabilityAssessmentScanState	O estado da análise.
properties.storageContainerPath	string	O caminho do contentor de armazenamento dos resultados da análise.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	O tipo de acionador de análise.
type	string	Tipo de recurso.

VulnerabilityAssessmentScanRecordListResult

Object

Uma lista de registos de análise de avaliação de vulnerabilidades.

Name	Tipo	Description
nextLink	string	Ligação para obter a página seguinte dos resultados.
value	VulnerabilityAssessmentScanRecord[]	Matriz de resultados.

VulnerabilityAssessmentScanState

Enumeration

O estado da análise.

Valor	Description
Failed
FailedToRun
InProgress
Passed

VulnerabilityAssessmentScanTriggerType

Enumeration

O tipo de acionador de análise.

Valor	Description
OnDemand
Recurring

Partilhar via

Database Vulnerability Assessment Scans - List By Database

Parâmetros do URI

Respostas

Exemplos

Gets the list of a database vulnerability assessment scan records

Pedido de amostra

Resposta da amostra

Definições

VulnerabilityAssessmentName

VulnerabilityAssessmentScanError

VulnerabilityAssessmentScanRecord

VulnerabilityAssessmentScanRecordListResult

VulnerabilityAssessmentScanState

VulnerabilityAssessmentScanTriggerType

Recursos adicionais