Action Groups - Get

Referenz

Dienst:: Monitor

API-Version:: 2021-09-01

Ruft eine Aktionsgruppe ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
actionGroupName	path	True	string	Der Name der Aktionsgruppe.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string	Hierbei handelt es sich um die ID des Zielabonnements.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	ActionGroupResource	Die Anforderung war erfolgreich.
Other Status Codes	ErrorResponse	Ein Fehler ist aufgetreten, und die Aktionsgruppe konnte nicht abgerufen werden. 404: Die Aktionsgruppe ist nicht vorhanden.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Get an action group

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

package armmonitor_test

import (
	"context"
	"log"

	"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/getActionGroup.json
func ExampleActionGroupsClient_Get() {
	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.Get(ctx,
		"<resource-group-name>",
		"<action-group-name>",
		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

Beispiel für eine Antwort

Statuscode:: 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": true
      },
      {
        "name": "Jane Smith's email",
        "emailAddress": "janesmith@email.com",
        "status": "Disabled",
        "useCommonAlertSchema": true
      }
    ],
    "smsReceivers": [
      {
        "name": "John Doe's mobile",
        "countryCode": "1",
        "phoneNumber": "1234567890",
        "status": "Disabled"
      },
      {
        "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": []
  }
}

Definitionen

Name	Beschreibung
ActionGroupResource	Eine Aktionsgruppenressource.
ArmRoleReceiver	Ein Armrollenempfänger.
AutomationRunbookReceiver	Der Azure Automation Runbook-Benachrichtigungsempfänger.
AzureAppPushReceiver	Der Azure Mobile App-Pushbenachrichtigungsempfänger.
AzureFunctionReceiver	Ein Azure-Funktionsempfänger.
EmailReceiver	Ein E-Mail-Empfänger.
ErrorResponse	Beschreibt das Format der Fehlerantwort.
EventHubReceiver	Ein Event Hub-Empfänger.
ItsmReceiver	Ein Itsm-Empfänger.
LogicAppReceiver	Ein Logik-App-Empfänger.
ReceiverStatus	Gibt die status des Empfängers an. Empfänger, die nicht aktiviert sind, erhalten keine Kommunikation.
SmsReceiver	Ein SMS-Empfänger.
VoiceReceiver	Ein Sprachempfänger.
WebhookReceiver	Ein Webhookempfänger.

ActionGroupResource

Eine Aktionsgruppenressource.

Name	Typ	Standardwert	Beschreibung
id	string		Azure-Ressourcen-ID
location	string		Ressourcenspeicherort
name	string		Name der Azure-Ressource
properties.armRoleReceivers	ArmRoleReceiver[]		Die Liste der ARM-Rollenempfänger, die Teil dieser Aktionsgruppe sind. Rollen sind Azure RBAC-Rollen, und nur integrierte Rollen werden unterstützt.
properties.automationRunbookReceivers	AutomationRunbookReceiver[]		Die Liste der AutomationRunbook-Empfänger, die Teil dieser Aktionsgruppe sind.
properties.azureAppPushReceivers	AzureAppPushReceiver[]		Die Liste der AzureAppPush-Empfänger, die Teil dieser Aktionsgruppe sind.
properties.azureFunctionReceivers	AzureFunctionReceiver[]		Die Liste der Azure-Funktionsempfänger, die Teil dieser Aktionsgruppe sind.
properties.emailReceivers	EmailReceiver[]		Die Liste der E-Mail-Empfänger, die Teil dieser Aktionsgruppe sind.
properties.enabled	boolean	True	Gibt an, ob diese Aktionsgruppe aktiviert ist. Wenn eine Aktionsgruppe nicht aktiviert ist, empfängt keiner ihrer Empfänger Kommunikation.
properties.eventHubReceivers	EventHubReceiver[]		Die Liste der Event Hub-Empfänger, die Teil dieser Aktionsgruppe sind.
properties.groupShortName	string		Der kurze Name der Aktionsgruppe. Dies wird in SMS-Nachrichten verwendet.
properties.itsmReceivers	ItsmReceiver[]		Die Liste der ITSM-Empfänger, die Teil dieser Aktionsgruppe sind.
properties.logicAppReceivers	LogicAppReceiver[]		Die Liste der Logik-App-Empfänger, die Teil dieser Aktionsgruppe sind.
properties.smsReceivers	SmsReceiver[]		Die Liste der SMS-Empfänger, die Teil dieser Aktionsgruppe sind.
properties.voiceReceivers	VoiceReceiver[]		Die Liste der Sprachempfänger, die Teil dieser Aktionsgruppe sind.
properties.webhookReceivers	WebhookReceiver[]		Die Liste der Webhookempfänger, die Teil dieser Aktionsgruppe sind.
tags	object		Ressourcentags
type	string		Azure-Ressourcentyp

ArmRoleReceiver

Ein Armrollenempfänger.

Name	Typ	Standardwert	Beschreibung
name	string		Der Name des Armrollenempfängers. Namen müssen für alle Empfänger innerhalb einer Aktionsgruppe eindeutig sein.
roleId	string		Die Armrollen-ID.
useCommonAlertSchema	boolean	False	Gibt an, ob das allgemeine Warnungsschema verwendet werden soll.

AutomationRunbookReceiver

Der Azure Automation Runbook-Benachrichtigungsempfänger.

Name	Typ	Standardwert	Beschreibung
automationAccountId	string		Die Azure Automation-Konto-ID, die dieses Runbook enthält und sich bei der Azure-Ressource authentifiziert.
isGlobalRunbook	boolean		Gibt an, ob es sich bei diesem instance um ein globales Runbook handelt.
name	string		Gibt den Namen des Webhooks an.
runbookName	string		Der Name für dieses Runbook.
serviceUri	string		Der URI, an den Webhooks gesendet werden sollen.
useCommonAlertSchema	boolean	False	Gibt an, ob das allgemeine Warnungsschema verwendet werden soll.
webhookResourceId	string		Die Ressourcen-ID für den Webhook, der mit diesem Runbook verknüpft ist.

AzureAppPushReceiver

Der Azure Mobile App-Pushbenachrichtigungsempfänger.

Name	Typ	Beschreibung
emailAddress	string	Die für die mobile Azure-App registrierte E-Mail-Adresse.
name	string	Der Name des Pushempfängers für die mobile Azure-App. Namen müssen für alle Empfänger innerhalb einer Aktionsgruppe eindeutig sein.

AzureFunctionReceiver

Ein Azure-Funktionsempfänger.

Name	Typ	Standardwert	Beschreibung
functionAppResourceId	string		Die Azure-Ressourcen-ID der Funktions-App.
functionName	string		Der Funktionsname in der Funktions-App.
httpTriggerUrl	string		Die HTTP-Trigger-URL, an die die HTTP-Anforderung gesendet wird.
name	string		Der Name des Azure-Funktionsempfängers. Namen müssen für alle Empfänger innerhalb einer Aktionsgruppe eindeutig sein.
useCommonAlertSchema	boolean	False	Gibt an, ob das allgemeine Warnungsschema verwendet werden soll.

EmailReceiver

Ein E-Mail-Empfänger.

Name	Typ	Standardwert	Beschreibung
emailAddress	string		Die E-Mail-Adresse dieses Empfängers.
name	string		Der Name des E-Mail-Empfängers. Namen müssen für alle Empfänger innerhalb einer Aktionsgruppe eindeutig sein.
status	ReceiverStatus		Der Empfänger status der E-Mail.
useCommonAlertSchema	boolean	False	Gibt an, ob das allgemeine Warnungsschema verwendet werden soll.

ErrorResponse

Beschreibt das Format der Fehlerantwort.

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

EventHubReceiver

Ein Event Hub-Empfänger.

Name	Typ	Standardwert	Beschreibung
eventHubName	string		Der Name der spezifischen Event Hub-Warteschlange
eventHubNameSpace	string		Der Event Hub-Namespace
name	string		Der Name des Event Hub-Empfängers. Namen müssen für alle Empfänger innerhalb einer Aktionsgruppe eindeutig sein.
subscriptionId	string		Die ID für das Abonnement, das diesen Event Hub enthält
tenantId	string		Die Mandanten-ID für das Abonnement, das diesen Event Hub enthält
useCommonAlertSchema	boolean	False	Gibt an, ob das allgemeine Warnungsschema verwendet werden soll.

ItsmReceiver

Ein Itsm-Empfänger.

Name	Typ	Beschreibung
connectionId	string	Eindeutige Identifizierung der ITSM-Verbindung zwischen mehreren, die im obigen Arbeitsbereich definiert sind.
name	string	Der Name des Itsm-Empfängers. Namen müssen für alle Empfänger innerhalb einer Aktionsgruppe eindeutig sein.
region	string	Region, in der sich der Arbeitsbereich befindet. Unterstützte Werte:'centralindia','japaneast','southeastasia','australiasoutheast','uksouth','westcentralus','canadacentral','eastus','westeurope'
ticketConfiguration	string	JSON-Blob für die Konfigurationen der ITSM-Aktion. Die Option CreateMultipleWorkItems ist ebenfalls Teil dieses Blobs.
workspaceId	string	OMS LA instance Bezeichner.

LogicAppReceiver

Ein Logik-App-Empfänger.

Name	Typ	Standardwert	Beschreibung
callbackUrl	string		Die Rückruf-URL, an die http-Anforderung gesendet wird.
name	string		Der Name des Logik-App-Empfängers. Namen müssen für alle Empfänger innerhalb einer Aktionsgruppe eindeutig sein.
resourceId	string		Die Azure-Ressourcen-ID des Logik-App-Empfängers.
useCommonAlertSchema	boolean	False	Gibt an, ob das allgemeine Warnungsschema verwendet werden soll.

ReceiverStatus

Gibt die status des Empfängers an. Empfänger, die nicht aktiviert sind, erhalten keine Kommunikation.

Name	Typ	Beschreibung
Disabled	string
Enabled	string
NotSpecified	string

SmsReceiver

Ein SMS-Empfänger.

Name	Typ	Beschreibung
countryCode	string	Die Landesvorwahl des SMS-Empfängers.
name	string	Der Name des SMS-Empfängers. Namen müssen für alle Empfänger innerhalb einer Aktionsgruppe eindeutig sein.
phoneNumber	string	Die Telefonnummer des SMS-Empfängers.
status	ReceiverStatus	Die status des Empfängers.

VoiceReceiver

Ein Sprachempfänger.

Name	Typ	Beschreibung
countryCode	string	Die Ländervorwahl des Sprachempfängers.
name	string	Der Name des Sprachempfängers. Namen müssen für alle Empfänger innerhalb einer Aktionsgruppe eindeutig sein.
phoneNumber	string	Die Telefonnummer des Sprachempfängers.

WebhookReceiver

Ein Webhookempfänger.

Name	Typ	Standardwert	Beschreibung
identifierUri	string		Gibt den Bezeichner-URI für die aad-Authentifizierung an.
name	string		Der Name des Webhookempfängers. Namen müssen für alle Empfänger innerhalb einer Aktionsgruppe eindeutig sein.
objectId	string		Gibt die Webhook-App-Objekt-ID für aad-Authentifizierung an.
serviceUri	string		Der URI, an den Webhooks gesendet werden sollen.
tenantId	string		Gibt die Mandanten-ID für die aad-Authentifizierung an.
useAadAuth	boolean	False	Gibt an, ob die AAD-Authentifizierung verwendet wird.
useCommonAlertSchema	boolean	False	Gibt an, ob das allgemeine Warnungsschema verwendet werden soll.

Freigeben über