Server 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}/advancedThreatProtectionSettings/Default?api-version=2021-11-01

URI パラメーター

名前	/	必須	型	説明
advancedThreatProtectionName	path	True	AdvancedThreatProtectionName	Advanced Threat Protection 状態の名前。
resourceGroupName	path	True	string	リソースが含まれているリソースグループの名前。この値は、Azure リソースマネージャー 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	ServerAdvancedThreatProtection	Advanced Threat Protection の状態が正常に作成または更新されました。
202 Accepted		Advanced Threat Protection の状態を設定する要求を作成しました。
Other Status Codes		エラー応答: *** 400 UpdateNotAllowedOnServerContainingPausedDWDatabase - サーバーの Advanced Threat Protection 設定の設定は、Data Warehouse データベースが一時停止されているサーバーでは許可されません 400 AdvancedThreatProtectionInsufficientDiskSpace - Advanced Threat Protection 設定メタデータをデータベースに保存するためのディスク領域が不足しています 400 InvalidServerAdvancedThreatProtectionCreateRequest - サーバーの作成 Advanced Threat Protection 要求が存在しないか、プロパティオブジェクトがありません 400 AdvancedThreatProtectionInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました 400 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください 400 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください 404 OperationIdNotFound - Id を持つ操作が存在しません。 409 ServerAdvancedThreatProtectionInProgress - サーバーの Advanced Threat Protection 設定の設定は既に進行中です 409 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください 409 OperationCancelled - 操作がユーザーによって取り消されました。 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。 500 DatabaseIsUnavailable - 読み込みに失敗しました。後で再度お試しください。 500 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください 500 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作をやり直してください。 503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。

名前

型

説明

200 OK

ServerAdvancedThreatProtection

Advanced Threat Protection の状態が正常に作成または更新されました。

202 Accepted

Advanced Threat Protection の状態を設定する要求を作成しました。

Other Status Codes

エラー応答: ***

400 UpdateNotAllowedOnServerContainingPausedDWDatabase - サーバーの Advanced Threat Protection 設定の設定は、Data Warehouse データベースが一時停止されているサーバーでは許可されません
400 AdvancedThreatProtectionInsufficientDiskSpace - Advanced Threat Protection 設定メタデータをデータベースに保存するためのディスク領域が不足しています
400 InvalidServerAdvancedThreatProtectionCreateRequest - サーバーの作成 Advanced Threat Protection 要求が存在しないか、プロパティオブジェクトがありません
400 AdvancedThreatProtectionInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました
400 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください
400 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください
404 OperationIdNotFound - Id を持つ操作が存在しません。
409 ServerAdvancedThreatProtectionInProgress - サーバーの Advanced Threat Protection 設定の設定は既に進行中です
409 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください
409 OperationCancelled - 操作がユーザーによって取り消されました。
409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。
429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。
429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。
500 DatabaseIsUnavailable - 読み込みに失敗しました。後で再度お試しください。
500 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください
500 UpsertServerAdvancedThreatProtectionFailed - Advanced Threat Protection 設定の保存中にエラーが発生しました。後でもう一度お試しください
500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作をやり直してください。
503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。

例

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

応答のサンプル

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

状態コード:: 202

Update a server'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/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

応答のサンプル

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

状態コード:: 202

定義

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

AdvancedThreatProtectionName

Advanced Threat Protection 状態の名前。

名前	型	説明
Default	string

AdvancedThreatProtectionState

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

名前	型	説明
Disabled	string
Enabled	string
New	string

createdByType

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

名前	型	説明
Application	string
Key	string
ManagedIdentity	string
User	string