Server Advanced Threat Protection Settings - Create Or Update

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Tworzy lub aktualizuje stan zaawansowanej ochrony przed zagrożeniami.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
advancedThreatProtectionName	path	True	AdvancedThreatProtectionName	Nazwa stanu zaawansowanej ochrony przed zagrożeniami.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Wymagane	Typ	Opis
properties.state	True	AdvancedThreatProtectionState	Określa stan zaawansowanej ochrony przed zagrożeniami, niezależnie od tego, czy jest włączony, czy wyłączony, czy stan nie został jeszcze zastosowany na określonej bazie danych lub serwerze.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ServerAdvancedThreatProtection	Pomyślnie utworzono lub zaktualizowano stan zaawansowanej ochrony przed zagrożeniami.
202 Accepted		Utworzono żądanie ustawiania stanu zaawansowanej ochrony przed zagrożeniami.
Other Status Codes		Odpowiedzi na błędy: *** 400 UpdateNotAllowedOnServerContainingPausedDWDatabase — ustawienie ustawień zaawansowanej ochrony przed zagrożeniami na serwerze z wstrzymaną bazą danych Data Warehouse 400 AdvancedThreatProtectionInsufficientDiskSpace — za mało miejsca na dysku, aby zapisać metadane ustawień zaawansowanej ochrony przed zagrożeniami w bazie danych 400 InvalidServerAdvancedThreatProtectionCreateRequest — żądanie tworzenia serwera Advanced Threat Protection nie istnieje lub nie ma obiektu właściwości 400 AdvancedThreatProtectionInvalidUserSuppliedParameter — klient podał nieprawidłową wartość parametru 400 UpsertServerAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 400 UpsertServerAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 UpsertServerAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 409 ServerAdvancedThreatProtectionInProgress — ustawianie ustawień zaawansowanej ochrony przed zagrożeniami serwera jest już w toku 409 UpsertServerAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 500 DatabaseIsUnavailable — ładowanie nie powiodło się. Spróbuj ponownie później. 500 UpsertServerAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 500 UpsertServerAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

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.

Przykładowe żądanie

HTTP

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

Java

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

Przykładowa odpowiedź

Kod stanu:

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

Kod stanu:

202

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

Przykładowe żądanie

HTTP

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

Java

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

Przykładowa odpowiedź

Kod stanu:

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

Kod stanu:

202

Definicje

Nazwa	Opis
AdvancedThreatProtectionName	Nazwa stanu zaawansowanej ochrony przed zagrożeniami.
AdvancedThreatProtectionState	Określa stan zaawansowanej ochrony przed zagrożeniami, niezależnie od tego, czy jest włączony, czy wyłączony, czy stan nie został jeszcze zastosowany na określonej bazie danych lub serwerze.
createdByType	Typ tożsamości, która utworzyła zasób.
ServerAdvancedThreatProtection	Serwer Advanced Threat Protection.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AdvancedThreatProtectionName

Nazwa stanu zaawansowanej ochrony przed zagrożeniami.

Nazwa	Typ	Opis
Default	string

AdvancedThreatProtectionState

Określa stan zaawansowanej ochrony przed zagrożeniami, niezależnie od tego, czy jest włączony, czy wyłączony, czy stan nie został jeszcze zastosowany na określonej bazie danych lub serwerze.

Nazwa	Typ	Opis
Disabled	string
Enabled	string
New	string

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

ServerAdvancedThreatProtection

Serwer Advanced Threat Protection.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.creationTime	string	Określa czas tworzenia zasad w formacie UTC.
properties.state	AdvancedThreatProtectionState	Określa stan zaawansowanej ochrony przed zagrożeniami, niezależnie od tego, czy jest włączony, czy wyłączony, czy stan nie został jeszcze zastosowany na określonej bazie danych lub serwerze.
systemData	systemData	SystemData elementu AdvancedThreatProtectionResource.
type	string	Typ zasobu.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.