Managed Database Vulnerability Assessment Scans - Get

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém um registo de análise de avaliação de vulnerabilidades de uma base 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 do URI

Name	Em	Necessário	Tipo	Description
databaseName	path	True	string	O nome da base de dados.
managedInstanceName	path	True	string	O nome da instância gerida.
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.
scanId	path	True	string	O ID de análise da avaliação de vulnerabilidades da análise a obter.
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	VulnerabilityAssessmentScanRecord	O registo de análise da avaliação de vulnerabilidades da base de dados foi obtido 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 a database vulnerability assessment scan record by scan ID

Pedido de amostra

HTTP

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

Java

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

/**
 * Samples for ManagedDatabaseVulnerabilityAssessmentScans Get.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseVulnerabilityAssessmentScanRecordsGet.json
     */
    /**
     * Sample code: Gets a database vulnerability assessment scan record by scan ID.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsADatabaseVulnerabilityAssessmentScanRecordByScanID(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseVulnerabilityAssessmentScans().getWithResponse(
            "vulnerabilityassessmenttest-4711", "vulnerabilityassessmenttest-6411", "testdb",
            VulnerabilityAssessmentName.DEFAULT, "scan001", 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

{
  "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

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.
VulnerabilityAssessmentScanState	O estado da análise.
VulnerabilityAssessmentScanTriggerType	O tipo de acionador de análise.

VulnerabilityAssessmentName

O nome da avaliação de vulnerabilidades.

Name	Tipo	Description
default	string

VulnerabilityAssessmentScanError

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

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.

VulnerabilityAssessmentScanState

O estado da análise.

Name	Tipo	Description
Failed	string
FailedToRun	string
InProgress	string
Passed	string

VulnerabilityAssessmentScanTriggerType

O tipo de acionador de análise.

Name	Tipo	Description
OnDemand	string
Recurring	string