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ának neve.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

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

subscriptionId
path True

string

minLength: 1

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

api-version
query True

string

minLength: 1

A művelethez használni kívánt API-verzió.

Kérelem törzse

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

ActionList

Azok a műveletek, amelyek a feltétel teljesülésekor aktiválódnak.

properties.condition True

AlertRuleAllOfCondition

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

properties.scopes True

string[]

Az előtagként használt erőforrásazonosí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 egyikébe 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, nyugat-európai és észak-európai régiókban támogatottak.

properties.description

string

A tevékenységnapló riasztási szabályának 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űvelet sem lesz aktiválva.

tags

object

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

Válaszok

Name Típus Description
200 OK

ActivityLogAlertResource

A rendszer sikeresen frissített 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álya nem hozható létre vagy 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 a 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

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ípusok tulajdonságai nem létezhetnek egy feltételben.

  • levélfeltétel – "mezőt" és "egyenlőséget" vagy "containsAny"-t kell tartalmaznia. Kérjük, vegye figyelembe, hogy az "anyOf" nem levélfeltételben beállítva.
  • AnyOf feltétel – csak "anyOf" kell tartalmaznia (ez a levélfeltételek tömbje). Vegye figyelembe, hogy a "mező", az "equals" és a "containsAny" nem , anyOf feltételben kell megadni.
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" szöveget.

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űveletbe belefoglalandó egyéni tulajdonságok szótára. Ezek az adatok hozzá vannak fűzve a webhook hasznos adataihoz.

ActionList

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, nyugat-európai és észak-európai régiókban támogatottak.

name

string

Az erőforrás neve.

properties.actions

ActionList

Azok a műveletek, amelyek a feltétel teljesülésekor aktiválódnak.

properties.condition

AlertRuleAllOfCondition

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

properties.description

string

A tevékenységnapló riasztási szabályának 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űvelet sem lesz aktiválva.

properties.scopes

string[]

Az előtagként használt erőforrásazonosí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 egyikébe 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ételeinek 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ípusok tulajdonságai nem létezhetnek egy feltételben.

  • levélfeltétel – "mezőt" és "egyenlőséget" vagy "containsAny"-t kell tartalmaznia. Kérjük, vegye figyelembe, hogy az "anyOf" nem levélfeltételben beállítva.
  • AnyOf feltétel – csak "anyOf" kell tartalmaznia (ez a levélfeltételek tömbje). Vegye figyelembe, hogy a "mező", az "equals" és a "containsAny" nem , anyOf feltételben kell megadni.
Name Típus Description
anyOf

AlertRuleLeafCondition[]

Tevékenységnapló-riasztási szabály "anyOf" feltétel.
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 (a kis- és nagybetűk nem érzékenyek), hogy megállapítsa, teljesül-e a feltétel.

equals

string

Az esemény mezőjének értékét összehasonlítjuk ezzel az értékkel (kis- és nagybetűket nem érzékennyé), hogy megállapítsuk, teljesül-e a feltétel.

field

string

Annak a tevékenységnapló-eseménynek a neve, amelyet ez a feltétel megvizsgál. A mező lehetséges értékei a következők : "resourceId", "category", "caller", "level", "operationName", "resourceGroup", "resourceProvider", "status", "subStatus", "resourceType", vagy bármi, amely a "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" szöveget.

Name Típus Description
containsAny

string[]

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

equals

string

Az esemény mezőjének értékét összehasonlítjuk ezzel az értékkel (kis- és nagybetűket nem érzékennyé), hogy megállapítsuk, teljesül-e a feltétel.

field

string

Annak a tevékenységnapló-eseménynek a neve, amelyet ez a feltétel megvizsgál. A mező lehetséges értékei a következők : "resourceId", "category", "caller", "level", "operationName", "resourceGroup", "resourceProvider", "status", "subStatus", "resourceType", vagy bármi, amely a "tulajdonságok" kezdetű.

ErrorResponse

A hibaválasz.

Name Típus Description
code

string

A hibakód.

message

string

A művelet sikertelen voltát jelző hibaüzenet.