Partilhar via

Managed Server Security Alert Policies - List By Instance

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

Obtenha as políticas de deteção de ameaças do servidor gerido.

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

Parâmetros do URI

Name Em Necessário Tipo Description
managedInstanceName
 path True

string

O nome da instância gerida.
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
subscriptionId
 path True

string

O ID da subscrição que identifica uma subscrição do Azure.
api-version
 query True

string

A versão da API a utilizar para o pedido.

Respostas

Name Tipo Description
200 OK

ManagedServerSecurityAlertPolicyListResult

As políticas de deteção de ameaças do servidor gerido foram obtidas com êxito.
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 – a definição de definições de Deteção de Ameaças do servidor não é permitida num servidor com uma base de dados Data Warehouse em pausa

  • 400 SecurityAlertPoliciesInsufficientDiskSpace – Espaço em disco insuficiente para guardar metadados da política de alertas de segurança na base de dados

  • 400 SecurityAlertPoliciesInsufficientStorageAccountPermissions – permissões de leitura ou escrita 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 – o pedido de política de alerta de segurança de Deteção de Ameaças do servidor de criação 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 guardar as definições de deteção de ameaças. Tente novamente mais tarde

  • 400 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao guardar as definições de deteção de ameaças. Tente novamente mais tarde

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

  • 404 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao guardar as definiçõ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 curso

  • 409 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao guardar as definições de deteção de ameaças. Tente novamente mais tarde

  • 500 DatabaseIsUnavailable – O carregamento falhou. Tente novamente mais tarde.

  • 500 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao guardar as definições de deteção de ameaças. Tente novamente mais tarde

  • 500 GetServerSecurityAlertPolicyFailed – Falha ao obter as definições de Deteção de Ameaças

Exemplos

Get the managed server's threat detection policies

Pedido de amostra

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

Resposta da amostra

Código de estado:
200 
{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/managedInstances/securityalert-6440",
      "name": "Default",
      "type": "Microsoft.Sql/managedInstances/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": "Disabled",
        "emailAccountAdmins": true,
        "emailAddresses": [
          "test@consoto.com;user@consoto.com"
        ],
        "disabledAlerts": [
          "Access_Anomaly"
        ],
        "retentionDays": 0,
        "storageAccountAccessKey": "",
        "storageEndpoint": "",
        "creationTime": "2020-04-03T04:41:33.937Z"
      }
    }
  ]
}

Definições

Name Description
createdByType

O tipo de identidade que criou o recurso.
ManagedServerSecurityAlertPolicy

Uma política de alerta de segurança do servidor gerido.
ManagedServerSecurityAlertPolicyListResult

Uma lista das políticas de alerta de segurança do Servidor gerido.
SecurityAlertsPolicyState

Especifica o estado da política, se está ativada ou desativada ou se ainda não foi aplicada uma política na base de dados específica.
systemData

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

createdByType

Enumeration

O tipo de identidade que criou o recurso.

Valor Description
Application
Key
ManagedIdentity
User

ManagedServerSecurityAlertPolicy

Object

Uma política de alerta de segurança do servidor gerido.

Name Tipo Description
id

string

ID do Recurso.
name

string

Nome do recurso.
properties.creationTime

string

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

string[]

Especifica uma matriz de alertas que estão desativados. 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 para os administradores de conta.
properties.emailAddresses

string[]

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

integer

Especifica o número de dias a manter nos registos de auditoria da Deteção de Ameaças.
properties.state

SecurityAlertsPolicyState

Especifica o estado da política, se está ativada ou desativada ou se ainda não foi aplicada uma política na base de dados específica.
properties.storageAccountAccessKey

string

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

string

Especifica o ponto final de armazenamento de blobs (por exemplo, https://MyAccount.blob.core.windows.net). Este armazenamento de blobs irá conter todos os registos de auditoria da Deteção de Ameaças.
systemData

systemData

SystemData de SecurityAlertPolicyResource.
type

string

Tipo de recurso.

ManagedServerSecurityAlertPolicyListResult

Object

Uma lista das políticas de alerta de segurança do Servidor gerido.

Name Tipo Description
nextLink

string

Ligação para obter a página seguinte dos resultados.
value

ManagedServerSecurityAlertPolicy[]

Matriz de resultados.

SecurityAlertsPolicyState

Enumeration

Especifica o estado da política, se está ativada ou desativada ou se ainda não foi aplicada uma política na base de dados específica.

Valor Description
Disabled
Enabled

systemData

Object

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

Name Tipo Description
createdAt

string

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

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.