Managed Database Vulnerability Assessment Scans - List By Database

Ссылка

Service:: SQL Database

API Version:: 2021-11-01

Списки проверки уязвимостей базы данных.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
databaseName	path	True	string	Имя базы данных.
managedInstanceName	path	True	string	Имя управляемого экземпляра.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
subscriptionId	path	True	string	Идентификатор подписки Azure.
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	Имя оценки уязвимости.
api-version	query	True	string	Версия API для использования в запросе.

Ответы

Имя	Тип	Описание
200 OK	VulnerabilityAssessmentScanRecordListResult	Записи проверки оценки уязвимостей базы данных успешно получены.
Other Status Codes		Ответы на ошибки: *** 400 InvalidStorageAccountName — указанная учетная запись хранения недопустимая или не существует. 400 InvalidStorageAccountCredentials — указан недопустимый подписанный url-адрес учетной записи хранения или ключ хранения учетной записи. 400 VulnerabilityAssessmentInvalidPolicy — параметры оценки уязвимостей не существуют или недопустимые хранилища, указанные в параметрах. 400 VulnerabilityAssessmentADSIsDisabled — для использования оценки уязвимостей необходимо включить расширенную безопасность данных. 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath — путь к контейнеру хранилища должен быть указан, если он не задан в политике уровня сервера 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated — не удалось выполнить операцию оценки уязвимостей, так как база данных приостановлена. Пожалуйста, возобновите его. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed — учетная запись хранения отсутствует в списке правил брандмауэра для исходящего трафика. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 SourceDatabaseNotFound — база данных-источник не существует. 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress — проверка оценки уязвимостей уже выполняется. 500 DatabaseIsUnavailable — сбой загрузки. Повторите попытку позже.

Имя

Тип

Описание

200 OK

VulnerabilityAssessmentScanRecordListResult

Записи проверки оценки уязвимостей базы данных успешно получены.

Other Status Codes

Ответы на ошибки: ***

400 InvalidStorageAccountName — указанная учетная запись хранения недопустимая или не существует.
400 InvalidStorageAccountCredentials — указан недопустимый подписанный url-адрес учетной записи хранения или ключ хранения учетной записи.
400 VulnerabilityAssessmentInvalidPolicy — параметры оценки уязвимостей не существуют или недопустимые хранилища, указанные в параметрах.
400 VulnerabilityAssessmentADSIsDisabled — для использования оценки уязвимостей необходимо включить расширенную безопасность данных.
400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath — путь к контейнеру хранилища должен быть указан, если он не задан в политике уровня сервера
400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated — не удалось выполнить операцию оценки уязвимостей, так как база данных приостановлена. Пожалуйста, возобновите его.
400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed — учетная запись хранения отсутствует в списке правил брандмауэра для исходящего трафика.
404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден
404 SourceDatabaseNotFound — база данных-источник не существует.
404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера.
409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress — проверка оценки уязвимостей уже выполняется.
500 DatabaseIsUnavailable — сбой загрузки. Повторите попытку позже.

Примеры

Gets the list of a database vulnerability assessment scan records

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6411/databases/testdb/vulnerabilityAssessments/default/scans?api-version=2021-11-01


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.VulnerabilityAssessmentName;

/** Samples for ManagedDatabaseVulnerabilityAssessmentScans ListByDatabase. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseVulnerabilityAssessmentScanRecordsListByDatabase.json
     */
    /**
     * Sample code: Gets the list of a database vulnerability assessment scan records.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsTheListOfADatabaseVulnerabilityAssessmentScanRecords(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseVulnerabilityAssessmentScans().listByDatabase(
            "vulnerabilityassessmenttest-4711", "vulnerabilityassessmenttest-6411", "testdb",
            VulnerabilityAssessmentName.DEFAULT, 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/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan001",
      "name": "scan001",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan001",
        "triggerType": "OnDemand",
        "state": "Passed",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 9
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan002",
      "name": "scan002",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan002",
        "triggerType": "Recurring",
        "state": "Failed",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 9
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan003",
      "name": "scan003",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
      "properties": {
        "scanId": "scan003",
        "triggerType": "Recurring",
        "state": "FailedToRun",
        "startTime": "2017-12-12T17:45:06Z",
        "endTime": "2017-12-12T17:47:06Z",
        "errors": [
          {
            "code": "StorageNotFound",
            "message": "Storage not found"
          }
        ],
        "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
        "numberOfFailedSecurityChecks": 0
      }
    }
  ]
}

Определения

Имя	Описание
VulnerabilityAssessmentName	Имя оценки уязвимости.
VulnerabilityAssessmentScanError	Свойства ошибки проверки оценки уязвимостей.
VulnerabilityAssessmentScanRecord	Запись сканирования оценки уязвимостей.
VulnerabilityAssessmentScanRecordListResult	Список записей проверки оценки уязвимостей.
VulnerabilityAssessmentScanState	Состояние сканирования.
VulnerabilityAssessmentScanTriggerType	Тип триггера сканирования.

VulnerabilityAssessmentName

Имя оценки уязвимости.

Имя	Тип	Описание
default	string

VulnerabilityAssessmentScanError

Свойства ошибки проверки оценки уязвимостей.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке.

VulnerabilityAssessmentScanRecord

Запись сканирования оценки уязвимостей.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.endTime	string	Время окончания сканирования (UTC).
properties.errors	VulnerabilityAssessmentScanError[]	Ошибки сканирования.
properties.numberOfFailedSecurityChecks	integer	Количество неудачных проверок безопасности.
properties.scanId	string	Идентификатор сканирования.
properties.startTime	string	Время начала сканирования (UTC).
properties.state	VulnerabilityAssessmentScanState	Состояние сканирования.
properties.storageContainerPath	string	Путь к контейнеру хранилища результатов сканирования.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	Тип триггера сканирования.
type	string	Тип ресурса.

VulnerabilityAssessmentScanRecordListResult

Список записей проверки оценки уязвимостей.

Имя	Тип	Описание
nextLink	string	Ссылка для получения следующей страницы результатов.
value	VulnerabilityAssessmentScanRecord[]	Массив результатов.

VulnerabilityAssessmentScanState

Состояние сканирования.

Имя	Тип	Описание
Failed	string
FailedToRun	string
InProgress	string
Passed	string

VulnerabilityAssessmentScanTriggerType

Тип триггера сканирования.

Имя	Тип	Описание
OnDemand	string
Recurring	string

Managed Database Vulnerability Assessment Scans - List By Database

Параметры URI

Ответы

Примеры

Gets the list of a database vulnerability assessment scan records

Sample Request

Sample Response

Определения

VulnerabilityAssessmentName

VulnerabilityAssessmentScanError

VulnerabilityAssessmentScanRecord

VulnerabilityAssessmentScanRecordListResult

VulnerabilityAssessmentScanState

VulnerabilityAssessmentScanTriggerType

Дополнительные ресурсы