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=2023-08-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
dev
|
path | True | ||
resource
|
path | True |
string |
Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu. |
server
|
path | True |
string |
Název serveru. |
subscription
|
path | True |
string |
ID předplatného, které identifikuje předplatné Azure. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro požadavek. |
Text požadavku
Name | 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 |
Určuje, jestli se události auditu DevOps odesílají do služby Azure Monitor. Pokud chcete odesílat události do služby Azure Monitor, jako true zadejte State a IsAzureMonitorTargetEnabled. Při konfiguraci auditování DevOps je potřeba vytvořit také nastavení diagnostiky s kategorií diagnostických protokolů DevOpsOperationsAudit v hlavní databázi. Formát identifikátoru URI nastavení diagnostiky: 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 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 |
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ř. https://MyAccount.blob.core.windows.net). Pokud je stav Povoleno, je vyžadována možnost storageEndpoint nebo isAzureMonitorTargetEnabled. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Nastavení auditu DevOps bylo úspěšně aktualizováno. |
|
202 Accepted |
Probíhá aktualizace nastavení Audit DevOps. Hlavičky Location: string |
|
Other Status Codes |
Chybové odpovědi: ***
|
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=2023-08-01
{
"properties": {
"state": "Enabled",
"storageAccountAccessKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"storageEndpoint": "https://mystorage.blob.core.windows.net",
"storageAccountSubscriptionId": "00000000-1234-0000-5678-000000000000",
"isAzureMonitorTargetEnabled": true
}
}
Ukázková odpověď
{
"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
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=2023-08-01
{
"properties": {
"state": "Enabled",
"storageAccountAccessKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"storageEndpoint": "https://mystorage.blob.core.windows.net"
}
}
Ukázková odpověď
{
"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"
}
}
Definice
Name | 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 |
---|---|
Disabled | |
Enabled |
createdByType
Typ identity, která prostředek vytvořila.
Hodnota | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
DevOpsAuditingSettingsName
Hodnota | Description |
---|---|
Default |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Další typ informací. |
ErrorDetail
Podrobnosti o chybě.
Name | 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ěď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
ServerDevOpsAuditingSettings
Nastavení auditování DevOps serveru
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku. |
name |
string |
Název prostředku |
properties.isAzureMonitorTargetEnabled |
boolean |
Určuje, jestli se události auditu DevOps odesílají do služby Azure Monitor. Pokud chcete odesílat události do služby Azure Monitor, jako true zadejte State a IsAzureMonitorTargetEnabled. Při konfiguraci auditování DevOps je potřeba vytvořit také nastavení diagnostiky s kategorií diagnostických protokolů DevOpsOperationsAudit v hlavní databázi. Formát identifikátoru URI nastavení diagnostiky: 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 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 |
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ř. https://MyAccount.blob.core.windows.net). Pokud je stav Povoleno, je vyžadována možnost storageEndpoint nebo isAzureMonitorTargetEnabled. |
systemData |
SystemData of ServerDevOpsAuditSettingsResource. |
|
type |
string |
Typ prostředku. |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
Name | 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. |