Partilhar via


Microsoft. Servidores SQL/devOpsAuditingSettings

Definição de recurso Bicep

O tipo de recurso servers/devOpsAuditingSettings pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar uma Microsoft. Recurso Sql/servers/devOpsAuditingSettings, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Sql/servers/devOpsAuditingSettings@2025-02-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    isAzureMonitorTargetEnabled: bool
    isManagedIdentityInUse: bool
    state: 'string'
    storageAccountAccessKey: 'string'
    storageAccountSubscriptionId: 'string'
    storageEndpoint: 'string'
  }
}

Valores de propriedade

Microsoft. Sql/servers/devOpsAuditingSettings

Name Description Value
name O nome do recurso 'Padrão' (obrigatório)
elemento principal No Bicep, podes especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.
Nome simbólico para recurso do tipo: servidores
properties Propriedades do recurso. ServerDevOpsAuditSettingsProperties

ServerDevOpsAuditSettingsProperties

Name Description Value
isAzureMonitorTargetEnabled Especifica se os eventos de auditoria DevOps são enviados para o Azure Monitor.
Para enviar os eventos para o Azure Monitor, especifique 'State' como 'Enabled' e 'IsAzureMonitorTargetEnabled' como verdadeiros.

Ao usar a API REST para configurar a auditoria de DevOps, as Configurações de Diagnóstico com a categoria de logs de diagnóstico 'DevOpsOperationsAudit' no banco de dados mestre também devem ser criadas.

Formato URI das configurações de diagnóstico:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/master/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview

Para obter mais informações, consulte API REST de configurações de diagnóstico
ou Configurações de Diagnóstico PowerShell
bool
isManagedIdentityInUse Especifica se a Identidade Gerenciada é usada para acessar o armazenamento de blob bool
state Especifica o estado da auditoria. Se o estado for Enabled, storageEndpoint ou isAzureMonitorTargetEnabled serão necessários. 'Disabled'
'Ativado' (obrigatório)
storageAccountAccessKey Especifica a chave identificador da conta de armazenamento de auditoria.
Se state for Enabled e storageEndpoint for especificado, não especificar o storageAccountAccessKey usará a identidade gerenciada atribuída pelo sistema do SQL Server para acessar o armazenamento.
Pré-requisitos para usar a autenticação de identidade gerenciada:
1. Atribuir ao SQL Server uma identidade gerida atribuída pelo sistema no Azure Active Directory (AAD).
2. Conceder acesso à identidade do SQL Server à conta de armazenamento adicionando o papel RBAC 'Storage Blob Data Contributor' à identidade do servidor.
Para obter mais informações, consulte Auditoria de armazenamento usando autenticação de identidade gerenciada
string

Constraints:
Valor sensível. Passe como um parâmetro seguro.
storageAccountSubscriptionId Especifica a ID da assinatura de armazenamento de blob. string

Constraints:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageEndpoint Especifica o ponto de extremidade de armazenamento de blob (por exemplo, https://MyAccount.blob.core.windows.net). Se o estado for Enabled, storageEndpoint ou isAzureMonitorTargetEnabled será necessário. cadeia (de caracteres)

Exemplos de uso

Azure Quickstart Samples

Os seguintes modelos Azure Quickstart contêm Bicep exemplos para implementar este tipo de recurso.

Ficheiro Bicep Description
Azure SQL Server com Auditoria escrita para Log Analytics Este modelo permite-lhe implementar um servidor SQL do Azure com Auditoria ativada para escrever registos de auditoria no Log Analytics (espaço de trabalho OMS)

Definição de recurso de modelo ARM

O tipo de recurso servers/devOpsAuditingSettings pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar uma Microsoft. Sql/servers/devOpsAuditingSettings, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Sql/servers/devOpsAuditingSettings",
  "apiVersion": "2025-02-01-preview",
  "name": "string",
  "properties": {
    "isAzureMonitorTargetEnabled": "bool",
    "isManagedIdentityInUse": "bool",
    "state": "string",
    "storageAccountAccessKey": "string",
    "storageAccountSubscriptionId": "string",
    "storageEndpoint": "string"
  }
}

Valores de propriedade

Microsoft. Sql/servers/devOpsAuditingSettings

Name Description Value
apiVersion A versão api '2025-02-01-pré-visualização'
name O nome do recurso 'Padrão' (obrigatório)
properties Propriedades do recurso. ServerDevOpsAuditSettingsProperties
tipo O tipo de recurso 'Microsoft. Sql/servers/devOpsAuditingSettings'

ServerDevOpsAuditSettingsProperties

Name Description Value
isAzureMonitorTargetEnabled Especifica se os eventos de auditoria DevOps são enviados para o Azure Monitor.
Para enviar os eventos para o Azure Monitor, especifique 'State' como 'Enabled' e 'IsAzureMonitorTargetEnabled' como verdadeiros.

Ao usar a API REST para configurar a auditoria de DevOps, as Configurações de Diagnóstico com a categoria de logs de diagnóstico 'DevOpsOperationsAudit' no banco de dados mestre também devem ser criadas.

Formato URI das configurações de diagnóstico:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/master/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview

Para obter mais informações, consulte API REST de configurações de diagnóstico
ou Configurações de Diagnóstico PowerShell
bool
isManagedIdentityInUse Especifica se a Identidade Gerenciada é usada para acessar o armazenamento de blob bool
state Especifica o estado da auditoria. Se o estado for Enabled, storageEndpoint ou isAzureMonitorTargetEnabled serão necessários. 'Disabled'
'Ativado' (obrigatório)
storageAccountAccessKey Especifica a chave identificador da conta de armazenamento de auditoria.
Se state for Enabled e storageEndpoint for especificado, não especificar o storageAccountAccessKey usará a identidade gerenciada atribuída pelo sistema do SQL Server para acessar o armazenamento.
Pré-requisitos para usar a autenticação de identidade gerenciada:
1. Atribuir ao SQL Server uma identidade gerida atribuída pelo sistema no Azure Active Directory (AAD).
2. Conceder acesso à identidade do SQL Server à conta de armazenamento adicionando o papel RBAC 'Storage Blob Data Contributor' à identidade do servidor.
Para obter mais informações, consulte Auditoria de armazenamento usando autenticação de identidade gerenciada
string

Constraints:
Valor sensível. Passe como um parâmetro seguro.
storageAccountSubscriptionId Especifica a ID da assinatura de armazenamento de blob. string

Constraints:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageEndpoint Especifica o ponto de extremidade de armazenamento de blob (por exemplo, https://MyAccount.blob.core.windows.net). Se o estado for Enabled, storageEndpoint ou isAzureMonitorTargetEnabled será necessário. cadeia (de caracteres)

Exemplos de uso

Modelos de Início Rápido do Azure

Os seguintes modelos Azure Quickstart implementam este tipo de recurso.

Template Description
Azure SQL Server com Auditoria escrita para Log Analytics

Implementar para Azure
Este modelo permite-lhe implementar um servidor SQL do Azure com Auditoria ativada para escrever registos de auditoria no Log Analytics (espaço de trabalho OMS)

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso servers/devOpsAuditingSettings pode ser implantado com operações direcionadas:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar uma Microsoft. Sql/servers/devOpsAuditingSettings, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/devOpsAuditingSettings@2025-02-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      isAzureMonitorTargetEnabled = bool
      isManagedIdentityInUse = bool
      state = "string"
      storageAccountAccessKey = "string"
      storageAccountSubscriptionId = "string"
      storageEndpoint = "string"
    }
  }
}

Valores de propriedade

Microsoft. Sql/servers/devOpsAuditingSettings

Name Description Value
name O nome do recurso 'Padrão' (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID para recurso do tipo: servidores
properties Propriedades do recurso. ServerDevOpsAuditSettingsProperties
tipo O tipo de recurso "Microsoft. Sql/servidores/devOpsAuditingSettings@2025-02-01-pré-visualização"

ServerDevOpsAuditSettingsProperties

Name Description Value
isAzureMonitorTargetEnabled Especifica se os eventos de auditoria DevOps são enviados para o Azure Monitor.
Para enviar os eventos para o Azure Monitor, especifique 'State' como 'Enabled' e 'IsAzureMonitorTargetEnabled' como verdadeiros.

Ao usar a API REST para configurar a auditoria de DevOps, as Configurações de Diagnóstico com a categoria de logs de diagnóstico 'DevOpsOperationsAudit' no banco de dados mestre também devem ser criadas.

Formato URI das configurações de diagnóstico:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/master/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview

Para obter mais informações, consulte API REST de configurações de diagnóstico
ou Configurações de Diagnóstico PowerShell
bool
isManagedIdentityInUse Especifica se a Identidade Gerenciada é usada para acessar o armazenamento de blob bool
state Especifica o estado da auditoria. Se o estado for Enabled, storageEndpoint ou isAzureMonitorTargetEnabled serão necessários. 'Disabled'
'Ativado' (obrigatório)
storageAccountAccessKey Especifica a chave identificador da conta de armazenamento de auditoria.
Se state for Enabled e storageEndpoint for especificado, não especificar o storageAccountAccessKey usará a identidade gerenciada atribuída pelo sistema do SQL Server para acessar o armazenamento.
Pré-requisitos para usar a autenticação de identidade gerenciada:
1. Atribuir ao SQL Server uma identidade gerida atribuída pelo sistema no Azure Active Directory (AAD).
2. Conceder acesso à identidade do SQL Server à conta de armazenamento adicionando o papel RBAC 'Storage Blob Data Contributor' à identidade do servidor.
Para obter mais informações, consulte Auditoria de armazenamento usando autenticação de identidade gerenciada
string

Constraints:
Valor sensível. Passe como um parâmetro seguro.
storageAccountSubscriptionId Especifica a ID da assinatura de armazenamento de blob. string

Constraints:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageEndpoint Especifica o ponto de extremidade de armazenamento de blob (por exemplo, https://MyAccount.blob.core.windows.net). Se o estado for Enabled, storageEndpoint ou isAzureMonitorTargetEnabled será necessário. cadeia (de caracteres)