Managed Server Security Alert Policies - Get

リファレンス

サービス:: SQL Database

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

マネージドサーバーの脅威検出ポリシーを取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/securityAlertPolicies/Default?api-version=2021-11-01

URI パラメーター

名前	/	必須	型	説明
managedInstanceName	path	True	string	マネージドインスタンスの名前。
resourceGroupName	path	True	string	リソースを含むリソースグループの名前。この値は、Azure Resource Manager API またはポータルから取得できます。
securityAlertPolicyName	path	True	SecurityAlertPolicyName	セキュリティアラートポリシーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求に使用する API バージョン。

応答

名前	型	説明
200 OK	ManagedServerSecurityAlertPolicy	マネージドサーバーの脅威検出ポリシーが正常に取得されました。
Other Status Codes		エラー応答: *** 400 SecurityAlertPoliciesInvalidStorageAccountName - 指定されたストレージアカウントが無効であるか、存在しません。 400 SecurityAlertPoliciesInvalidStorageAccountCredentials - 指定されたストレージアカウントのアクセスキーが無効です。 400 UpdateNotAllowedOnServerContainingPausedDWDatabase - Data Warehouse データベースが一時停止されているサーバーでは、サーバーの脅威検出設定を設定できません 400 SecurityAlertPoliciesInsufficientDiskSpace - データベースにセキュリティアラートポリシーメタデータを保存するためのディスク領域が不足しています 400 SecurityAlertPoliciesInsufficientStorageAccountPermissions - 指定されたストレージアカウントに対する読み取りまたは書き込みアクセス許可が不十分です。 400 SecurityAlertPoliciesStorageAccountIsDisabled - 脅威検出ポリシーで指定されたストレージアカウントが無効になっています。 400 InvalidServerSecurityAlertPolicyCreateRequest - サーバーの脅威検出セキュリティアラートポリシーの作成要求が存在しないか、プロパティオブジェクトがありません。 400 DataSecurityInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました。 400 UpsertServerSecurityAlertPolicyFailed - 脅威検出設定の保存中にエラーが発生しました。後でもう一度お試しください 400 UpsertServerSecurityAlertPolicyFailed - 脅威検出設定の保存中にエラーが発生しました。後でもう一度お試しください 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 UpsertServerSecurityAlertPolicyFailed - 脅威検出設定の保存中にエラーが発生しました。後でもう一度やり直してください 409 ServerSecurityAlertPolicyInProgress - サーバーセキュリティアラートポリシーの設定は既に進行中です 409 UpsertServerSecurityAlertPolicyFailed - 脅威検出設定の保存中にエラーが発生しました。後でもう一度やり直してください 500 DatabaseIsUnavailable - 読み込みに失敗しました。後でもう一度やり直してください。 500 UpsertServerSecurityAlertPolicyFailed - 脅威検出設定の保存中にエラーが発生しました。後でもう一度やり直してください 500 GetServerSecurityAlertPolicyFailed - 脅威検出設定を取得できませんでした

名前

型

説明

200 OK

ManagedServerSecurityAlertPolicy

マネージドサーバーの脅威検出ポリシーが正常に取得されました。

Other Status Codes

エラー応答: ***

400 SecurityAlertPoliciesInvalidStorageAccountName - 指定されたストレージアカウントが無効であるか、存在しません。
400 SecurityAlertPoliciesInvalidStorageAccountCredentials - 指定されたストレージアカウントのアクセスキーが無効です。
400 UpdateNotAllowedOnServerContainingPausedDWDatabase - Data Warehouse データベースが一時停止されているサーバーでは、サーバーの脅威検出設定を設定できません
400 SecurityAlertPoliciesInsufficientDiskSpace - データベースにセキュリティアラートポリシーメタデータを保存するためのディスク領域が不足しています
400 SecurityAlertPoliciesInsufficientStorageAccountPermissions - 指定されたストレージアカウントに対する読み取りまたは書き込みアクセス許可が不十分です。
400 SecurityAlertPoliciesStorageAccountIsDisabled - 脅威検出ポリシーで指定されたストレージアカウントが無効になっています。
400 InvalidServerSecurityAlertPolicyCreateRequest - サーバーの脅威検出セキュリティアラートポリシーの作成要求が存在しないか、プロパティオブジェクトがありません。
400 DataSecurityInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました。
400 UpsertServerSecurityAlertPolicyFailed - 脅威検出設定の保存中にエラーが発生しました。後でもう一度お試しください
400 UpsertServerSecurityAlertPolicyFailed - 脅威検出設定の保存中にエラーが発生しました。後でもう一度お試しください
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 UpsertServerSecurityAlertPolicyFailed - 脅威検出設定の保存中にエラーが発生しました。後でもう一度やり直してください
409 ServerSecurityAlertPolicyInProgress - サーバーセキュリティアラートポリシーの設定は既に進行中です
409 UpsertServerSecurityAlertPolicyFailed - 脅威検出設定の保存中にエラーが発生しました。後でもう一度やり直してください
500 DatabaseIsUnavailable - 読み込みに失敗しました。後でもう一度やり直してください。
500 UpsertServerSecurityAlertPolicyFailed - 脅威検出設定の保存中にエラーが発生しました。後でもう一度やり直してください
500 GetServerSecurityAlertPolicyFailed - 脅威検出設定を取得できませんでした

例

Get a managed server's threat detection policy

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/managedInstances/securityalert-6440/securityAlertPolicies/Default?api-version=2021-11-01


import com.azure.resourcemanager.sql.models.SecurityAlertPolicyNameAutoGenerated;

/**
 * Samples for ManagedServerSecurityAlertPolicies Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedServerSecurityAlertGet.json
     */
    /**
     * Sample code: Get a managed server's threat detection policy.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAManagedServerSThreatDetectionPolicy(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedServerSecurityAlertPolicies().getWithResponse(
            "securityalert-4799", "securityalert-6440", SecurityAlertPolicyNameAutoGenerated.DEFAULT,
            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/securityalert-4799/providers/Microsoft.Sql/managedInstances/securityalert-6440",
  "name": "Default",
  "type": "Microsoft.Sql/managedInstances/securityAlertPolicies",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-04-03T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-04-03T04:41:33.937Z"
  },
  "properties": {
    "state": "Disabled",
    "emailAccountAdmins": true,
    "emailAddresses": [
      "test@consoto.com;user@consoto.com"
    ],
    "disabledAlerts": [
      "Access_Anomaly"
    ],
    "retentionDays": 0,
    "storageAccountAccessKey": "",
    "storageEndpoint": "",
    "creationTime": "2020-04-03T04:41:33.937Z"
  }
}

定義

名前	説明
createdByType	リソースを作成した ID の種類。
ManagedServerSecurityAlertPolicy	マネージドサーバーセキュリティアラートポリシー。
SecurityAlertPolicyName	セキュリティアラートポリシーの名前。
SecurityAlertsPolicyState	ポリシーの状態を指定します。ポリシーが有効か無効か、またはポリシーがまだ特定のデータベースに適用されていません。
systemData	リソースの作成と最後の変更に関連するメタデータ。

createdByType

列挙

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

値	説明
Application
Key
ManagedIdentity
User

ManagedServerSecurityAlertPolicy

Object

マネージドサーバーセキュリティアラートポリシー。

名前	型	説明
id	string	リソース ID。
name	string	リソース名。
properties.creationTime	string (date-time)	ポリシーの UTC 作成時刻を指定します。
properties.disabledAlerts	string[]	無効になっているアラートの配列を指定します。使用できる値: Sql_Injection、Sql_Injection_Vulnerability、Access_Anomaly、Data_Exfiltration、Unsafe_Action、Brute_Force
properties.emailAccountAdmins	boolean	アラートがアカウント管理者に送信されることを指定します。
properties.emailAddresses	string[]	アラートの送信先となる電子メールアドレスの配列を指定します。
properties.retentionDays	integer (int32)	脅威検出監査ログに保持する日数を指定します。
properties.state	SecurityAlertsPolicyState	ポリシーの状態を指定します。ポリシーが有効か無効か、またはポリシーがまだ特定のデータベースに適用されていません。
properties.storageAccountAccessKey	string	脅威検出監査ストレージアカウントの識別子キーを指定します。
properties.storageEndpoint	string	BLOB ストレージエンドポイント (例: https://MyAccount.blob.core.windows.net) を指定します。この BLOB ストレージには、すべての脅威検出監査ログが保持されます。
systemData	systemData	SecurityAlertPolicyResource の SystemData。
type	string	リソースの種類。

SecurityAlertPolicyName

列挙

セキュリティアラートポリシーの名前。

値	説明
Default

SecurityAlertsPolicyState

列挙

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

値	説明
Disabled
Enabled

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有

Managed Server Security Alert Policies - Get

URI パラメーター

応答

例

Get a managed server's threat detection policy

要求のサンプル

応答のサンプル

定義

createdByType

ManagedServerSecurityAlertPolicy

SecurityAlertPolicyName

SecurityAlertsPolicyState

systemData

その他のリソース