次の方法で共有


Action Groups - Update

既存のアクション グループのタグを更新します。 他のフィールドを更新するには、CreateOrUpdate メソッドを使用します。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/actionGroups/{actionGroupName}?api-version=2021-09-01

URI パラメーター

名前 / 必須 説明
actionGroupName
path True

string

アクション グループの名前。

resourceGroupName
path True

string

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

subscriptionId
path True

string

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

api-version
query True

string

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

要求本文

名前 説明
properties.enabled

boolean

このアクション グループが有効かどうかを示します。 アクション グループが有効になっていない場合、そのアクションはアクティブになりません。

tags

object

リソース タグ

応答

名前 説明
200 OK

ActionGroupResource

既存のアクション グループが正常に更新されました。

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 action group

要求のサンプル

PATCH https://management.azure.com/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/Default-NotificationRules/providers/Microsoft.Insights/actionGroups/SampleActionGroup?api-version=2021-09-01

{
  "tags": {
    "key1": "value1",
    "key2": "value2"
  },
  "properties": {
    "enabled": false
  }
}

応答のサンプル

{
  "id": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/Default-NotificationRules/providers/microsoft.insights/actionGroups/SampleActionGroup",
  "type": "Microsoft.Insights/ActionGroups",
  "name": "SampleActionGroup",
  "location": "Global",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  },
  "properties": {
    "groupShortName": "sample",
    "enabled": true,
    "emailReceivers": [
      {
        "name": "John Doe's email",
        "emailAddress": "johndoe@email.com",
        "status": "Enabled",
        "useCommonAlertSchema": true
      },
      {
        "name": "Jane Smith's email",
        "emailAddress": "janesmith@email.com",
        "status": "Enabled",
        "useCommonAlertSchema": true
      }
    ],
    "smsReceivers": [
      {
        "name": "John Doe's mobile",
        "countryCode": "1",
        "phoneNumber": "1234567890",
        "status": "Enabled"
      },
      {
        "name": "Jane Smith's mobile",
        "countryCode": "1",
        "phoneNumber": "0987654321",
        "status": "Enabled"
      }
    ],
    "webhookReceivers": [
      {
        "name": "Sample webhook",
        "serviceUri": "http://www.example.com/webhook",
        "useCommonAlertSchema": false
      },
      {
        "name": "Sample webhook 2",
        "serviceUri": "http://www.example.com/webhook2",
        "useCommonAlertSchema": true,
        "useAadAuth": true,
        "objectId": "d3bb868c-fe44-452c-aa26-769a6538c808",
        "identifierUri": "http://someidentifier/d7811ba3-7996-4a93-99b6-6b2f3f355f8a",
        "tenantId": "68a4459a-ccb8-493c-b9da-dd30457d1b84"
      }
    ],
    "itsmReceivers": [],
    "azureAppPushReceivers": [],
    "automationRunbookReceivers": [],
    "voiceReceivers": [],
    "logicAppReceivers": [],
    "azureFunctionReceivers": [],
    "armRoleReceivers": [],
    "eventHubReceivers": []
  }
}

定義

名前 説明
ActionGroupPatchBody

パッチ操作の本文のアクション グループ オブジェクト。

ActionGroupResource

アクション グループ リソース。

ArmRoleReceiver

arm ロール レシーバー。

AutomationRunbookReceiver

Azure Automation Runbook 通知レシーバー。

AzureAppPushReceiver

Azure モバイル アプリプッシュ通知レシーバー。

AzureFunctionReceiver

Azure 関数レシーバー。

EmailReceiver

電子メール 受信者。

ErrorResponse

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

EventHubReceiver

イベント ハブ レシーバー。

ItsmReceiver

Itsm レシーバー。

LogicAppReceiver

ロジック アプリ レシーバー。

ReceiverStatus

受信側の状態を示します。 有効になっていない受信者は、通信を受信しません。

SmsReceiver

SMS レシーバー。

VoiceReceiver

音声レシーバー。

WebhookReceiver

Webhook レシーバー。

ActionGroupPatchBody

パッチ操作の本文のアクション グループ オブジェクト。

名前 規定値 説明
properties.enabled

boolean

True

このアクション グループが有効かどうかを示します。 アクション グループが有効になっていない場合、そのアクションはアクティブになりません。

tags

object

リソース タグ

ActionGroupResource

アクション グループ リソース。

名前 規定値 説明
id

string

Azure リソース ID

location

string

リソースの場所

name

string

Azure リソース名

properties.armRoleReceivers

ArmRoleReceiver[]

このアクション グループの一部である ARM ロール レシーバーの一覧。 ロールは Azure RBAC ロールであり、組み込みロールのみがサポートされます。

properties.automationRunbookReceivers

AutomationRunbookReceiver[]

このアクション グループの一部である AutomationRunbook レシーバーの一覧。

properties.azureAppPushReceivers

AzureAppPushReceiver[]

このアクション グループの一部である AzureAppPush レシーバーの一覧。

properties.azureFunctionReceivers

AzureFunctionReceiver[]

このアクション グループの一部である Azure 関数レシーバーの一覧。

properties.emailReceivers

EmailReceiver[]

このアクション グループの一部である電子メール レシーバーの一覧。

properties.enabled

boolean

True

このアクション グループが有効かどうかを示します。 アクション グループが有効になっていない場合、どの受信者も通信を受信しません。

properties.eventHubReceivers

EventHubReceiver[]

このアクション グループの一部であるイベント ハブ レシーバーの一覧。

properties.groupShortName

string

アクション グループの短い名前。 これは SMS メッセージで使用されます。

properties.itsmReceivers

ItsmReceiver[]

このアクション グループの一部である ITSM レシーバーの一覧。

properties.logicAppReceivers

LogicAppReceiver[]

このアクション グループの一部であるロジック アプリ レシーバーの一覧。

properties.smsReceivers

SmsReceiver[]

このアクション グループの一部である SMS レシーバーの一覧。

properties.voiceReceivers

VoiceReceiver[]

このアクション グループの一部である音声レシーバーの一覧。

properties.webhookReceivers

WebhookReceiver[]

このアクション グループの一部である Webhook レシーバーの一覧。

tags

object

リソース タグ

type

string

Azure リソースタイプ

ArmRoleReceiver

arm ロール レシーバー。

名前 規定値 説明
name

string

arm ロール レシーバーの名前。 名前は、アクション グループ内のすべての受信者で一意である必要があります。

roleId

string

arm ロール ID。

useCommonAlertSchema

boolean

False

共通アラート スキーマを使用するかどうかを示します。

AutomationRunbookReceiver

Azure Automation Runbook 通知レシーバー。

名前 規定値 説明
automationAccountId

string

この Runbook を保持し、Azure リソースに対して認証する Azure Automation アカウント ID。

isGlobalRunbook

boolean

このインスタンスがグローバル Runbook であるかどうかを示します。

name

string

Webhook の名前を示します。

runbookName

string

この Runbook の名前。

serviceUri

string

Webhook を送信する URI。

useCommonAlertSchema

boolean

False

共通アラート スキーマを使用するかどうかを示します。

webhookResourceId

string

この Runbook にリンクされている Webhook のリソース ID。

AzureAppPushReceiver

Azure モバイル アプリプッシュ通知レシーバー。

名前 説明
emailAddress

string

Azure モバイル アプリに登録されている電子メール アドレス。

name

string

Azure モバイル アプリ プッシュ レシーバーの名前。 名前は、アクション グループ内のすべての受信者で一意である必要があります。

AzureFunctionReceiver

Azure 関数レシーバー。

名前 規定値 説明
functionAppResourceId

string

関数アプリの Azure リソース ID。

functionName

string

関数アプリの関数名。

httpTriggerUrl

string

http 要求の送信先の http トリガー URL。

name

string

Azure 関数レシーバーの名前。 名前は、アクション グループ内のすべての受信者で一意である必要があります。

useCommonAlertSchema

boolean

False

共通アラート スキーマを使用するかどうかを示します。

EmailReceiver

電子メール 受信者。

名前 規定値 説明
emailAddress

string

この受信者のメール アドレス。

name

string

電子メール 受信者の名前。 名前は、アクション グループ内のすべての受信者で一意である必要があります。

status

ReceiverStatus

電子メールの受信者の状態。

useCommonAlertSchema

boolean

False

共通アラート スキーマを使用するかどうかを示します。

ErrorResponse

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

名前 説明
code

string

エラー コード

message

string

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

EventHubReceiver

イベント ハブ レシーバー。

名前 規定値 説明
eventHubName

string

特定のイベント ハブ キューの名前

eventHubNameSpace

string

Event Hub 名前空間

name

string

イベント ハブ レシーバーの名前。 名前は、アクション グループ内のすべての受信者で一意である必要があります。

subscriptionId

string

このイベント ハブを含むサブスクリプションの ID

tenantId

string

このイベント ハブを含むサブスクリプションのテナント ID

useCommonAlertSchema

boolean

False

共通アラート スキーマを使用するかどうかを示します。

ItsmReceiver

Itsm レシーバー。

名前 説明
connectionId

string

上記のワークスペースで定義されている複数の間の ITSM 接続の一意の識別。

name

string

Itsm レシーバーの名前。 名前は、アクション グループ内のすべての受信者で一意である必要があります。

region

string

ワークスペースが存在するリージョン。 サポートされている値:'centralindia'、'japaneast'、'southeastasia'、'australiasoutheast'、'uksouth'、'westcentralus'、'canadacentral'、'eastus'、'westeurope'

ticketConfiguration

string

ITSM アクションの構成用の JSON BLOB。 CreateMultipleWorkItems オプションもこの BLOB の一部になります。

workspaceId

string

OMS LA インスタンス識別子。

LogicAppReceiver

ロジック アプリ レシーバー。

名前 規定値 説明
callbackUrl

string

http 要求の送信先のコールバック URL。

name

string

ロジック アプリ レシーバーの名前。 名前は、アクション グループ内のすべての受信者で一意である必要があります。

resourceId

string

ロジック アプリ レシーバーの Azure リソース ID。

useCommonAlertSchema

boolean

False

共通アラート スキーマを使用するかどうかを示します。

ReceiverStatus

受信側の状態を示します。 有効になっていない受信者は、通信を受信しません。

名前 説明
Disabled

string

Enabled

string

NotSpecified

string

SmsReceiver

SMS レシーバー。

名前 説明
countryCode

string

SMS レシーバーの国コード。

name

string

SMS レシーバーの名前。 名前は、アクション グループ内のすべての受信者で一意である必要があります。

phoneNumber

string

SMS レシーバーの電話番号。

status

ReceiverStatus

受信側の状態。

VoiceReceiver

音声レシーバー。

名前 説明
countryCode

string

音声レシーバーの国コード。

name

string

音声レシーバーの名前。 名前は、アクション グループ内のすべての受信者で一意である必要があります。

phoneNumber

string

音声レシーバーの電話番号。

WebhookReceiver

Webhook レシーバー。

名前 規定値 説明
identifierUri

string

aad 認証の識別子 URI を示します。

name

string

Webhook レシーバーの名前。 名前は、アクション グループ内のすべての受信者で一意である必要があります。

objectId

string

aad 認証の Webhook アプリ オブジェクト ID を示します。

serviceUri

string

Webhook を送信する URI。

tenantId

string

認証のテナント ID を示します。

useAadAuth

boolean

False

AAD 認証を使用するかどうかを示します。

useCommonAlertSchema

boolean

False

共通アラート スキーマを使用するかどうかを示します。