Sql Vulnerability Assessment Scans - List By Sql Vulnerability Assessments

リファレンス

Service:: SQL Database

API Version:: 2023-08-01-preview

データベースの脆弱性評価スキャンをListsします。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/sqlVulnerabilityAssessments/default/scans?systemDatabaseName=master&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	脆弱性評価の名前。
api-version	query	True	string	要求で使用する API のバージョン。
systemDatabaseName	query	True	VulnerabilityAssessmentSystemDatabaseName	脆弱性評価システムデータベース名。

応答

名前	型	説明
200 OK	SqlVulnerabilityAssessmentScanRecordListResult	データベース脆弱性評価スキャンレコードが正常に取得されました。
Other Status Codes	ErrorResponse	エラー応答: *** 400 SqlVulnerabilityAssessmentIsDisabled - SQL 脆弱性評価機能が無効になっています。他の SQL 脆弱性評価操作を実行する前に、この機能を有効にしてください。 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 または空であるため、ベースラインが設定されていません 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 SourceDatabaseNotFound - ソースデータベースが存在しません。 404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - SQL 脆弱性評価スキャンは既に進行中です 409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled - このサーバーまたは互換性のないバージョンの基になるデータベースのいずれかで脆弱性評価が有効になっています。その他のトラブルシューティング情報については、を参照してください https://aka.ms/SQLVAStoragelessDocumentation。 500 DatabaseIsUnavailable - 読み込みに失敗しました。後で再度お試しください。

名前

型

説明

200 OK

SqlVulnerabilityAssessmentScanRecordListResult

データベース脆弱性評価スキャンレコードが正常に取得されました。

Other Status Codes

ErrorResponse

エラー応答: ***

400 SqlVulnerabilityAssessmentIsDisabled - SQL 脆弱性評価機能が無効になっています。他の SQL 脆弱性評価操作を実行する前に、この機能を有効にしてください。
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 または空であるため、ベースラインが設定されていません
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 SourceDatabaseNotFound - ソースデータベースが存在しません。
404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。
409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - SQL 脆弱性評価スキャンは既に進行中です
409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled - このサーバーまたは互換性のないバージョンの基になるデータベースのいずれかで脆弱性評価が有効になっています。その他のトラブルシューティング情報については、を参照してください https://aka.ms/SQLVAStoragelessDocumentation。
500 DatabaseIsUnavailable - 読み込みに失敗しました。後で再度お試しください。

例

Gets the list of a database vulnerability assessment scan records

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/sqlVulnerabilityAssessments/default/scans?systemDatabaseName=master&api-version=2023-08-01-preview

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/sqlVulnerabilityAssessments/default/scans/scan001",
      "name": "scan001",
      "type": "Microsoft.Sql/servers/sqlVulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan001",
        "triggerType": "Recurring",
        "state": "Failed",
        "server": "vulnerabilityassessmenttest-6411",
        "database": "master",
        "sqlVersion": "15.0.2000",
        "startTime": "2020-06-23T12:19:00.6455136+05:30",
        "endTime": "2020-06-23T06:49:00.7236217Z",
        "highSeverityFailedRulesCount": 3,
        "mediumSeverityFailedRulesCount": 2,
        "lowSeverityFailedRulesCount": 1,
        "totalPassedRulesCount": 20,
        "totalFailedRulesCount": 6,
        "totalRulesCount": 26,
        "isBaselineApplied": false,
        "lastScanTime": "2020-06-23T12:19:00.6455136+05:30"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/sqlVulnerabilityAssessments/default/scans/scan002",
      "name": "scan001",
      "type": "Microsoft.Sql/servers/sqlVulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan002",
        "triggerType": "Recurring",
        "state": "Failed",
        "server": "vulnerabilityassessmenttest-6411",
        "database": "master",
        "sqlVersion": "15.0.2000",
        "startTime": "2020-06-23T12:19:00.6455136+05:30",
        "endTime": "2020-06-23T06:49:00.7236217Z",
        "highSeverityFailedRulesCount": 3,
        "mediumSeverityFailedRulesCount": 2,
        "lowSeverityFailedRulesCount": 1,
        "totalPassedRulesCount": 20,
        "totalFailedRulesCount": 6,
        "totalRulesCount": 26,
        "isBaselineApplied": false,
        "lastScanTime": "2020-06-23T12:19:00.6455136+05:30"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/sqlVulnerabilityAssessments/default/scans/scan003",
      "name": "scan001",
      "type": "Microsoft.Sql/servers/sqlVulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan003",
        "triggerType": "Recurring",
        "state": "Failed",
        "server": "vulnerabilityassessmenttest-6411",
        "database": "master",
        "sqlVersion": "15.0.2000",
        "startTime": "2020-06-23T12:19:00.6455136+05:30",
        "endTime": "2020-06-23T06:49:00.7236217Z",
        "highSeverityFailedRulesCount": 0,
        "mediumSeverityFailedRulesCount": 0,
        "lowSeverityFailedRulesCount": 0,
        "totalPassedRulesCount": 20,
        "totalFailedRulesCount": 6,
        "totalRulesCount": 26,
        "isBaselineApplied": true,
        "lastScanTime": "2020-06-23T12:19:00.6455136+05:30"
      }
    }
  ]
}

定義

名前	説明
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
SqlVulnerabilityAssessmentScanError	脆弱性評価スキャンエラーのプロパティ。
SqlVulnerabilityAssessmentScanRecord	脆弱性評価スキャンレコード。
SqlVulnerabilityAssessmentScanRecordListResult	脆弱性評価スキャンレコードの一覧。
systemData	リソースの作成と最後の変更に関連するメタデータ。
VulnerabilityAssessmentName	脆弱性評価の名前。
VulnerabilityAssessmentScanState	スキャンの状態。
VulnerabilityAssessmentScanTriggerType	スキャントリガーの種類。
VulnerabilityAssessmentSystemDatabaseName	脆弱性評価システムデータベース名。

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 オブジェクト。

SqlVulnerabilityAssessmentScanError

脆弱性評価スキャンエラーのプロパティ。

名前	型	説明
code	string	エラーコード。
message	string	エラーメッセージ。

SqlVulnerabilityAssessmentScanRecord

脆弱性評価スキャンレコード。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.database	string	データベース名。
properties.endTime	string	スキャンの終了時刻 (UTC)。
properties.errors	SqlVulnerabilityAssessmentScanError[]	スキャンエラー。
properties.highSeverityFailedRulesCount	integer	重大度が高い失敗したルールの数。
properties.isBaselineApplied	boolean	このデータベース用に作成され、1 つ以上のルールがあるベースライン。
properties.lastScanTime	string	最後のスキャン時刻。
properties.lowSeverityFailedRulesCount	integer	重大度が低い失敗したルールの数。
properties.mediumSeverityFailedRulesCount	integer	重大度が中程度の失敗したルールの数。
properties.scanId	string	スキャン ID。
properties.server	string	サーバー名。
properties.sqlVersion	string	SQL バージョン。
properties.startTime	string	スキャンの開始時刻 (UTC)。
properties.state	VulnerabilityAssessmentScanState	スキャンの状態。
properties.totalFailedRulesCount	integer	失敗したルールの合計数。
properties.totalPassedRulesCount	integer	合格したルールの合計数。
properties.totalRulesCount	integer	評価された合計ルールの数。
properties.triggerType	VulnerabilityAssessmentScanTriggerType	スキャントリガーの種類。
systemData	systemData	SqlVulnerabilityAssessmentScanRecordResource の SystemData。
type	string	リソースの種類。

SqlVulnerabilityAssessmentScanRecordListResult

脆弱性評価スキャンレコードの一覧。

名前	型	説明
nextLink	string	結果の次のページを取得するためのリンク。
value	SqlVulnerabilityAssessmentScanRecord[]	結果の配列。

systemData

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

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

VulnerabilityAssessmentName

脆弱性評価の名前。

名前	型	説明
default	string

VulnerabilityAssessmentScanState

スキャンの状態。

名前	型	説明
Failed	string
FailedToRun	string
InProgress	string
Passed	string

VulnerabilityAssessmentScanTriggerType

スキャントリガーの種類。

名前	型	説明
OnDemand	string
Recurring	string

VulnerabilityAssessmentSystemDatabaseName

脆弱性評価システムデータベース名。

名前	型	説明
master	string

次の方法で共有

Sql Vulnerability Assessment Scans - List By Sql Vulnerability Assessments

URI パラメーター

応答

例

Gets the list of a database vulnerability assessment scan records

Sample Request

Sample Response

定義

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SqlVulnerabilityAssessmentScanError

SqlVulnerabilityAssessmentScanRecord

SqlVulnerabilityAssessmentScanRecordListResult

systemData

VulnerabilityAssessmentName

VulnerabilityAssessmentScanState

VulnerabilityAssessmentScanTriggerType

VulnerabilityAssessmentSystemDatabaseName

その他のリソース