Database Blob Auditing Policies - Get

サービス:: SQL Database

API バージョン:: 2025-01-01

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

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

URI パラメーター

名前	/	必須	型	説明
blobAuditingPolicyName	path	True	BlobAuditingPolicyName	ブロブ監査ポリシーの名前です。
databaseName	path	True	string	データベースの名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	DatabaseBlobAuditingPolicy	Azureの運用は無事に完了しました。
Other Status Codes	ErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Get a database's blob auditing policy

要求のサンプル

HTTP

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=2025-01-01

応答のサンプル

状態コード:: 200

{
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/auditingSettings",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/blobauditingtest-6852/providers/Microsoft.Sql/servers/blobauditingtest-2080/databases/testdb",
  "kind": "V12",
  "properties": {
    "auditActionsAndGroups": [],
    "isAzureMonitorTargetEnabled": false,
    "isManagedIdentityInUse": false,
    "isStorageSecondaryKeyInUse": false,
    "retentionDays": 0,
    "state": "Disabled",
    "storageAccountSubscriptionId": "00000000-0000-0000-0000-000000000000",
    "storageEndpoint": ""
  }
}

定義

名前	説明
BlobAuditingPolicyName
BlobAuditingPolicyState	監査の状態を指定します。状態が有効の場合、storageEndpoint または isAzureMonitorTargetEnabled が必要です。
createdByType	リソースを作成した ID の種類。
DatabaseBlobAuditingPolicy	データベース BLOB 監査ポリシー。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
systemData	リソースの作成と最後の変更に関連するメタデータ。

BlobAuditingPolicyName

列挙

値	説明
default	デフォルト

BlobAuditingPolicyState

列挙

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

値	説明
Enabled	有効
Disabled	Disabled

createdByType

列挙

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

値	説明
User
Application
ManagedIdentity
Key

DatabaseBlobAuditingPolicy

Object

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

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	リソースの種類。
name	string	リソースの名前
properties.auditActionsAndGroups	string[]	監査する Actions-Groups とアクションを指定します。使用する推奨されるアクショングループのセットは次の組み合わせです。これにより、データベースに対して実行されたすべてのクエリとストアドプロシージャ、および成功したログインと失敗したログインが監査されます。 BATCH_COMPLETED_GROUP、SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP、FAILED_DATABASE_AUTHENTICATION_GROUP。上記の組み合わせは、Azureポータルから監査を有効にする際にデフォルトで設定されているセットでもあります。監査でサポートされているアクショングループは次のとおりです (注: 監査のニーズに対応する特定のグループのみを選択してください)。不要なグループを使用すると、非常に大量の監査レコードが発生する可能性があります。 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のSELECT by public DATABASE::myDatabase on SCHEMA:SELECT by publicのSELECT::SCHEMA::mySchemaのSELECT 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 (password)	監査ストレージアカウントの識別子キーを指定します。状態が Enabled で storageEndpoint が指定されている場合、storageAccountAccessKey を指定しないと、SQL サーバーのシステム割り当てマネージド ID を使用してストレージにアクセスします。マネージド ID 認証を使用するための前提条件: SQL Server に Azure Active Directory (AAD) でシステム割り当て管理型アイデンティティを割り当ててください。サーバーのアイデンティティに「Storage Blob Data Contributor」というRBAC役割を追加することで、SQL ServerのIDへのアクセスをストレージアカウントに付与します。詳細については、「マネージド ID 認証を使用したストレージへの監査の」を参照してください。
properties.storageAccountSubscriptionId	string (uuid)	BLOB ストレージサブスクリプション ID を指定します。
properties.storageEndpoint	string	BLOB ストレージエンドポイント (例: `https://MyAccount.blob.core.windows.net`) を指定します。状態が有効の場合、storageEndpoint または isAzureMonitorTargetEnabled が必要です。
systemData	systemData	create By と modifiedBy の情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例えば「Microsoft。Compute/virtualMachines」または「Microsoft」などです。ストレージ/ストレージアカウント」

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

systemData

Object

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

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

次の方法で共有

Database Blob Auditing Policies - Get

URI パラメーター

応答

セキュリティ

azure_auth

スコープ

例

Get a database's blob auditing policy

要求のサンプル

応答のサンプル

定義

BlobAuditingPolicyName

BlobAuditingPolicyState

createdByType

DatabaseBlobAuditingPolicy

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

systemData