Database Vulnerability Assessments - List By Database

Service:

SQL Database

API Version:

2021-11-01

データベースに関連付けられている脆弱性評価ポリシーをListsします。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/vulnerabilityAssessments?api-version=2021-11-01

URI パラメーター

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

応答

名前	型	説明
200 OK	DatabaseVulnerabilityAssessmentListResult	データベースの脆弱性評価ポリシーを正常に取得しました。
Other Status Codes		エラー応答: *** 400 InvalidStorageAccountName - 指定されたストレージ アカウントが無効であるか、存在しません。 400 InvalidStorageAccountCredentials - 指定されたストレージ アカウントの共有アクセス署名またはアカウント ストレージ キーが無効です。 400 VulnerabilityAssessmentInvalidPolicy - 脆弱性評価の設定が存在しないか、設定で指定されたストレージが無効です。 400 VulnerabilityAssessmentADSIsDisabled - 脆弱性評価を使用するには、Advanced Data Security を有効にする必要があります。 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath - サーバー レベル ポリシーで設定されていない場合は、ストレージ コンテナー パスを指定する必要があります 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated - データベースが一時停止しているため、脆弱性評価操作を実行できませんでした。 再開してください。 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed - ストレージ アカウントが送信ファイアウォール規則の一覧にありません。 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 SourceDatabaseNotFound - ソース データベースが存在しません。 404 DatabaseDoesNotExist - ユーザーがこのサーバー インスタンスに存在しないデータベース名を指定しました。 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - 脆弱性評価スキャンは既に進行中です。 500 DatabaseIsUnavailable - 読み込みに失敗しました。 後で再度お試しください。

例

Get the database's vulnerability assessment policies

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/vulnerabilityAssessments?api-version=2021-11-01

Java

import com.azure.core.util.Context;

/** Samples for DatabaseVulnerabilityAssessments ListByDatabase. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * DatabaseVulnerabilityAssessmentListByDatabase.json
     */
    /**
     * Sample code: Get the database's vulnerability assessment policies.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheDatabaseSVulnerabilityAssessmentPolicies(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseVulnerabilityAssessments().listByDatabase(
            "vulnerabilityaseessmenttest-4799", "vulnerabilityaseessmenttest-6440", "testdb", Context.NONE);
    }
}

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

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/vulnerabilityAssessments/default",
      "name": "default",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments",
      "properties": {
        "recurringScans": {
          "isEnabled": true,
          "emailSubscriptionAdmins": true,
          "emails": [
            "email1@mail.com",
            "email2@mail.com"
          ]
        }
      }
    }
  ]
}

定義

名前	説明
DatabaseVulnerabilityAssessment	データベースの脆弱性評価。
DatabaseVulnerabilityAssessmentListResult	データベースの脆弱性評価の一覧。
VulnerabilityAssessmentRecurringScansProperties	脆弱性評価の定期的なスキャンのプロパティ。

DatabaseVulnerabilityAssessment

データベースの脆弱性評価。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.recurringScans	VulnerabilityAssessmentRecurringScansProperties	定期的なスキャンの設定
properties.storageAccountAccessKey	string	脆弱性評価スキャン結果のストレージ アカウントの識別子キーを指定します。 'StorageContainerSasKey' が指定されていない場合は、storageAccountAccessKey が必要です。 ストレージ アカウントが Vnet またはファイアウォールの背後にない場合にのみ適用されます
properties.storageContainerPath	string	スキャン結果を保持するための BLOB ストレージ コンテナー パス (例: https://myStorage.blob.core.windows.net/VaScans/)。 サーバー レベルの脆弱性評価ポリシーが設定されていない場合に必要です
properties.storageContainerSasKey	string	'storageContainerPath' パラメーターで指定された BLOB コンテナーへの書き込みアクセス権を持つ共有アクセス署名 (SAS キー)。 'storageAccountAccessKey' が指定されていない場合は、StorageContainerSasKey が必要です。 ストレージ アカウントが Vnet またはファイアウォールの背後にない場合にのみ適用されます
type	string	リソースの種類。

DatabaseVulnerabilityAssessmentListResult

データベースの脆弱性評価の一覧。

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

VulnerabilityAssessmentRecurringScansProperties

脆弱性評価の定期的なスキャンのプロパティ。

名前	型	既定値	説明
emailSubscriptionAdmins	boolean	True	スケジュール スキャン通知をサブスクリプション管理者に送信することを指定します。
emails	string[]		スキャン通知の送信先となる電子メール アドレスの配列を指定します。
isEnabled	boolean		定期的なスキャンの状態。