Partilhar via

Managed 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 gerenciado.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/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 gerenciado para o qual a diretiva de alerta de segurança está definida.
managedInstanceName
 path True

string

O nome da instância gerenciada.
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.
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

ManagedDatabaseSecurityAlertPolicy

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

Respostas de erro: ***

  • 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 UpdateNotAllowedOnServerContainingPausedDWDatabase - Não é permitida a configuração de configurações de Deteção de Ameaças do servidor em um servidor com um banco de dados do Data Warehouse pausado

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

  • 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 InvalidServerSecurityAlertPolicyCreateRequest - A solicitação de política de alerta de segurança de deteção de ameaças para criar servidor 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 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de deteção de ameaças, tente novamente mais tarde

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

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

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

  • 409 ServerSecurityAlertPolicyInProgress - Definir a política de alerta de segurança do servidor já está em andamento

  • 409 UpsertServerSecurityAlertPolicyFailed - 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 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de deteção de ameaças, tente novamente mais tarde

  • 500 GetServerSecurityAlertPolicyFailed - 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/managedInstances/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/managedInstances/securityalert-2080/databases/testdb",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/databases/securityAlertPolicies",
  "properties": {
    "state": "Enabled",
    "emailAccountAdmins": true,
    "emailAddresses": [
      "test@contoso.com",
      "user@contoso.com"
    ],
    "disabledAlerts": [
      "Usage_Anomaly"
    ],
    "retentionDays": 0,
    "storageAccountAccessKey": "",
    "storageEndpoint": ""
  }
}

Definições

Name Description
ManagedDatabaseSecurityAlertPolicy

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

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

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.

ManagedDatabaseSecurityAlertPolicy

Object

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

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

SecurityAlertPolicyState

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.
type

string

Tipo de recurso.

SecurityAlertPolicyName

Enumeração

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

Valor Description
default

SecurityAlertPolicyState

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
New