Database Advanced Threat Protection Settings - Create Or Update

Referência

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 de URI

Nome	Em	Obrigatório	Tipo	Description
advancedThreatProtectionName	path	True	AdvancedThreatProtectionName	O nome do estado de 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 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.

Corpo da solicitação

Nome	Obrigató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 um estado ainda não foi aplicado no banco de dados ou servidor específico.

Respostas

Nome	Tipo	Description
200 OK	DatabaseAdvancedThreatProtection	Defina com êxito o estado de Proteção Avançada contra Ameaças do banco de dados.
201 Created	DatabaseAdvancedThreatProtection	Criou 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 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

Nome

Tipo

Description

200 OK

DatabaseAdvancedThreatProtection

Defina com êxito o estado de Proteção Avançada contra Ameaças do banco de dados.

201 Created

DatabaseAdvancedThreatProtection

Criou 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 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

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

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


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 de exemplo

Código de status:: 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 status:: 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

Solicitação de exemplo

HTTP
Java

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


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 de exemplo

Código de status:: 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 status:: 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

Nome	Description
AdvancedThreatProtectionName	O nome do estado de 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 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.
systemData	Metadados relativos à criação e à última modificação do recurso.

AdvancedThreatProtectionName

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

Nome	Tipo	Description
Default	string

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