次の方法で共有


Alert Rules - Update

既存のクラシック メトリック AlertRuleResource を更新します。 他のフィールドを更新するには、CreateOrUpdate メソッドを使用します。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/alertrules/{ruleName}?api-version=2016-03-01

URI パラメーター

名前 / 必須 説明
resourceGroupName
path True

string

リソース グループの名前。 名前の大文字と小文字は区別されます。

ruleName
path True

string

ルールの名前です。

subscriptionId
path True

string

ターゲット サブスクリプションの ID。

api-version
query True

string

この操作に使用する API バージョン。

要求本文

名前 必須 説明
properties.condition True RuleCondition:

アラート ルールがアクティブ化される条件。

properties.isEnabled True

boolean

アラート ルールが有効になっているかどうかを示すフラグ。

properties.name True

string

アラート ルールの名前。

properties.action RuleAction:

アラート ルールがアクティブになったとき、およびアラート条件が解決されたときに実行されるアクション。

properties.actions RuleAction[]:

アラート ルールがアクティブになったとき、およびアラート条件が解決されたときに実行されるアクションの配列。

properties.description

string

アラート メールに含まれるアラート ルールの説明。

properties.provisioningState

string

プロビジョニングの状態。

tags

object

リソース タグ

応答

名前 説明
200 OK

AlertRuleResource

アラート ルールを更新するための要求が成功しました

201 Created

AlertRuleResource

アラート ルールを更新する要求が成功し、その結果アラート ルールが作成されました

Other Status Codes

ErrorResponse

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントの借用

Patch an alert rule

要求のサンプル

PATCH https://management.azure.com/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourcegroups/Rac46PostSwapRG/providers/Microsoft.Insights/alertrules/chiricutin?api-version=2016-03-01

{
  "tags": {
    "$type": "Microsoft.WindowsAzure.Management.Common.Storage.CasePreservedDictionary"
  },
  "properties": {
    "name": "chiricutin",
    "description": "Pura Vida",
    "isEnabled": true,
    "condition": {
      "odata.type": "Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition",
      "dataSource": {
        "odata.type": "Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource",
        "resourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/Rac46PostSwapRG/providers/Microsoft.Web/sites/leoalerttest",
        "metricName": "Requests"
      },
      "operator": "GreaterThan",
      "threshold": 3,
      "windowSize": "PT5M",
      "timeAggregation": "Total"
    },
    "actions": []
  }
}

応答のサンプル

{
  "id": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/Rac46PostSwapRG/providers/microsoft.insights/alertrules/chiricutin",
  "name": "chiricutin",
  "type": "Microsoft.Insights/alertRules",
  "location": "West US",
  "tags": {
    "$type": "Microsoft.WindowsAzure.Management.Common.Storage.CasePreservedDictionary"
  },
  "properties": {
    "name": "chiricutin",
    "description": "Pura Vida",
    "isEnabled": true,
    "condition": {
      "odata.type": "Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition",
      "dataSource": {
        "odata.type": "Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource",
        "resourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/Rac46PostSwapRG/providers/Microsoft.Web/sites/leoalerttest",
        "metricName": "Requests"
      },
      "operator": "GreaterThan",
      "threshold": 3,
      "windowSize": "PT5M",
      "timeAggregation": "Total"
    },
    "lastUpdatedTime": "2016-11-23T21:23:52.0221265Z",
    "actions": []
  }
}
{
  "id": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/Rac46PostSwapRG/providers/microsoft.insights/alertrules/chiricutin",
  "name": "chiricutin",
  "type": "Microsoft.Insights/alertRules",
  "location": "West US",
  "tags": {
    "$type": "Microsoft.WindowsAzure.Management.Common.Storage.CasePreservedDictionary"
  },
  "properties": {
    "name": "chiricutin",
    "description": "Pura Vida",
    "isEnabled": true,
    "condition": {
      "odata.type": "Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition",
      "dataSource": {
        "odata.type": "Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource",
        "resourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/Rac46PostSwapRG/providers/Microsoft.Web/sites/leoalerttest",
        "metricName": "Requests"
      },
      "operator": "GreaterThan",
      "threshold": 3,
      "windowSize": "PT5M",
      "timeAggregation": "Total"
    },
    "lastUpdatedTime": "2016-11-23T21:23:52.0221265Z",
    "actions": []
  }
}

定義

名前 説明
AlertRuleResource

アラート ルール リソース。

AlertRuleResourcePatch

パッチ操作のアラート ルール オブジェクト。

ConditionOperator

ルール条件で使用できる演算子。

ErrorResponse

エラー応答の形式について説明します。

LocationThresholdRuleCondition

特定の数の場所に基づくルールの条件が失敗します。

ManagementEventAggregationCondition

収集されたデータの経時的な結合方法。

ManagementEventRuleCondition

管理イベント ルールの条件。

RuleEmailAction

ルールの条件が評価されたときに電子メールを送信するアクションを指定します。 この場合、識別子は常に RuleEmailAction です。

RuleManagementEventClaimsDataSource

ルール管理イベント データ ソースの要求。

RuleManagementEventDataSource

ルール管理イベント データ ソース。 この場合、識別子フィールドは常に RuleManagementEventDataSource です。

RuleMetricDataSource

ルール メトリック データ ソース。 この場合、識別子の値は常に RuleMetricDataSource です。

RuleWebhookAction

ルールの条件が評価されるときにサービスに投稿するアクションを指定します。 この場合、識別子は常に RuleWebhookAction です。

ThresholdRuleCondition

しきい値を超えるメトリックに基づくルール条件。

TimeAggregationOperator

ルールで使用できる集計演算子。

AlertRuleResource

アラート ルール リソース。

名前 説明
id

string

Azure リソース ID

location

string

リソースの場所

name

string

Azure リソース名

properties.action RuleAction:

アラート ルールがアクティブになったとき、およびアラート条件が解決されたときに実行されるアクション。

properties.actions RuleAction[]:

アラート ルールがアクティブになったとき、およびアラート条件が解決されたときに実行されるアクションの配列。

properties.condition RuleCondition:

アラート ルールがアクティブ化される条件。

properties.description

string

アラート メールに含まれるアラート ルールの説明。

properties.isEnabled

boolean

アラート ルールが有効になっているかどうかを示すフラグ。

properties.lastUpdatedTime

string

ルールが最後にISO8601形式で更新されたとき。

properties.name

string

アラート ルールの名前。

properties.provisioningState

string

プロビジョニングの状態。

tags

object

リソース タグ

type

string

Azure リソースタイプ

AlertRuleResourcePatch

パッチ操作のアラート ルール オブジェクト。

名前 説明
properties.action RuleAction:

アラート ルールがアクティブになったとき、およびアラート条件が解決されたときに実行されるアクション。

properties.actions RuleAction[]:

アラート ルールがアクティブになったとき、およびアラート条件が解決されたときに実行されるアクションの配列。

properties.condition RuleCondition:

アラート ルールがアクティブ化される条件。

properties.description

string

アラート メールに含まれるアラート ルールの説明。

properties.isEnabled

boolean

アラート ルールが有効になっているかどうかを示すフラグ。

properties.lastUpdatedTime

string

ルールが最後にISO8601形式で更新されたとき。

properties.name

string

アラート ルールの名前。

properties.provisioningState

string

プロビジョニングの状態。

tags

object

リソース タグ

ConditionOperator

ルール条件で使用できる演算子。

名前 説明
GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

ErrorResponse

エラー応答の形式について説明します。

名前 説明
code

string

エラー コード

message

string

操作が失敗した理由を示すエラー メッセージ。

LocationThresholdRuleCondition

特定の数の場所に基づくルールの条件が失敗します。

名前 説明
dataSource RuleDataSource:

ルールがデータを収集するリソース。 この型の場合、dataSource は常に RuleMetricDataSource 型になります。

failedLocationCount

integer

アラートのアクティブ化に失敗する必要がある場所の数。

odata.type string:

Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition

は条件の種類を指定します。 これは、ManagementEventRuleCondition (管理イベントの発生)、LocationThresholdRuleCondition (Web テストの失敗数に基づく)、ThresholdRuleCondition (メトリックのしきい値に基づく) の 3 種類のいずれかです。

windowSize

string

しきい値に基づいてアラート アクティビティを監視するために使用される期間 (ISO 8601 期間形式)。 指定する場合は、5 分から 1 日の間である必要があります。

ManagementEventAggregationCondition

収集されたデータの経時的な結合方法。

名前 説明
operator

ConditionOperator

条件演算子。

threshold

number

アラートを有効にするしきい値。

windowSize

string

しきい値に基づいてアラート アクティビティを監視するために使用される期間 (ISO 8601 期間形式)。 指定する場合は、5 分から 1 日の間である必要があります。

ManagementEventRuleCondition

管理イベント ルールの条件。

名前 説明
aggregation

ManagementEventAggregationCondition

収集されるデータを時間の経過と同時に、アラートをアクティブ化するタイミングを組み合わせる方法。 管理イベントのアラートの集計は省略可能です。指定しない場合は、すべてのイベントによってアラートがアクティブ化されます。

dataSource RuleDataSource:

ルールがデータを収集するリソース。 この型の場合、dataSource は常に RuleMetricDataSource 型になります。

odata.type string:

Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition

は条件の種類を指定します。 これは、ManagementEventRuleCondition (管理イベントの発生)、LocationThresholdRuleCondition (Web テストの失敗数に基づく)、ThresholdRuleCondition (メトリックのしきい値に基づく) の 3 種類のいずれかです。

RuleEmailAction

ルールの条件が評価されたときに電子メールを送信するアクションを指定します。 この場合、識別子は常に RuleEmailAction です。

名前 説明
customEmails

string[]

アラートのアクティブ化を通知する管理者のカスタム 電子メール アドレスの一覧。

odata.type string:

Microsoft.Azure.Management.Insights.Models.RuleEmailAction

は、アクションの種類を指定します。 アクションには、RuleEmailAction と RuleWebhookAction の 2 種類があります。

sendToServiceOwners

boolean

アラートがアクティブ化されたときにサービスの管理者 (サービスと共同管理者) に通知する必要があるかどうか。

RuleManagementEventClaimsDataSource

ルール管理イベント データ ソースの要求。

名前 説明
emailAddress

string

電子メール アドレス。

RuleManagementEventDataSource

ルール管理イベント データ ソース。 この場合、識別子フィールドは常に RuleManagementEventDataSource です。

名前 説明
claims

RuleManagementEventClaimsDataSource

要求。

eventName

string

イベント名。

eventSource

string

イベント ソース。

legacyResourceId

string

ルールが監視するリソースのレガシ リソース識別子。 : このプロパティは、既存のルールに対して更新できません。

level

string

レベルを指定します。

metricNamespace

string

メトリックの名前空間。

odata.type string:

Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource

は、データ ソースの種類を指定します。 ルール データ ソースには、RuleMetricDataSource と RuleManagementEventDataSource の 2 種類があります。

operationName

string

確認する必要がある操作の名前。 名前を指定しない場合は、すべての操作が一致します。

resourceGroupName

string

リソース グループ名。

resourceLocation

string

リソースの場所。

resourceProviderName

string

リソース プロバイダー名。

resourceUri

string

ルールが監視するリソースのリソース識別子。 : このプロパティは、既存のルールに対して更新できません。

status

string

確認する必要がある操作の状態。 状態を指定しない場合は、すべての状態が一致します。

subStatus

string

サブステータス。

RuleMetricDataSource

ルール メトリック データ ソース。 この場合、識別子の値は常に RuleMetricDataSource です。

名前 説明
legacyResourceId

string

ルールが監視するリソースのレガシ リソース識別子。 : このプロパティは、既存のルールに対して更新できません。

metricName

string

ルールが監視する内容を定義するメトリックの名前。

metricNamespace

string

メトリックの名前空間。

odata.type string:

Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource

は、データ ソースの種類を指定します。 ルール データ ソースには、RuleMetricDataSource と RuleManagementEventDataSource の 2 種類があります。

resourceLocation

string

リソースの場所。

resourceUri

string

ルールが監視するリソースのリソース識別子。 : このプロパティは、既存のルールに対して更新できません。

RuleWebhookAction

ルールの条件が評価されるときにサービスに投稿するアクションを指定します。 この場合、識別子は常に RuleWebhookAction です。

名前 説明
odata.type string:

Microsoft.Azure.Management.Insights.Models.RuleWebhookAction

は、アクションの種類を指定します。 アクションには、RuleEmailAction と RuleWebhookAction の 2 種類があります。

properties

object

post 操作に含めるカスタム プロパティのディクショナリ。 これらのデータは Webhook ペイロードに追加されます。

serviceUri

string

アラートがアクティブ化または解決されたときに通知を投稿するサービス URI。

ThresholdRuleCondition

しきい値を超えるメトリックに基づくルール条件。

名前 説明
dataSource RuleDataSource:

ルールがデータを収集するリソース。 この型の場合、dataSource は常に RuleMetricDataSource 型になります。

odata.type string:

Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition

は条件の種類を指定します。 これは、ManagementEventRuleCondition (管理イベントの発生)、LocationThresholdRuleCondition (Web テストの失敗数に基づく)、ThresholdRuleCondition (メトリックのしきい値に基づく) の 3 種類のいずれかです。

operator

ConditionOperator

データとしきい値の比較に使用される演算子。

threshold

number

アラートをアクティブにするしきい値。

timeAggregation

TimeAggregationOperator

時間集計演算子。 収集されるデータを時間の経過と同時に組み合わせる方法。 既定値は、メトリックの PrimaryAggregationType です。

windowSize

string

しきい値に基づいてアラート アクティビティを監視するために使用される期間 (ISO 8601 期間形式)。 指定する場合は、5 分から 1 日の間である必要があります。

TimeAggregationOperator

ルールで使用できる集計演算子。

名前 説明
Average

string

Last

string

Maximum

string

Minimum

string

Total

string