다음을 통해 공유

Activity Log Alerts - Create Or Update

  • 참조
서비스:
Monitor
API 버전:
2020-10-01

새 활동 로그 경고 규칙을 만들거나 기존 활동 로그 경고 규칙을 업데이트합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
activityLogAlertName
 path True

string

활동 로그 경고 규칙의 이름입니다.
resourceGroupName
 path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.
subscriptionId
 path True

string

대상 구독의 ID입니다.
api-version
 query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

Name 필수 형식 Description
properties.actions True

ActionList

조건이 충족될 때 활성화되는 작업입니다.
properties.condition True

AlertRuleAllOfCondition

이 경고가 활성화되는 조건입니다.
properties.scopes True

string[]

접두사로 사용할 리소스 ID 목록입니다. 경고는 이러한 접두사 중 하나에 속하는 리소스 ID가 있는 활동 로그 이벤트에만 적용됩니다. 이 목록에는 하나 이상의 항목이 포함되어야 합니다.
location

string

리소스의 위치입니다. Azure 활동 로그 경고 규칙은 글로벌, 서유럽 및 북유럽 지역에서 지원됩니다.
properties.description

string

이 활동 로그 경고 규칙에 대한 설명입니다.
properties.enabled

boolean

이 활동 로그 경고 규칙을 사용할 수 있는지 여부를 나타냅니다. 활동 로그 경고 규칙을 사용하도록 설정하지 않으면 해당 작업이 활성화되지 않습니다.
tags

object

리소스의 태그입니다.

응답

Name 형식 Description
200 OK

ActivityLogAlertResource

기존 활동 로그 경고 규칙이 성공적으로 업데이트되었습니다.
201 Created

ActivityLogAlertResource

새 활동 로그 경고 규칙이 성공적으로 만들어졌습니다.
Other Status Codes

ErrorResponse

오류가 발생하여 활동 로그 경고 규칙을 만들거나 업데이트할 수 없습니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

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

샘플 요청

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."
  }
}

샘플 응답

상태 코드:
200 
{
  "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."
  }
}
상태 코드:
201 
{
  "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

샘플 요청

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."
  }
}

샘플 응답

상태 코드:
200 
{
  "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."
  }
}
상태 코드:
201 
{
  "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'

샘플 요청

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'."
  }
}

샘플 응답

상태 코드:
200 
{
  "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'."
  }
}
상태 코드:
201 
{
  "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'."
  }
}

정의

Name Description
ActionGroup

Azure 작업 그룹에 대한 포인터입니다.
ActionList

활동 로그 경고 규칙 작업 목록입니다.
ActivityLogAlertResource

활동 로그 경고 규칙 리소스입니다.
AlertRuleAllOfCondition

모든 멤버 조건이 충족될 때 충족되는 활동 로그 경고 규칙 조건입니다.
AlertRuleAnyOfOrLeafCondition

모든 멤버 조건이 충족될 때 충족되는 활동 로그 경고 규칙 조건입니다. 각 조건은 다음 형식 중 하나일 수 있습니다. 중요: 각 형식에는 고유한 속성 하위 집합이 있습니다. 다른 형식의 속성은 한 조건에 존재할 수 없습니다.

  • 리프 조건 - 'field'와 'equals' 또는 'containsAny'를 포함해야 합니다. 'anyOf'는 리프 조건에서 설정 해서는 안 됩니다.
  • AnyOf 조건 - 리프 조건의 배열인 'anyOf' 만 포함해야 합니다. 'field', 'equals' 및 'containsAny'는 AnyOf 조건에서 설정 해서는 안 됩니다.
AlertRuleLeafCondition

활동 로그 이벤트의 필드와 값을 비교하여 충족되는 활동 로그 경고 규칙 조건입니다. 이 조건에는 'field'와 'equals' 또는 'containsAny'가 포함되어야 합니다.
ErrorResponse

오류 응답입니다.

ActionGroup

Azure 작업 그룹에 대한 포인터입니다.

Name 형식 Description
actionGroupId

string

작업 그룹의 리소스 ID입니다. null이거나 비어 있을 수 없습니다.
webhookProperties

object

게시 작업에 포함할 사용자 지정 속성의 사전입니다. 이러한 데이터는 웹후크 페이로드에 추가됩니다.

ActionList

활동 로그 경고 규칙 작업 목록입니다.

Name 형식 Description
actionGroups

ActionGroup[]

작업 그룹의 목록입니다.

ActivityLogAlertResource

활동 로그 경고 규칙 리소스입니다.

Name 형식 Default value Description
id

string

리소스 ID입니다.
location

string

global

리소스의 위치입니다. Azure 활동 로그 경고 규칙은 글로벌, 서유럽 및 북유럽 지역에서 지원됩니다.
name

string

리소스의 이름입니다.
properties.actions

ActionList

조건이 충족될 때 활성화되는 작업입니다.
properties.condition

AlertRuleAllOfCondition

이 경고가 활성화되는 조건입니다.
properties.description

string

이 활동 로그 경고 규칙에 대한 설명입니다.
properties.enabled

boolean

True

이 활동 로그 경고 규칙을 사용할 수 있는지 여부를 나타냅니다. 활동 로그 경고 규칙을 사용하도록 설정하지 않으면 해당 작업이 활성화되지 않습니다.
properties.scopes

string[]

접두사로 사용할 리소스 ID 목록입니다. 경고는 이러한 접두사 중 하나에 속하는 리소스 ID가 있는 활동 로그 이벤트에만 적용됩니다. 이 목록에는 하나 이상의 항목이 포함되어야 합니다.
tags

object

리소스의 태그입니다.
type

string

리소스 형식입니다.

AlertRuleAllOfCondition

모든 멤버 조건이 충족될 때 충족되는 활동 로그 경고 규칙 조건입니다.

Name 형식 Description
allOf

AlertRuleAnyOfOrLeafCondition[]

활동 로그 경고 규칙 조건 목록입니다.

AlertRuleAnyOfOrLeafCondition

모든 멤버 조건이 충족될 때 충족되는 활동 로그 경고 규칙 조건입니다. 각 조건은 다음 형식 중 하나일 수 있습니다. 중요: 각 형식에는 고유한 속성 하위 집합이 있습니다. 다른 형식의 속성은 한 조건에 존재할 수 없습니다.

  • 리프 조건 - 'field'와 'equals' 또는 'containsAny'를 포함해야 합니다. 'anyOf'는 리프 조건에서 설정 해서는 안 됩니다.
  • AnyOf 조건 - 리프 조건의 배열인 'anyOf' 만 포함해야 합니다. 'field', 'equals' 및 'containsAny'는 AnyOf 조건에서 설정 해서는 안 됩니다.
Name 형식 Description
anyOf

AlertRuleLeafCondition[]

활동 로그 경고 규칙 'anyOf' 조건입니다.
멤버 리프 조건 중 하나 이상이 충족될 때 충족되는 활동 로그 경고 규칙 조건입니다.
containsAny

string[]

이벤트의 필드 값은 이 배열의 값(대/소문자를 구분하지 않음)과 비교하여 조건이 충족되는지 확인합니다.
equals

string

이벤트 필드의 값을 이 값(대/소문자를 구분하지 않음)과 비교하여 조건이 충족되는지 확인합니다.
field

string

이 조건이 검사할 활동 로그 이벤트 필드의 이름입니다. 이 필드에 사용할 수 있는 값은 'resourceId', 'category', 'caller', 'level', 'operationName', 'resourceGroup', 'resourceProvider', '상태', 'subStatus', 'resourceType' 또는 'properties'로 시작하는 모든 값입니다.

AlertRuleLeafCondition

활동 로그 이벤트의 필드와 값을 비교하여 충족되는 활동 로그 경고 규칙 조건입니다. 이 조건에는 'field'와 'equals' 또는 'containsAny'가 포함되어야 합니다.

Name 형식 Description
containsAny

string[]

이벤트의 필드 값은 이 배열의 값(대/소문자를 구분하지 않음)과 비교하여 조건이 충족되는지 확인합니다.
equals

string

이벤트 필드의 값을 이 값(대/소문자를 구분하지 않음)과 비교하여 조건이 충족되는지 확인합니다.
field

string

이 조건이 검사할 활동 로그 이벤트 필드의 이름입니다. 이 필드에 사용할 수 있는 값은 'resourceId', 'category', 'caller', 'level', 'operationName', 'resourceGroup', 'resourceProvider', '상태', 'subStatus', 'resourceType' 또는 'properties'로 시작하는 모든 값입니다.

ErrorResponse

오류 응답입니다.

Name 형식 Description
code

string

오류 코드입니다.
message

string

작업이 실패한 이유를 나타내는 오류 메시지입니다.