Server Advanced Threat Protection Settings - Create Or Update

Referencia

Servicio:: SQL Database

Versión de la API:: 2021-11-01

Crea o actualiza un estado de Advanced Threat Protection.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
advancedThreatProtectionName	path	True	AdvancedThreatProtectionName	Nombre del estado advanced Threat Protection.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
serverName	path	True	string	El nombre del servidor.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.state	True	AdvancedThreatProtectionState	Especifica el estado de Advanced Threat Protection, tanto si está habilitado como deshabilitado o si aún no se ha aplicado un estado en la base de datos o servidor específico.

Respuestas

Nombre	Tipo	Description
200 OK	ServerAdvancedThreatProtection	Se ha creado o actualizado correctamente el estado de Advanced Threat Protection.
202 Accepted		Solicitud creada para establecer el estado de Advanced Threat Protection.
Other Status Codes		Respuestas de error: *** 400 UpdateNotAllowedOnServerContainingPausedDWDatabase: no se permite establecer la configuración de Advanced Threat Protection del servidor en un servidor con una base de datos de Data Warehouse en pausa 400 AdvancedThreatProtectionInsufficientDiskSpace: espacio en disco insuficiente para ahorrar los metadatos de configuración de Advanced Threat Protection en la base de datos 400 InvalidServerAdvancedThreatProtectionCreateRequest: la solicitud de protección contra amenazas avanzada del servidor de creación no existe o no tiene ningún objeto properties 400 AdvancedThreatProtectionInvalidUserSuppliedParameter: el cliente proporcionó un valor de parámetro no válido. 400 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde. 400 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado 404 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde. 404 OperationIdNotFound: la operación con id. no existe. 409 ServerAdvancedThreatProtectionInProgress: el establecimiento de la configuración de Advanced Threat Protection del servidor ya está en curso 409 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde. 409 OperationCancelled: el usuario ha cancelado la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 500 DatabaseIsUnavailable: error al cargar. Vuelva a intentarlo más tarde. 500 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde. 500 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde. 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación y, 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

Nombre

Tipo

Description

200 OK

ServerAdvancedThreatProtection

Se ha creado o actualizado correctamente el estado de Advanced Threat Protection.

202 Accepted

Solicitud creada para establecer el estado de Advanced Threat Protection.

Other Status Codes

Respuestas de error: ***

400 UpdateNotAllowedOnServerContainingPausedDWDatabase: no se permite establecer la configuración de Advanced Threat Protection del servidor en un servidor con una base de datos de Data Warehouse en pausa
400 AdvancedThreatProtectionInsufficientDiskSpace: espacio en disco insuficiente para ahorrar los metadatos de configuración de Advanced Threat Protection en la base de datos
400 InvalidServerAdvancedThreatProtectionCreateRequest: la solicitud de protección contra amenazas avanzada del servidor de creación no existe o no tiene ningún objeto properties
400 AdvancedThreatProtectionInvalidUserSuppliedParameter: el cliente proporcionó un valor de parámetro no válido.
400 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde.
400 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde.
404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado
404 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde.
404 OperationIdNotFound: la operación con id. no existe.
409 ServerAdvancedThreatProtectionInProgress: el establecimiento de la configuración de Advanced Threat Protection del servidor ya está en curso
409 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde.
409 OperationCancelled: el usuario ha cancelado la operación.
409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso.
429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.
429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.
500 DatabaseIsUnavailable: error al cargar. Vuelva a intentarlo más tarde.
500 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde.
500 UpsertServerAdvancedThreatProtectionFailed: error al guardar la configuración de Advanced Threat Protection, inténtelo de nuevo más tarde.
500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación y,
503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

Ejemplos

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

Respuesta de muestra

status code:: 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"
  }
}

status code:: 202

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

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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"
  }
}

status code:: 202

Definiciones

Nombre	Description
AdvancedThreatProtectionName	Nombre del estado advanced Threat Protection.
AdvancedThreatProtectionState	Especifica el estado de Advanced Threat Protection, tanto si está habilitado como deshabilitado o si aún no se ha aplicado un estado en la base de datos o servidor específico.
createdByType	Tipo de identidad que creó el recurso.
ServerAdvancedThreatProtection	Un servidor Advanced Threat Protection.
systemData	Metadatos relacionados con la creación y la última modificación del recurso.

AdvancedThreatProtectionName

Enumeration

Nombre del estado advanced Threat Protection.

Valor	Description
Default

AdvancedThreatProtectionState

Enumeration

Especifica el estado de Advanced Threat Protection, tanto si está habilitado como deshabilitado o si aún no se ha aplicado un estado en la base de datos o servidor específico.

Valor	Description
Disabled
Enabled
New

createdByType

Enumeration

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User