Server Vulnerability Assessments - List By Server

Serviço:

SQL Database

Versão da API:

2021-11-01

Listas as políticas de avaliação de vulnerabilidade associadas a um servidor.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/vulnerabilityAssessments?api-version=2021-11-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
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.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Respostas

Nome	Tipo	Description
200 OK	ServerVulnerabilityAssessmentListResult	Recuperamos com êxito as políticas de avaliação de vulnerabilidade do servidor.
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 VulnerabilityAssessmentUnsupportedStorageAccount - A conta de armazenamento fornecida não tem suporte. 400 VulnerabilityAssessmentADSIsDisabled – Advanced Data Security deve ser habilitado para usar a Avaliação de Vulnerabilidade. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed – A conta de armazenamento não está na lista de Regras de Firewall de Saída. 400 VulnerabilityAssessmentInsufficientStorageAccountPermissions – permissões insuficientes na conta de armazenamento fornecida. 400 VulnerabilityAssessmentStorageAccountIsDisabled – a conta de armazenamento fornecida está desabilitada. 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado

Exemplos

Get a server's vulnerability assessment policies

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments?api-version=2021-11-01

Java

/**
 * Samples for ServerVulnerabilityAssessments ListByServer.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ServerVulnerabilityAssessmentListByServer.json
     */
    /**
     * Sample code: Get a server's vulnerability assessment policies.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAServerSVulnerabilityAssessmentPolicies(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerVulnerabilityAssessments().listByServer(
            "vulnerabilityaseessmenttest-4799", "vulnerabilityaseessmenttest-6440", 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 de exemplo

Código de status:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/",
      "name": "default",
      "type": "Microsoft.Sql/servers/vulnerabilityAssessments",
      "properties": {
        "recurringScans": {
          "isEnabled": true,
          "emailSubscriptionAdmins": true,
          "emails": [
            "email1@mail.com",
            "email2@mail.com"
          ]
        }
      }
    }
  ]
}

Definições

Nome	Description
ServerVulnerabilityAssessment	Uma avaliação de vulnerabilidade do servidor.
ServerVulnerabilityAssessmentListResult	Uma lista das avaliações de vulnerabilidade do servidor.
VulnerabilityAssessmentRecurringScansProperties	Propriedades de uma avaliação de vulnerabilidade de verificações recorrentes.

ServerVulnerabilityAssessment

Uma avaliação de vulnerabilidade do servidor.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.recurringScans	VulnerabilityAssessmentRecurringScansProperties	As configurações de verificações recorrentes
properties.storageAccountAccessKey	string	Especifica a chave de identificador da conta de armazenamento para resultados da verificação de avaliação de vulnerabilidade. Se 'StorageContainerSasKey' não for especificado, storageAccountAccessKey será necessário. Aplica-se somente se a conta de armazenamento não estiver atrás de uma Vnet ou um firewall
properties.storageContainerPath	string	Um caminho de contêiner de armazenamento de blobs para manter os resultados da verificação (por exemplo, https://myStorage.blob.core.windows.net/VaScans/).
properties.storageContainerSasKey	string	Uma assinatura de acesso compartilhado (Chave SAS) que tem acesso de gravação ao contêiner de blob especificado no parâmetro 'storageContainerPath'. Se 'storageAccountAccessKey' não for especificado, StorageContainerSasKey será necessário. Aplica-se somente se a conta de armazenamento não estiver atrás de uma Vnet ou um firewall
type	string	Tipo de recurso.

ServerVulnerabilityAssessmentListResult

Uma lista das avaliações de vulnerabilidade do servidor.

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

VulnerabilityAssessmentRecurringScansProperties

Propriedades de uma avaliação de vulnerabilidade de verificações recorrentes.

Nome	Tipo	Valor padrão	Description
emailSubscriptionAdmins	boolean	True	Especifica que a notificação de verificação de agendamento será enviada aos administradores da assinatura.
emails	string[]		Especifica uma matriz de endereços de email para os quais a notificação de verificação é enviada.
isEnabled	boolean		Estado de verificações recorrentes.