Server Security Alert Policies - Get

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Obter a política de alerta de segurança de um servidor.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio 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

Nome	Tipo	Description
200 OK	ServerSecurityAlertPolicy	A política de detecção de ameaças do servidor foi recuperada 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 configuração das configurações de Detecção de Ameaças do servidor não é permitida em um servidor com um banco de dados 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 detecção de ameaças está desabilitada. 400 InvalidServerSecurityAlertPolicyCreateRequest - A solicitação de política de alerta de segurança de Detecção de Ameaças do servidor de criação não existe ou não tem nenhum objeto properties. 400 DataSecurityInvalidUserSuppliedParameter - Um valor de parâmetro inválido foi fornecido pelo cliente. 400 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de detecção de ameaças. Tente novamente mais tarde 400 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de detecçã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 detecção de ameaças. Tente novamente mais tarde 409 ServerSecurityAlertPolicyInProgress - Definir política de alerta de segurança do servidor já está em andamento 409 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de detecçã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 detecção de ameaças. Tente novamente mais tarde 500 GetServerSecurityAlertPolicyFailed - Falha ao obter as configurações de Detecção de Ameaças

Nome

Tipo

Description

200 OK

ServerSecurityAlertPolicy

A política de detecção de ameaças do servidor foi recuperada 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 configuração das configurações de Detecção de Ameaças do servidor não é permitida em um servidor com um banco de dados 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 detecção de ameaças está desabilitada.
400 InvalidServerSecurityAlertPolicyCreateRequest - A solicitação de política de alerta de segurança de Detecção de Ameaças do servidor de criação não existe ou não tem nenhum objeto properties.
400 DataSecurityInvalidUserSuppliedParameter - Um valor de parâmetro inválido foi fornecido pelo cliente.
400 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de detecção de ameaças. Tente novamente mais tarde
400 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de detecçã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 detecção de ameaças. Tente novamente mais tarde
409 ServerSecurityAlertPolicyInProgress - Definir política de alerta de segurança do servidor já está em andamento
409 UpsertServerSecurityAlertPolicyFailed - Ocorreu um erro ao salvar as configurações de detecçã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 detecção de ameaças. Tente novamente mais tarde
500 GetServerSecurityAlertPolicyFailed - Falha ao obter as configurações de Detecção de Ameaças

Exemplos

Get a server's threat detection policy

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


import com.azure.resourcemanager.sql.models.SecurityAlertPolicyNameAutoGenerated;

/**
 * Samples for ServerSecurityAlertPolicies Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerSecurityAlertsGet.json
     */
    /**
     * Sample code: Get a server's threat detection policy.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAServerSThreatDetectionPolicy(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerSecurityAlertPolicies().getWithResponse(
            "securityalert-4799", "securityalert-6440", SecurityAlertPolicyNameAutoGenerated.DEFAULT,
            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

Resposta de exemplo

Código de status:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securityalert-4799/providers/Microsoft.Sql/servers/securityalert-6440/securityAlertPolicies/default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/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",
    "creationTime": "2020-04-03T04:41:33.937Z",
    "emailAccountAdmins": true,
    "emailAddresses": [
      "test@consoto.com;user@consoto.com"
    ],
    "disabledAlerts": [
      "Access_Anomaly"
    ],
    "retentionDays": 0,
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
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 uma política ainda não foi aplicada no banco de dados específico.
ServerSecurityAlertPolicy	Uma política de alerta de segurança do servidor.
systemData	Metadados relativos à criação e à última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

SecurityAlertPolicyName

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

Nome	Tipo	Description
Default	string

SecurityAlertsPolicyState

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

Nome	Tipo	Description
Disabled	string
Enabled	string

ServerSecurityAlertPolicy

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

Nome	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 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 da conta.
properties.emailAddresses	string[]	Especifica uma matriz de endereços de email para os quais o alerta é enviado.
properties.retentionDays	integer	Especifica o número de dias a serem mantidos nos logs de auditoria de Detecção de Ameaças.
properties.state	SecurityAlertsPolicyState	Especifica o estado da política, se ela está habilitada ou desabilitada ou uma política ainda não foi aplicada no banco de dados específico.
properties.storageAccountAccessKey	string	Especifica a chave de identificador da conta de armazenamento de auditoria de Detecção de Ameaças.
properties.storageEndpoint	string	Especifica o ponto de extremidade de armazenamento de blobs (por exemplo, https://MyAccount.blob.core.windows.net). Esse armazenamento de blobs conterá todos os logs de auditoria de Detecção de Ameaças.
systemData	systemData	SystemData de SecurityAlertPolicyResource.
type	string	Tipo de recurso.

systemData

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

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

Compartilhar via

Server Security Alert Policies - Get

Parâmetros de URI

Respostas

Exemplos

Get a server's threat detection policy

Solicitação de exemplo

Resposta de exemplo

Definições

createdByType

SecurityAlertPolicyName

SecurityAlertsPolicyState

ServerSecurityAlertPolicy

systemData

Recursos adicionais