Dela via


Diagnostic Settings - Create Or Update

Skapar eller uppdaterar diagnostikinställningar för den angivna resursen.

PUT https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/diagnosticSettings/{name}?api-version=2021-05-01-preview

URI-parametrar

Name I Obligatorisk Typ Description
name
path True

string

Namnet på diagnostikinställningen.

resourceUri
path True

string

Resursens identifierare.

api-version
query True

string

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Typ Description
properties.eventHubAuthorizationRuleId

string

Resurs-ID:t för händelsehubbens auktoriseringsregel.

properties.eventHubName

string

Namnet på händelsehubben. Om ingen anges väljs standardhändelsehubben.

properties.logAnalyticsDestinationType

string

En sträng som anger om exporten till Log Analytics ska använda standardmåltypen, t.ex. AzureDiagnostics, eller använda en måltyp som konstruerats på följande sätt: _. Möjliga värden är: Dedikerad och null (null är standard.)

properties.logs

LogSettings[]

Listan över logginställningar.

properties.marketplacePartnerId

string

Det fullständiga ARM-resurs-ID:t för Marketplace-resursen som du vill skicka diagnostikloggar till.

properties.metrics

MetricSettings[]

Listan över måttinställningar.

properties.serviceBusRuleId

string

Service Bus-regel-ID för diagnostikinställningen. Detta är här för att upprätthålla bakåtkompatibilitet.

properties.storageAccountId

string

Resurs-ID för lagringskontot som du vill skicka diagnostikloggar till.

properties.workspaceId

string

Det fullständiga ARM-resurs-ID:t för Log Analytics-arbetsytan som du vill skicka diagnostikloggar till. Exempel: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

Svar

Name Typ Description
200 OK

DiagnosticSettingsResource

Lyckad begäran om att skapa en diagnostikinställning

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Creates or Updates the diagnostic setting
Creates or Updates the diagnostic setting for category

Creates or Updates the diagnostic setting

Exempelbegäran

PUT https://management.azure.com/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourcegroups/viruela1/providers/microsoft.logic/workflows/viruela6/providers/Microsoft.Insights/diagnosticSettings/mysetting?api-version=2021-05-01-preview

{
  "properties": {
    "storageAccountId": "/subscriptions/df602c9c-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/apptest/providers/Microsoft.Storage/storageAccounts/appteststorage1",
    "workspaceId": "",
    "eventHubAuthorizationRuleId": "/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourceGroups/montest/providers/microsoft.eventhub/namespaces/mynamespace/authorizationrules/myrule",
    "eventHubName": "myeventhub",
    "marketplacePartnerId": "/subscriptions/abcdeabc-1234-1234-ab12-123a1234567a/resourceGroups/test-rg/providers/Microsoft.Datadog/monitors/dd1",
    "metrics": [
      {
        "category": "WorkflowMetrics",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      }
    ],
    "logs": [
      {
        "categoryGroup": "allLogs",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      }
    ],
    "logAnalyticsDestinationType": "Dedicated"
  }
}

Exempelsvar

{
  "id": "/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourcegroups/viruela1/providers/microsoft.logic/workflows/viruela6/providers/microsoft.insights/diagnosticSettings/mysetting",
  "type": "Microsoft.Insights/diagnosticSettings",
  "name": "mysetting",
  "properties": {
    "storageAccountId": "/subscriptions/df602c9c-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/apptest/providers/Microsoft.Storage/storageAccounts/appteststorage1",
    "workspaceId": "",
    "eventHubAuthorizationRuleId": "/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourceGroups/montest/providers/microsoft.eventhub/namespaces/mynamespace/authorizationrules/myrule",
    "eventHubName": "myeventhub",
    "marketplacePartnerId": "/subscriptions/abcdeabc-1234-1234-ab12-123a1234567a/resourceGroups/test-rg/providers/Microsoft.Datadog/monitors/dd1",
    "metrics": [
      {
        "category": "WorkflowMetrics",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      }
    ],
    "logs": [
      {
        "categoryGroup": "allLogs",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      }
    ],
    "logAnalyticsDestinationType": "Dedicated"
  }
}

Creates or Updates the diagnostic setting for category

Exempelbegäran

PUT https://management.azure.com/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourcegroups/viruela1/providers/microsoft.logic/workflows/viruela6/providers/Microsoft.Insights/diagnosticSettings/mysetting?api-version=2021-05-01-preview

{
  "properties": {
    "storageAccountId": "/subscriptions/df602c9c-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/apptest/providers/Microsoft.Storage/storageAccounts/appteststorage1",
    "workspaceId": "",
    "eventHubAuthorizationRuleId": "/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourceGroups/montest/providers/microsoft.eventhub/namespaces/mynamespace/authorizationrules/myrule",
    "eventHubName": "myeventhub",
    "marketplacePartnerId": "/subscriptions/abcdeabc-1234-1234-ab12-123a1234567a/resourceGroups/test-rg/providers/Microsoft.Datadog/monitors/dd1",
    "metrics": [
      {
        "category": "WorkflowMetrics",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      }
    ],
    "logs": [
      {
        "category": "WorkflowRuntime",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      }
    ],
    "logAnalyticsDestinationType": "Dedicated"
  }
}

Exempelsvar

{
  "id": "/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourcegroups/viruela1/providers/microsoft.logic/workflows/viruela6/diagnosticSettings/mysetting",
  "type": "",
  "name": "mysetting",
  "properties": {
    "storageAccountId": "/subscriptions/df602c9c-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/apptest/providers/Microsoft.Storage/storageAccounts/appteststorage1",
    "workspaceId": "",
    "eventHubAuthorizationRuleId": "/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourceGroups/montest/providers/microsoft.eventhub/namespaces/mynamespace/authorizationrules/myrule",
    "eventHubName": "myeventhub",
    "marketplacePartnerId": "/subscriptions/abcdeabc-1234-1234-ab12-123a1234567a/resourceGroups/test-rg/providers/Microsoft.Datadog/monitors/dd1",
    "metrics": [
      {
        "category": "WorkflowMetrics",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      }
    ],
    "logs": [
      {
        "category": "WorkflowRuntime",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      }
    ],
    "logAnalyticsDestinationType": "Dedicated"
  }
}

Definitioner

Name Description
createdByType

Den typ av identitet som skapade resursen.

DiagnosticSettingsResource

Diagnostikinställningsresursen.

ErrorResponse

Beskriver formatet felsvar.

LogSettings

Del av MultiTenantDiagnosticSettings. Anger inställningarna för en viss logg.

MetricSettings

Del av MultiTenantDiagnosticSettings. Anger inställningarna för ett visst mått.

RetentionPolicy

Anger kvarhållningsprincipen för loggen.

systemData

Metadata som rör skapande och senaste ändring av resursen.

createdByType

Den typ av identitet som skapade resursen.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

DiagnosticSettingsResource

Diagnostikinställningsresursen.

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Namnet på resursen

properties.eventHubAuthorizationRuleId

string

Resurs-ID:t för händelsehubbens auktoriseringsregel.

properties.eventHubName

string

Namnet på händelsehubben. Om ingen anges väljs standardhändelsehubben.

properties.logAnalyticsDestinationType

string

En sträng som anger om exporten till Log Analytics ska använda standardmåltypen, t.ex. AzureDiagnostics, eller använda en måltyp som konstruerats på följande sätt: _. Möjliga värden är: Dedikerad och null (null är standard.)

properties.logs

LogSettings[]

Listan över logginställningar.

properties.marketplacePartnerId

string

Det fullständiga ARM-resurs-ID:t för Marketplace-resursen som du vill skicka diagnostikloggar till.

properties.metrics

MetricSettings[]

Listan över måttinställningar.

properties.serviceBusRuleId

string

Service Bus-regel-ID för diagnostikinställningen. Detta är här för att upprätthålla bakåtkompatibilitet.

properties.storageAccountId

string

Resurs-ID för lagringskontot som du vill skicka diagnostikloggar till.

properties.workspaceId

string

Det fullständiga ARM-resurs-ID:t för Log Analytics-arbetsytan som du vill skicka diagnostikloggar till. Exempel: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

systemData

systemData

Systemmetadata som är relaterade till den här resursen.

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

ErrorResponse

Beskriver formatet felsvar.

Name Typ Description
code

string

Felkod

message

string

Felmeddelande som anger varför åtgärden misslyckades.

LogSettings

Del av MultiTenantDiagnosticSettings. Anger inställningarna för en viss logg.

Name Typ Description
category

string

Namnet på en diagnostikloggkategori för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över diagnostikloggkategorier för en resurs utför du först en get-diagnostikinställningsåtgärd.

categoryGroup

string

Namnet på en kategorigrupp för diagnostikloggar för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över diagnostikloggkategorier för en resurs utför du först en get-diagnostikinställningsåtgärd.

enabled

boolean

ett värde som anger om den här loggen är aktiverad.

retentionPolicy

RetentionPolicy

kvarhållningsprincipen för den här loggen.

MetricSettings

Del av MultiTenantDiagnosticSettings. Anger inställningarna för ett visst mått.

Name Typ Description
category

string

Namnet på en kategori för diagnostikmått för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över diagnostikmåttkategorier för en resurs utför du först en get-diagnostikinställningsåtgärd.

enabled

boolean

ett värde som anger om den här kategorin är aktiverad.

retentionPolicy

RetentionPolicy

kvarhållningsprincipen för den här kategorin.

timeGrain

string

tidsgrain för måttet i ISO8601 format.

RetentionPolicy

Anger kvarhållningsprincipen för loggen.

Name Typ Description
days

integer

antalet dagar för kvarhållningen i dagar. Värdet 0 behåller händelserna på obestämd tid.

enabled

boolean

ett värde som anger om kvarhållningsprincipen är aktiverad.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.