Server DevOps Audit Settings - Create Or Update

サービス:: SQL Database

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

サーバーの DevOps 監査設定を作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/devOpsAuditingSettings/Default?api-version=2025-01-01

URI パラメーター

名前	/	必須	型	説明
devOpsAuditingSettingsName	path	True	DevOpsAuditingSettingsName
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 バージョン。

要求本文

名前	必須	型	説明
properties.state	True	BlobAuditingPolicyState	監査の状態を指定します。状態が有効の場合、storageEndpoint または isAzureMonitorTargetEnabled が必要です。
properties.isAzureMonitorTargetEnabled		boolean	DevOps監査イベントがAzure Monitorに送信されるかどうかを指定します。イベントをAzure Monitorに送信するには、「State」を「Enabled」、「IsAzureMonitorTargetEnabled」をtrueに指定してください。 REST API を使用して DevOps 監査を構成する場合は、マスターデータベースに "DevOpsOperationsAudit" 診断ログカテゴリを含む診断設定も作成する必要があります。診断設定 URIフォーマット:PUT `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/master/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview` 詳細については、「診断設定 REST API 」または「診断設定の PowerShell する」を参照してください。
properties.isManagedIdentityInUse		boolean	BLOB ストレージへのアクセスにマネージド ID を使用するかどうかを指定します
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 が必要です。

応答

名前	型	説明
200 OK	ServerDevOpsAuditingSettings	リソース「ServerDevOpsAuditingSettings」の更新操作が成功しました
202 Accepted		リソース操作が受け入れられます。ヘッダー Azure-AsyncOperation: string Location: string
Other Status Codes	ErrorResponse	予期しないエラー応答。

名前

型

説明

200 OK

ServerDevOpsAuditingSettings

リソース「ServerDevOpsAuditingSettings」の更新操作が成功しました

202 Accepted

リソース操作が受け入れられます。

ヘッダー

Azure-AsyncOperation: string
Location: string

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	ユーザーアカウントを偽装する

例

Update a server's DevOps audit settings with all params

Update a server's DevOps audit settings with minimal input

Update a server's DevOps audit settings with all params

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/Default?api-version=2025-01-01

{
  "properties": {
    "isAzureMonitorTargetEnabled": true,
    "state": "Enabled",
    "storageAccountAccessKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "storageAccountSubscriptionId": "00000000-1234-0000-5678-000000000000",
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "Default",
  "type": "Microsoft.Sql/servers/devOpsAuditingSettings",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/default",
  "properties": {
    "isAzureMonitorTargetEnabled": true,
    "state": "Enabled",
    "storageAccountSubscriptionId": "00000000-1234-0000-5678-000000000000",
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

状態コード:: 202

Update a server's DevOps audit settings with minimal input

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/Default?api-version=2025-01-01

{
  "properties": {
    "state": "Enabled",
    "storageAccountAccessKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "Default",
  "type": "Microsoft.Sql/servers/devOpsAuditingSettings",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/default",
  "properties": {
    "state": "Enabled",
    "storageAccountSubscriptionId": "00000000-1234-0000-5678-000000000000",
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

状態コード:: 202

定義

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

BlobAuditingPolicyState

列挙

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

値	説明
Enabled	有効
Disabled	Disabled

createdByType

列挙

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

値	説明
User
Application
ManagedIdentity
Key

DevOpsAuditingSettingsName

列挙

値	説明
Default	デフォルト

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

エラーの詳細。

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

ErrorResponse

Object

エラー応答

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

ServerDevOpsAuditingSettings

Object

サーバー DevOps 監査設定。

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties.isAzureMonitorTargetEnabled	boolean	DevOps監査イベントがAzure Monitorに送信されるかどうかを指定します。イベントをAzure Monitorに送信するには、「State」を「Enabled」、「IsAzureMonitorTargetEnabled」をtrueに指定してください。 REST API を使用して DevOps 監査を構成する場合は、マスターデータベースに "DevOpsOperationsAudit" 診断ログカテゴリを含む診断設定も作成する必要があります。診断設定 URIフォーマット:PUT `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/master/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview` 詳細については、「診断設定 REST API 」または「診断設定の PowerShell する」を参照してください。
properties.isManagedIdentityInUse	boolean	BLOB ストレージへのアクセスにマネージド ID を使用するかどうかを指定します
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」などです。ストレージ/ストレージアカウント」

systemData

Object

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

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