Sql Vulnerability Assessments Settings - Create Or Update

リファレンス

Service:: SQL Database

API Version:: 2023-08-01-preview

SQL 脆弱性評価ポリシーを作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/sqlVulnerabilityAssessments/default?api-version=2023-08-01-preview

URI パラメーター

名前	/	必須	型	説明
resourceGroupName	path	True	string	リソースが含まれているリソースグループの名前。この値は、Azure リソースマネージャー API またはポータルから取得できます。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	SQL 脆弱性評価の名前。
api-version	query	True	string	要求で使用する API のバージョン。

要求本文

名前	型	説明
properties.state	SqlVulnerabilityAssessmentState	SQL 脆弱性評価の状態を指定します。有効か無効か、特定のデータベースまたはサーバーに状態がまだ適用されていません。

応答

名前	型	説明
200 OK	SqlVulnerabilityAssessment	SQL 脆弱性評価を正常に設定しました。
201 Created	SqlVulnerabilityAssessment	SQL 脆弱性評価が正常に作成されました。
Other Status Codes	ErrorResponse	エラー応答: *** 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました。 400 InvalidSqlVulnerabilityAssessmentBaselineInput - SQL 脆弱性評価ベースライン入力が null または空です。 400 InvalidSqlVulnerabilityAssessmentSettingsInput - SQL 脆弱性評価設定の入力が null または空です 400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet - SQL 脆弱性評価の結果はまだ利用できません。後でもう一度お試しください。 400 SqlVulnerabilityAssessmentInvalidRuleId - SQL 脆弱性評価ルール ID が無効です。 400 SqlVulnerabilityAssessmentScanDoesNotExist - SQL 脆弱性評価スキャンが存在しません。 400 SqlVulnerabilityAssessmentNoBaseline - リソースの最新スキャンのベースラインが見つかりませんでした 400 SqlVulnerabilityAssessmentNoRuleBaseline - SQL 脆弱性評価ベースラインが見つかりませんでした 400 SqlVulnerabilityAssessmentBaselineNoScanResults - ルール ID のスキャン結果が見つかりませんでした。ベースラインを設定するには、利用可能な最新のスキャンでこのルールの結果が必要です 400 SqlVulnerabilityAssessmentBadBinaryRuleFormat - バイナリルールの入力がブール値表現ではありません 400 SqlVulnerabilityAssessmentBadRuleFormat - 提供された結果は、スキャン結果の実際のレイアウトに準拠していません 400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat - 提供された結果が、スキャン結果の実際のレイアウトに準拠していません 400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat - バイナリルールの入力がブール値表現ではありません 400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId - いずれかのルールのスキャン結果が見つかりませんでした。ベースラインを設定するには、利用可能な最新のスキャンでこのルールの結果が必要です 400 SqlVulnerabilityAssessmentEmptyBaseline - 結果が null または空であるためにベースラインが設定されない 400 SqlVulnerabilityAssessmentIsDisabled - SQL 脆弱性評価機能が無効になっています。他の SQL 脆弱性評価操作を実行する前に、この機能を有効にしてください。 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 SourceDatabaseNotFound - ソースデータベースが存在しません。 404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。 409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled - このサーバーまたは互換性のないバージョンの基になるデータベースのいずれかで脆弱性評価が有効になっています。その他のトラブルシューティング情報については、を参照してください https://aka.ms/SQLVAStoragelessDocumentation。 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - SQL 脆弱性評価スキャンは既に進行中です 500 DatabaseIsUnavailable - 読み込みに失敗しました。後で再度お試しください。

名前

型

説明

200 OK

SqlVulnerabilityAssessment

SQL 脆弱性評価を正常に設定しました。

201 Created

SqlVulnerabilityAssessment

SQL 脆弱性評価が正常に作成されました。

Other Status Codes

ErrorResponse

エラー応答: ***

400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました。
400 InvalidSqlVulnerabilityAssessmentBaselineInput - SQL 脆弱性評価ベースライン入力が null または空です。
400 InvalidSqlVulnerabilityAssessmentSettingsInput - SQL 脆弱性評価設定の入力が null または空です
400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet - SQL 脆弱性評価の結果はまだ利用できません。後でもう一度お試しください。
400 SqlVulnerabilityAssessmentInvalidRuleId - SQL 脆弱性評価ルール ID が無効です。
400 SqlVulnerabilityAssessmentScanDoesNotExist - SQL 脆弱性評価スキャンが存在しません。
400 SqlVulnerabilityAssessmentNoBaseline - リソースの最新スキャンのベースラインが見つかりませんでした
400 SqlVulnerabilityAssessmentNoRuleBaseline - SQL 脆弱性評価ベースラインが見つかりませんでした
400 SqlVulnerabilityAssessmentBaselineNoScanResults - ルール ID のスキャン結果が見つかりませんでした。ベースラインを設定するには、利用可能な最新のスキャンでこのルールの結果が必要です
400 SqlVulnerabilityAssessmentBadBinaryRuleFormat - バイナリルールの入力がブール値表現ではありません
400 SqlVulnerabilityAssessmentBadRuleFormat - 提供された結果は、スキャン結果の実際のレイアウトに準拠していません
400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat - 提供された結果が、スキャン結果の実際のレイアウトに準拠していません
400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat - バイナリルールの入力がブール値表現ではありません
400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId - いずれかのルールのスキャン結果が見つかりませんでした。ベースラインを設定するには、利用可能な最新のスキャンでこのルールの結果が必要です
400 SqlVulnerabilityAssessmentEmptyBaseline - 結果が null または空であるためにベースラインが設定されない
400 SqlVulnerabilityAssessmentIsDisabled - SQL 脆弱性評価機能が無効になっています。他の SQL 脆弱性評価操作を実行する前に、この機能を有効にしてください。
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 SourceDatabaseNotFound - ソースデータベースが存在しません。
404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。
409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled - このサーバーまたは互換性のないバージョンの基になるデータベースのいずれかで脆弱性評価が有効になっています。その他のトラブルシューティング情報については、を参照してください https://aka.ms/SQLVAStoragelessDocumentation。
409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - SQL 脆弱性評価スキャンは既に進行中です
500 DatabaseIsUnavailable - 読み込みに失敗しました。後で再度お試しください。

例

Create a SQL Vulnerability Assessment policy

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/sqlVulnerabilityAssessments/default?api-version=2023-08-01-preview

{
  "properties": {
    "state": "Enabled"
  }
}

Sample Response

Status code:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/sqlVulnerabilityAssessments/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/sqlVulnerabilityAssessments",
  "properties": {
    "state": "Enabled"
  }
}

Status code:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/sqlVulnerabilityAssessments/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/sqlVulnerabilityAssessments",
  "properties": {
    "state": "Enabled"
  }
}

定義

名前	説明
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
SqlVulnerabilityAssessment	SQL 脆弱性評価。
SqlVulnerabilityAssessmentState	SQL 脆弱性評価の状態を指定します。有効か無効か、特定のデータベースまたはサーバーに状態がまだ適用されていません。
systemData	リソースの作成と最後の変更に関連するメタデータ。
VulnerabilityAssessmentName	SQL 脆弱性評価の名前。

createdByType

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

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

ErrorAdditionalInfo

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

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

ErrorDetail

エラーの詳細。

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

ErrorResponse

エラー応答

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

SqlVulnerabilityAssessment

SQL 脆弱性評価。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.state	SqlVulnerabilityAssessmentState	SQL 脆弱性評価の状態を指定します。有効か無効か、特定のデータベースまたはサーバーに状態がまだ適用されていません。
systemData	systemData	SqlVulnerabilityAssessmentResource の SystemData。
type	string	リソースの種類。

SqlVulnerabilityAssessmentState

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

名前	型	説明
Disabled	string
Enabled	string

systemData

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

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

VulnerabilityAssessmentName

SQL 脆弱性評価の名前。

名前	型	説明
default	string

次の方法で共有

Sql Vulnerability Assessments Settings - Create Or Update

URI パラメーター

要求本文

応答

例

Create a SQL Vulnerability Assessment policy

Sample Request

Sample Response

定義

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SqlVulnerabilityAssessment

SqlVulnerabilityAssessmentState

systemData

VulnerabilityAssessmentName

その他のリソース