Server DevOps Audit Settings - Create Or Update

Létrehozza vagy frissíti a kiszolgáló DevOps-naplózási beállításait.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/devOpsAuditingSettings/Default?api-version=2025-01-01

URI-paraméterek

Name In Kötelező Típus Description
devOpsAuditingSettingsName
path True

DevOpsAuditingSettingsName

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

serverName
path True

string

A kiszolgáló neve.

subscriptionId
path True

string (uuid)

A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.

api-version
query True

string

minLength: 1

A művelethez használandó API-verzió.

Kérelem törzse

Name Kötelező Típus Description
properties.state True

BlobAuditingPolicyState

A naplózás állapotát adja meg. Ha az állapot engedélyezve van, a storageEndpoint vagy az isAzureMonitorTargetEnabled szükséges.

properties.isAzureMonitorTargetEnabled

boolean

Megadja, hogy DevOps audit eseményei elküldenek-e az Azure Monitor-ba. Az események elküldéséhez az Azure Monitor-hoz a 'State'-et 'Enabled'-ként, 'IsAzureMonitorTargetEnabled'-et pedig true-ként állítsd be.

Amikor REST API-t használ a DevOps-naplózás konfigurálásához, létre kell hozni a diagnosztikai beállításokat a "DevOpsOperationsAudit" diagnosztikai naplókat tartalmazó kategóriával a főadatbázison.

Diagnosztikai beállítások URI formátum: 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

További információ: Diagnosztikai beállítások REST API vagy Diagnosztikai beállítások PowerShell-

properties.isManagedIdentityInUse

boolean

Megadja, hogy a felügyelt identitás használható-e a blobtároló eléréséhez

properties.storageAccountAccessKey

string (password)

Megadja a naplózási tárfiók azonosítókulcsát. Ha az állapot engedélyezve van, és a storageEndpoint meg van adva, a storageAccountAccessKey megadásakor a rendszer által hozzárendelt felügyelt SQL Server-identitás fogja használni a tároló elérését. A felügyelt identitás hitelesítésének előfeltételei:

  1. Assign SQL Server a system-assigned managed identity in Azure Active Directory (AAD).
  2. Az SQL Server identitáshoz való hozzáférést a tárolófiókhoz azzal, hogy hozzáadja a szerver identitásához a 'Storage Blob Data Contributor' RBAC szerepet. További információ: Naplózás a tárolóba felügyelt identitásalapú hitelesítéssel
properties.storageAccountSubscriptionId

string (uuid)

Megadja a Blob Storage-előfizetés azonosítóját.

properties.storageEndpoint

string

Megadja a blobtároló végpontját (például https://MyAccount.blob.core.windows.net). Ha az állapot engedélyezve van, a storageEndpoint vagy az isAzureMonitorTargetEnabled szükséges.

Válaszok

Name Típus Description
200 OK

ServerDevOpsAuditingSettings

Resource 'ServerDevOpsAuditingSettings' frissítési művelete sikeres

202 Accepted

Az erőforrásművelet elfogadott.

Fejlécek

  • Azure-AsyncOperation: string
  • Location: string
Other Status Codes

ErrorResponse

Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

Update a server's DevOps audit settings with all params
Update a server's DevOps audit settings with minimal input

Update a server's DevOps audit settings with all params

Mintakérelem

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/Default?api-version=2025-01-01

{
  "properties": {
    "isAzureMonitorTargetEnabled": true,
    "state": "Enabled",
    "storageAccountAccessKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "storageAccountSubscriptionId": "00000000-1234-0000-5678-000000000000",
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

Mintaválasz

{
  "name": "Default",
  "type": "Microsoft.Sql/servers/devOpsAuditingSettings",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/default",
  "properties": {
    "isAzureMonitorTargetEnabled": true,
    "state": "Enabled",
    "storageAccountSubscriptionId": "00000000-1234-0000-5678-000000000000",
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

Update a server's DevOps audit settings with minimal input

Mintakérelem

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/Default?api-version=2025-01-01

{
  "properties": {
    "state": "Enabled",
    "storageAccountAccessKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

Mintaválasz

{
  "name": "Default",
  "type": "Microsoft.Sql/servers/devOpsAuditingSettings",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/devAuditTestRG/providers/Microsoft.Sql/servers/devOpsAuditTestSvr/devOpsAuditingSettings/default",
  "properties": {
    "state": "Enabled",
    "storageAccountSubscriptionId": "00000000-1234-0000-5678-000000000000",
    "storageEndpoint": "https://mystorage.blob.core.windows.net"
  }
}

Definíciók

Name Description
BlobAuditingPolicyState

A naplózás állapotát adja meg. Ha az állapot engedélyezve van, a storageEndpoint vagy az isAzureMonitorTargetEnabled szükséges.

createdByType

Az erőforrást létrehozó identitás típusa.

DevOpsAuditingSettingsName
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

ServerDevOpsAuditingSettings

Kiszolgálói DevOps-naplózási beállítások.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

BlobAuditingPolicyState

A naplózás állapotát adja meg. Ha az állapot engedélyezve van, a storageEndpoint vagy az isAzureMonitorTargetEnabled szükséges.

Érték Description
Enabled

Engedélyezett

Disabled

Disabled

createdByType

Az erőforrást létrehozó identitás típusa.

Érték Description
User
Application
ManagedIdentity
Key

DevOpsAuditingSettingsName

Érték Description
Default

Alapértelmezett

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hiba célpontja.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

ServerDevOpsAuditingSettings

Kiszolgálói DevOps-naplózási beállítások.

Name Típus Description
id

string (arm-id)

Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Az erőforrás neve

properties.isAzureMonitorTargetEnabled

boolean

Megadja, hogy DevOps audit eseményei elküldenek-e az Azure Monitor-ba. Az események elküldéséhez az Azure Monitor-hoz a 'State'-et 'Enabled'-ként, 'IsAzureMonitorTargetEnabled'-et pedig true-ként állítsd be.

Amikor REST API-t használ a DevOps-naplózás konfigurálásához, létre kell hozni a diagnosztikai beállításokat a "DevOpsOperationsAudit" diagnosztikai naplókat tartalmazó kategóriával a főadatbázison.

Diagnosztikai beállítások URI formátum: 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

További információ: Diagnosztikai beállítások REST API vagy Diagnosztikai beállítások PowerShell-

properties.isManagedIdentityInUse

boolean

Megadja, hogy a felügyelt identitás használható-e a blobtároló eléréséhez

properties.state

BlobAuditingPolicyState

A naplózás állapotát adja meg. Ha az állapot engedélyezve van, a storageEndpoint vagy az isAzureMonitorTargetEnabled szükséges.

properties.storageAccountAccessKey

string (password)

Megadja a naplózási tárfiók azonosítókulcsát. Ha az állapot engedélyezve van, és a storageEndpoint meg van adva, a storageAccountAccessKey megadásakor a rendszer által hozzárendelt felügyelt SQL Server-identitás fogja használni a tároló elérését. A felügyelt identitás hitelesítésének előfeltételei:

  1. Assign SQL Server a system-assigned managed identity in Azure Active Directory (AAD).
  2. Az SQL Server identitáshoz való hozzáférést a tárolófiókhoz azzal, hogy hozzáadja a szerver identitásához a 'Storage Blob Data Contributor' RBAC szerepet. További információ: Naplózás a tárolóba felügyelt identitásalapú hitelesítéssel
properties.storageAccountSubscriptionId

string (uuid)

Megadja a Blob Storage-előfizetés azonosítóját.

properties.storageEndpoint

string

Megadja a blobtároló végpontját (például https://MyAccount.blob.core.windows.net). Ha az állapot engedélyezve van, a storageEndpoint vagy az isAzureMonitorTargetEnabled szükséges.

systemData

systemData

Azure Resource Manager metaadat, amely createdBy és modifiedBy információkat tartalmaz.

type

string

Az erőforrás típusa. Például: "Microsoft. Compute/virtualMachines" vagy "Microsoft. Tárhely/tárolásFiókok"

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Típus Description
createdAt

string (date-time)

Az erőforrás-létrehozás időbélyege (UTC).

createdBy

string

Az erőforrást létrehozó identitás.

createdByType

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt

string (date-time)

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy

string

Az erőforrást legutóbb módosító identitás.

lastModifiedByType

createdByType

Az erőforrást legutóbb módosító identitás típusa.