Database Sql Vulnerability Assessment Scans - Get

リファレンス

サービス:: SQL Database

API バージョン:: 2023-05-01-preview

データベース脆弱性評価スキャン結果を取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/sqlVulnerabilityAssessments/default/scans/{scanId}?api-version=2023-05-01-preview

URI パラメーター

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

応答

名前	型	説明
200 OK	SqlVulnerabilityAssessmentScanRecord	データベース脆弱性評価スキャンが正常に取得されました。
Other Status Codes		エラー応答: *** 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

SqlVulnerabilityAssessmentScanRecord

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

Other Status Codes

エラー応答: ***

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 - 読み込みに失敗しました。後で再度お試しください。

例

Get a database's vulnerability assessment scan.

要求のサンプル

HTTP

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

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/databases/testdb/sqlVulnerabilityAssessments/default/scans/scan001",
  "name": "scan001",
  "type": "Microsoft.Sql/servers/databases/sqlVulnerabilityAssessments/scans",
  "properties": {
    "scanId": "scan001",
    "triggerType": "Recurring",
    "state": "Failed",
    "server": "vulnerabilityassessmenttest-6411",
    "database": "testdb",
    "sqlVersion": "15.0.2000",
    "startTime": "2020-06-22T23:49:00.6455136-07:00",
    "endTime": "2020-06-23T06:49:00.7236217Z",
    "highSeverityFailedRulesCount": 3,
    "mediumSeverityFailedRulesCount": 2,
    "lowSeverityFailedRulesCount": 1,
    "totalPassedRulesCount": 20,
    "totalFailedRulesCount": 6,
    "totalRulesCount": 26,
    "isBaselineApplied": false,
    "lastScanTime": "2020-06-22T23:49:00.6455136-07:00"
  }
}

定義

名前	説明
createdByType	リソースを作成した ID の種類。
SqlVulnerabilityAssessmentScanError	脆弱性評価スキャンエラーのプロパティ。
SqlVulnerabilityAssessmentScanRecord	脆弱性評価スキャンレコード。
systemData	リソースの作成と最後の変更に関連するメタデータ。
VulnerabilityAssessmentName	脆弱性評価の名前。
VulnerabilityAssessmentScanState	スキャンの状態。
VulnerabilityAssessmentScanTriggerType	スキャントリガーの種類。

createdByType

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

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

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	リソースの種類。

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

次の方法で共有

Database Sql Vulnerability Assessment Scans - Get

URI パラメーター

応答

例

Get a database's vulnerability assessment scan.

要求のサンプル

応答のサンプル

定義

createdByType

SqlVulnerabilityAssessmentScanError

SqlVulnerabilityAssessmentScanRecord

systemData

VulnerabilityAssessmentName

VulnerabilityAssessmentScanState

VulnerabilityAssessmentScanTriggerType

その他のリソース