Server DevOps Audit Settings - Create Or Update
Vytvoří nebo aktualizuje nastavení auditu DevOps serveru.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/devOpsAuditingSettings/Default?api-version=2025-01-01
Parametry identifikátoru URI
| Název | V | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
dev
|
path | True | ||
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Název skupiny prostředků. Název nerozlišuje malá a velká písmena. |
|
server
|
path | True |
string |
Název serveru. |
|
subscription
|
path | True |
string (uuid) |
ID cílového předplatného. Hodnota musí být UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Verze rozhraní API, která se má použít pro tuto operaci. |
Text požadavku
| Název | Vyžadováno | Typ | Description |
|---|---|---|---|
| properties.state | True |
Určuje stav auditu. Pokud je stav Povoleno, jsou vyžadovány hodnoty storageEndpoint nebo isAzureMonitorTargetEnabled. |
|
| properties.isAzureMonitorTargetEnabled |
boolean |
Specifikuje, zda jsou auditní události DevOps odesílány do Azure Monitor. Pro odeslání událostí do Azure Monitor určete 'State' jako 'Enabled' a 'IsAzureMonitorTargetEnabled' jako true. Při konfiguraci auditování DevOps je potřeba vytvořit také nastavení diagnostiky s kategorií diagnostických protokolů DevOpsOperationsAudit v hlavní databázi. Diagnostická nastavení URI formát: PUT Další informace najdete v tématu rozhraní REST API pro nastavení diagnostiky nebo nastavení diagnostiky |
|
| properties.isManagedIdentityInUse |
boolean |
Určuje, jestli se spravovaná identita používá pro přístup k úložišti objektů blob. |
|
| properties.storageAccountAccessKey |
string (password) |
Určuje identifikátor klíče účtu úložiště auditování. Pokud je stav Povoleno a parametr storageEndpoint je zadaný, nezadávejte klíč storageAccountAccessKey pro přístup k úložišti spravovanou identitu přiřazenou systémem sql serveru. Předpoklady pro použití ověřování spravované identity:
|
|
| properties.storageAccountSubscriptionId |
string (uuid) |
Určuje ID předplatného úložiště objektů blob. |
|
| properties.storageEndpoint |
string |
Určuje koncový bod úložiště objektů blob (např. |
Odpovědi
| Název | Typ | Description |
|---|---|---|
| 200 OK |
Aktualizace zdroje 'ServerDevOpsAuditingSettings' byla úspěšná |
|
| 202 Accepted |
Operace prostředku byla přijata. Hlavičky
|
|
| Other Status Codes |
Neočekávaná chybová odpověď |
Zabezpečení
azure_auth
Tok OAuth2 služby Azure Active Directory.
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
| Název | Description |
|---|---|
| user_impersonation | zosobnění uživatelského účtu |
Příklady
|
Update a server's Dev |
|
Update a server's Dev |
Update a server's DevOps audit settings with all params
Ukázkový požadavek
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"
}
}
Ukázková odpověď
{
"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
Ukázkový požadavek
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"
}
}
Ukázková odpověď
{
"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"
}
}
Definice
| Název | Description |
|---|---|
|
Blob |
Určuje stav auditu. Pokud je stav Povoleno, jsou vyžadovány hodnoty storageEndpoint nebo isAzureMonitorTargetEnabled. |
|
created |
Typ identity, která prostředek vytvořila. |
|
Dev |
|
|
Error |
Další informace o chybě správy prostředků |
|
Error |
Podrobnosti o chybě. |
|
Error |
Chybová odpověď |
|
Server |
Nastavení auditování DevOps serveru |
|
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
BlobAuditingPolicyState
Určuje stav auditu. Pokud je stav Povoleno, jsou vyžadovány hodnoty storageEndpoint nebo isAzureMonitorTargetEnabled.
| Hodnota | Description |
|---|---|
| Enabled |
Enabled |
| Disabled |
Disabled |
createdByType
Typ identity, která prostředek vytvořila.
| Hodnota | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DevOpsAuditingSettingsName
| Hodnota | Description |
|---|---|
| Default |
Výchozí |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
| Název | Typ | Description |
|---|---|---|
| info |
object |
Další informace. |
| type |
string |
Další typ informací. |
ErrorDetail
Podrobnosti o chybě.
| Název | Typ | Description |
|---|---|---|
| additionalInfo |
Další informace o chybě. |
|
| code |
string |
Kód chyby. |
| details |
Podrobnosti o chybě. |
|
| message |
string |
Chybová zpráva. |
| target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
| Název | Typ | Description |
|---|---|---|
| error |
Objekt chyby. |
ServerDevOpsAuditingSettings
Nastavení auditování DevOps serveru
| Název | Typ | Description |
|---|---|---|
| id |
string (arm-id) |
Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Název prostředku |
| properties.isAzureMonitorTargetEnabled |
boolean |
Specifikuje, zda jsou auditní události DevOps odesílány do Azure Monitor. Pro odeslání událostí do Azure Monitor určete 'State' jako 'Enabled' a 'IsAzureMonitorTargetEnabled' jako true. Při konfiguraci auditování DevOps je potřeba vytvořit také nastavení diagnostiky s kategorií diagnostických protokolů DevOpsOperationsAudit v hlavní databázi. Diagnostická nastavení URI formát: PUT Další informace najdete v tématu rozhraní REST API pro nastavení diagnostiky nebo nastavení diagnostiky |
| properties.isManagedIdentityInUse |
boolean |
Určuje, jestli se spravovaná identita používá pro přístup k úložišti objektů blob. |
| properties.state |
Určuje stav auditu. Pokud je stav Povoleno, jsou vyžadovány hodnoty storageEndpoint nebo isAzureMonitorTargetEnabled. |
|
| properties.storageAccountAccessKey |
string (password) |
Určuje identifikátor klíče účtu úložiště auditování. Pokud je stav Povoleno a parametr storageEndpoint je zadaný, nezadávejte klíč storageAccountAccessKey pro přístup k úložišti spravovanou identitu přiřazenou systémem sql serveru. Předpoklady pro použití ověřování spravované identity:
|
| properties.storageAccountSubscriptionId |
string (uuid) |
Určuje ID předplatného úložiště objektů blob. |
| properties.storageEndpoint |
string |
Určuje koncový bod úložiště objektů blob (např. |
| systemData |
Azure Resource Manager metadata obsahující informace createdBy a modifiedBy. |
|
| type |
string |
Typ prostředku. Například "Microsoft. Compute/virtualMachines" nebo "Microsoft. Úložiště/úložištěÚčty" |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
| Název | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Časové razítko vytvoření prostředku (UTC). |
| createdBy |
string |
Identita, která prostředek vytvořila. |
| createdByType |
Typ identity, která prostředek vytvořila. |
|
| lastModifiedAt |
string (date-time) |
Časové razítko poslední změny zdroje (UTC) |
| lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
| lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |