Database 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 bazy danych.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/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.
databaseName	path	True	string	Nazwa bazy danych.
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	DatabaseAdvancedThreatProtection	Pomyślnie ustawiono stan zaawansowanej ochrony przed zagrożeniami bazy danych.
201 Created	DatabaseAdvancedThreatProtection	Pomyślnie utworzono stan zaawansowanej ochrony przed zagrożeniami bazy danych.
Other Status Codes		Odpowiedzi na błędy: *** 400 UpdateNotAllowedOnPausedDatabase — użytkownik próbował wykonać aktualizację wstrzymanej bazy danych. 400 AdvancedThreatProtectionInsufficientDiskSpace — za mało miejsca na dysku, aby zapisać metadane ustawień zaawansowanej ochrony przed zagrożeniami w bazie danych 400 InvalidDatabaseAdvancedThreatProtectionCreateRequest — żądanie tworzenia bazy danych Advanced Threat Protection nie istnieje lub nie ma obiektu właściwości 400 AdvancedThreatProtectionInvalidUserSuppliedParameter — klient podał nieprawidłową wartość parametru 400 UpsertDatabaseAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 400 UpsertDatabaseAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 DatabaseDoesNotExist — użytkownik określił nazwę bazy danych, która nie istnieje w tym wystąpieniu serwera. 404 UpsertDatabaseAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 409 DatabaseAdvancedThreatProtectionInProgress — ustawianie bazy danych Usługi Advanced Threat Protection jest już w toku 409 UpsertDatabaseAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 500 DatabaseIsUnavailable — ładowanie nie powiodło się. Spróbuj ponownie później. 500 UpsertDatabaseAdvancedThreatProtectionFailed — wystąpił błąd podczas zapisywania ustawień usługi Advanced Threat Protection. Spróbuj ponownie później 500 GetDatabaseAdvancedThreatProtectionFailed — nie można pobrać ustawień zaawansowanej ochrony przed zagrożeniami

Przykłady

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

Przykładowe żądanie

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

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

Kod stanu:

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

Przykładowe żądanie

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

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

Kod stanu:

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

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.
DatabaseAdvancedThreatProtection	Baza danych 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

DatabaseAdvancedThreatProtection

Baza danych 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.