Managed Instance Vulnerability Assessments - List By Instance

Служба:

SQL Database

Версия API:

2021-11-01

Возвращает политики оценки уязвимостей управляемого экземпляра.

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

Параметры URI

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

Ответы

Имя	Тип	Описание
200 OK	ManagedInstanceVulnerabilityAssessmentListResult	Успешно получены политики оценки уязвимостей управляемого экземпляра.
Other Status Codes		Ответы об ошибках: *** 400 InvalidStorageAccountName — указанная учетная запись хранения недопустимая или не существует. 400 InvalidStorageAccountCredentials — указан недопустимый подписанный URL-адрес учетной записи хранения или ключ хранения учетной записи. 400 VulnerabilityAssessmentADSIsDisabled — для использования оценки уязвимостей должна быть включена расширенная безопасность данных. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed — учетная запись хранения отсутствует в списке правил брандмауэра для исходящего трафика. 400 VulnerabilityAssessmentInsufficientStorageAccountPermissions — недостаточно разрешений для предоставленной учетной записи хранения. 400 VulnerabilityAssessmentStorageAccountIsDisabled — указанная учетная запись хранения отключена. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден.

Примеры

Get a managed instance's vulnerability assessment policies

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

HTTP

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

Java

/**
 * Samples for ManagedInstanceVulnerabilityAssessments ListByInstance.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceVulnerabilityAssessmentListByInstance.json
     */
    /**
     * Sample code: Get a managed instance's vulnerability assessment policies.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAManagedInstanceSVulnerabilityAssessmentPolicies(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceVulnerabilityAssessments().listByInstance(
            "vulnerabilityaseessmenttest-4799", "vulnerabilityaseessmenttest-6440", 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

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

Определения

Имя	Описание
ManagedInstanceVulnerabilityAssessment	Оценка уязвимостей управляемого экземпляра.
ManagedInstanceVulnerabilityAssessmentListResult	Список оценок уязвимостей ManagedInstance.
VulnerabilityAssessmentRecurringScansProperties	Свойства повторяющихся проверок оценки уязвимостей.

ManagedInstanceVulnerabilityAssessment

Оценка уязвимостей управляемого экземпляра.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.recurringScans	VulnerabilityAssessmentRecurringScansProperties	Параметры повторяющихся проверок
properties.storageAccountAccessKey	string	Указывает ключ идентификатора учетной записи хранения для результатов проверки оценки уязвимостей. Если параметр StorageContainerSasKey не указан, требуется storageAccountAccessKey. Применяется, только если учетная запись хранения не находится за виртуальной сетью или брандмауэром.
properties.storageContainerPath	string	Путь к контейнеру хранилища BLOB-объектов для хранения результатов сканирования (например, https://myStorage.blob.core.windows.net/VaScans/).
properties.storageContainerSasKey	string	Подписанный URL-адрес (ключ SAS), имеющий доступ на запись к контейнеру BLOB-объектов, указанному в параметре storageContainerPath. Если параметр storageAccountAccessKey не указан, требуется storageContainerSasKey. Применяется, только если учетная запись хранения не находится за виртуальной сетью или брандмауэром.
type	string	Тип ресурса.

ManagedInstanceVulnerabilityAssessmentListResult

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

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

VulnerabilityAssessmentRecurringScansProperties

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

Имя	Тип	Default value	Описание
emailSubscriptionAdmins	boolean	True	Указывает, что уведомление о проверке расписания будет отправлено администраторам подписки.
emails	string[]		Указывает массив адресов электронной почты, на которые отправляется уведомление о сканировании.
isEnabled	boolean		Состояние повторяющихся проверок.