Server DevOps Audit Settings - Create Or Update
Cria ou atualiza as configurações de auditoria de DevOps de um servidor.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/devOpsAuditingSettings/Default?api-version=2023-08-01
Parâmetros do URI
| Name | Em | Necessário | Tipo | Description |
|---|---|---|---|---|
|
dev
|
path | True | ||
|
resource
|
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. |
|
server
|
path | True |
string |
O nome do servidor. |
|
subscription
|
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. |
Corpo do Pedido
| Name | Necessário | Tipo | Description |
|---|---|---|---|
| properties.state | True |
Especifica o estado da auditoria. Se o estado for Enabled, storageEndpoint ou isAzureMonitorTargetEnabled serão necessários. |
|
| properties.isAzureMonitorTargetEnabled |
boolean |
Especifica se os eventos de auditoria do DevOps são enviados para o Azure Monitor. Para enviar os eventos para o Azure Monitor, especifique 'State' como 'Enabled' e 'IsAzureMonitorTargetEnabled' como true. 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 Para obter mais informações, consulte API REST de configurações de diagnóstico ou Configurações de diagnóstico PowerShell |
|
| properties.isManagedIdentityInUse |
boolean |
Especifica se a Identidade Gerenciada é usada para acessar o armazenamento de blob |
|
| properties.storageAccountAccessKey |
string |
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:
|
|
| properties.storageAccountSubscriptionId |
string (uuid) |
Especifica a ID da assinatura de armazenamento de blob. |
|
| properties.storageEndpoint |
string |
Especifica o ponto de extremidade de armazenamento de blob (por exemplo, |
Respostas
| Name | Tipo | Description |
|---|---|---|
| 200 OK |
Atualizadas com êxito as configurações de auditoria de DevOps. |
|
| 202 Accepted |
A atualização das configurações de DevOps de auditoria está em andamento. Cabeçalhos Location: string |
|
| Other Status Codes |
Respostas de erro: ***
|
Exemplos
|
Update a server's Dev |
|
Update a server's Dev |
Update a server's DevOps audit settings with all params
Pedido de amostra
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/Default?api-version=2023-08-01
{
"properties": {
"state": "Enabled",
"storageAccountAccessKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"storageEndpoint": "https://mystorage.blob.core.windows.net",
"storageAccountSubscriptionId": "00000000-1234-0000-5678-000000000000",
"isAzureMonitorTargetEnabled": true
}
}
Resposta da amostra
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/default",
"name": "Default",
"type": "Microsoft.Sql/servers/devOpsAuditingSettings",
"properties": {
"state": "Enabled",
"storageEndpoint": "https://mystorage.blob.core.windows.net",
"storageAccountSubscriptionId": "00000000-1234-0000-5678-000000000000",
"isAzureMonitorTargetEnabled": true
}
}
Update a server's DevOps audit settings with minimal input
Pedido de amostra
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/Default?api-version=2023-08-01
{
"properties": {
"state": "Enabled",
"storageAccountAccessKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"storageEndpoint": "https://mystorage.blob.core.windows.net"
}
}
Resposta da amostra
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/default",
"name": "Default",
"type": "Microsoft.Sql/servers/devOpsAuditingSettings",
"properties": {
"state": "Enabled",
"storageEndpoint": "https://mystorage.blob.core.windows.net",
"storageAccountSubscriptionId": "00000000-1234-0000-5678-000000000000"
}
}
Definições
| Name | Description |
|---|---|
|
Blob |
Especifica o estado da auditoria. Se o estado for Enabled, storageEndpoint ou isAzureMonitorTargetEnabled serão necessários. |
|
created |
O tipo de identidade que criou o recurso. |
|
Dev |
|
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
Server |
Configurações de auditoria de DevOps de um servidor. |
|
system |
Metadados referentes à criação e última modificação do recurso. |
BlobAuditingPolicyState
Especifica o estado da auditoria. Se o estado for Enabled, storageEndpoint ou isAzureMonitorTargetEnabled serão necessários.
| Valor | Description |
|---|---|
| Enabled | |
| Disabled |
createdByType
O tipo de identidade que criou o recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DevOpsAuditingSettingsName
| Valor | Description |
|---|---|
| Default |
ErrorAdditionalInfo
O erro de gerenciamento de recursos informações adicionais.
| Name | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Name | Tipo | Description |
|---|---|---|
| additionalInfo |
O erro informações adicionais. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Name | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
ServerDevOpsAuditingSettings
Configurações de auditoria de DevOps de um servidor.
| Name | Tipo | Description |
|---|---|---|
| id |
string |
ID do recurso. |
| name |
string |
Nome do recurso. |
| properties.isAzureMonitorTargetEnabled |
boolean |
Especifica se os eventos de auditoria do DevOps são enviados para o Azure Monitor. Para enviar os eventos para o Azure Monitor, especifique 'State' como 'Enabled' e 'IsAzureMonitorTargetEnabled' como true. 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 Para obter mais informações, consulte API REST de configurações de diagnóstico ou Configurações de diagnóstico PowerShell |
| properties.isManagedIdentityInUse |
boolean |
Especifica se a Identidade Gerenciada é usada para acessar o armazenamento de blob |
| properties.state |
Especifica o estado da auditoria. Se o estado for Enabled, storageEndpoint ou isAzureMonitorTargetEnabled serão necessários. |
|
| properties.storageAccountAccessKey |
string |
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:
|
| properties.storageAccountSubscriptionId |
string (uuid) |
Especifica a ID da assinatura de armazenamento de blob. |
| properties.storageEndpoint |
string |
Especifica o ponto de extremidade de armazenamento de blob (por exemplo, |
| systemData |
SystemData de ServerDevOpsAuditSettingsResource. |
|
| type |
string |
Tipo de recurso. |
systemData
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 |
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 |
O tipo de identidade que modificou o recurso pela última vez. |