Managed Database Vulnerability Assessment Scans - List By Database

Referência

Service:: SQL Database

API Version:: 2021-11-01

Listas 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 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.
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	VulnerabilityAssessmentScanRecordListResult	Recuperamos 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 habilitado 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á em pausa. 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 de servidor. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - A verificação da Avaliação de Vulnerabilidade já está em andamento. 500 DatabaseIsUnavailable – Falha ao carregar. Tente novamente mais tarde.

Nome

Tipo

Description

200 OK

VulnerabilityAssessmentScanRecordListResult

Recuperamos 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 habilitado 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á em pausa. 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 de servidor.
409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - A verificação da Avaliação de Vulnerabilidade já está em andamento.
500 DatabaseIsUnavailable – Falha ao carregar. 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/managedInstances/vulnerabilityassessmenttest-6411/databases/testdb/vulnerabilityAssessments/default/scans?api-version=2021-11-01


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.VulnerabilityAssessmentName;

/** Samples for ManagedDatabaseVulnerabilityAssessmentScans ListByDatabase. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseVulnerabilityAssessmentScanRecordsListByDatabase.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().getManagedDatabaseVulnerabilityAssessmentScans().listByDatabase(
            "vulnerabilityassessmenttest-4711", "vulnerabilityassessmenttest-6411", "testdb",
            VulnerabilityAssessmentName.DEFAULT, 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

Sample Response

Status code:: 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

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.
VulnerabilityAssessmentScanRecordListResult	Uma lista de registros de verificação de avaliação de vulnerabilidade.
VulnerabilityAssessmentScanState	A verificação status.
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	A verificação status.
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.

VulnerabilityAssessmentScanRecordListResult

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

Nome	Tipo	Description
nextLink	string	Link para recuperar a próxima página de resultados.
value	VulnerabilityAssessmentScanRecord[]	Matriz de resultados.

VulnerabilityAssessmentScanState

A verificação status.

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

Share via

Managed Database Vulnerability Assessment Scans - List By Database

Parâmetros de URI

Respostas

Exemplos

Gets the list of a database vulnerability assessment scan records

Sample Request

Sample Response

Definições

VulnerabilityAssessmentName

VulnerabilityAssessmentScanError

VulnerabilityAssessmentScanRecord

VulnerabilityAssessmentScanRecordListResult

VulnerabilityAssessmentScanState

VulnerabilityAssessmentScanTriggerType

Recursos adicionais