Megosztás a következőn keresztül:


Activity Log Alerts - Create Or Update

Hozzon létre egy új tevékenységnapló-riasztási szabályt, vagy frissítsen egy meglévőt.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/activityLogAlerts/{activityLogAlertName}?api-version=2020-10-01

URI-paraméterek

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

string

A tevékenységnapló-riasztási szabály neve.

resourceGroupName
path True

string

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

subscriptionId
path True

string

A cél-előfizetés azonosítója.

api-version
query True

string

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

Kérelem törzse

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

ActionList

A feltétel teljesülésekor aktiválni kívánt műveletek.

properties.condition True

AlertRuleAllOfCondition

A riasztás aktiválását okozó feltétel.

properties.scopes True

string[]

Az előtagként használni kívánt erőforrás-azonosítók listája. A riasztás csak olyan tevékenységnapló-eseményekre vonatkozik, amelyek erőforrás-azonosítói ezen előtagok valamelyike alá tartoznak. Ennek a listának legalább egy elemet tartalmaznia kell.

location

string

Az erőforrás helye. Az Azure-tevékenységnapló-riasztási szabályok a globális, a nyugat-európai és az észak-európai régiókban támogatottak.

properties.description

string

Ennek a tevékenységnapló-riasztási szabálynak a leírása.

properties.enabled

boolean

Azt jelzi, hogy engedélyezve van-e ez a tevékenységnapló-riasztási szabály. Ha egy tevékenységnapló-riasztási szabály nincs engedélyezve, akkor egyik művelete sem lesz aktiválva.

tags

object

Az erőforrás címkéi.

Válaszok

Name Típus Description
200 OK

ActivityLogAlertResource

Sikeresen frissítettek egy meglévő tevékenységnapló-riasztási szabályt.

201 Created

ActivityLogAlertResource

Sikeresen létrejött egy új tevékenységnapló-riasztási szabály.

Other Status Codes

ErrorResponse

Hiba történt, és a tevékenységnapló-riasztási szabály nem hozható létre és nem frissíthető.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

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

Hatókörök

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

Példák

Create or update an Activity Log Alert rule
Create or update an Activity Log Alert rule with 'anyOf' condition
Create or update an Activity Log Alert rule with 'containsAny'

Create or update an Activity Log Alert rule

Mintakérelem

PUT https://management.azure.com/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/activityLogAlerts/SampleActivityLogAlertRule?api-version=2020-10-01

{
  "location": "Global",
  "tags": {},
  "properties": {
    "scopes": [
      "/subscriptions/187f412d-1758-44d9-b052-169e2564721d"
    ],
    "condition": {
      "allOf": [
        {
          "field": "category",
          "equals": "Administrative"
        },
        {
          "field": "level",
          "equals": "Error"
        }
      ]
    },
    "actions": {
      "actionGroups": [
        {
          "actionGroupId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/actionGroups/SampleActionGroup",
          "webhookProperties": {
            "sampleWebhookProperty": "SamplePropertyValue"
          }
        }
      ]
    },
    "enabled": true,
    "description": "Description of sample Activity Log Alert rule."
  }
}

Mintaválasz

{
  "id": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/activityLogAlerts/SampleActivityLogAlertRule",
  "type": "Microsoft.Insights/ActivityLogAlerts",
  "name": "SampleActivityLogAlertRule",
  "location": "Global",
  "tags": {},
  "properties": {
    "scopes": [
      "subscriptions/187f412d-1758-44d9-b052-169e2564721d"
    ],
    "condition": {
      "allOf": [
        {
          "field": "Category",
          "equals": "Administrative"
        },
        {
          "field": "Level",
          "equals": "Error"
        }
      ]
    },
    "actions": {
      "actionGroups": [
        {
          "actionGroupId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/actionGroups/SampleActionGroup",
          "webhookProperties": {
            "sampleWebhookProperty": "SamplePropertyValue"
          }
        }
      ]
    },
    "enabled": true,
    "description": "Description of sample Activity Log Alert rule."
  }
}
{
  "id": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/activityLogAlerts/SampleActivityLogAlertRule",
  "type": "Microsoft.Insights/ActivityLogAlerts",
  "name": "SampleActivityLogAlertRule",
  "location": "Global",
  "tags": {},
  "properties": {
    "scopes": [
      "subscriptions/187f412d-1758-44d9-b052-169e2564721d"
    ],
    "condition": {
      "allOf": [
        {
          "field": "Category",
          "equals": "Administrative"
        },
        {
          "field": "Level",
          "equals": "Error"
        }
      ]
    },
    "actions": {
      "actionGroups": [
        {
          "actionGroupId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/actionGroups/SampleActionGroup",
          "webhookProperties": {
            "sampleWebhookProperty": "SamplePropertyValue"
          }
        }
      ]
    },
    "enabled": true,
    "description": "Description of sample Activity Log Alert rule."
  }
}

Create or update an Activity Log Alert rule with 'anyOf' condition

Mintakérelem

PUT https://management.azure.com/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/activityLogAlerts/SampleActivityLogAlertRuleWithAnyOfCondition?api-version=2020-10-01

{
  "location": "Global",
  "tags": {},
  "properties": {
    "scopes": [
      "subscriptions/187f412d-1758-44d9-b052-169e2564721d"
    ],
    "condition": {
      "allOf": [
        {
          "field": "category",
          "equals": "ServiceHealth"
        },
        {
          "anyOf": [
            {
              "field": "properties.incidentType",
              "equals": "Incident"
            },
            {
              "field": "properties.incidentType",
              "equals": "Maintenance"
            }
          ]
        }
      ]
    },
    "actions": {
      "actionGroups": [
        {
          "actionGroupId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/actionGroups/SampleActionGroup",
          "webhookProperties": {
            "sampleWebhookProperty": "SamplePropertyValue"
          }
        }
      ]
    },
    "enabled": true,
    "description": "Description of sample Activity Log Alert rule with 'anyOf' condition."
  }
}

Mintaválasz

{
  "id": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/activityLogAlerts/SampleActivityLogAlertRuleWithAnyOfCondition",
  "type": "Microsoft.Insights/ActivityLogAlerts",
  "name": "SampleActivityLogAlertRuleWithAnyOfCondition",
  "location": "Global",
  "tags": {},
  "properties": {
    "scopes": [
      "subscriptions/187f412d-1758-44d9-b052-169e2564721d"
    ],
    "condition": {
      "allOf": [
        {
          "field": "category",
          "equals": "ServiceHealth"
        },
        {
          "anyOf": [
            {
              "field": "properties.incidentType",
              "equals": "Incident"
            },
            {
              "field": "properties.incidentType",
              "equals": "Maintenance"
            }
          ]
        }
      ]
    },
    "actions": {
      "actionGroups": [
        {
          "actionGroupId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/actionGroups/SampleActionGroup",
          "webhookProperties": {
            "sampleWebhookProperty": "SamplePropertyValue"
          }
        }
      ]
    },
    "enabled": true,
    "description": "Description of sample Activity Log Alert rule with 'anyOf' condition."
  }
}
{
  "id": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/activityLogAlerts/SampleActivityLogAlertRuleWithAnyOfCondition",
  "type": "Microsoft.Insights/ActivityLogAlerts",
  "name": "SampleActivityLogAlertRuleWithAnyOfCondition",
  "location": "Global",
  "tags": {},
  "properties": {
    "scopes": [
      "subscriptions/187f412d-1758-44d9-b052-169e2564721d"
    ],
    "condition": {
      "allOf": [
        {
          "field": "category",
          "equals": "ServiceHealth"
        },
        {
          "anyOf": [
            {
              "field": "properties.incidentType",
              "equals": "Incident"
            },
            {
              "field": "properties.incidentType",
              "equals": "Maintenance"
            }
          ]
        }
      ]
    },
    "actions": {
      "actionGroups": [
        {
          "actionGroupId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/actionGroups/SampleActionGroup",
          "webhookProperties": {
            "sampleWebhookProperty": "SamplePropertyValue"
          }
        }
      ]
    },
    "enabled": true,
    "description": "Description of sample Activity Log Alert rule with 'anyOf' condition."
  }
}

Create or update an Activity Log Alert rule with 'containsAny'

Mintakérelem

PUT https://management.azure.com/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/activityLogAlerts/SampleActivityLogAlertRuleWithContainsAny?api-version=2020-10-01

{
  "location": "Global",
  "tags": {},
  "properties": {
    "scopes": [
      "subscriptions/187f412d-1758-44d9-b052-169e2564721d"
    ],
    "condition": {
      "allOf": [
        {
          "field": "category",
          "equals": "ServiceHealth"
        },
        {
          "field": "properties.impactedServices[*].ImpactedRegions[*].RegionName",
          "containsAny": [
            "North Europe",
            "West Europe"
          ]
        }
      ]
    },
    "actions": {
      "actionGroups": [
        {
          "actionGroupId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/actionGroups/SampleActionGroup",
          "webhookProperties": {
            "sampleWebhookProperty": "SamplePropertyValue"
          }
        }
      ]
    },
    "enabled": true,
    "description": "Description of sample Activity Log Alert rule with 'containsAny'."
  }
}

Mintaválasz

{
  "id": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/activityLogAlerts/SampleActivityLogAlertRuleWithContainsAny",
  "type": "Microsoft.Insights/ActivityLogAlerts",
  "name": "SampleActivityLogAlertRuleWithContainsAny",
  "location": "Global",
  "tags": {},
  "properties": {
    "scopes": [
      "subscriptions/187f412d-1758-44d9-b052-169e2564721d"
    ],
    "condition": {
      "allOf": [
        {
          "field": "category",
          "equals": "ServiceHealth"
        },
        {
          "field": "properties.impactedServices[*].ImpactedRegions[*].RegionName",
          "containsAny": [
            "North Europe",
            "West Europe"
          ]
        }
      ]
    },
    "actions": {
      "actionGroups": [
        {
          "actionGroupId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/actionGroups/SampleActionGroup",
          "webhookProperties": {
            "sampleWebhookProperty": "SamplePropertyValue"
          }
        }
      ]
    },
    "enabled": true,
    "description": "Description of sample Activity Log Alert rule with 'containsAny'."
  }
}
{
  "id": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/activityLogAlerts/SampleActivityLogAlertRuleWithContainsAny",
  "type": "Microsoft.Insights/ActivityLogAlerts",
  "name": "SampleActivityLogAlertRuleWithContainsAny",
  "location": "Global",
  "tags": {},
  "properties": {
    "scopes": [
      "subscriptions/187f412d-1758-44d9-b052-169e2564721d"
    ],
    "condition": {
      "allOf": [
        {
          "field": "category",
          "equals": "ServiceHealth"
        },
        {
          "field": "properties.impactedServices[*].ImpactedRegions[*].RegionName",
          "containsAny": [
            "North Europe",
            "West Europe"
          ]
        }
      ]
    },
    "actions": {
      "actionGroups": [
        {
          "actionGroupId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/actionGroups/SampleActionGroup",
          "webhookProperties": {
            "sampleWebhookProperty": "SamplePropertyValue"
          }
        }
      ]
    },
    "enabled": true,
    "description": "Description of sample Activity Log Alert rule with 'containsAny'."
  }
}

Definíciók

Name Description
ActionGroup

Egy Azure-műveletcsoportra mutató mutató.

ActionList

A tevékenységnapló-riasztási szabályműveletek listája.

ActivityLogAlertResource

Tevékenységnapló-riasztási szabály erőforrása.

AlertRuleAllOfCondition

Tevékenységnapló-riasztási szabályfeltétel, amely akkor teljesül, ha az összes tagfeltétel teljesül.

AlertRuleAnyOfOrLeafCondition

Tevékenységnapló-riasztási szabályfeltétel, amely akkor teljesül, ha az összes tagfeltétel teljesül. Minden feltétel a következő típusok valamelyike lehet: Fontos: Minden típus egyedi tulajdonsághalmazsal rendelkezik. A különböző típusú tulajdonságok nem létezhetnek egy feltételben.

  • Levélfeltétel – a "mező" és az "equals" vagy a "containsAny" értéket kell tartalmaznia. Kérjük, vegye figyelembe, hogy az "anyOf" nem állítható be levélfeltételben.
  • AnyOf feltétel –csak "anyOf" (levélfeltételek tömbje) tartalmazhat. Vegye figyelembe, hogy a "mező", az "equals" és a "containsAny" nem állítható be AnyOf feltételben.
AlertRuleLeafCondition

Tevékenységnapló-riasztási szabályfeltétel, amely egy tevékenységnapló-esemény mezőjének és értékének összehasonlításával teljesül. Ennek a feltételnek tartalmaznia kell a "mező" és az "equals" vagy a "containsAny" értéket.

ErrorResponse

A hibaválasz.

ActionGroup

Egy Azure-műveletcsoportra mutató mutató.

Name Típus Description
actionGroupId

string

A műveletcsoport erőforrás-azonosítója. Ez nem lehet null értékű vagy üres.

webhookProperties

object

a post művelethez felvenni kívánt egyéni tulajdonságok szótárát. Ezek az adatok hozzá vannak fűzve a webhook hasznos adataihoz.

ActionList

A tevékenységnapló-riasztási szabályműveletek listája.

Name Típus Description
actionGroups

ActionGroup[]

A műveletcsoportok listája.

ActivityLogAlertResource

Tevékenységnapló-riasztási szabály erőforrása.

Name Típus Alapértelmezett érték Description
id

string

Az erőforrás azonosítója.

location

string

global

Az erőforrás helye. Az Azure-tevékenységnapló-riasztási szabályok a globális, a nyugat-európai és az észak-európai régiókban támogatottak.

name

string

Az erőforrás neve.

properties.actions

ActionList

A feltétel teljesülésekor aktiválni kívánt műveletek.

properties.condition

AlertRuleAllOfCondition

A riasztás aktiválását okozó feltétel.

properties.description

string

Ennek a tevékenységnapló-riasztási szabálynak a leírása.

properties.enabled

boolean

True

Azt jelzi, hogy engedélyezve van-e ez a tevékenységnapló-riasztási szabály. Ha egy tevékenységnapló-riasztási szabály nincs engedélyezve, akkor egyik művelete sem lesz aktiválva.

properties.scopes

string[]

Az előtagként használni kívánt erőforrás-azonosítók listája. A riasztás csak olyan tevékenységnapló-eseményekre vonatkozik, amelyek erőforrás-azonosítói ezen előtagok valamelyike alá tartoznak. Ennek a listának legalább egy elemet tartalmaznia kell.

tags

object

Az erőforrás címkéi.

type

string

Az erőforrás típusa.

AlertRuleAllOfCondition

Tevékenységnapló-riasztási szabályfeltétel, amely akkor teljesül, ha az összes tagfeltétel teljesül.

Name Típus Description
allOf

AlertRuleAnyOfOrLeafCondition[]

A tevékenységnapló-riasztási szabályfeltételek listája.

AlertRuleAnyOfOrLeafCondition

Tevékenységnapló-riasztási szabályfeltétel, amely akkor teljesül, ha az összes tagfeltétel teljesül. Minden feltétel a következő típusok valamelyike lehet: Fontos: Minden típus egyedi tulajdonsághalmazsal rendelkezik. A különböző típusú tulajdonságok nem létezhetnek egy feltételben.

  • Levélfeltétel – a "mező" és az "equals" vagy a "containsAny" értéket kell tartalmaznia. Kérjük, vegye figyelembe, hogy az "anyOf" nem állítható be levélfeltételben.
  • AnyOf feltétel –csak "anyOf" (levélfeltételek tömbje) tartalmazhat. Vegye figyelembe, hogy a "mező", az "equals" és a "containsAny" nem állítható be AnyOf feltételben.
Name Típus Description
anyOf

AlertRuleLeafCondition[]

Tevékenységnapló-riasztási szabály "anyOf" feltétel.
Egy tevékenységnapló-riasztási szabályfeltétel, amely akkor teljesül, ha legalább az egyik taglevélfeltétel teljesül.

containsAny

string[]

Az esemény mezőjének értékét a rendszer összehasonlítja a tömb értékeivel (kis- és nagybetűk megkülönböztetése), hogy megállapítsa, teljesül-e a feltétel.

equals

string

Az esemény mezőjének értéke ehhez az értékhez lesz összehasonlítani (kis- és nagybetűk megkülönböztetése), hogy megállapítsa, teljesül-e a feltétel.

field

string

Annak a tevékenységnapló-eseménynek a neve, amelyet ez a feltétel megvizsgál. Ennek a mezőnek a lehetséges értékei (kis- és nagybetűk megkülönböztetése): "resourceId", "category", "caller", "level", "operationName", "resourceGroup", "resourceProvider", "status", "subStatus", "resourceType", vagy bármi, amely "tulajdonságok" kezdetű.

AlertRuleLeafCondition

Tevékenységnapló-riasztási szabályfeltétel, amely egy tevékenységnapló-esemény mezőjének és értékének összehasonlításával teljesül. Ennek a feltételnek tartalmaznia kell a "mező" és az "equals" vagy a "containsAny" értéket.

Name Típus Description
containsAny

string[]

Az esemény mezőjének értékét a rendszer összehasonlítja a tömb értékeivel (kis- és nagybetűk megkülönböztetése), hogy megállapítsa, teljesül-e a feltétel.

equals

string

Az esemény mezőjének értéke ehhez az értékhez lesz összehasonlítani (kis- és nagybetűk megkülönböztetése), hogy megállapítsa, teljesül-e a feltétel.

field

string

Annak a tevékenységnapló-eseménynek a neve, amelyet ez a feltétel megvizsgál. Ennek a mezőnek a lehetséges értékei (kis- és nagybetűk megkülönböztetése): "resourceId", "category", "caller", "level", "operationName", "resourceGroup", "resourceProvider", "status", "subStatus", "resourceType", vagy bármi, amely "tulajdonságok" kezdetű.

ErrorResponse

A hibaválasz.

Name Típus Description
code

string

A hibakód.

message

string

A művelet meghiúsulását jelző hibaüzenet.