Database Advanced Threat Protection Settings - List By Database

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém uma lista dos estados de Proteção Avançada contra Ameaças do banco de dados.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/advancedThreatProtectionSettings?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.
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	DatabaseAdvancedThreatProtectionListResult	Recuperamos com êxito os estados de Proteção Avançada contra Ameaças do banco de dados.
Other Status Codes		Respostas de erro: *** 400 UpdateNotAllowedOnPausedDatabase – O usuário tentou executar uma atualização em um banco de dados em pausa. 400 AdvancedThreatProtectionInsufficientDiskSpace – Espaço em disco insuficiente para salvar os metadados de configurações da Proteção Avançada contra Ameaças no banco de dados 400 InvalidDatabaseAdvancedThreatProtectionCreateRequest - A solicitação criar proteção avançada contra ameaças do banco de dados não existe ou não tem nenhum objeto properties 400 AdvancedThreatProtectionInvalidUserSuppliedParameter - Um valor de parâmetro inválido foi fornecido pelo cliente 400 UpsertDatabaseAdvancedThreatProtectionFailed - Ocorreu um erro ao salvar as configurações de Proteção Avançada contra Ameaças, tente novamente mais tarde 400 UpsertDatabaseAdvancedThreatProtectionFailed - Ocorreu um erro ao salvar as configurações de Proteção Avançada contra Ameaças, tente novamente mais tarde 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado 404 DatabaseDoesNotExist – o usuário especificou um nome de banco de dados que não existe nesta instância do servidor. 404 UpsertDatabaseAdvancedThreatProtectionFailed - Ocorreu um erro ao salvar as configurações de Proteção Avançada contra Ameaças, tente novamente mais tarde 409 DatabaseAdvancedThreatProtectionInProgress – A definição da Proteção Avançada contra Ameaças do banco de dados já está em andamento 409 UpsertDatabaseAdvancedThreatProtectionFailed - Ocorreu um erro ao salvar as configurações da Proteção Avançada contra Ameaças, tente novamente mais tarde 500 DatabaseIsUnavailable – Falha no carregamento. Tente novamente mais tarde. 500 UpsertDatabaseAdvancedThreatProtectionFailed - Ocorreu um erro ao salvar as configurações de Proteção Avançada contra Ameaças, tente novamente mais tarde 500 GetDatabaseAdvancedThreatProtectionFailed – Falha ao obter configurações avançadas de Proteção contra Ameaças

Exemplos

Lists the database's Advanced Threat Protection settings.

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/threatprotection-6852/providers/Microsoft.Sql/servers/threatprotection-2080/databases/testdb/advancedThreatProtectionSettings?api-version=2021-11-01

Java

/**
 * Samples for DatabaseAdvancedThreatProtectionSettings ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * DatabaseAdvancedThreatProtectionSettingsListByDatabase.json
     */
    /**
     * Sample code: Lists the database's Advanced Threat Protection settings.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        listsTheDatabaseSAdvancedThreatProtectionSettings(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseAdvancedThreatProtectionSettings().listByDatabase(
            "threatprotection-6852", "threatprotection-2080", "testdb", 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/threatprotection-6852/providers/Microsoft.Sql/servers/threatprotection-2080/databases/testdb/advancedThreatProtectionSettings/Default",
      "name": "Default",
      "type": "Microsoft.Sql/servers/databases/advancedThreatProtectionSettings",
      "systemData": {
        "createdBy": "string",
        "createdByType": "User",
        "createdAt": "2022-04-03T04:41:33.937Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2022-04-03T04:41:33.937Z"
      },
      "properties": {
        "state": "Enabled",
        "creationTime": "2022-04-03T04:41:33.937Z"
      }
    }
  ]
}

Definições

Nome	Description
AdvancedThreatProtectionState	Especifica o estado da Proteção Avançada contra Ameaças, se ela está habilitada ou desabilitada ou um estado ainda não foi aplicado no banco de dados ou servidor específico.
createdByType	O tipo de identidade que criou o recurso.
DatabaseAdvancedThreatProtection	Um banco de dados Proteção Avançada contra Ameaças.
DatabaseAdvancedThreatProtectionListResult	Uma lista das configurações de Proteção Avançada contra Ameaças do banco de dados.
systemData	Metadados relativos à criação e à última modificação do recurso.

AdvancedThreatProtectionState

Especifica o estado da Proteção Avançada contra Ameaças, se ela está habilitada ou desabilitada ou um estado ainda não foi aplicado no banco de dados ou servidor específico.

Nome	Tipo	Description
Disabled	string
Enabled	string
New	string

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DatabaseAdvancedThreatProtection

Um banco de dados Proteção Avançada contra Ameaças.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.creationTime	string	Especifica a hora de criação utc da política.
properties.state	AdvancedThreatProtectionState	Especifica o estado da Proteção Avançada contra Ameaças, se ela está habilitada ou desabilitada ou um estado ainda não foi aplicado no banco de dados ou servidor específico.
systemData	systemData	SystemData de AdvancedThreatProtectionResource.
type	string	Tipo de recurso.

DatabaseAdvancedThreatProtectionListResult

Uma lista das configurações de Proteção Avançada contra Ameaças do banco de dados.

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

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.