Database Advanced Threat Protection Settings - Create Or Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Vytvoří nebo aktualizuje stav služby Advanced Threat Protection databáze.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
advancedThreatProtectionName	path	True	AdvancedThreatProtectionName	Název stavu Služby Advanced Threat Protection.
databaseName	path	True	string	Název databáze.
resourceGroupName	path	True	string	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Vyžadováno	Typ	Description
properties.state	True	AdvancedThreatProtectionState	Určuje stav rozšířené ochrany před internetovými útoky, jestli je povolená nebo zakázaná nebo jestli se na konkrétní databázi nebo serveru ještě nepoužádá.

Odpovědi

Name	Typ	Description
200 OK	DatabaseAdvancedThreatProtection	Stav Advanced Threat Protection pro databázi se úspěšně nastavil.
201 Created	DatabaseAdvancedThreatProtection	Databáze se úspěšně vytvořila ve stavu Advanced Threat Protection.
Other Status Codes		Chybové odpovědi: *** 400 UpdateNotAllowedOnPausedDatabase – uživatel se pokusil provést aktualizaci pozastavené databáze. 400 AdvancedThreatProtectionInsufficientDiskSpace – nedostatek místa na disku k uložení metadat nastavení Advanced Threat Protection v databázi 400 InvalidDatabaseAdvancedThreatProtectionCreateRequest – Požadavek Advanced Threat Protection na vytvoření databáze neexistuje nebo nemá žádný objekt properties. 400 AdvancedThreatProtectionInvalidUserSuppliedParameter – klient zadal neplatnou hodnotu parametru. 400 UpsertDatabaseAdvancedThreatProtectionFailed – Při ukládání nastavení Advanced Threat Protection došlo k chybě. Zkuste to prosím znovu později. 400 UpsertDatabaseAdvancedThreatProtectionFailed – Při ukládání nastavení Advanced Threat Protection došlo k chybě. Zkuste to prosím znovu později. 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel. 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který na této instanci serveru neexistuje. 404 UpsertDatabaseAdvancedThreatProtectionFailed – Při ukládání nastavení Advanced Threat Protection došlo k chybě. Zkuste to prosím znovu později. 409 DatabaseAdvancedThreatProtectionInProgress – nastavení rozšířené ochrany před internetovými útoky v databázi už probíhá. 409 UpsertDatabaseAdvancedThreatProtectionFailed – Při ukládání nastavení Advanced Threat Protection došlo k chybě. Zkuste to prosím znovu později. 500 DatabaseIsUnavailable – Načtení se nezdařilo. Zkuste to později. 500 UpsertDatabaseAdvancedThreatProtectionFailed – při ukládání nastavení Advanced Threat Protection došlo k chybě. Zkuste to prosím znovu později. 500 GetDatabaseAdvancedThreatProtectionFailed – Nepodařilo se získat nastavení Advanced Threat Protection

Příklady

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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

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

Definice

Name	Description
AdvancedThreatProtectionName	Název stavu Služby Advanced Threat Protection.
AdvancedThreatProtectionState	Určuje stav rozšířené ochrany před internetovými útoky, jestli je povolená nebo zakázaná nebo jestli se na konkrétní databázi nebo serveru ještě nepoužádá.
createdByType	Typ identity, která prostředek vytvořila.
DatabaseAdvancedThreatProtection	Databáze Advanced Threat Protection.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

AdvancedThreatProtectionName

Název stavu Služby Advanced Threat Protection.

Name	Typ	Description
Default	string

AdvancedThreatProtectionState

Určuje stav rozšířené ochrany před internetovými útoky, jestli je povolená nebo zakázaná nebo jestli se na konkrétní databázi nebo serveru ještě nepoužádá.

Name	Typ	Description
Disabled	string
Enabled	string
New	string

createdByType

Typ identity, která prostředek vytvořila.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DatabaseAdvancedThreatProtection

Databáze Advanced Threat Protection.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.creationTime	string	Určuje čas vytvoření zásady v UTC.
properties.state	AdvancedThreatProtectionState	Určuje stav rozšířené ochrany před internetovými útoky, jestli je povolená nebo zakázaná nebo jestli se na konkrétní databázi nebo serveru ještě nepoužádá.
systemData	systemData	SystemData z AdvancedThreatProtectionResource.
type	string	Typ prostředku.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string	Časové razítko vytvoření prostředku (UTC)
createdBy	string	Identita, která vytvořila prostředek.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string	Časové razítko poslední změny prostředku (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.