Partilhar via

Database Security Alert Policies - Get

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Obtém a política de alerta de segurança de um banco de dados.

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

Parâmetros do URI

Name Em Necessário Tipo Description
databaseName
 path True

string

O nome do banco de dados para o qual a diretiva de alerta de segurança está definida.
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal.
securityAlertPolicyName
 path True

SecurityAlertPolicyName

O nome da política de alerta de segurança.
serverName
 path True

string

O nome do servidor.
subscriptionId
 path True

string

A ID de assinatura que identifica uma assinatura do Azure.
api-version
 query True

string

A versão da API a ser usada para a solicitação.

Respostas

Name Tipo Description
200 OK

DatabaseSecurityAlertPolicy

Recuperada com êxito a política de alerta de segurança do banco de dados.
Other Status Codes

Respostas de erro: ***

  • 400 UpdateNotAllowedOnPausedDatabase - O usuário tentou executar uma atualização em um banco de dados pausado.

  • 400 SecurityAlertPoliciesInsufficientStorageAccountPermissions - Permissões de leitura ou gravação insuficientes na conta de armazenamento fornecida.

  • 400 SecurityAlertPoliciesStorageAccountIsDisabled - A conta de armazenamento fornecida na política de deteção de ameaças está desativada.

  • 400 SecurityAlertPoliciesInsufficientDiskSpace - Espaço em disco insuficiente para salvar metadados da política de alerta de segurança no banco de dados

  • 400 SecurityAlertPoliciesInvalidStorageAccountName - A conta de armazenamento fornecida não é válida ou não existe.

  • 400 SecurityAlertPoliciesInvalidStorageAccountCredentials - A chave de acesso da conta de armazenamento fornecida não é válida.

  • 400 InvalidDatabaseSecurityAlertPolicyCreateRequest - A solicitação de política de alerta de segurança de deteção de ameaças de criação de banco de dados não existe ou não tem nenhum objeto de propriedades.

  • 400 DataSecurityInvalidUserSuppliedParameter - Um valor de parâmetro inválido foi fornecido pelo cliente.

  • 400 UpsertDatabaseSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de deteção de ameaças, tente novamente mais tarde

  • 400 UpsertDatabaseSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de deteção de ameaças, tente novamente mais tarde

  • 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância do servidor.

  • 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado

  • 404 UpsertDatabaseSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de deteção de ameaças, tente novamente mais tarde

  • 409 DatabaseSecurityAlertPolicyInProgress - Definir a política de alerta de segurança do banco de dados já está em andamento

  • 409 UpsertDatabaseSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de deteção de ameaças, tente novamente mais tarde

  • 500 DatabaseIsUnavailable - Falha ao carregar. Tente novamente mais tarde.

  • 500 UpsertDatabaseSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de deteção de ameaças, tente novamente mais tarde

  • 500 GetDatabaseSecurityAlertPolicyFailed - Falha ao obter as configurações de deteção de ameaças

Exemplos

Get a database's threat detection policy

Pedido de amostra

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

Resposta da amostra

Código de estado:
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"
  }
}

Definições

Name Description
createdByType

O tipo de identidade que criou o recurso.
DatabaseSecurityAlertPolicy

Uma política de alerta de segurança de banco de dados.
SecurityAlertPolicyName

O nome da política de alerta de segurança.
SecurityAlertsPolicyState

Especifica o estado da política, se ela está habilitada ou desabilitada ou se uma política ainda não foi aplicada no banco de dados específico.
systemData

Metadados referentes à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor Description
Application
Key
ManagedIdentity
User

DatabaseSecurityAlertPolicy

Object

Uma política de alerta de segurança de banco de dados.

Name Tipo Description
id

string

ID do recurso.
name

string

Nome do recurso.
properties.creationTime

string (date-time)

Especifica a hora de criação UTC da política.
properties.disabledAlerts

string[]

Especifica uma matriz de alertas que estão desabilitados. Os valores permitidos são: Sql_Injection, Sql_Injection_Vulnerability, Access_Anomaly, Data_Exfiltration, Unsafe_Action Brute_Force
properties.emailAccountAdmins

boolean

Especifica que o alerta é enviado aos administradores de conta.
properties.emailAddresses

string[]

Especifica uma matriz de endereços de email para os quais o alerta é enviado.
properties.retentionDays

integer (int32)

Especifica o número de dias a serem mantidos nos logs de auditoria de Deteção de Ameaças.
properties.state

SecurityAlertsPolicyState

Especifica o estado da política, se ela está habilitada ou desabilitada ou se uma política ainda não foi aplicada no banco de dados específico.
properties.storageAccountAccessKey

string

Especifica a chave identificador da conta de armazenamento de auditoria de Deteção de Ameaças.
properties.storageEndpoint

string

Especifica o ponto de extremidade de armazenamento de blob (por exemplo, https://MyAccount.blob.core.windows.net). Esse armazenamento de blob armazenará todos os logs de auditoria de Deteção de Ameaças.
systemData

systemData

SystemData de SecurityAlertPolicyResource.
type

string

Tipo de recurso.

SecurityAlertPolicyName

Enumeração

O nome da política de alerta de segurança.

Valor Description
default

SecurityAlertsPolicyState

Enumeração

Especifica o estado da política, se ela está habilitada ou desabilitada ou se uma política ainda não foi aplicada no banco de dados específico.

Valor Description
Disabled
Enabled

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.