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 パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
resource
|
path | True |
string |
リソース グループの名前。 名前の大文字と小文字は区別されます。 |
rule
|
path | True |
string |
ルールの名前です。 |
subscription
|
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 |
アラート ルールを更新するための要求が成功しました |
|
201 Created |
アラート ルールを更新する要求が成功し、その結果アラート ルールが作成されました |
|
Other Status Codes |
操作に失敗した理由を説明するエラー応答。 |
セキュリティ
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": []
}
}
定義
名前 | 説明 |
---|---|
Alert |
アラート ルール リソース。 |
Alert |
パッチ操作のアラート ルール オブジェクト。 |
Condition |
ルール条件で使用できる演算子。 |
Error |
エラー応答の形式について説明します。 |
Location |
特定の数の場所に基づくルールの条件が失敗します。 |
Management |
収集されたデータの経時的な結合方法。 |
Management |
管理イベント ルールの条件。 |
Rule |
ルールの条件が評価されたときに電子メールを送信するアクションを指定します。 この場合、識別子は常に RuleEmailAction です。 |
Rule |
ルール管理イベント データ ソースの要求。 |
Rule |
ルール管理イベント データ ソース。 この場合、識別子フィールドは常に RuleManagementEventDataSource です。 |
Rule |
ルール メトリック データ ソース。 この場合、識別子の値は常に RuleMetricDataSource です。 |
Rule |
ルールの条件が評価されるときにサービスに投稿するアクションを指定します。 この場合、識別子は常に RuleWebhookAction です。 |
Threshold |
しきい値を超えるメトリックに基づくルール条件。 |
Time |
ルールで使用できる集計演算子。 |
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. |
は条件の種類を指定します。 これは、ManagementEventRuleCondition (管理イベントの発生)、LocationThresholdRuleCondition (Web テストの失敗数に基づく)、ThresholdRuleCondition (メトリックのしきい値に基づく) の 3 種類のいずれかです。 |
windowSize |
string |
しきい値に基づいてアラート アクティビティを監視するために使用される期間 (ISO 8601 期間形式)。 指定する場合は、5 分から 1 日の間である必要があります。 |
ManagementEventAggregationCondition
収集されたデータの経時的な結合方法。
名前 | 型 | 説明 |
---|---|---|
operator |
条件演算子。 |
|
threshold |
number |
アラートを有効にするしきい値。 |
windowSize |
string |
しきい値に基づいてアラート アクティビティを監視するために使用される期間 (ISO 8601 期間形式)。 指定する場合は、5 分から 1 日の間である必要があります。 |
ManagementEventRuleCondition
管理イベント ルールの条件。
名前 | 型 | 説明 |
---|---|---|
aggregation |
収集されるデータを時間の経過と同時に、アラートをアクティブ化するタイミングを組み合わせる方法。 管理イベントのアラートの集計は省略可能です。指定しない場合は、すべてのイベントによってアラートがアクティブ化されます。 |
|
dataSource | RuleDataSource: |
ルールがデータを収集するリソース。 この型の場合、dataSource は常に RuleMetricDataSource 型になります。 |
odata.type |
string:
Microsoft. |
は条件の種類を指定します。 これは、ManagementEventRuleCondition (管理イベントの発生)、LocationThresholdRuleCondition (Web テストの失敗数に基づく)、ThresholdRuleCondition (メトリックのしきい値に基づく) の 3 種類のいずれかです。 |
RuleEmailAction
ルールの条件が評価されたときに電子メールを送信するアクションを指定します。 この場合、識別子は常に RuleEmailAction です。
名前 | 型 | 説明 |
---|---|---|
customEmails |
string[] |
アラートのアクティブ化を通知する管理者のカスタム 電子メール アドレスの一覧。 |
odata.type |
string:
Microsoft. |
は、アクションの種類を指定します。 アクションには、RuleEmailAction と RuleWebhookAction の 2 種類があります。 |
sendToServiceOwners |
boolean |
アラートがアクティブ化されたときにサービスの管理者 (サービスと共同管理者) に通知する必要があるかどうか。 |
RuleManagementEventClaimsDataSource
ルール管理イベント データ ソースの要求。
名前 | 型 | 説明 |
---|---|---|
emailAddress |
string |
電子メール アドレス。 |
RuleManagementEventDataSource
ルール管理イベント データ ソース。 この場合、識別子フィールドは常に RuleManagementEventDataSource です。
名前 | 型 | 説明 |
---|---|---|
claims |
要求。 |
|
eventName |
string |
イベント名。 |
eventSource |
string |
イベント ソース。 |
legacyResourceId |
string |
ルールが監視するリソースのレガシ リソース識別子。 注: このプロパティは、既存のルールに対して更新できません。 |
level |
string |
レベルを指定します。 |
metricNamespace |
string |
メトリックの名前空間。 |
odata.type |
string:
Microsoft. |
は、データ ソースの種類を指定します。 ルール データ ソースには、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. |
は、データ ソースの種類を指定します。 ルール データ ソースには、RuleMetricDataSource と RuleManagementEventDataSource の 2 種類があります。 |
resourceLocation |
string |
リソースの場所。 |
resourceUri |
string |
ルールが監視するリソースのリソース識別子。 注: このプロパティは、既存のルールに対して更新できません。 |
RuleWebhookAction
ルールの条件が評価されるときにサービスに投稿するアクションを指定します。 この場合、識別子は常に RuleWebhookAction です。
名前 | 型 | 説明 |
---|---|---|
odata.type |
string:
Microsoft. |
は、アクションの種類を指定します。 アクションには、RuleEmailAction と RuleWebhookAction の 2 種類があります。 |
properties |
object |
post 操作に含めるカスタム プロパティのディクショナリ。 これらのデータは Webhook ペイロードに追加されます。 |
serviceUri |
string |
アラートがアクティブ化または解決されたときに通知を投稿するサービス URI。 |
ThresholdRuleCondition
しきい値を超えるメトリックに基づくルール条件。
名前 | 型 | 説明 |
---|---|---|
dataSource | RuleDataSource: |
ルールがデータを収集するリソース。 この型の場合、dataSource は常に RuleMetricDataSource 型になります。 |
odata.type |
string:
Microsoft. |
は条件の種類を指定します。 これは、ManagementEventRuleCondition (管理イベントの発生)、LocationThresholdRuleCondition (Web テストの失敗数に基づく)、ThresholdRuleCondition (メトリックのしきい値に基づく) の 3 種類のいずれかです。 |
operator |
データとしきい値の比較に使用される演算子。 |
|
threshold |
number |
アラートをアクティブにするしきい値。 |
timeAggregation |
時間集計演算子。 収集されるデータを時間の経過と同時に組み合わせる方法。 既定値は、メトリックの PrimaryAggregationType です。 |
|
windowSize |
string |
しきい値に基づいてアラート アクティビティを監視するために使用される期間 (ISO 8601 期間形式)。 指定する場合は、5 分から 1 日の間である必要があります。 |
TimeAggregationOperator
ルールで使用できる集計演算子。
名前 | 型 | 説明 |
---|---|---|
Average |
string |
|
Last |
string |
|
Maximum |
string |
|
Minimum |
string |
|
Total |
string |