Action Groups - Update

Referência

Serviço:: Monitor

Versão da API:: 2021-09-01

Atualizações etiquetas de um grupo de ações existente. Para atualizar outros campos, utilize o método CreateOrUpdate.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
actionGroupName	path	True	string	O nome do grupo de ações.
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.
subscriptionId	path	True	string	O ID da subscrição de destino.
api-version	query	True	string	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Tipo	Description
properties.enabled	boolean	Indica se este grupo de ações está ativado. Se um grupo de ações não estiver ativado, nenhuma das ações será ativada.
tags	object	Etiquetas de recursos

Respostas

Name	Tipo	Description
200 OK	ActionGroupResource	Um grupo de ações existente foi atualizado com êxito.
Other Status Codes	ErrorResponse	Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

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

Resposta da amostra

Código de estado:: 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": []
  }
}

Definições

Name	Description
ActionGroupPatchBody	Um objeto de grupo de ações para o corpo das operações de patch.
ActionGroupResource	Um recurso do grupo de ações.
ArmRoleReceiver	Um recetor de função de braço.
AutomationRunbookReceiver	O recetor de notificação Automatização do Azure Runbook.
AzureAppPushReceiver	O recetor de notificação push da Aplicação móvel do Azure.
AzureFunctionReceiver	Um recetor de funções do Azure.
EmailReceiver	Um recetor de e-mail.
ErrorResponse	Descreve o formato de Resposta a erros.
EventHubReceiver	Um recetor do Hub de Eventos.
ItsmReceiver	Um recetor Itsm.
LogicAppReceiver	Um recetor de aplicação lógica.
ReceiverStatus	Indica o estado do recetor. Os recetores que não estejam Ativados não receberão comunicações.
SmsReceiver	Um recetor SMS.
VoiceReceiver	Um recetor de voz.
WebhookReceiver	Um recetor de webhook.

ActionGroupPatchBody

Um objeto de grupo de ações para o corpo das operações de patch.

Name	Tipo	Default value	Description
properties.enabled	boolean	True	Indica se este grupo de ações está ativado. Se um grupo de ações não estiver ativado, nenhuma das ações será ativada.
tags	object		Etiquetas de recursos

ActionGroupResource

Um recurso do grupo de ações.

Name	Tipo	Default value	Description
id	string		ID do recurso do Azure
location	string		Localização do recurso
name	string		Nome do recurso do Azure
properties.armRoleReceivers	ArmRoleReceiver[]		A lista de recetores de função ARM que fazem parte deste grupo de ações. As funções são funções RBAC do Azure e só são suportadas funções incorporadas.
properties.automationRunbookReceivers	AutomationRunbookReceiver[]		A lista de recetores automationRunbook que fazem parte deste grupo de ações.
properties.azureAppPushReceivers	AzureAppPushReceiver[]		A lista de recetores do AzureAppPush que fazem parte deste grupo de ações.
properties.azureFunctionReceivers	AzureFunctionReceiver[]		A lista de recetores de funções do Azure que fazem parte deste grupo de ações.
properties.emailReceivers	EmailReceiver[]		A lista de recetores de e-mail que fazem parte deste grupo de ações.
properties.enabled	boolean	True	Indica se este grupo de ações está ativado. Se um grupo de ações não estiver ativado, nenhum dos respetivos recetores receberá comunicações.
properties.eventHubReceivers	EventHubReceiver[]		A lista de recetores do hub de eventos que fazem parte deste grupo de ações.
properties.groupShortName	string		O nome abreviado do grupo de ações. Isto será utilizado em mensagens SMS.
properties.itsmReceivers	ItsmReceiver[]		A lista de recetores ITSM que fazem parte deste grupo de ações.
properties.logicAppReceivers	LogicAppReceiver[]		A lista de recetores de aplicações lógicas que fazem parte deste grupo de ações.
properties.smsReceivers	SmsReceiver[]		A lista de recetores de SMS que fazem parte deste grupo de ações.
properties.voiceReceivers	VoiceReceiver[]		A lista de recetores de voz que fazem parte deste grupo de ações.
properties.webhookReceivers	WebhookReceiver[]		A lista de recetores de webhook que fazem parte deste grupo de ações.
tags	object		Etiquetas de recursos
type	string		Tipo de recurso do Azure

ArmRoleReceiver

Um recetor de função de braço.

Name	Tipo	Default value	Description
name	string		O nome do recetor da função de braço. Os nomes têm de ser exclusivos em todos os recetores dentro de um grupo de ações.
roleId	string		O ID da função do braço.
useCommonAlertSchema	boolean	False	Indica se deve utilizar um esquema de alerta comum.

AutomationRunbookReceiver

O recetor de notificação Automatização do Azure Runbook.

Name	Tipo	Default value	Description
automationAccountId	string		O ID da conta de automatização do Azure que contém este runbook e autentica-se no recurso do Azure.
isGlobalRunbook	boolean		Indica se esta instância é um runbook global.
name	string		Indica o nome do webhook.
runbookName	string		O nome deste runbook.
serviceUri	string		O URI para onde os webhooks devem ser enviados.
useCommonAlertSchema	boolean	False	Indica se deve utilizar um esquema de alerta comum.
webhookResourceId	string		O ID de recurso do webhook ligado a este runbook.

AzureAppPushReceiver

O recetor de notificação push da Aplicação móvel do Azure.

Name	Tipo	Description
emailAddress	string	O endereço de e-mail registado para a aplicação móvel do Azure.
name	string	O nome do recetor push da aplicação móvel do Azure. Os nomes têm de ser exclusivos em todos os recetores dentro de um grupo de ações.

AzureFunctionReceiver

Um recetor de funções do Azure.

Name	Tipo	Default value	Description
functionAppResourceId	string		O ID de recurso do azure da aplicação de funções.
functionName	string		O nome da função na aplicação de funções.
httpTriggerUrl	string		O url do acionador http para o qual o pedido http foi enviado.
name	string		O nome do recetor de funções do azure. Os nomes têm de ser exclusivos em todos os recetores dentro de um grupo de ações.
useCommonAlertSchema	boolean	False	Indica se deve utilizar um esquema de alerta comum.

EmailReceiver

Um recetor de e-mail.

Name	Tipo	Default value	Description
emailAddress	string		O endereço de e-mail deste recetor.
name	string		O nome do recetor de e-mail. Os nomes têm de ser exclusivos em todos os recetores dentro de um grupo de ações.
status	ReceiverStatus		O estado do recetor do e-mail.
useCommonAlertSchema	boolean	False	Indica se deve utilizar um esquema de alerta comum.

ErrorResponse

Descreve o formato de Resposta a erros.

Name	Tipo	Description
code	string	Código de erro
message	string	Mensagem de erro a indicar por que motivo a operação falhou.

EventHubReceiver

Um recetor do Hub de Eventos.

Name	Tipo	Default value	Description
eventHubName	string		O nome da fila específica do Hub de Eventos
eventHubNameSpace	string		O espaço de nomes do Hub de Eventos
name	string		O nome do recetor do Hub de Eventos. Os nomes têm de ser exclusivos em todos os recetores dentro de um grupo de ações.
subscriptionId	string		O ID da subscrição que contém este hub de eventos
tenantId	string		O ID do inquilino da subscrição que contém este hub de eventos
useCommonAlertSchema	boolean	False	Indica se deve utilizar um esquema de alerta comum.

ItsmReceiver

Um recetor Itsm.

Name	Tipo	Description
connectionId	string	Identificação exclusiva da ligação ITSM entre múltiplos definidos na área de trabalho acima.
name	string	O nome do recetor Itsm. Os nomes têm de ser exclusivos em todos os recetores dentro de um grupo de ações.
region	string	Região onde reside a área de trabalho. Valores suportados:'centralindia','japaneast','southeastasia','australiasoutheast','uksouth','westcentralus','canadacentral','eastus','westeurope'
ticketConfiguration	string	Blob JSON para as configurações da ação ITSM. A opção CreateMultipleWorkItems também fará parte deste blob.
workspaceId	string	Identificador de instância do OMS LA.

LogicAppReceiver

Um recetor de aplicação lógica.

Name	Tipo	Default value	Description
callbackUrl	string		O url de chamada de retorno para o qual o pedido http foi enviado.
name	string		O nome do recetor da aplicação lógica. Os nomes têm de ser exclusivos em todos os recetores dentro de um grupo de ações.
resourceId	string		O ID de recurso do azure do recetor da aplicação lógica.
useCommonAlertSchema	boolean	False	Indica se deve utilizar um esquema de alerta comum.

ReceiverStatus

Indica o estado do recetor. Os recetores que não estejam Ativados não receberão comunicações.

Name	Tipo	Description
Disabled	string
Enabled	string
NotSpecified	string

SmsReceiver

Um recetor SMS.

Name	Tipo	Description
countryCode	string	O código de país do recetor de SMS.
name	string	O nome do recetor de SMS. Os nomes têm de ser exclusivos em todos os recetores dentro de um grupo de ações.
phoneNumber	string	O número de telefone do recetor de SMS.
status	ReceiverStatus	O estado do recetor.

VoiceReceiver

Um recetor de voz.

Name	Tipo	Description
countryCode	string	O código de país do recetor de voz.
name	string	O nome do recetor de voz. Os nomes têm de ser exclusivos em todos os recetores dentro de um grupo de ações.
phoneNumber	string	O número de telefone do recetor de voz.

WebhookReceiver

Um recetor de webhook.

Name	Tipo	Default value	Description
identifierUri	string		Indica o uri do identificador para aad auth.
name	string		O nome do recetor do webhook. Os nomes têm de ser exclusivos em todos os recetores dentro de um grupo de ações.
objectId	string		Indica o ID do objeto da aplicação webhook para autenticação de aad.
serviceUri	string		O URI para onde os webhooks devem ser enviados.
tenantId	string		Indica o ID do inquilino para aad auth.
useAadAuth	boolean	False	Indica se utiliza ou não a autenticação do AAD.
useCommonAlertSchema	boolean	False	Indica se deve utilizar um esquema de alerta comum.

Partilhar via