Database Advanced Threat Protection Settings - Create Or Update

リファレンス

サービス:: SQL Database

API バージョン:: 2021-11-01

データベースの Advanced Threat Protection 状態を作成または更新します。

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

URI パラメーター

名前	/	必須	型	説明
advancedThreatProtectionName	path	True	AdvancedThreatProtectionName	Advanced Threat Protection 状態の名前。
databaseName	path	True	string	データベースの名前。
resourceGroupName	path	True	string	リソースを含むリソースグループの名前。この値は、Azure Resource Manager API またはポータルから取得できます。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求に使用する API バージョン。

要求本文

名前	必須	型	説明
properties.state	True	AdvancedThreatProtectionState	Advanced Threat Protection の状態を指定します。有効か無効か、特定のデータベースまたはサーバーに状態がまだ適用されていません。

応答

名前	型	説明
200 OK	DatabaseAdvancedThreatProtection	データベースの Advanced Threat Protection の状態を正常に設定しました。
201 Created	DatabaseAdvancedThreatProtection	データベース Advanced Threat Protection の状態が正常に作成されました。
Other Status Codes		エラー応答: *** 400 UpdateNotAllowedOnPausedDatabase - ユーザーが一時停止しているデータベースで更新を実行しようとしました。 400 AdvancedThreatProtectionInsufficientDiskSpace - Advanced Threat Protection 設定メタデータをデータベースに保存するためのディスク領域が不足しています 400 InvalidDatabaseAdvancedThreatProtectionCreateRequest - データベースの作成 Advanced Threat Protection 要求が存在しないか、プロパティオブジェクトがありません 400 AdvancedThreatProtectionInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました 400 UpsertDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください 400 UpsertDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。 404 UpsertDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度やり直してください 409 DatabaseAdvancedThreatProtectionInProgress - Advanced Threat Protection データベースの設定は既に進行中です 409 UpsertDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度やり直してください 500 DatabaseIsUnavailable - 読み込みに失敗しました。後でもう一度やり直してください。 500 UpsertDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください 500 GetDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定を取得できませんでした

名前

型

説明

200 OK

DatabaseAdvancedThreatProtection

データベースの Advanced Threat Protection の状態を正常に設定しました。

201 Created

DatabaseAdvancedThreatProtection

データベース Advanced Threat Protection の状態が正常に作成されました。

Other Status Codes

エラー応答: ***

400 UpdateNotAllowedOnPausedDatabase - ユーザーが一時停止しているデータベースで更新を実行しようとしました。
400 AdvancedThreatProtectionInsufficientDiskSpace - Advanced Threat Protection 設定メタデータをデータベースに保存するためのディスク領域が不足しています
400 InvalidDatabaseAdvancedThreatProtectionCreateRequest - データベースの作成 Advanced Threat Protection 要求が存在しないか、プロパティオブジェクトがありません
400 AdvancedThreatProtectionInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました
400 UpsertDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください
400 UpsertDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。
404 UpsertDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度やり直してください
409 DatabaseAdvancedThreatProtectionInProgress - Advanced Threat Protection データベースの設定は既に進行中です
409 UpsertDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度やり直してください
500 DatabaseIsUnavailable - 読み込みに失敗しました。後でもう一度やり直してください。
500 UpsertDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください
500 GetDatabaseAdvancedThreatProtectionFailed - Advanced Threat Protection 設定を取得できませんでした

例

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

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


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

応答のサンプル

状態コード:: 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"
  }
}

状態コード:: 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

要求のサンプル

HTTP
Java

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


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

応答のサンプル

状態コード:: 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"
  }
}

状態コード:: 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"
  }
}

定義

名前	説明
AdvancedThreatProtectionName	Advanced Threat Protection 状態の名前。
AdvancedThreatProtectionState	Advanced Threat Protection の状態を指定します。有効か無効か、特定のデータベースまたはサーバーに状態がまだ適用されていません。
createdByType	リソースを作成した ID の種類。
DatabaseAdvancedThreatProtection	データベースの Advanced Threat Protection。
systemData	リソースの作成と最後の変更に関連するメタデータ。

AdvancedThreatProtectionName

列挙

Advanced Threat Protection 状態の名前。

値	説明
Default

AdvancedThreatProtectionState

列挙

Advanced Threat Protection の状態を指定します。有効か無効か、特定のデータベースまたはサーバーに状態がまだ適用されていません。

値	説明
Disabled
Enabled
New

createdByType

列挙

リソースを作成した ID の種類。

値	説明
Application
Key
ManagedIdentity
User