Managed Database Vulnerability Assessment Scans - Get

Служба:

SQL Database

Версия API:

2021-11-01

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

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

Параметры URI

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

Ответы

Имя	Тип	Описание
200 OK	VulnerabilityAssessmentScanRecord	Успешно получена запись проверки оценки уязвимостей базы данных.
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 a database vulnerability assessment scan record by scan ID

Образец запроса

HTTP

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/scan001?api-version=2021-11-01

Java

import com.azure.resourcemanager.sql.models.VulnerabilityAssessmentName;

/**
 * Samples for ManagedDatabaseVulnerabilityAssessmentScans Get.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseVulnerabilityAssessmentScanRecordsGet.json
     */
    /**
     * Sample code: Gets a database vulnerability assessment scan record by scan ID.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsADatabaseVulnerabilityAssessmentScanRecordByScanID(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseVulnerabilityAssessmentScans().getWithResponse(
            "vulnerabilityassessmenttest-4711", "vulnerabilityassessmenttest-6411", "testdb",
            VulnerabilityAssessmentName.DEFAULT, "scan001", com.azure.core.util.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

Пример ответа

Код состояния:

200

{
  "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
  }
}

Определения

Имя	Описание
VulnerabilityAssessmentName	Имя оценки уязвимостей.
VulnerabilityAssessmentScanError	Свойства ошибки проверки оценки уязвимостей.
VulnerabilityAssessmentScanRecord	Запись сканирования оценки уязвимостей.
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	Тип ресурса.

VulnerabilityAssessmentScanState

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

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

VulnerabilityAssessmentScanTriggerType

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

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