Server Advanced Threat Protection Settings - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/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 do Advanced Threat Protection.
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.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Necessário	Tipo	Description
properties.state	True	AdvancedThreatProtectionState	Especifica o estado do Advanced Threat Protection, quer esteja ativado ou desativado ou se ainda não foi aplicado um estado na base de dados ou servidor específico.

Respostas

Name	Tipo	Description
200 OK	ServerAdvancedThreatProtection	Criou ou atualizou com êxito o estado do Advanced Threat Protection.
202 Accepted		Foi criado um pedido para definir o estado do Advanced Threat Protection.
Other Status Codes		Respostas de Erro: *** 400 UpdateNotAllowedOnServerContainingPausedDWDatabase - A definição das definições de Proteção Avançada contra Ameaças do servidor não é permitida num servidor com uma base de dados de Data Warehouse em pausa 400 AdvancedThreatProtectionInsufficientDiskSpace - Espaço em disco insuficiente para guardar os metadados das definições do Advanced Threat Protection na base de dados 400 InvalidServerAdvancedThreatProtectionCreateRequest - O pedido de criação do servidor Advanced Threat Protection não existe ou não tem nenhum objeto de propriedades 400 AdvancedThreatProtectionInvalidUserSuppliedParameter – foi fornecido um valor de parâmetro inválido pelo cliente 400 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde 400 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde 404 OperationIdNotFound - A operação com o ID não existe. 409 ServerAdvancedThreatProtectionInProgress - Definição de que as definições de Proteção Avançada contra Ameaças do servidor já estão em curso 409 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 500 DatabaseIsUnavailable - O carregamento falhou. Tente novamente mais tarde. 500 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde 500 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

Name

Tipo

Description

200 OK

ServerAdvancedThreatProtection

Criou ou atualizou com êxito o estado do Advanced Threat Protection.

202 Accepted

Foi criado um pedido para definir o estado do Advanced Threat Protection.

Other Status Codes

Respostas de Erro: ***

400 UpdateNotAllowedOnServerContainingPausedDWDatabase - A definição das definições de Proteção Avançada contra Ameaças do servidor não é permitida num servidor com uma base de dados de Data Warehouse em pausa
400 AdvancedThreatProtectionInsufficientDiskSpace - Espaço em disco insuficiente para guardar os metadados das definições do Advanced Threat Protection na base de dados
400 InvalidServerAdvancedThreatProtectionCreateRequest - O pedido de criação do servidor Advanced Threat Protection não existe ou não tem nenhum objeto de propriedades
400 AdvancedThreatProtectionInvalidUserSuppliedParameter – foi fornecido um valor de parâmetro inválido pelo cliente
400 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde
400 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde
404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado
404 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde
404 OperationIdNotFound - A operação com o ID não existe.
409 ServerAdvancedThreatProtectionInProgress - Definição de que as definições de Proteção Avançada contra Ameaças do servidor já estão em curso
409 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde
409 OperationCancelled - A operação foi cancelada pelo utilizador.
409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso.
429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.
429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.
500 DatabaseIsUnavailable - O carregamento falhou. Tente novamente mais tarde.
500 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde
500 UpsertServerAdvancedThreatProtectionFailed - Ocorreu um erro ao guardar as definições do Advanced Threat Protection. Tente novamente mais tarde
500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação.
503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

Exemplos

Update a server's Advanced Threat Protection settings with all parameters.

Update a server's Advanced Threat Protection settings with minimal parameters.

Update a server'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/advancedThreatProtectionSettings/Default?api-version=2021-11-01

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


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

/**
 * Samples for ServerAdvancedThreatProtectionSettings CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ServerAdvancedThreatProtectionSettingsCreateMax.json
     */
    /**
     * Sample code: Update a server's Advanced Threat Protection settings with all parameters.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAServerSAdvancedThreatProtectionSettingsWithAllParameters(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAdvancedThreatProtectionSettings().createOrUpdate(
            "threatprotection-4799", "threatprotection-6440", AdvancedThreatProtectionName.DEFAULT,
            new ServerAdvancedThreatProtectionInner().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/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:: 202

Update a server's Advanced Threat Protection settings with minimal parameters.

Pedido de amostra

HTTP
Java

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

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


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

/**
 * Samples for ServerAdvancedThreatProtectionSettings CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ServerAdvancedThreatProtectionSettingsCreateMin.json
     */
    /**
     * Sample code: Update a server's Advanced Threat Protection settings with minimal parameters.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAServerSAdvancedThreatProtectionSettingsWithMinimalParameters(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAdvancedThreatProtectionSettings().createOrUpdate(
            "threatprotection-4799", "threatprotection-6440", AdvancedThreatProtectionName.DEFAULT,
            new ServerAdvancedThreatProtectionInner().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/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:: 202

Definições

Name	Description
AdvancedThreatProtectionName	O nome do estado do Advanced Threat Protection.
AdvancedThreatProtectionState	Especifica o estado do Advanced Threat Protection, quer esteja ativado ou desativado ou se ainda não foi aplicado um estado na base de dados ou servidor específico.
createdByType	O tipo de identidade que criou o recurso.
ServerAdvancedThreatProtection	Um servidor advanced threat protection.
systemData	Metadados relativos à criação e última modificação do recurso.

AdvancedThreatProtectionName

O nome do estado do Advanced Threat Protection.

Name	Tipo	Description
Default	string

AdvancedThreatProtectionState

Especifica o estado do Advanced Threat Protection, quer esteja ativado ou desativado ou se ainda não foi aplicado um estado na base de dados ou servidor específico.

Name	Tipo	Description
Disabled	string
Enabled	string
New	string

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string