次の方法で共有

Sql Vulnerability Assessment Scans - Get

  • リファレンス
サービス:
SQL Database
API バージョン:
2024-05-01-preview

システム データベースの脆弱性評価スキャン レコードを取得します。

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

URI パラメーター

名前 / 必須 型 説明
resourceGroupName
 path True

string

リソースを含むリソース グループの名前。 この値は、Azure Resource Manager API またはポータルから取得できます。
scanId
 path True

string

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

SqlVulnerabilityAssessmentScanRecord

データベース脆弱性評価スキャン レコードを正常に取得しました。
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 a database vulnerability assessment scan records

要求のサンプル

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

応答のサンプル

状態コード:
200 
{
  "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"
  }
}

定義

名前 説明
createdByType

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

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

エラーの詳細。
ErrorResponse

エラー応答
SqlVulnerabilityAssessmentScanError

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

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

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

脆弱性評価の名前。
VulnerabilityAssessmentScanState

スキャンの状態。
VulnerabilityAssessmentScanTriggerType

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

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

createdByType

列挙

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

値 説明
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

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

名前 型 説明
info

object

追加情報。
type

string

追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

ErrorDetail[]

エラーの詳細。
message

string

エラー メッセージ。
target

string

エラーターゲット。

ErrorResponse

Object

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

SqlVulnerabilityAssessmentScanError

Object

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

名前 型 説明
code

string

エラー コード。
message

string

エラー メッセージ。

SqlVulnerabilityAssessmentScanRecord

Object

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

名前 型 説明
id

string

リソース ID。
name

string

リソース名。
properties.database

string

データベース名。
properties.endTime

string (date-time)

スキャンの終了時刻 (UTC)。
properties.errors

SqlVulnerabilityAssessmentScanError[]

スキャン エラー。
properties.highSeverityFailedRulesCount

integer (int32)

重大度が高い失敗したルールの数。
properties.isBaselineApplied

boolean

このデータベース用に作成され、1 つ以上のルールを持つベースライン。
properties.lastScanTime

string (date-time)

最後のスキャン時刻。
properties.lowSeverityFailedRulesCount

integer (int32)

重大度が低い失敗したルールの数。
properties.mediumSeverityFailedRulesCount

integer (int32)

重大度が中程度の失敗したルールの数。
properties.scanId

string

スキャン ID。
properties.server

string

サーバー名。
properties.sqlVersion

string

SQL バージョン。
properties.startTime

string (date-time)

スキャン開始時刻 (UTC)。
properties.state

VulnerabilityAssessmentScanState

スキャンの状態。
properties.totalFailedRulesCount

integer (int32)

失敗したルールの合計数。
properties.totalPassedRulesCount

integer (int32)

渡されたルールの合計数。
properties.totalRulesCount

integer (int32)

評価されたルールの合計数。
properties.triggerType

VulnerabilityAssessmentScanTriggerType

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

systemData

SqlVulnerabilityAssessmentScanRecordResource の SystemData。
type

string

リソースの種類。

systemData

Object

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

名前 型 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。
createdBy

string

リソースを作成した ID。
createdByType

createdByType

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

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy

string

リソースを最後に変更した ID。
lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。

VulnerabilityAssessmentName

列挙

脆弱性評価の名前。

値 説明
default

VulnerabilityAssessmentScanState

列挙

スキャンの状態。

値 説明
Failed
FailedToRun
InProgress
Passed

VulnerabilityAssessmentScanTriggerType

列挙

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

値 説明
OnDemand
Recurring

VulnerabilityAssessmentSystemDatabaseName

列挙

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

値 説明
master