Database Advanced Threat Protection Settings - Create Or Update

Serviço:

SQL Database

Versão da API:

2021-11-01

Cria ou atualiza o estado de Proteção Avançada contra Ameaças de um banco de dados.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/advancedThreatProtectionSettings/Default?api-version=2021-11-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
advancedThreatProtectionName	path	True	AdvancedThreatProtectionName	O nome do estado Proteção Avançada contra Ameaças.
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 da API do Azure Resource Manager ou 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.

Corpo do Pedido

Name	Necessário	Tipo	Description
properties.state	True	AdvancedThreatProtectionState	Especifica o estado da Proteção Avançada contra Ameaças, se ela está habilitada ou desabilitada ou se um estado ainda não foi aplicado no banco de dados ou servidor específico.

Respostas

Name	Tipo	Description
200 OK	DatabaseAdvancedThreatProtection	Defina com êxito o estado da Proteção Avançada contra Ameaças do banco de dados.
201 Created	DatabaseAdvancedThreatProtection	Criado com êxito o estado 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 pausado. 400 AdvancedThreatProtectionInsufficientDiskSpace - Espaço em disco insuficiente para salvar os metadados das configurações da Proteção Avançada contra Ameaças no banco de dados 400 InvalidDatabaseAdvancedThreatProtectionCreateRequest - A solicitação de criação de banco de dados Proteção Avançada contra Ameaças não existe ou não tem nenhum objeto de propriedades 400 AdvancedThreatProtectionInvalidUserSuppliedParameter - Um valor de parâmetro inválido foi fornecido pelo cliente 400 UpsertDatabaseAdvancedThreatProtectionFailed - Ocorreu um erro ao salvar as configurações da Proteção Avançada contra Ameaças, tente novamente mais tarde 400 UpsertDatabaseAdvancedThreatProtectionFailed - Ocorreu um erro ao salvar as configurações da 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 da Proteção Avançada contra Ameaças, tente novamente mais tarde 409 DatabaseAdvancedThreatProtectionInProgress - A configuração do banco de dados Advanced Threat Protection 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 ao carregar. Tente novamente mais tarde. 500 UpsertDatabaseAdvancedThreatProtectionFailed - Ocorreu um erro ao salvar as configurações da Proteção Avançada contra Ameaças, tente novamente mais tarde 500 GetDatabaseAdvancedThreatProtectionFailed - Falha ao obter as configurações de Proteção Avançada contra Ameaças

Exemplos

Update a database's Advanced Threat Protection settings with all parameters

Update a database's Advanced Threat Protection settings with minimal parameters

Update a database's Advanced Threat Protection settings with all parameters

Pedido de amostra

HTTP

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

{
  "properties": {
    "state": "Enabled"
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.DatabaseAdvancedThreatProtectionInner;
import com.azure.resourcemanager.sql.models.AdvancedThreatProtectionName;
import com.azure.resourcemanager.sql.models.AdvancedThreatProtectionState;

/**
 * Samples for DatabaseAdvancedThreatProtectionSettings CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * DatabaseAdvancedThreatProtectionSettingsCreateMax.json
     */
    /**
     * Sample code: Update a database's Advanced Threat Protection settings with all parameters.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateADatabaseSAdvancedThreatProtectionSettingsWithAllParameters(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseAdvancedThreatProtectionSettings()
            .createOrUpdateWithResponse("threatprotection-4799", "threatprotection-6440", "testdb",
                AdvancedThreatProtectionName.DEFAULT,
                new DatabaseAdvancedThreatProtectionInner().withState(AdvancedThreatProtectionState.ENABLED),
                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/threatprotection-4799/providers/Microsoft.Sql/servers/threatprotection-6440/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"
  }
}

Código de estado:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/threatprotection-4799/providers/Microsoft.Sql/servers/threatprotection-6440/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"
  }
}

Update a database's Advanced Threat Protection settings with minimal parameters

Pedido de amostra

HTTP

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

{
  "properties": {
    "state": "Disabled"
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.DatabaseAdvancedThreatProtectionInner;
import com.azure.resourcemanager.sql.models.AdvancedThreatProtectionName;
import com.azure.resourcemanager.sql.models.AdvancedThreatProtectionState;

/**
 * Samples for DatabaseAdvancedThreatProtectionSettings CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * DatabaseAdvancedThreatProtectionSettingsCreateMin.json
     */
    /**
     * Sample code: Update a database's Advanced Threat Protection settings with minimal parameters.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateADatabaseSAdvancedThreatProtectionSettingsWithMinimalParameters(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseAdvancedThreatProtectionSettings()
            .createOrUpdateWithResponse("threatprotection-4799", "threatprotection-6440", "testdb",
                AdvancedThreatProtectionName.DEFAULT,
                new DatabaseAdvancedThreatProtectionInner().withState(AdvancedThreatProtectionState.DISABLED),
                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/threatprotection-4799/providers/Microsoft.Sql/servers/threatprotection-6440/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": "Disabled",
    "creationTime": "2022-04-03T04:41:33.937Z"
  }
}

Código de estado:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/threatprotection-4799/providers/Microsoft.Sql/servers/threatprotection-6440/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": "Disabled",
    "creationTime": "2022-04-03T04:41:33.937Z"
  }
}

Definições

Name	Description
AdvancedThreatProtectionName	O nome do estado Proteção Avançada contra Ameaças.
AdvancedThreatProtectionState	Especifica o estado da Proteção Avançada contra Ameaças, se ela está habilitada ou desabilitada ou se 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	Uma Base de Dados de Proteção Avançada contra Ameaças.
systemData	Metadados referentes à criação e última modificação do recurso.

AdvancedThreatProtectionName

Enumeração

O nome do estado Proteção Avançada contra Ameaças.

Valor	Description
Default

AdvancedThreatProtectionState

Enumeração

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

Valor	Description
Disabled
Enabled
New

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

DatabaseAdvancedThreatProtection

Object

Uma Base de Dados de Proteção Avançada contra Ameaças.

Name	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.creationTime	string (date-time)	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 se 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.

systemData

Object

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

Name	Tipo	Description
createdAt	string (date-time)	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 (date-time)	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.