Database Blob Auditing Policies - Get

リファレンス

サービス:: SQL Database

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

データベースの BLOB 監査ポリシーを取得します。

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

URI パラメーター

名前	/	必須	型	説明
blobAuditingPolicyName	path	True	blobAuditingPolicyName	BLOB 監査ポリシーの名前。
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 バージョン。

応答

名前	型	説明
200 OK	DatabaseBlobAuditingPolicy	データベース BLOB 監査ポリシーが正常に取得されました。
Other Status Codes		エラー応答: *** 400 BlobAuditingIsNotSupportedOnResourceType - BLOB 監査は現在、このリソースの種類ではサポートされていません。 404 SourceDatabaseNotFound - ソースデータベースが存在しません。 404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。 500 DatabaseIsUnavailable - 読み込みに失敗しました。後でもう一度やり直してください。

名前

型

説明

200 OK

DatabaseBlobAuditingPolicy

データベース BLOB 監査ポリシーが正常に取得されました。

Other Status Codes

エラー応答: ***

400 BlobAuditingIsNotSupportedOnResourceType - BLOB 監査は現在、このリソースの種類ではサポートされていません。
404 SourceDatabaseNotFound - ソースデータベースが存在しません。
404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。
500 DatabaseIsUnavailable - 読み込みに失敗しました。後でもう一度やり直してください。

例

Get a database's blob auditing policy

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/blobauditingtest-6852/providers/Microsoft.Sql/servers/blobauditingtest-2080/databases/testdb/auditingSettings/default?api-version=2021-11-01


/**
 * Samples for DatabaseBlobAuditingPolicies Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseBlobAuditingGet.json
     */
    /**
     * Sample code: Get a database's blob auditing policy.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getADatabaseSBlobAuditingPolicy(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseBlobAuditingPolicies().getWithResponse(
            "blobauditingtest-6852", "blobauditingtest-2080", "testdb", 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/blobauditingtest-6852/providers/Microsoft.Sql/servers/blobauditingtest-2080/databases/testdb",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/auditingSettings",
  "kind": "V12",
  "properties": {
    "state": "Disabled",
    "storageEndpoint": "",
    "retentionDays": 0,
    "auditActionsAndGroups": [],
    "storageAccountSubscriptionId": "00000000-0000-0000-0000-000000000000",
    "isStorageSecondaryKeyInUse": false,
    "isAzureMonitorTargetEnabled": false,
    "isManagedIdentityInUse": false
  }
}

定義

名前	説明
blobAuditingPolicyName	BLOB 監査ポリシーの名前。
BlobAuditingPolicyState	監査の状態を指定します。状態が有効の場合、storageEndpoint または isAzureMonitorTargetEnabled が必要です。
DatabaseBlobAuditingPolicy	データベース BLOB 監査ポリシー。

blobAuditingPolicyName

列挙

BLOB 監査ポリシーの名前。

値	説明
default

BlobAuditingPolicyState

列挙

監査の状態を指定します。状態が有効の場合、storageEndpoint または isAzureMonitorTargetEnabled が必要です。

値	説明
Disabled
Enabled

DatabaseBlobAuditingPolicy

Object

データベース BLOB 監査ポリシー。

名前	型	説明
id	string	リソース ID。
kind	string	リソースの種類。
name	string	リソース名。
properties.auditActionsAndGroups	string[]	監査する Actions-Groups とアクションを指定します。使用する推奨されるアクショングループのセットは次の組み合わせです。これにより、データベースに対して実行されたすべてのクエリとストアドプロシージャ、および成功したログインと失敗したログインが監査されます。 BATCH_COMPLETED_GROUP、SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP、FAILED_DATABASE_AUTHENTICATION_GROUP。上記の組み合わせも、Azure portal から監査を有効にするときに既定で構成されるセットです。監査でサポートされているアクショングループは次のとおりです (注: 監査のニーズに対応する特定のグループのみを選択してください)。不要なグループを使用すると、非常に大量の監査レコードが発生する可能性があります。 APPLICATION_ROLE_CHANGE_PASSWORD_GROUP BACKUP_RESTORE_GROUP DATABASE_LOGOUT_GROUP DATABASE_OBJECT_CHANGE_GROUP DATABASE_OBJECT_OWNERSHIP_CHANGE_GROUP DATABASE_OBJECT_PERMISSION_CHANGE_GROUP DATABASE_OPERATION_GROUP DATABASE_PERMISSION_CHANGE_GROUP DATABASE_PRINCIPAL_CHANGE_GROUP DATABASE_PRINCIPAL_IMPERSONATION_GROUP DATABASE_ROLE_MEMBER_CHANGE_GROUP FAILED_DATABASE_AUTHENTICATION_GROUP SCHEMA_OBJECT_ACCESS_GROUP SCHEMA_OBJECT_CHANGE_GROUP SCHEMA_OBJECT_OWNERSHIP_CHANGE_GROUP SCHEMA_OBJECT_PERMISSION_CHANGE_GROUP SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP USER_CHANGE_PASSWORD_GROUP BATCH_STARTED_GROUP BATCH_COMPLETED_GROUP DBCC_GROUP DATABASE_OWNERSHIP_CHANGE_GROUP DATABASE_CHANGE_GROUP LEDGER_OPERATION_GROUP これらは、データベースに対して実行されるすべての SQL ステートメントとストアドプロシージャを対象とするグループであり、監査ログが重複するため、他のグループと組み合わせて使用しないでください。詳細については、「Database-Level 監査アクショングループの」を参照してください。データベース監査ポリシーでは、特定のアクションを指定することもできます (サーバー監査ポリシーにはアクションを指定できないことに注意してください)。監査でサポートされているアクションは、SELECT UPDATE INSERT DELETE EXECUTE RECEIVE REFERENCES です。監査対象のアクションを定義するための一般的な形式は、{action} ON {object} BY {principal} です。上記の形式では、テーブル、ビュー、ストアドプロシージャなどのオブジェクト、またはデータベースまたはスキーマ全体を参照できることに注意してください。後者の場合は、それぞれ DATABASE::{db_name} と SCHEMA::{schema_name} という形式が使用されます。例: DBo.myTable by public SELECT on DATABASE::myDatabase by public SELECT on SCHEMA::mySchema by public 詳細については、「Database-Level 監査アクションの」を参照してください。
properties.isAzureMonitorTargetEnabled	boolean	監査イベントを Azure Monitor に送信するかどうかを指定します。 Azure Monitor にイベントを送信するには、'State' を 'Enabled' に、'IsAzureMonitorTargetEnabled' を true に指定します。 REST API を使用して監査を構成する場合は、データベースに "SQLSecurityAuditEvents" 診断ログカテゴリを含む診断設定も作成する必要があります。サーバーレベルの監査では、'master' データベースを {databaseName} として使用する必要があることに注意してください。診断設定 URI 形式: PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview 詳細については、「診断設定 REST API 」または「診断設定の PowerShell する」を参照してください。
properties.isManagedIdentityInUse	boolean	BLOB ストレージへのアクセスにマネージド ID を使用するかどうかを指定します
properties.isStorageSecondaryKeyInUse	boolean	storageAccountAccessKey 値がストレージのセカンダリキーかどうかを指定します。
properties.queueDelayMs	integer (int32)	監査アクションが強制的に処理されるまでの時間をミリ秒単位で指定します。既定値は 1000 (1 秒) です。最大値は 2,147,483,647 です。
properties.retentionDays	integer (int32)	ストレージアカウントの監査ログに保持する日数を指定します。
properties.state	BlobAuditingPolicyState	監査の状態を指定します。状態が有効の場合、storageEndpoint または isAzureMonitorTargetEnabled が必要です。
properties.storageAccountAccessKey	string	監査ストレージアカウントの識別子キーを指定します。状態が Enabled で storageEndpoint が指定されている場合、storageAccountAccessKey を指定しないと、SQL サーバーのシステム割り当てマネージド ID を使用してストレージにアクセスします。マネージド ID 認証を使用するための前提条件: AZURE Active Directory (AAD) で SQL Server にシステム割り当てマネージド ID を割り当てます。サーバー ID に "ストレージ BLOB データ共同作成者" RBAC ロールを追加して、SQL Server ID にストレージアカウントへのアクセス権を付与します。詳細については、「マネージド ID 認証を使用したストレージへの監査の」を参照してください。
properties.storageAccountSubscriptionId	string (uuid)	BLOB ストレージサブスクリプション ID を指定します。
properties.storageEndpoint	string	BLOB ストレージエンドポイント (例: https://MyAccount.blob.core.windows.net) を指定します。状態が有効の場合、storageEndpoint または isAzureMonitorTargetEnabled が必要です。
type	string	リソースの種類。

次の方法で共有

Database Blob Auditing Policies - Get

URI パラメーター

応答

例

Get a database's blob auditing policy

要求のサンプル

応答のサンプル

定義

blobAuditingPolicyName

BlobAuditingPolicyState

DatabaseBlobAuditingPolicy

その他のリソース