Activity Log Alerts - Get

Referens

Tjänst:: Monitor

API-version:: 2020-10-01

Hämta en aktivitetsloggaviseringsregel.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/activityLogAlerts/{activityLogAlertName}?api-version=2020-10-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
activityLogAlertName	path	True	string	Namnet på aktivitetsloggaviseringsregeln.
resourceGroupName	path	True	string	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string	ID för målprenumerationen.
api-version	query	True	string	Den API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	ActivityLogAlertResource	Begäran lyckades.
Other Status Codes	ErrorResponse	Ett fel uppstod och det gick inte att hämta aktivitetsloggaviseringsregeln.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Get an Activity Log Alert rule

Exempelbegäran

GET https://management.azure.com/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/Microsoft.Insights/activityLogAlerts/SampleActivityLogAlertRule?api-version=2020-10-01


/**
 * Samples for ActivityLogAlerts GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/monitor/resource-manager/Microsoft.Insights/stable/2020-10-01/examples/ActivityLogAlertRule_Get.
     * json
     */
    /**
     * Sample code: Get an Activity Log Alert rule.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAnActivityLogAlertRule(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.diagnosticSettings().manager().serviceClient().getActivityLogAlerts().getByResourceGroupWithResponse(
            "MyResourceGroup", "SampleActivityLogAlertRule", com.azure.core.util.Context.NONE);
    }
}

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

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/blob/969fd0c2634fbcc1975d7abe3749330a5145a97c/specification/monitor/resource-manager/Microsoft.Insights/stable/2020-10-01/examples/ActivityLogAlertRule_Get.json
func ExampleActivityLogAlertsClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmonitor.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewActivityLogAlertsClient().Get(ctx, "MyResourceGroup", "SampleActivityLogAlertRule", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ActivityLogAlertResource = armmonitor.ActivityLogAlertResource{
	// 	Name: to.Ptr("SampleActivityLogAlertRule"),
	// 	Type: to.Ptr("Microsoft.Insights/ActivityLogAlerts"),
	// 	ID: to.Ptr("/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/activityLogAlerts/SampleActivityLogAlertRule"),
	// 	Location: to.Ptr("Global"),
	// 	Tags: map[string]*string{
	// 	},
	// 	Properties: &armmonitor.AlertRuleProperties{
	// 		Description: to.Ptr("Description of sample Activity Log Alert rule."),
	// 		Actions: &armmonitor.ActionList{
	// 			ActionGroups: []*armmonitor.ActionGroupAutoGenerated{
	// 				{
	// 					ActionGroupID: to.Ptr("/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/actionGroups/SampleActionGroup"),
	// 					WebhookProperties: map[string]*string{
	// 						"sampleWebhookProperty": to.Ptr("SamplePropertyValue"),
	// 					},
	// 			}},
	// 		},
	// 		Condition: &armmonitor.AlertRuleAllOfCondition{
	// 			AllOf: []*armmonitor.AlertRuleAnyOfOrLeafCondition{
	// 				{
	// 					Equals: to.Ptr("Administrative"),
	// 					Field: to.Ptr("category"),
	// 				},
	// 				{
	// 					Equals: to.Ptr("Error"),
	// 					Field: to.Ptr("level"),
	// 			}},
	// 		},
	// 		Enabled: to.Ptr(true),
	// 		Scopes: []*string{
	// 			to.Ptr("subscriptions/187f412d-1758-44d9-b052-169e2564721d")},
	// 		},
	// 	}
}

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

const { MonitorClient } = require("@azure/arm-monitor");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Get an Activity Log Alert rule.
 *
 * @summary Get an Activity Log Alert rule.
 * x-ms-original-file: specification/monitor/resource-manager/Microsoft.Insights/stable/2020-10-01/examples/ActivityLogAlertRule_Get.json
 */
async function getAnActivityLogAlertRule() {
  const subscriptionId =
    process.env["MONITOR_SUBSCRIPTION_ID"] || "187f412d-1758-44d9-b052-169e2564721d";
  const resourceGroupName = process.env["MONITOR_RESOURCE_GROUP"] || "MyResourceGroup";
  const activityLogAlertName = "SampleActivityLogAlertRule";
  const credential = new DefaultAzureCredential();
  const client = new MonitorClient(credential, subscriptionId);
  const result = await client.activityLogAlerts.get(resourceGroupName, activityLogAlertName);
  console.log(result);
}

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Monitor.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Monitor;

// Generated from example definition: specification/monitor/resource-manager/Microsoft.Insights/stable/2020-10-01/examples/ActivityLogAlertRule_Get.json
// this example is just showing the usage of "ActivityLogAlerts_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ActivityLogAlertResource created on azure
// for more information of creating ActivityLogAlertResource, please refer to the document of ActivityLogAlertResource
string subscriptionId = "187f412d-1758-44d9-b052-169e2564721d";
string resourceGroupName = "MyResourceGroup";
string activityLogAlertName = "SampleActivityLogAlertRule";
ResourceIdentifier activityLogAlertResourceId = ActivityLogAlertResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, activityLogAlertName);
ActivityLogAlertResource activityLogAlert = client.GetActivityLogAlertResource(activityLogAlertResourceId);

// invoke the operation
ActivityLogAlertResource result = await activityLogAlert.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ActivityLogAlertData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Exempelsvar

Statuskod:: 200

{
  "id": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/activityLogAlerts/SampleActivityLogAlertRule",
  "type": "Microsoft.Insights/ActivityLogAlerts",
  "name": "SampleActivityLogAlertRule",
  "location": "Global",
  "tags": {},
  "properties": {
    "scopes": [
      "subscriptions/187f412d-1758-44d9-b052-169e2564721d"
    ],
    "condition": {
      "allOf": [
        {
          "field": "category",
          "equals": "Administrative"
        },
        {
          "field": "level",
          "equals": "Error"
        }
      ]
    },
    "actions": {
      "actionGroups": [
        {
          "actionGroupId": "/subscriptions/187f412d-1758-44d9-b052-169e2564721d/resourceGroups/MyResourceGroup/providers/microsoft.insights/actionGroups/SampleActionGroup",
          "webhookProperties": {
            "sampleWebhookProperty": "SamplePropertyValue"
          }
        }
      ]
    },
    "enabled": true,
    "description": "Description of sample Activity Log Alert rule."
  }
}

Definitioner

Name	Description
ActionGroup	En pekare till en Azure-åtgärdsgrupp.
ActionList	En lista över åtgärder för aktivitetsloggaviseringsregler.
ActivityLogAlertResource	En aktivitetsloggaviseringsregelresurs.
AlertRuleAllOfCondition	Ett villkor för aktivitetsloggaviseringsregeln som uppfylls när alla dess medlemsvillkor uppfylls.
AlertRuleAnyOfOrLeafCondition	Ett villkor för aktivitetsloggaviseringsregeln som uppfylls när alla dess medlemsvillkor uppfylls. Varje villkor kan vara av någon av följande typer: Viktigt: Varje typ har sin unika delmängd av egenskaper. Egenskaper från olika typer KAN INTE finnas i ett villkor. Lövvillkor – måste innehålla "fält" och antingen "lika med" eller "containsAny". Observera att "anyOf" inte* ska anges i ett lövvillkor.* AnyOf Condition – får bara innehålla "anyOf" (som är en matris med lövvillkor). Observera att "field", "equals" och "containsAny" inte* ska anges i ett AnyOf-villkor.*
AlertRuleLeafCondition	Ett villkor för aktivitetsloggaviseringsregeln som uppfylls genom att jämföra fältet och värdet för en aktivitetslogghändelse. Det här villkoret måste innehålla "fält" och antingen "lika med" eller "containsAny".
ErrorResponse	Felsvaret.

ActionGroup

En pekare till en Azure-åtgärdsgrupp.

Name	Typ	Description
actionGroupId	string	Resurs-ID för åtgärdsgruppen. Detta får inte vara null eller tomt.
webhookProperties	object	ordlistan med anpassade egenskaper som ska inkluderas i poståtgärden. Dessa data läggs till webhook-nyttolasten.

ActionList

En lista över åtgärder för aktivitetsloggaviseringsregler.

Name	Typ	Description
actionGroups	ActionGroup[]	Listan över åtgärdsgrupper.

ActivityLogAlertResource

En aktivitetsloggaviseringsregelresurs.

Name	Typ	Standardvärde	Description
id	string		Resurs-ID:t.
location	string	global	Platsen för resursen. Azure Activity Log Alert-regler stöds i regionerna Global, Europa, västra och Europa, norra.
name	string		Namnet på resursen.
properties.actions	ActionList		De åtgärder som aktiveras när villkoret uppfylls.
properties.condition	AlertRuleAllOfCondition		Villkoret som gör att aviseringen aktiveras.
properties.description	string		En beskrivning av den här aktivitetsloggaviseringsregeln.
properties.enabled	boolean	True	Anger om den här aktivitetsloggaviseringsregeln är aktiverad. Om en aktivitetsloggaviseringsregel inte är aktiverad aktiveras ingen av dess åtgärder.
properties.scopes	string[]		En lista över resurs-ID:t som ska användas som prefix. Aviseringen gäller endast för aktivitetslogghändelser med resurs-ID:t som faller under något av dessa prefix. Den här listan måste innehålla minst ett objekt.
tags	object		Resursens taggar.
type	string		Resurstypen.

AlertRuleAllOfCondition

Ett villkor för aktivitetsloggaviseringsregeln som uppfylls när alla dess medlemsvillkor uppfylls.

Name	Typ	Description
allOf	AlertRuleAnyOfOrLeafCondition[]	Listan över villkor för aktivitetsloggaviseringsregler.

AlertRuleAnyOfOrLeafCondition

Ett villkor för aktivitetsloggaviseringsregeln som uppfylls när alla dess medlemsvillkor uppfylls. Varje villkor kan vara av någon av följande typer: Viktigt: Varje typ har sin unika delmängd av egenskaper. Egenskaper från olika typer KAN INTE finnas i ett villkor.

Lövvillkor – måste innehålla "fält" och antingen "lika med" eller "containsAny". Observera att "anyOf" inte ska anges i ett lövvillkor.
AnyOf Condition – får bara innehålla "anyOf" (som är en matris med lövvillkor). Observera att "field", "equals" och "containsAny" inte ska anges i ett AnyOf-villkor.

Name	Typ	Description
anyOf	AlertRuleLeafCondition[]	Ett villkor för aktivitetsloggaviseringsregeln "anyOf". Ett villkor för aktivitetsloggaviseringsregeln som uppfylls när minst ett av dess medlemslövvillkor uppfylls.
containsAny	string[]	Värdet för händelsens fält jämförs med värdena i den här matrisen (skiftlägesokänsliga) för att avgöra om villkoret uppfylls.
equals	string	Värdet för händelsens fält jämförs med det här värdet (skiftlägesokänsligt) för att avgöra om villkoret uppfylls.
field	string	Namnet på aktivitetslogghändelsens fält som villkoret ska undersöka. Möjliga värden för det här fältet är (skiftlägesokänsliga): 'resourceId', 'category', 'caller', 'level', 'operationName', 'resourceGroup', 'resourceProvider', 'status', 'subStatus', 'resourceType', eller något som börjar med 'properties'.

AlertRuleLeafCondition

Ett villkor för aktivitetsloggaviseringsregeln som uppfylls genom att jämföra fältet och värdet för en aktivitetslogghändelse. Det här villkoret måste innehålla "fält" och antingen "lika med" eller "containsAny".

Name	Typ	Description
containsAny	string[]	Värdet för händelsens fält jämförs med värdena i den här matrisen (skiftlägesokänsliga) för att avgöra om villkoret uppfylls.
equals	string	Värdet för händelsens fält jämförs med det här värdet (skiftlägesokänsligt) för att avgöra om villkoret uppfylls.
field	string	Namnet på aktivitetslogghändelsens fält som villkoret ska undersöka. Möjliga värden för det här fältet är (skiftlägesokänsliga): 'resourceId', 'category', 'caller', 'level', 'operationName', 'resourceGroup', 'resourceProvider', 'status', 'subStatus', 'resourceType', eller något som börjar med 'properties'.

ErrorResponse

Felsvaret.

Name	Typ	Description
code	string	Felkoden.
message	string	Felmeddelandet som anger varför åtgärden misslyckades.

Dela via

Activity Log Alerts - Get

URI-parametrar

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Get an Activity Log Alert rule

Exempelbegäran

Exempelsvar

Definitioner

ActionGroup

ActionList

ActivityLogAlertResource

AlertRuleAllOfCondition

AlertRuleAnyOfOrLeafCondition

AlertRuleLeafCondition

ErrorResponse

Ytterligare resurser