Action Groups - Update

リファレンス

サービス:: Monitor

API バージョン:: 2021-09-01

既存のアクショングループのタグを更新します。他のフィールドを更新するには、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
  }
}

package armmonitor_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/monitor/armmonitor"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/monitor/resource-manager/Microsoft.Insights/stable/2021-09-01/examples/patchActionGroup.json
func ExampleActionGroupsClient_Update() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
		return
	}
	ctx := context.Background()
	client, err := armmonitor.NewActionGroupsClient("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
		return
	}
	res, err := client.Update(ctx,
		"<resource-group-name>",
		"<action-group-name>",
		armmonitor.ActionGroupPatchBody{
			Properties: &armmonitor.ActionGroupPatch{
				Enabled: to.Ptr(false),
			},
			Tags: map[string]*string{
				"key1": to.Ptr("value1"),
				"key2": to.Ptr("value2"),
			},
		},
		nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
		return
	}
	// TODO: use response item
	_ = res
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

{
  "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	共通アラートスキーマを使用するかどうかを示します。

次の方法で共有