Action Groups - Create Or Update

Riferimento

Servizio:: Monitor

Versione API:: 2021-09-01

Creare un nuovo gruppo di azioni o aggiornarne uno esistente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
actionGroupName	path	True	string	Nome del gruppo di azioni.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Percorso risorsa
properties.enabled	True	boolean	Indica se questo gruppo di azioni è abilitato. Se un gruppo di azioni non è abilitato, nessuno dei destinatari riceverà le comunicazioni.
properties.groupShortName	True	string maxLength: 12	Nome breve del gruppo di azioni. Questo verrà usato nei messaggi SMS.
properties.armRoleReceivers		ArmRoleReceiver[]	Elenco dei ricevitori di ruolo arm che fanno parte di questo gruppo di azioni. I ruoli sono ruoli controllo degli accessi in base al ruolo di Azure e sono supportati solo i ruoli predefiniti.
properties.automationRunbookReceivers		AutomationRunbookReceiver[]	Elenco dei ricevitori automationRunbook che fanno parte di questo gruppo di azioni.
properties.azureAppPushReceivers		AzureAppPushReceiver[]	Elenco dei ricevitori AzureAppPush che fanno parte di questo gruppo di azioni.
properties.azureFunctionReceivers		AzureFunctionReceiver[]	Elenco di ricevitori di funzioni di Azure che fanno parte di questo gruppo di azioni.
properties.emailReceivers		EmailReceiver[]	Elenco di ricevitori di posta elettronica che fanno parte di questo gruppo di azioni.
properties.eventHubReceivers		EventHubReceiver[]	Elenco dei ricevitori dell'hub eventi che fanno parte di questo gruppo di azioni.
properties.itsmReceivers		ItsmReceiver[]	Elenco di ricevitori ITSM che fanno parte di questo gruppo di azioni.
properties.logicAppReceivers		LogicAppReceiver[]	Elenco dei ricevitori di app per la logica che fanno parte di questo gruppo di azioni.
properties.smsReceivers		SmsReceiver[]	Elenco di ricevitori SMS che fanno parte di questo gruppo di azioni.
properties.voiceReceivers		VoiceReceiver[]	Elenco di ricevitori vocali che fanno parte di questo gruppo di azioni.
properties.webhookReceivers		WebhookReceiver[]	Elenco di ricevitori webhook che fanno parte di questo gruppo di azioni.
tags		object	Tag delle risorse

Risposte

Nome	Tipo	Descrizione
200 OK	ActionGroupResource	Un gruppo di azioni esistente è stato aggiornato correttamente.
201 Created	ActionGroupResource	È stato creato un nuovo gruppo di azioni.
Other Status Codes	ErrorResponse	Si è verificato un errore e non è stato possibile creare o aggiornare il gruppo di azioni.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Create or update an action group

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

{
  "location": "Global",
  "tags": {},
  "properties": {
    "groupShortName": "sample",
    "enabled": true,
    "emailReceivers": [
      {
        "name": "John Doe's email",
        "emailAddress": "johndoe@email.com",
        "useCommonAlertSchema": false
      },
      {
        "name": "Jane Smith's email",
        "emailAddress": "janesmith@email.com",
        "useCommonAlertSchema": true
      }
    ],
    "smsReceivers": [
      {
        "name": "John Doe's mobile",
        "countryCode": "1",
        "phoneNumber": "1234567890"
      },
      {
        "name": "Jane Smith's mobile",
        "countryCode": "1",
        "phoneNumber": "0987654321"
      }
    ],
    "webhookReceivers": [
      {
        "name": "Sample webhook 1",
        "serviceUri": "http://www.example.com/webhook1",
        "useCommonAlertSchema": true
      },
      {
        "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": [
      {
        "name": "Sample itsm",
        "workspaceId": "5def922a-3ed4-49c1-b9fd-05ec533819a3|55dfd1f8-7e59-4f89-bf56-4c82f5ace23c",
        "connectionId": "a3b9076c-ce8e-434e-85b4-aff10cb3c8f1",
        "ticketConfiguration": "{\"PayloadRevision\":0,\"WorkItemType\":\"Incident\",\"UseTemplate\":false,\"WorkItemData\":\"{}\",\"CreateOneWIPerCI\":false}",
        "region": "westcentralus"
      }
    ],
    "azureAppPushReceivers": [
      {
        "name": "Sample azureAppPush",
        "emailAddress": "johndoe@email.com"
      }
    ],
    "automationRunbookReceivers": [
      {
        "automationAccountId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/runbookTest/providers/Microsoft.Automation/automationAccounts/runbooktest",
        "runbookName": "Sample runbook",
        "webhookResourceId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/runbookTest/providers/Microsoft.Automation/automationAccounts/runbooktest/webhooks/Alert1510184037084",
        "isGlobalRunbook": false,
        "name": "testRunbook",
        "serviceUri": "<serviceUri>",
        "useCommonAlertSchema": true
      }
    ],
    "voiceReceivers": [
      {
        "name": "Sample voice",
        "countryCode": "1",
        "phoneNumber": "1234567890"
      }
    ],
    "logicAppReceivers": [
      {
        "name": "Sample logicApp",
        "resourceId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/LogicApp/providers/Microsoft.Logic/workflows/testLogicApp",
        "callbackUrl": "https://prod-27.northcentralus.logic.azure.com/workflows/68e572e818e5457ba898763b7db90877/triggers/manual/paths/invoke/azns/test?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=Abpsb72UYJxPPvmDo937uzofupO5r_vIeWEx7KVHo7w",
        "useCommonAlertSchema": false
      }
    ],
    "azureFunctionReceivers": [
      {
        "name": "Sample azureFunction",
        "functionAppResourceId": "/subscriptions/5def922a-3ed4-49c1-b9fd-05ec533819a3/resourceGroups/aznsTest/providers/Microsoft.Web/sites/testFunctionApp",
        "functionName": "HttpTriggerCSharp1",
        "httpTriggerUrl": "http://test.me",
        "useCommonAlertSchema": true
      }
    ],
    "armRoleReceivers": [
      {
        "name": "Sample armRole",
        "roleId": "8e3af657-a8ff-443c-a75c-2fe8c4bcb635",
        "useCommonAlertSchema": true
      }
    ],
    "eventHubReceivers": [
      {
        "name": "Sample eventHub",
        "eventHubNameSpace": "testEventHubNameSpace",
        "eventHubName": "testEventHub",
        "subscriptionId": "187f412d-1758-44d9-b052-169e2564721d",
        "tenantId": "68a4459a-ccb8-493c-b9da-dd30457d1b84"
      }
    ]
  }
}

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/createOrUpdateActionGroup.json
func ExampleActionGroupsClient_CreateOrUpdate() {
	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.CreateOrUpdate(ctx,
		"<resource-group-name>",
		"<action-group-name>",
		armmonitor.ActionGroupResource{
			Location: to.Ptr("<location>"),
			Tags:     map[string]*string{},
			Properties: &armmonitor.ActionGroup{
				ArmRoleReceivers: []*armmonitor.ArmRoleReceiver{
					{
						Name:                 to.Ptr("<name>"),
						RoleID:               to.Ptr("<role-id>"),
						UseCommonAlertSchema: to.Ptr(true),
					}},
				AutomationRunbookReceivers: []*armmonitor.AutomationRunbookReceiver{
					{
						Name:                 to.Ptr("<name>"),
						AutomationAccountID:  to.Ptr("<automation-account-id>"),
						IsGlobalRunbook:      to.Ptr(false),
						RunbookName:          to.Ptr("<runbook-name>"),
						ServiceURI:           to.Ptr("<service-uri>"),
						UseCommonAlertSchema: to.Ptr(true),
						WebhookResourceID:    to.Ptr("<webhook-resource-id>"),
					}},
				AzureAppPushReceivers: []*armmonitor.AzureAppPushReceiver{
					{
						Name:         to.Ptr("<name>"),
						EmailAddress: to.Ptr("<email-address>"),
					}},
				AzureFunctionReceivers: []*armmonitor.AzureFunctionReceiver{
					{
						Name:                  to.Ptr("<name>"),
						FunctionAppResourceID: to.Ptr("<function-app-resource-id>"),
						FunctionName:          to.Ptr("<function-name>"),
						HTTPTriggerURL:        to.Ptr("<httptrigger-url>"),
						UseCommonAlertSchema:  to.Ptr(true),
					}},
				EmailReceivers: []*armmonitor.EmailReceiver{
					{
						Name:                 to.Ptr("<name>"),
						EmailAddress:         to.Ptr("<email-address>"),
						UseCommonAlertSchema: to.Ptr(false),
					},
					{
						Name:                 to.Ptr("<name>"),
						EmailAddress:         to.Ptr("<email-address>"),
						UseCommonAlertSchema: to.Ptr(true),
					}},
				Enabled: to.Ptr(true),
				EventHubReceivers: []*armmonitor.EventHubReceiver{
					{
						Name:              to.Ptr("<name>"),
						EventHubName:      to.Ptr("<event-hub-name>"),
						EventHubNameSpace: to.Ptr("<event-hub-name-space>"),
						SubscriptionID:    to.Ptr("<subscription-id>"),
						TenantID:          to.Ptr("<tenant-id>"),
					}},
				GroupShortName: to.Ptr("<group-short-name>"),
				ItsmReceivers: []*armmonitor.ItsmReceiver{
					{
						Name:                to.Ptr("<name>"),
						ConnectionID:        to.Ptr("<connection-id>"),
						Region:              to.Ptr("<region>"),
						TicketConfiguration: to.Ptr("<ticket-configuration>"),
						WorkspaceID:         to.Ptr("<workspace-id>"),
					}},
				LogicAppReceivers: []*armmonitor.LogicAppReceiver{
					{
						Name:                 to.Ptr("<name>"),
						CallbackURL:          to.Ptr("<callback-url>"),
						ResourceID:           to.Ptr("<resource-id>"),
						UseCommonAlertSchema: to.Ptr(false),
					}},
				SmsReceivers: []*armmonitor.SmsReceiver{
					{
						Name:        to.Ptr("<name>"),
						CountryCode: to.Ptr("<country-code>"),
						PhoneNumber: to.Ptr("<phone-number>"),
					},
					{
						Name:        to.Ptr("<name>"),
						CountryCode: to.Ptr("<country-code>"),
						PhoneNumber: to.Ptr("<phone-number>"),
					}},
				VoiceReceivers: []*armmonitor.VoiceReceiver{
					{
						Name:        to.Ptr("<name>"),
						CountryCode: to.Ptr("<country-code>"),
						PhoneNumber: to.Ptr("<phone-number>"),
					}},
				WebhookReceivers: []*armmonitor.WebhookReceiver{
					{
						Name:                 to.Ptr("<name>"),
						ServiceURI:           to.Ptr("<service-uri>"),
						UseCommonAlertSchema: to.Ptr(true),
					},
					{
						Name:                 to.Ptr("<name>"),
						IdentifierURI:        to.Ptr("<identifier-uri>"),
						ObjectID:             to.Ptr("<object-id>"),
						ServiceURI:           to.Ptr("<service-uri>"),
						TenantID:             to.Ptr("<tenant-id>"),
						UseAADAuth:           to.Ptr(true),
						UseCommonAlertSchema: to.Ptr(true),
					}},
			},
		},
		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

Risposta di esempio

Codice di stato:: 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": {},
  "properties": {
    "groupShortName": "sample",
    "enabled": true,
    "emailReceivers": [
      {
        "name": "John Doe's email",
        "emailAddress": "johndoe@email.com",
        "status": "Enabled",
        "useCommonAlertSchema": false
      },
      {
        "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 1",
        "serviceUri": "http://www.example.com/webhook1",
        "useCommonAlertSchema": true
      },
      {
        "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": [
      {
        "name": "Sample itsm",
        "workspaceId": "5def922a-3ed4-49c1-b9fd-05ec533819a3|55dfd1f8-7e59-4f89-bf56-4c82f5ace23c",
        "connectionId": "a3b9076c-ce8e-434e-85b4-aff10cb3c8f1",
        "ticketConfiguration": "{\"PayloadRevision\":0,\"WorkItemType\":\"Incident\",\"UseTemplate\":false,\"WorkItemData\":\"{}\",\"CreateOneWIPerCI\":false}",
        "region": "westcentralus"
      }
    ],
    "azureAppPushReceivers": [
      {
        "name": "Sample azureAppPush",
        "emailAddress": "johndoe@email.com"
      }
    ],
    "automationRunbookReceivers": [
      {
        "automationAccountId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/runbookTest/providers/Microsoft.Automation/automationAccounts/runbooktest",
        "runbookName": "Sample runbook",
        "webhookResourceId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/runbookTest/providers/Microsoft.Automation/automationAccounts/runbooktest/webhooks/Alert1510184037084",
        "isGlobalRunbook": false,
        "name": "testRunbook",
        "serviceUri": "<serviceUri>",
        "useCommonAlertSchema": true
      }
    ],
    "voiceReceivers": [
      {
        "name": "Sample voice",
        "countryCode": "1",
        "phoneNumber": "1234567890"
      }
    ],
    "logicAppReceivers": [
      {
        "name": "Sample logicApp",
        "resourceId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/LogicApp/providers/Microsoft.Logic/workflows/testLogicApp",
        "callbackUrl": "https://prod-27.northcentralus.logic.azure.com/workflows/68e572e818e5457ba898763b7db90877/triggers/manual/paths/invoke/azns/test?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=Abpsb72UYJxPPvmDo937uzofupO5r_vIeWEx7KVHo7w",
        "useCommonAlertSchema": false
      }
    ],
    "azureFunctionReceivers": [
      {
        "name": "Sample azureFunction",
        "functionAppResourceId": "/subscriptions/5def922a-3ed4-49c1-b9fd-05ec533819a3/resourceGroups/aznsTest/providers/Microsoft.Web/sites/testFunctionApp",
        "functionName": "HttpTriggerCSharp1",
        "httpTriggerUrl": "<httpTriggerUrl>",
        "useCommonAlertSchema": true
      }
    ],
    "armRoleReceivers": [
      {
        "name": "Sample armRole",
        "roleId": "8e3af657-a8ff-443c-a75c-2fe8c4bcb635",
        "useCommonAlertSchema": true
      }
    ],
    "eventHubReceivers": [
      {
        "name": "Sample eventHub",
        "eventHubNameSpace": "testEventHubNameSpace",
        "eventHubName": "testEventHub",
        "subscriptionId": "187f412d-1758-44d9-b052-169e2564721d",
        "tenantId": "68a4459a-ccb8-493c-b9da-dd30457d1b84",
        "useCommonAlertSchema": false
      }
    ]
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/Default-NotificationRules/providers/microsoft.insights/actionGroups/SampleActionGroup",
  "type": "Microsoft.Insights/ActionGroups",
  "name": "SampleActionGroup",
  "location": "Global",
  "tags": {},
  "properties": {
    "groupShortName": "sample",
    "enabled": true,
    "emailReceivers": [
      {
        "name": "John Doe's email",
        "emailAddress": "johndoe@email.com",
        "status": "Enabled",
        "useCommonAlertSchema": false
      },
      {
        "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 1",
        "serviceUri": "http://www.example.com/webhook1",
        "useCommonAlertSchema": true
      },
      {
        "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": [
      {
        "name": "Sample itsm",
        "workspaceId": "5def922a-3ed4-49c1-b9fd-05ec533819a3|55dfd1f8-7e59-4f89-bf56-4c82f5ace23c",
        "connectionId": "a3b9076c-ce8e-434e-85b4-aff10cb3c8f1",
        "ticketConfiguration": "{\"PayloadRevision\":0,\"WorkItemType\":\"Incident\",\"UseTemplate\":false,\"WorkItemData\":\"{}\",\"CreateOneWIPerCI\":false}",
        "region": "westcentralus"
      }
    ],
    "azureAppPushReceivers": [
      {
        "name": "Sample azureAppPush",
        "emailAddress": "johndoe@email.com"
      }
    ],
    "automationRunbookReceivers": [
      {
        "automationAccountId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/runbookTest/providers/Microsoft.Automation/automationAccounts/runbooktest",
        "runbookName": "Sample runbook",
        "webhookResourceId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/runbookTest/providers/Microsoft.Automation/automationAccounts/runbooktest/webhooks/Alert1510184037084",
        "isGlobalRunbook": false,
        "name": "testRunbook",
        "serviceUri": "<serviceUri>",
        "useCommonAlertSchema": true
      }
    ],
    "voiceReceivers": [
      {
        "name": "Sample voice",
        "countryCode": "1",
        "phoneNumber": "1234567890"
      }
    ],
    "logicAppReceivers": [
      {
        "name": "Sample logicApp",
        "resourceId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/LogicApp/providers/Microsoft.Logic/workflows/testLogicApp",
        "callbackUrl": "https://prod-27.northcentralus.logic.azure.com/workflows/68e572e818e5457ba898763b7db90877/triggers/manual/paths/invoke/azns/test?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=Abpsb72UYJxPPvmDo937uzofupO5r_vIeWEx7KVHo7w",
        "useCommonAlertSchema": false
      }
    ],
    "azureFunctionReceivers": [
      {
        "name": "Sample azureFunction",
        "functionAppResourceId": "/subscriptions/5def922a-3ed4-49c1-b9fd-05ec533819a3/resourceGroups/aznsTest/providers/Microsoft.Web/sites/testFunctionApp",
        "functionName": "HttpTriggerCSharp1",
        "httpTriggerUrl": "<httpTriggerUrl>",
        "useCommonAlertSchema": true
      }
    ],
    "armRoleReceivers": [
      {
        "name": "Sample armRole",
        "roleId": "8e3af657-a8ff-443c-a75c-2fe8c4bcb635",
        "useCommonAlertSchema": true
      }
    ],
    "eventHubReceivers": [
      {
        "name": "Sample eventHub",
        "eventHubNameSpace": "testEventHubNameSpace",
        "eventHubName": "testEventHub",
        "subscriptionId": "187f412d-1758-44d9-b052-169e2564721d",
        "tenantId": "68a4459a-ccb8-493c-b9da-dd30457d1b84",
        "useCommonAlertSchema": false
      }
    ]
  }
}

Definizioni

Nome	Descrizione
ActionGroupResource	Una risorsa del gruppo di azioni.
ArmRoleReceiver	Ricevitore del ruolo arm.
AutomationRunbookReceiver	Ricevitore di notifica del runbook di Automazione di Azure.
AzureAppPushReceiver	Ricevitore di notifiche push dell'app per dispositivi mobili di Azure.
AzureFunctionReceiver	Ricevitore di funzioni di Azure.
EmailReceiver	Ricevitore di posta elettronica.
ErrorResponse	Descrive il formato della risposta di errore.
EventHubReceiver	Ricevitore dell'hub eventi.
ItsmReceiver	Ricevitore Itsm.
LogicAppReceiver	Ricevitore di app per la logica.
ReceiverStatus	Indica lo stato del ricevitore. I ricevitori che non sono abilitati non riceveranno alcuna comunicazione.
SmsReceiver	Ricevitore SMS.
VoiceReceiver	Ricevitore vocale.
WebhookReceiver	Ricevitore webhook.

ActionGroupResource

Object

Una risorsa del gruppo di azioni.

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID risorsa di Azure
location	string		Percorso risorsa
name	string		Nome risorsa di Azure
properties.armRoleReceivers	ArmRoleReceiver[]		Elenco dei ricevitori di ruolo arm che fanno parte di questo gruppo di azioni. I ruoli sono ruoli controllo degli accessi in base al ruolo di Azure e sono supportati solo i ruoli predefiniti.
properties.automationRunbookReceivers	AutomationRunbookReceiver[]		Elenco dei ricevitori automationRunbook che fanno parte di questo gruppo di azioni.
properties.azureAppPushReceivers	AzureAppPushReceiver[]		Elenco dei ricevitori AzureAppPush che fanno parte di questo gruppo di azioni.
properties.azureFunctionReceivers	AzureFunctionReceiver[]		Elenco di ricevitori di funzioni di Azure che fanno parte di questo gruppo di azioni.
properties.emailReceivers	EmailReceiver[]		Elenco di ricevitori di posta elettronica che fanno parte di questo gruppo di azioni.
properties.enabled	boolean	True	Indica se questo gruppo di azioni è abilitato. Se un gruppo di azioni non è abilitato, nessuno dei destinatari riceverà le comunicazioni.
properties.eventHubReceivers	EventHubReceiver[]		Elenco dei ricevitori dell'hub eventi che fanno parte di questo gruppo di azioni.
properties.groupShortName	string maxLength: 12		Nome breve del gruppo di azioni. Questo verrà usato nei messaggi SMS.
properties.itsmReceivers	ItsmReceiver[]		Elenco di ricevitori ITSM che fanno parte di questo gruppo di azioni.
properties.logicAppReceivers	LogicAppReceiver[]		Elenco dei ricevitori di app per la logica che fanno parte di questo gruppo di azioni.
properties.smsReceivers	SmsReceiver[]		Elenco di ricevitori SMS che fanno parte di questo gruppo di azioni.
properties.voiceReceivers	VoiceReceiver[]		Elenco di ricevitori vocali che fanno parte di questo gruppo di azioni.
properties.webhookReceivers	WebhookReceiver[]		Elenco di ricevitori webhook che fanno parte di questo gruppo di azioni.
tags	object		Tag delle risorse
type	string		Tipo di risorsa di Azure

ArmRoleReceiver

Object

Ricevitore del ruolo arm.

Nome	Tipo	Valore predefinito	Descrizione
name	string		Nome del ricevitore del ruolo arm. I nomi devono essere univoci in tutti i ricevitori all'interno di un gruppo di azioni.
roleId	string		ID ruolo arm.
useCommonAlertSchema	boolean	False	Indica se utilizzare lo schema di avviso comune.

AutomationRunbookReceiver

Object

Ricevitore di notifica del runbook di Automazione di Azure.

Nome	Tipo	Valore predefinito	Descrizione
automationAccountId	string		ID dell'account di Automazione di Azure che contiene questo runbook ed eseguire l'autenticazione nella risorsa di Azure.
isGlobalRunbook	boolean		Indica se questa istanza è un runbook globale.
name	string		Indica il nome del webhook.
runbookName	string		Nome del runbook.
serviceUri	string		URI in cui devono essere inviati i webhook.
useCommonAlertSchema	boolean	False	Indica se utilizzare lo schema di avviso comune.
webhookResourceId	string		ID risorsa per il webhook collegato a questo runbook.

AzureAppPushReceiver

Object

Ricevitore di notifiche push dell'app per dispositivi mobili di Azure.

Nome	Tipo	Descrizione
emailAddress	string	Indirizzo di posta elettronica registrato per l'app per dispositivi mobili di Azure.
name	string	Nome del ricevitore push dell'app per dispositivi mobili di Azure. I nomi devono essere univoci in tutti i ricevitori all'interno di un gruppo di azioni.

AzureFunctionReceiver

Object

Ricevitore di funzioni di Azure.

Nome	Tipo	Valore predefinito	Descrizione
functionAppResourceId	string		ID risorsa di Azure dell'app per le funzioni.
functionName	string		Nome della funzione nell'app per le funzioni.
httpTriggerUrl	string		URL del trigger HTTP a cui è stata inviata la richiesta HTTP.
name	string		Nome del ricevitore della funzione di Azure. I nomi devono essere univoci in tutti i ricevitori all'interno di un gruppo di azioni.
useCommonAlertSchema	boolean	False	Indica se utilizzare lo schema di avviso comune.

EmailReceiver

Object

Ricevitore di posta elettronica.

Nome	Tipo	Valore predefinito	Descrizione
emailAddress	string		Indirizzo di posta elettronica del ricevitore.
name	string		Nome del destinatario del messaggio di posta elettronica. I nomi devono essere univoci in tutti i ricevitori all'interno di un gruppo di azioni.
status	ReceiverStatus		Stato del destinatario del messaggio di posta elettronica.
useCommonAlertSchema	boolean	False	Indica se utilizzare lo schema di avviso comune.

ErrorResponse

Object

Descrive il formato della risposta di errore.

Nome	Tipo	Descrizione
code	string	Codice di errore
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

EventHubReceiver

Object

Ricevitore dell'hub eventi.

Nome	Tipo	Valore predefinito	Descrizione
eventHubName	string		Nome della coda di Hub eventi specifica
eventHubNameSpace	string		Spazio dei nomi dell'hub eventi
name	string		Nome del ricevitore dell'hub eventi. I nomi devono essere univoci in tutti i ricevitori all'interno di un gruppo di azioni.
subscriptionId	string		ID per la sottoscrizione contenente questo hub eventi
tenantId	string		ID tenant per la sottoscrizione contenente questo hub eventi
useCommonAlertSchema	boolean	False	Indica se utilizzare lo schema di avviso comune.

ItsmReceiver

Object

Ricevitore Itsm.

Nome	Tipo	Descrizione
connectionId	string	Identificazione univoca della connessione ITSM tra più definiti nell'area di lavoro precedente.
name	string	Nome del ricevitore Itsm. I nomi devono essere univoci in tutti i ricevitori all'interno di un gruppo di azioni.
region	string	Area in cui risiede l'area di lavoro. Valori supportati:'centralindia','japaneast','southeastasia','australiasoutheast','uksouth','westcentralus','canadacentral','eastus','westeurope'
ticketConfiguration	string	BLOB JSON per le configurazioni dell'azione gestione dei servizi IT. Anche l'opzione CreateMultipleWorkItems farà parte di questo BLOB.
workspaceId	string	Identificatore dell'istanza di OMS LA.

LogicAppReceiver

Object

Ricevitore di app per la logica.

Nome	Tipo	Valore predefinito	Descrizione
callbackUrl	string		URL di callback a cui è stata inviata la richiesta HTTP.
name	string		Nome del ricevitore dell'app per la logica. I nomi devono essere univoci in tutti i ricevitori all'interno di un gruppo di azioni.
resourceId	string		ID risorsa di Azure del ricevitore dell'app per la logica.
useCommonAlertSchema	boolean	False	Indica se utilizzare lo schema di avviso comune.

ReceiverStatus

Enumerazione

Indica lo stato del ricevitore. I ricevitori che non sono abilitati non riceveranno alcuna comunicazione.

Valore	Descrizione
Disabled
Enabled
NotSpecified

SmsReceiver

Object

Ricevitore SMS.

Nome	Tipo	Descrizione
countryCode	string	Codice paese del ricevitore SMS.
name	string	Nome del ricevitore SMS. I nomi devono essere univoci in tutti i ricevitori all'interno di un gruppo di azioni.
phoneNumber	string	Numero di telefono del ricevitore SMS.
status	ReceiverStatus	Stato del ricevitore.

VoiceReceiver

Object

Ricevitore vocale.

Nome	Tipo	Descrizione
countryCode	string	Codice paese del ricevitore vocale.
name	string	Nome del ricevitore vocale. I nomi devono essere univoci in tutti i ricevitori all'interno di un gruppo di azioni.
phoneNumber	string	Numero di telefono del ricevitore vocale.

WebhookReceiver

Object

Ricevitore webhook.

Nome	Tipo	Valore predefinito	Descrizione
identifierUri	string		Indica l'URI dell'identificatore per l'autenticazione aad.
name	string		Nome del ricevitore webhook. I nomi devono essere univoci in tutti i ricevitori all'interno di un gruppo di azioni.
objectId	string		Indica l'ID oggetto app webhook per l'autenticazione aad.
serviceUri	string		URI in cui devono essere inviati i webhook.
tenantId	string		Indica l'ID tenant per l'autenticazione aad.
useAadAuth	boolean	False	Indica se usare o meno l'autenticazione AAD.
useCommonAlertSchema	boolean	False	Indica se utilizzare lo schema di avviso comune.

Condividi tramite

Action Groups - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Create or update an action group

Esempio di richiesta

Risposta di esempio

Definizioni

ActionGroupResource

ArmRoleReceiver

AutomationRunbookReceiver

AzureAppPushReceiver

AzureFunctionReceiver

EmailReceiver

ErrorResponse

EventHubReceiver

ItsmReceiver

LogicAppReceiver

ReceiverStatus

SmsReceiver

VoiceReceiver

WebhookReceiver

Risorse aggiuntive