Поделиться через

Database Security Alert Policies - Get

  • Ссылка
Служба:
SQL Database
Версия API:
2021-11-01

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

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

Параметры URI

Имя В Обязательно Тип Описание
databaseName
 path True

string

Имя базы данных, для которой определена политика оповещений системы безопасности.
resourceGroupName
 path True

string

Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
securityAlertPolicyName
 path True

SecurityAlertPolicyName

Имя политики оповещений системы безопасности.
serverName
 path True

string

Имя сервера.
subscriptionId
 path True

string

Идентификатор подписки Azure.
api-version
 query True

string

Версия API для использования в запросе.

Ответы

Имя Тип Описание
200 OK

DatabaseSecurityAlertPolicy

Политика оповещений системы безопасности базы данных успешно получена.
Other Status Codes

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

  • 400 UpdateNotAllowedOnPausedDatabase — пользователь пытался выполнить обновление приостановленной базы данных.

  • 400 SecurityAlertPoliciesInsufficientStorageAccountPermissions — недостаточно разрешений на чтение или запись для предоставленной учетной записи хранения.

  • 400 SecurityAlertPoliciesStorageAccountIsDisabled — учетная запись хранения, предоставляемая в политике обнаружения угроз, отключена.

  • 400 SecurityAlertPoliciesInsufficientDiskSpace — недостаточно места на диске для сохранения метаданных политики оповещений системы безопасности в базе данных

  • 400 SecurityAlertPoliciesInvalidStorageAccountName — указанная учетная запись хранения недопустимая или не существует.

  • 400 SecurityAlertPoliciesInvalidStorageAccountCredentials — указанный ключ доступа учетной записи хранения недопустим.

  • 400 InvalidDatabaseSecurityAlertPolicyCreateRequest — запрос политики создания оповещений системы безопасности обнаружения угроз базы данных не существует или не имеет объекта свойств.

  • 400 DataSecurityInvalidUserSuppliedParameter — клиент предоставил недопустимое значение параметра.

  • 400 UpsertDatabaseSecurityAlertPolicyFailed — произошла ошибка при сохранении параметров обнаружения угроз. Повторите попытку позже.

  • 400 UpsertDatabaseSecurityAlertPolicyFailed — произошла ошибка при сохранении параметров обнаружения угроз. Повторите попытку позже.

  • 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера.

  • 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден

  • 404 UpsertDatabaseSecurityAlertPolicyFailed — произошла ошибка при сохранении параметров обнаружения угроз. Повторите попытку позже.

  • 409 DatabaseSecurityAlertPolicyInProgress — настройка политики оповещений системы безопасности базы данных уже выполняется

  • 409 UpsertDatabaseSecurityAlertPolicyFailed — произошла ошибка при сохранении параметров обнаружения угроз. Повторите попытку позже.

  • 500 DatabaseIsUnavailable — сбой загрузки. Повторите попытку позже.

  • 500 UpsertDatabaseSecurityAlertPolicyFailed — произошла ошибка при сохранении параметров обнаружения угроз. Повторите попытку позже.

  • 500 GetDatabaseSecurityAlertPolicyFailed — не удалось получить параметры обнаружения угроз

Примеры

Get a database's threat detection policy

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

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-6852/providers/Microsoft.Sql/servers/securityalert-2080/databases/testdb/securityAlertPolicies/default?api-version=2021-11-01

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

Код состояния:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-6852/providers/Microsoft.Sql/servers/securityalert-2080/databases/testdb",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/securityAlertPolicies",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-04-03T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-04-03T04:41:33.937Z"
  },
  "properties": {
    "state": "Enabled",
    "emailAccountAdmins": true,
    "emailAddresses": [
      "test@consoto.com",
      "user@consoto.com"
    ],
    "disabledAlerts": [
      "Usage_Anomaly"
    ],
    "retentionDays": 0,
    "creationTime": "2020-04-03T04:41:33.937Z"
  }
}

Определения

Имя Описание
createdByType

Тип удостоверения, создавшего ресурс.
DatabaseSecurityAlertPolicy

Политика оповещений безопасности базы данных.
SecurityAlertPolicyName

Имя политики оповещений системы безопасности.
SecurityAlertsPolicyState

Указывает состояние политики, независимо от того, включена она или отключена или политика еще не применена к определенной базе данных.
systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Имя Тип Описание
Application

string

Key

string

ManagedIdentity

string

User

string

DatabaseSecurityAlertPolicy

Политика оповещений безопасности базы данных.

Имя Тип Описание
id

string

Идентификатор ресурса.
name

string

Имя ресурса.
properties.creationTime

string

Указывает время создания политики в формате UTC.
properties.disabledAlerts

string[]

Указывает массив отключенных оповещений. Допустимые значения: Sql_Injection, Sql_Injection_Vulnerability, Access_Anomaly, Data_Exfiltration, Unsafe_Action, Brute_Force
properties.emailAccountAdmins

boolean

Указывает, что оповещение отправляется администраторам учетных записей.
properties.emailAddresses

string[]

Задает массив адресов электронной почты, на которые отправляется оповещение.
properties.retentionDays

integer

Указывает количество дней для хранения в журналах аудита обнаружения угроз.
properties.state

SecurityAlertsPolicyState

Указывает состояние политики, независимо от того, включена она или отключена или политика еще не применена к определенной базе данных.
properties.storageAccountAccessKey

string

Указывает ключ идентификатора учетной записи хранения аудита обнаружения угроз.
properties.storageEndpoint

string

Указывает конечную точку хранилища BLOB-объектов (например, https://MyAccount.blob.core.windows.net). В этом хранилище BLOB-объектов будут храниться все журналы аудита обнаружения угроз.
systemData

systemData

SystemData of SecurityAlertPolicyResource.
type

string

Тип ресурса.

SecurityAlertPolicyName

Имя политики оповещений системы безопасности.

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

string

SecurityAlertsPolicyState

Указывает состояние политики, независимо от того, включена она или отключена или политика еще не применена к определенной базе данных.

Имя Тип Описание
Disabled

string

Enabled

string

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя Тип Описание
createdAt

string

Метка времени создания ресурса (UTC).
createdBy

string

Удостоверение, создающее ресурс.
createdByType

createdByType

Тип удостоверения, создавшего ресурс.
lastModifiedAt

string

Метка времени последнего изменения ресурса (UTC)
lastModifiedBy

string

Удостоверение, которое в последний раз изменял ресурс.
lastModifiedByType

createdByType

Тип удостоверения, изменяющего ресурс в последний раз.