Database Sql Vulnerability Assessment Execute Scan - Execute

リファレンス

サービス:: SQL Database

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

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

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

URI パラメーター

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

応答

名前	型	説明
200 OK		脆弱性評価データベーススキャンが正常に実行されました。
202 Accepted		脆弱性評価データベーススキャンが正常に開始されました。
Other Status Codes	ErrorResponse	エラー応答: *** 400 SqlVulnerabilityAssessmentIsDisabled - SQL 脆弱性評価機能が無効になっています。他の SQL 脆弱性評価操作を実行する前に、この機能を有効にしてください。 400 InvalidVulnerabilityAssessmentOperationRequest - 脆弱性評価操作要求が存在しないか、プロパティオブジェクトがありません。 400 DataSecurityInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました。 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 SourceDatabaseNotFound - ソースデータベースが存在しません。 404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。 404 OperationIdNotFound - Id を持つ操作が存在しません。 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - SQL 脆弱性評価スキャンは既に進行中です 409 VulnerabilityAssessmentStoragelessIsEnabled - このサーバーまたはその基になるデータベースの 1 つで、互換性のないバージョンの脆弱性評価が有効になっています。その他のトラブルシューティング情報については、https://aka.ms/SQLVAStoragelessDocumentation参照してください。 409 CannotCancelOperation - 管理操作が取り消すことができない状態です。 409 OperationCancelled - 操作がユーザーによって取り消されました。 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 500 DatabaseIsUnavailable - 読み込みに失敗しました。後でもう一度やり直してください。 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作を再試行してください。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。

名前

型

説明

200 OK

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

202 Accepted

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

Other Status Codes

ErrorResponse

エラー応答: ***

400 SqlVulnerabilityAssessmentIsDisabled - SQL 脆弱性評価機能が無効になっています。他の SQL 脆弱性評価操作を実行する前に、この機能を有効にしてください。
400 InvalidVulnerabilityAssessmentOperationRequest - 脆弱性評価操作要求が存在しないか、プロパティオブジェクトがありません。
400 DataSecurityInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました。
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 SourceDatabaseNotFound - ソースデータベースが存在しません。
404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。
404 OperationIdNotFound - Id を持つ操作が存在しません。
409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - SQL 脆弱性評価スキャンは既に進行中です
409 VulnerabilityAssessmentStoragelessIsEnabled - このサーバーまたはその基になるデータベースの 1 つで、互換性のないバージョンの脆弱性評価が有効になっています。その他のトラブルシューティング情報については、https://aka.ms/SQLVAStoragelessDocumentation参照してください。
409 CannotCancelOperation - 管理操作が取り消すことができない状態です。
409 OperationCancelled - 操作がユーザーによって取り消されました。
409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。
429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求を超える要求。
429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。
500 DatabaseIsUnavailable - 読み込みに失敗しました。後でもう一度やり直してください。
500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作を再試行してください。
503 TooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。

例

Executes a database's vulnerability assessment scan.

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.sql import SqlManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-sql
# USAGE
    python database_sql_vulnerability_assessment_scans_execute.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SqlManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-1111-2222-3333-444444444444",
    )

    client.database_sql_vulnerability_assessment_execute_scan.begin_execute(
        resource_group_name="vulnerabilityassessmenttest-4711",
        server_name="vulnerabilityassessmenttest-6411",
        database_name="testdb",
        vulnerability_assessment_name="default",
    ).result()


# x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2024-05-01-preview/examples/DatabaseSqlVulnerabilityAssessmentScansExecute.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

状態コード:: 202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/westus/sqlVulnerabilityAssessmentOperationResults/00000000-1111-2222-3333-444444444444?api-version=2022-02-01-preview

定義

名前	説明
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
VulnerabilityAssessmentName	脆弱性評価の名前。

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

エラーの詳細。

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

ErrorResponse

Object

エラー応答

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

VulnerabilityAssessmentName

列挙

脆弱性評価の名前。

値	説明
default

次の方法で共有

Database Sql Vulnerability Assessment Execute Scan - Execute

URI パラメーター

応答

例

Executes a database's vulnerability assessment scan.

要求のサンプル

応答のサンプル

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

VulnerabilityAssessmentName

その他のリソース