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 |
|---|---|---|---|---|
|
dev
|
path | True | ||
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
|
server
|
path | True |
string |
A kiszolgáló neve. |
|
subscription
|
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 |
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 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:
|
|
| 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 |
Válaszok
| Name | Típus | Description |
|---|---|---|
| 200 OK |
Resource 'ServerDevOpsAuditingSettings' frissítési művelete sikeres |
|
| 202 Accepted |
Az erőforrásművelet elfogadott. Fejlécek
|
|
| Other Status Codes |
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 Dev |
|
Update a server's Dev |
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 |
|---|---|
|
Blob |
A naplózás állapotát adja meg. Ha az állapot engedélyezve van, a storageEndpoint vagy az isAzureMonitorTargetEnabled szükséges. |
|
created |
Az erőforrást létrehozó identitás típusa. |
|
Dev |
|
|
Error |
Az erőforrás-kezelési hiba további információi. |
|
Error |
A hiba részletei. |
|
Error |
Hibaválasz |
|
Server |
Kiszolgálói DevOps-naplózási beállítások. |
|
system |
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 |
A hiba további információi. |
|
| code |
string |
A hibakód. |
| details |
A hiba részletei. |
|
| message |
string |
A hibaüzenet. |
| target |
string |
A hiba célpontja. |
ErrorResponse
Hibaválasz
| Name | Típus | Description |
|---|---|---|
| error |
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 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 |
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:
|
| 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 |
| 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 |
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 |
Az erőforrást legutóbb módosító identitás típusa. |