Autoscale Settings - Create Or Update

Service:

Monitor

API Version:

2022-10-01

建立或更新自動調整設定。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/autoscalesettings/{autoscaleSettingName}?api-version=2022-10-01

URI 參數

名稱	位於	必要	類型	Description
autoscaleSettingName	path	True	string	自動調整設定名稱。
resourceGroupName	path	True	string	資源群組的名稱。 名稱不區分大小寫。
subscriptionId	path	True	string	目標訂用帳戶的標識碼。
api-version	query	True	string	用於此作業的 API 版本。

要求本文

名稱	必要	類型	Description
location	True	string	資源位置
properties.profiles	True	AutoscaleProfile[]	自動調整配置檔的集合，指定不同時段的不同縮放參數。 最多可指定 20 個設定檔。
properties.enabled		boolean	已啟用的旗標。 指定是否要針對資源啟用自動調整。 預設值為 'false'。
properties.name		string	自動調整設定的名稱。
properties.notifications		AutoscaleNotification[]	通知的集合。
properties.predictiveAutoscalePolicy		PredictiveAutoscalePolicy	預測性自動調整原則模式。
properties.targetResourceLocation		string	應新增自動調整設定的資源位置。
properties.targetResourceUri		string	應加入自動調整設定之資源的資源標識碼。
tags		object	取得或設定描述資源的索引鍵值組清單。 這些標記可用來在資源群組間檢視資源，以及對資源分組。 資源最多可提供15個標記。 每個標記的長度必須不超過 128 個字元，且長度不超過 256 個字元的值。

回應

名稱	類型	Description
200 OK	AutoscaleSettingResource	成功建立或更新自動調整設定的要求
201 Created	AutoscaleSettingResource	已建立自動調整設定
Other Status Codes	AutoscaleErrorResponse	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Create or update an autoscale setting

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourcegroups/TestingMetricsScaleSet/providers/Microsoft.Insights/autoscalesettings/MySetting?api-version=2022-10-01

{
  "location": "West US",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  },
  "properties": {
    "profiles": [
      {
        "name": "adios",
        "capacity": {
          "minimum": "1",
          "maximum": "10",
          "default": "1"
        },
        "rules": [
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT1M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 10,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Increase",
              "type": "ChangeCount",
              "value": "1",
              "cooldown": "PT5M"
            }
          },
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT2M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 15,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Decrease",
              "type": "ChangeCount",
              "value": "2",
              "cooldown": "PT6M"
            }
          }
        ],
        "fixedDate": {
          "timeZone": "UTC",
          "start": "2015-03-05T14:00:00Z",
          "end": "2015-03-05T14:30:00Z"
        }
      },
      {
        "name": "saludos",
        "capacity": {
          "minimum": "1",
          "maximum": "10",
          "default": "1"
        },
        "rules": [
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT1M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 10,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Increase",
              "type": "ChangeCount",
              "value": "1",
              "cooldown": "PT5M"
            }
          },
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT2M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 15,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Decrease",
              "type": "ChangeCount",
              "value": "2",
              "cooldown": "PT6M"
            }
          }
        ],
        "recurrence": {
          "frequency": "Week",
          "schedule": {
            "timeZone": "UTC",
            "days": [
              "1"
            ],
            "hours": [
              5
            ],
            "minutes": [
              15
            ]
          }
        }
      }
    ],
    "enabled": true,
    "predictiveAutoscalePolicy": {
      "scaleMode": "Enabled"
    },
    "targetResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
    "notifications": [
      {
        "operation": "Scale",
        "email": {
          "sendToSubscriptionAdministrator": true,
          "sendToSubscriptionCoAdministrators": true,
          "customEmails": [
            "gu@ms.com",
            "ge@ns.net"
          ]
        },
        "webhooks": [
          {
            "serviceUri": "http://myservice.com",
            "properties": {}
          }
        ]
      }
    ]
  }
}

Java

import com.azure.resourcemanager.monitor.fluent.models.AutoscaleProfileInner;
import com.azure.resourcemanager.monitor.fluent.models.AutoscaleSettingResourceInner;
import com.azure.resourcemanager.monitor.fluent.models.ScaleRuleInner;
import com.azure.resourcemanager.monitor.models.AutoscaleNotification;
import com.azure.resourcemanager.monitor.models.ComparisonOperationType;
import com.azure.resourcemanager.monitor.models.EmailNotification;
import com.azure.resourcemanager.monitor.models.MetricStatisticType;
import com.azure.resourcemanager.monitor.models.MetricTrigger;
import com.azure.resourcemanager.monitor.models.PredictiveAutoscalePolicy;
import com.azure.resourcemanager.monitor.models.PredictiveAutoscalePolicyScaleMode;
import com.azure.resourcemanager.monitor.models.Recurrence;
import com.azure.resourcemanager.monitor.models.RecurrenceFrequency;
import com.azure.resourcemanager.monitor.models.RecurrentSchedule;
import com.azure.resourcemanager.monitor.models.ScaleAction;
import com.azure.resourcemanager.monitor.models.ScaleCapacity;
import com.azure.resourcemanager.monitor.models.ScaleDirection;
import com.azure.resourcemanager.monitor.models.ScaleType;
import com.azure.resourcemanager.monitor.models.TimeAggregationType;
import com.azure.resourcemanager.monitor.models.TimeWindow;
import com.azure.resourcemanager.monitor.models.WebhookNotification;
import java.time.Duration;
import java.time.OffsetDateTime;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AutoscaleSettings CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/monitor/resource-manager/Microsoft.Insights/stable/2022-10-01/examples/
     * createOrUpdateAutoscaleSetting.json
     */
    /**
     * Sample code: Create or update an autoscale setting.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateAnAutoscaleSetting(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.diagnosticSettings().manager().serviceClient().getAutoscaleSettings()
            .createOrUpdateWithResponse("TestingMetricsScaleSet", "MySetting", new AutoscaleSettingResourceInner()
                .withLocation("West US").withTags(mapOf("key1", "fakeTokenPlaceholder", "key2", "fakeTokenPlaceholder"))
                .withProfiles(Arrays.asList(new AutoscaleProfileInner().withName("adios")
                    .withCapacity(new ScaleCapacity().withMinimum("1").withMaximum("10").withDefaultProperty("1"))
                    .withRules(Arrays.asList(new ScaleRuleInner().withMetricTrigger(new MetricTrigger()
                        .withMetricName("Percentage CPU")
                        .withMetricResourceUri(
                            "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc")
                        .withTimeGrain(Duration.parse("PT1M")).withStatistic(MetricStatisticType.AVERAGE)
                        .withTimeWindow(Duration.parse("PT5M")).withTimeAggregation(TimeAggregationType.AVERAGE)
                        .withOperator(ComparisonOperationType.GREATER_THAN).withThreshold(10.0)
                        .withDividePerInstance(false))
                        .withScaleAction(new ScaleAction().withDirection(ScaleDirection.INCREASE)
                            .withType(ScaleType.CHANGE_COUNT).withValue("1").withCooldown(Duration.parse("PT5M"))),
                        new ScaleRuleInner().withMetricTrigger(new MetricTrigger().withMetricName("Percentage CPU")
                            .withMetricResourceUri(
                                "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc")
                            .withTimeGrain(Duration.parse("PT2M")).withStatistic(MetricStatisticType.AVERAGE)
                            .withTimeWindow(Duration.parse("PT5M")).withTimeAggregation(TimeAggregationType.AVERAGE)
                            .withOperator(ComparisonOperationType.GREATER_THAN).withThreshold(15.0)
                            .withDividePerInstance(false))
                            .withScaleAction(new ScaleAction().withDirection(ScaleDirection.DECREASE)
                                .withType(ScaleType.CHANGE_COUNT).withValue("2").withCooldown(Duration.parse("PT6M")))))
                    .withFixedDate(
                        new TimeWindow().withTimeZone("UTC").withStart(OffsetDateTime.parse("2015-03-05T14:00:00Z"))
                            .withEnd(OffsetDateTime.parse("2015-03-05T14:30:00Z"))),
                    new AutoscaleProfileInner().withName("saludos")
                        .withCapacity(new ScaleCapacity().withMinimum("1").withMaximum("10").withDefaultProperty("1"))
                        .withRules(Arrays.asList(new ScaleRuleInner().withMetricTrigger(new MetricTrigger()
                            .withMetricName("Percentage CPU")
                            .withMetricResourceUri(
                                "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc")
                            .withTimeGrain(Duration.parse("PT1M")).withStatistic(MetricStatisticType.AVERAGE)
                            .withTimeWindow(Duration.parse("PT5M")).withTimeAggregation(TimeAggregationType.AVERAGE)
                            .withOperator(ComparisonOperationType.GREATER_THAN).withThreshold(10.0)
                            .withDividePerInstance(false))
                            .withScaleAction(new ScaleAction().withDirection(ScaleDirection.INCREASE)
                                .withType(ScaleType.CHANGE_COUNT).withValue("1").withCooldown(Duration.parse("PT5M"))),
                            new ScaleRuleInner().withMetricTrigger(new MetricTrigger().withMetricName("Percentage CPU")
                                .withMetricResourceUri(
                                    "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc")
                                .withTimeGrain(Duration.parse("PT2M")).withStatistic(MetricStatisticType.AVERAGE)
                                .withTimeWindow(Duration.parse("PT5M")).withTimeAggregation(TimeAggregationType.AVERAGE)
                                .withOperator(ComparisonOperationType.GREATER_THAN).withThreshold(15.0)
                                .withDividePerInstance(false))
                                .withScaleAction(new ScaleAction().withDirection(ScaleDirection.DECREASE)
                                    .withType(ScaleType.CHANGE_COUNT).withValue("2")
                                    .withCooldown(Duration.parse("PT6M")))))
                        .withRecurrence(new Recurrence().withFrequency(RecurrenceFrequency.WEEK)
                            .withSchedule(new RecurrentSchedule().withTimeZone("UTC").withDays(Arrays.asList("1"))
                                .withHours(Arrays.asList(5)).withMinutes(Arrays.asList(15))))))
                .withNotifications(Arrays.asList(new AutoscaleNotification()
                    .withEmail(new EmailNotification().withSendToSubscriptionAdministrator(true)
                        .withSendToSubscriptionCoAdministrators(true)
                        .withCustomEmails(Arrays.asList("gu@ms.com", "ge@ns.net")))
                    .withWebhooks(Arrays.asList(
                        new WebhookNotification().withServiceUri("http://myservice.com").withProperties(mapOf())))))
                .withEnabled(true)
                .withPredictiveAutoscalePolicy(
                    new PredictiveAutoscalePolicy().withScaleMode(PredictiveAutoscalePolicyScaleMode.ENABLED))
                .withTargetResourceUri(
                    "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
                com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

Go

package armmonitor_test

import (
	"context"
	"log"

	"time"

	"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/blob/969fd0c2634fbcc1975d7abe3749330a5145a97c/specification/monitor/resource-manager/Microsoft.Insights/stable/2022-10-01/examples/createOrUpdateAutoscaleSetting.json
func ExampleAutoscaleSettingsClient_CreateOrUpdate() {
	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.NewAutoscaleSettingsClient().CreateOrUpdate(ctx, "TestingMetricsScaleSet", "MySetting", armmonitor.AutoscaleSettingResource{
		Location: to.Ptr("West US"),
		Tags: map[string]*string{
			"key1": to.Ptr("value1"),
			"key2": to.Ptr("value2"),
		},
		Properties: &armmonitor.AutoscaleSetting{
			Enabled: to.Ptr(true),
			Notifications: []*armmonitor.AutoscaleNotification{
				{
					Email: &armmonitor.EmailNotification{
						CustomEmails: []*string{
							to.Ptr("gu@ms.com"),
							to.Ptr("ge@ns.net")},
						SendToSubscriptionAdministrator:    to.Ptr(true),
						SendToSubscriptionCoAdministrators: to.Ptr(true),
					},
					Operation: to.Ptr("Scale"),
					Webhooks: []*armmonitor.WebhookNotification{
						{
							Properties: map[string]*string{},
							ServiceURI: to.Ptr("http://myservice.com"),
						}},
				}},
			PredictiveAutoscalePolicy: &armmonitor.PredictiveAutoscalePolicy{
				ScaleMode: to.Ptr(armmonitor.PredictiveAutoscalePolicyScaleModeEnabled),
			},
			Profiles: []*armmonitor.AutoscaleProfile{
				{
					Name: to.Ptr("adios"),
					Capacity: &armmonitor.ScaleCapacity{
						Default: to.Ptr("1"),
						Maximum: to.Ptr("10"),
						Minimum: to.Ptr("1"),
					},
					FixedDate: &armmonitor.TimeWindow{
						End:      to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2015-03-05T14:30:00.000Z"); return t }()),
						Start:    to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2015-03-05T14:00:00.000Z"); return t }()),
						TimeZone: to.Ptr("UTC"),
					},
					Rules: []*armmonitor.ScaleRule{
						{
							MetricTrigger: &armmonitor.MetricTrigger{
								DividePerInstance: to.Ptr(false),
								MetricName:        to.Ptr("Percentage CPU"),
								MetricResourceURI: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
								Operator:          to.Ptr(armmonitor.ComparisonOperationTypeGreaterThan),
								Statistic:         to.Ptr(armmonitor.MetricStatisticTypeAverage),
								Threshold:         to.Ptr[float64](10),
								TimeAggregation:   to.Ptr(armmonitor.TimeAggregationTypeAverage),
								TimeGrain:         to.Ptr("PT1M"),
								TimeWindow:        to.Ptr("PT5M"),
							},
							ScaleAction: &armmonitor.ScaleAction{
								Type:      to.Ptr(armmonitor.ScaleTypeChangeCount),
								Cooldown:  to.Ptr("PT5M"),
								Direction: to.Ptr(armmonitor.ScaleDirectionIncrease),
								Value:     to.Ptr("1"),
							},
						},
						{
							MetricTrigger: &armmonitor.MetricTrigger{
								DividePerInstance: to.Ptr(false),
								MetricName:        to.Ptr("Percentage CPU"),
								MetricResourceURI: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
								Operator:          to.Ptr(armmonitor.ComparisonOperationTypeGreaterThan),
								Statistic:         to.Ptr(armmonitor.MetricStatisticTypeAverage),
								Threshold:         to.Ptr[float64](15),
								TimeAggregation:   to.Ptr(armmonitor.TimeAggregationTypeAverage),
								TimeGrain:         to.Ptr("PT2M"),
								TimeWindow:        to.Ptr("PT5M"),
							},
							ScaleAction: &armmonitor.ScaleAction{
								Type:      to.Ptr(armmonitor.ScaleTypeChangeCount),
								Cooldown:  to.Ptr("PT6M"),
								Direction: to.Ptr(armmonitor.ScaleDirectionDecrease),
								Value:     to.Ptr("2"),
							},
						}},
				},
				{
					Name: to.Ptr("saludos"),
					Capacity: &armmonitor.ScaleCapacity{
						Default: to.Ptr("1"),
						Maximum: to.Ptr("10"),
						Minimum: to.Ptr("1"),
					},
					Recurrence: &armmonitor.Recurrence{
						Frequency: to.Ptr(armmonitor.RecurrenceFrequencyWeek),
						Schedule: &armmonitor.RecurrentSchedule{
							Days: []*string{
								to.Ptr("1")},
							Hours: []*int32{
								to.Ptr[int32](5)},
							Minutes: []*int32{
								to.Ptr[int32](15)},
							TimeZone: to.Ptr("UTC"),
						},
					},
					Rules: []*armmonitor.ScaleRule{
						{
							MetricTrigger: &armmonitor.MetricTrigger{
								DividePerInstance: to.Ptr(false),
								MetricName:        to.Ptr("Percentage CPU"),
								MetricResourceURI: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
								Operator:          to.Ptr(armmonitor.ComparisonOperationTypeGreaterThan),
								Statistic:         to.Ptr(armmonitor.MetricStatisticTypeAverage),
								Threshold:         to.Ptr[float64](10),
								TimeAggregation:   to.Ptr(armmonitor.TimeAggregationTypeAverage),
								TimeGrain:         to.Ptr("PT1M"),
								TimeWindow:        to.Ptr("PT5M"),
							},
							ScaleAction: &armmonitor.ScaleAction{
								Type:      to.Ptr(armmonitor.ScaleTypeChangeCount),
								Cooldown:  to.Ptr("PT5M"),
								Direction: to.Ptr(armmonitor.ScaleDirectionIncrease),
								Value:     to.Ptr("1"),
							},
						},
						{
							MetricTrigger: &armmonitor.MetricTrigger{
								DividePerInstance: to.Ptr(false),
								MetricName:        to.Ptr("Percentage CPU"),
								MetricResourceURI: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
								Operator:          to.Ptr(armmonitor.ComparisonOperationTypeGreaterThan),
								Statistic:         to.Ptr(armmonitor.MetricStatisticTypeAverage),
								Threshold:         to.Ptr[float64](15),
								TimeAggregation:   to.Ptr(armmonitor.TimeAggregationTypeAverage),
								TimeGrain:         to.Ptr("PT2M"),
								TimeWindow:        to.Ptr("PT5M"),
							},
							ScaleAction: &armmonitor.ScaleAction{
								Type:      to.Ptr(armmonitor.ScaleTypeChangeCount),
								Cooldown:  to.Ptr("PT6M"),
								Direction: to.Ptr(armmonitor.ScaleDirectionDecrease),
								Value:     to.Ptr("2"),
							},
						}},
				}},
			TargetResourceURI: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
		},
	}, 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.AutoscaleSettingResource = armmonitor.AutoscaleSettingResource{
	// 	Name: to.Ptr("MySetting"),
	// 	Type: to.Ptr("Microsoft.Insights/autoscaleSettings"),
	// 	ID: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/microsoft.insights/autoscalesettings/MySetting"),
	// 	Location: to.Ptr("West US"),
	// 	Tags: map[string]*string{
	// 		"key1": to.Ptr("value1"),
	// 		"key2": to.Ptr("value2"),
	// 	},
	// 	Properties: &armmonitor.AutoscaleSetting{
	// 		Name: to.Ptr("MySetting"),
	// 		Enabled: to.Ptr(true),
	// 		Notifications: []*armmonitor.AutoscaleNotification{
	// 			{
	// 				Email: &armmonitor.EmailNotification{
	// 					CustomEmails: []*string{
	// 						to.Ptr("gu@ms.com"),
	// 						to.Ptr("ge@ns.net")},
	// 						SendToSubscriptionAdministrator: to.Ptr(true),
	// 						SendToSubscriptionCoAdministrators: to.Ptr(true),
	// 					},
	// 					Operation: to.Ptr("Scale"),
	// 					Webhooks: []*armmonitor.WebhookNotification{
	// 						{
	// 							Properties: map[string]*string{
	// 							},
	// 							ServiceURI: to.Ptr("http://myservice.com"),
	// 					}},
	// 			}},
	// 			PredictiveAutoscalePolicy: &armmonitor.PredictiveAutoscalePolicy{
	// 				ScaleMode: to.Ptr(armmonitor.PredictiveAutoscalePolicyScaleModeEnabled),
	// 			},
	// 			Profiles: []*armmonitor.AutoscaleProfile{
	// 				{
	// 					Name: to.Ptr("adios"),
	// 					Capacity: &armmonitor.ScaleCapacity{
	// 						Default: to.Ptr("1"),
	// 						Maximum: to.Ptr("10"),
	// 						Minimum: to.Ptr("1"),
	// 					},
	// 					FixedDate: &armmonitor.TimeWindow{
	// 						End: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2015-03-05T14:30:00.000Z"); return t}()),
	// 						Start: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2015-03-05T14:00:00.000Z"); return t}()),
	// 						TimeZone: to.Ptr("UTC"),
	// 					},
	// 					Rules: []*armmonitor.ScaleRule{
	// 						{
	// 							MetricTrigger: &armmonitor.MetricTrigger{
	// 								DividePerInstance: to.Ptr(false),
	// 								MetricName: to.Ptr("Percentage CPU"),
	// 								MetricResourceURI: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
	// 								Operator: to.Ptr(armmonitor.ComparisonOperationTypeGreaterThan),
	// 								Statistic: to.Ptr(armmonitor.MetricStatisticTypeAverage),
	// 								Threshold: to.Ptr[float64](10),
	// 								TimeAggregation: to.Ptr(armmonitor.TimeAggregationTypeAverage),
	// 								TimeGrain: to.Ptr("PT1M"),
	// 								TimeWindow: to.Ptr("PT5M"),
	// 							},
	// 							ScaleAction: &armmonitor.ScaleAction{
	// 								Type: to.Ptr(armmonitor.ScaleTypeChangeCount),
	// 								Cooldown: to.Ptr("PT5M"),
	// 								Direction: to.Ptr(armmonitor.ScaleDirectionIncrease),
	// 								Value: to.Ptr("1"),
	// 							},
	// 						},
	// 						{
	// 							MetricTrigger: &armmonitor.MetricTrigger{
	// 								DividePerInstance: to.Ptr(false),
	// 								MetricName: to.Ptr("Percentage CPU"),
	// 								MetricResourceURI: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
	// 								Operator: to.Ptr(armmonitor.ComparisonOperationTypeGreaterThan),
	// 								Statistic: to.Ptr(armmonitor.MetricStatisticTypeAverage),
	// 								Threshold: to.Ptr[float64](15),
	// 								TimeAggregation: to.Ptr(armmonitor.TimeAggregationTypeAverage),
	// 								TimeGrain: to.Ptr("PT2M"),
	// 								TimeWindow: to.Ptr("PT5M"),
	// 							},
	// 							ScaleAction: &armmonitor.ScaleAction{
	// 								Type: to.Ptr(armmonitor.ScaleTypeChangeCount),
	// 								Cooldown: to.Ptr("PT6M"),
	// 								Direction: to.Ptr(armmonitor.ScaleDirectionDecrease),
	// 								Value: to.Ptr("2"),
	// 							},
	// 					}},
	// 				},
	// 				{
	// 					Name: to.Ptr("saludos"),
	// 					Capacity: &armmonitor.ScaleCapacity{
	// 						Default: to.Ptr("1"),
	// 						Maximum: to.Ptr("10"),
	// 						Minimum: to.Ptr("1"),
	// 					},
	// 					Recurrence: &armmonitor.Recurrence{
	// 						Frequency: to.Ptr(armmonitor.RecurrenceFrequencyWeek),
	// 						Schedule: &armmonitor.RecurrentSchedule{
	// 							Days: []*string{
	// 								to.Ptr("1")},
	// 								Hours: []*int32{
	// 									to.Ptr[int32](5)},
	// 									Minutes: []*int32{
	// 										to.Ptr[int32](15)},
	// 										TimeZone: to.Ptr("UTC"),
	// 									},
	// 								},
	// 								Rules: []*armmonitor.ScaleRule{
	// 									{
	// 										MetricTrigger: &armmonitor.MetricTrigger{
	// 											DividePerInstance: to.Ptr(false),
	// 											MetricName: to.Ptr("Percentage CPU"),
	// 											MetricResourceURI: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
	// 											Operator: to.Ptr(armmonitor.ComparisonOperationTypeGreaterThan),
	// 											Statistic: to.Ptr(armmonitor.MetricStatisticTypeAverage),
	// 											Threshold: to.Ptr[float64](10),
	// 											TimeAggregation: to.Ptr(armmonitor.TimeAggregationTypeAverage),
	// 											TimeGrain: to.Ptr("PT1M"),
	// 											TimeWindow: to.Ptr("PT5M"),
	// 										},
	// 										ScaleAction: &armmonitor.ScaleAction{
	// 											Type: to.Ptr(armmonitor.ScaleTypeChangeCount),
	// 											Cooldown: to.Ptr("PT5M"),
	// 											Direction: to.Ptr(armmonitor.ScaleDirectionIncrease),
	// 											Value: to.Ptr("1"),
	// 										},
	// 									},
	// 									{
	// 										MetricTrigger: &armmonitor.MetricTrigger{
	// 											DividePerInstance: to.Ptr(false),
	// 											MetricName: to.Ptr("Percentage CPU"),
	// 											MetricResourceURI: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
	// 											Operator: to.Ptr(armmonitor.ComparisonOperationTypeGreaterThan),
	// 											Statistic: to.Ptr(armmonitor.MetricStatisticTypeAverage),
	// 											Threshold: to.Ptr[float64](15),
	// 											TimeAggregation: to.Ptr(armmonitor.TimeAggregationTypeAverage),
	// 											TimeGrain: to.Ptr("PT2M"),
	// 											TimeWindow: to.Ptr("PT5M"),
	// 										},
	// 										ScaleAction: &armmonitor.ScaleAction{
	// 											Type: to.Ptr(armmonitor.ScaleTypeChangeCount),
	// 											Cooldown: to.Ptr("PT6M"),
	// 											Direction: to.Ptr(armmonitor.ScaleDirectionDecrease),
	// 											Value: to.Ptr("2"),
	// 										},
	// 								}},
	// 						}},
	// 						TargetResourceURI: to.Ptr("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
	// 					},
	// 				}
}

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

JavaScript

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

/**
 * This sample demonstrates how to Creates or updates an autoscale setting.
 *
 * @summary Creates or updates an autoscale setting.
 * x-ms-original-file: specification/monitor/resource-manager/Microsoft.Insights/stable/2022-10-01/examples/createOrUpdateAutoscaleSetting.json
 */
async function createOrUpdateAnAutoscaleSetting() {
  const subscriptionId =
    process.env["MONITOR_SUBSCRIPTION_ID"] || "b67f7fec-69fc-4974-9099-a26bd6ffeda3";
  const resourceGroupName = process.env["MONITOR_RESOURCE_GROUP"] || "TestingMetricsScaleSet";
  const autoscaleSettingName = "MySetting";
  const parameters = {
    enabled: true,
    location: "West US",
    notifications: [
      {
        email: {
          customEmails: ["gu@ms.com", "ge@ns.net"],
          sendToSubscriptionAdministrator: true,
          sendToSubscriptionCoAdministrators: true,
        },
        operation: "Scale",
        webhooks: [{ properties: {}, serviceUri: "http://myservice.com" }],
      },
    ],
    predictiveAutoscalePolicy: { scaleMode: "Enabled" },
    profiles: [
      {
        name: "adios",
        capacity: { default: "1", maximum: "10", minimum: "1" },
        fixedDate: {
          end: new Date("2015-03-05T14:30:00Z"),
          start: new Date("2015-03-05T14:00:00Z"),
          timeZone: "UTC",
        },
        rules: [
          {
            metricTrigger: {
              dividePerInstance: false,
              metricName: "Percentage CPU",
              metricResourceUri:
                "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              operator: "GreaterThan",
              statistic: "Average",
              threshold: 10,
              timeAggregation: "Average",
              timeGrain: "PT1M",
              timeWindow: "PT5M",
            },
            scaleAction: {
              type: "ChangeCount",
              cooldown: "PT5M",
              direction: "Increase",
              value: "1",
            },
          },
          {
            metricTrigger: {
              dividePerInstance: false,
              metricName: "Percentage CPU",
              metricResourceUri:
                "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              operator: "GreaterThan",
              statistic: "Average",
              threshold: 15,
              timeAggregation: "Average",
              timeGrain: "PT2M",
              timeWindow: "PT5M",
            },
            scaleAction: {
              type: "ChangeCount",
              cooldown: "PT6M",
              direction: "Decrease",
              value: "2",
            },
          },
        ],
      },
      {
        name: "saludos",
        capacity: { default: "1", maximum: "10", minimum: "1" },
        recurrence: {
          frequency: "Week",
          schedule: { days: ["1"], hours: [5], minutes: [15], timeZone: "UTC" },
        },
        rules: [
          {
            metricTrigger: {
              dividePerInstance: false,
              metricName: "Percentage CPU",
              metricResourceUri:
                "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              operator: "GreaterThan",
              statistic: "Average",
              threshold: 10,
              timeAggregation: "Average",
              timeGrain: "PT1M",
              timeWindow: "PT5M",
            },
            scaleAction: {
              type: "ChangeCount",
              cooldown: "PT5M",
              direction: "Increase",
              value: "1",
            },
          },
          {
            metricTrigger: {
              dividePerInstance: false,
              metricName: "Percentage CPU",
              metricResourceUri:
                "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              operator: "GreaterThan",
              statistic: "Average",
              threshold: 15,
              timeAggregation: "Average",
              timeGrain: "PT2M",
              timeWindow: "PT5M",
            },
            scaleAction: {
              type: "ChangeCount",
              cooldown: "PT6M",
              direction: "Decrease",
              value: "2",
            },
          },
        ],
      },
    ],
    tags: { key1: "value1", key2: "value2" },
    targetResourceUri:
      "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
  };
  const credential = new DefaultAzureCredential();
  const client = new MonitorClient(credential, subscriptionId);
  const result = await client.autoscaleSettings.createOrUpdate(
    resourceGroupName,
    autoscaleSettingName,
    parameters,
  );
  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

dotnet

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

// Generated from example definition: specification/monitor/resource-manager/Microsoft.Insights/stable/2022-10-01/examples/createOrUpdateAutoscaleSetting.json
// this example is just showing the usage of "AutoscaleSettings_CreateOrUpdate" 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 ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "b67f7fec-69fc-4974-9099-a26bd6ffeda3";
string resourceGroupName = "TestingMetricsScaleSet";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this AutoscaleSettingResource
AutoscaleSettingCollection collection = resourceGroupResource.GetAutoscaleSettings();

// invoke the operation
string autoscaleSettingName = "MySetting";
AutoscaleSettingData data = new AutoscaleSettingData(new AzureLocation("West US"), new AutoscaleProfile[]
{
new AutoscaleProfile("adios",new MonitorScaleCapacity(1,10,1),new AutoscaleRule[]
{
new AutoscaleRule(new MetricTrigger("Percentage CPU",new ResourceIdentifier("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),XmlConvert.ToTimeSpan("PT1M"),MetricStatisticType.Average,XmlConvert.ToTimeSpan("PT5M"),MetricTriggerTimeAggregationType.Average,MetricTriggerComparisonOperation.GreaterThan,10)
{
IsDividedPerInstance = false,
},new MonitorScaleAction(MonitorScaleDirection.Increase,MonitorScaleType.ChangeCount,XmlConvert.ToTimeSpan("PT5M"))
{
Value = "1",
}),new AutoscaleRule(new MetricTrigger("Percentage CPU",new ResourceIdentifier("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),XmlConvert.ToTimeSpan("PT2M"),MetricStatisticType.Average,XmlConvert.ToTimeSpan("PT5M"),MetricTriggerTimeAggregationType.Average,MetricTriggerComparisonOperation.GreaterThan,15)
{
IsDividedPerInstance = false,
},new MonitorScaleAction(MonitorScaleDirection.Decrease,MonitorScaleType.ChangeCount,XmlConvert.ToTimeSpan("PT6M"))
{
Value = "2",
})
})
{
FixedDate = new MonitorTimeWindow(DateTimeOffset.Parse("2015-03-05T14:00:00Z"),DateTimeOffset.Parse("2015-03-05T14:30:00Z"))
{
TimeZone = "UTC",
},
},new AutoscaleProfile("saludos",new MonitorScaleCapacity(1,10,1),new AutoscaleRule[]
{
new AutoscaleRule(new MetricTrigger("Percentage CPU",new ResourceIdentifier("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),XmlConvert.ToTimeSpan("PT1M"),MetricStatisticType.Average,XmlConvert.ToTimeSpan("PT5M"),MetricTriggerTimeAggregationType.Average,MetricTriggerComparisonOperation.GreaterThan,10)
{
IsDividedPerInstance = false,
},new MonitorScaleAction(MonitorScaleDirection.Increase,MonitorScaleType.ChangeCount,XmlConvert.ToTimeSpan("PT5M"))
{
Value = "1",
}),new AutoscaleRule(new MetricTrigger("Percentage CPU",new ResourceIdentifier("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),XmlConvert.ToTimeSpan("PT2M"),MetricStatisticType.Average,XmlConvert.ToTimeSpan("PT5M"),MetricTriggerTimeAggregationType.Average,MetricTriggerComparisonOperation.GreaterThan,15)
{
IsDividedPerInstance = false,
},new MonitorScaleAction(MonitorScaleDirection.Decrease,MonitorScaleType.ChangeCount,XmlConvert.ToTimeSpan("PT6M"))
{
Value = "2",
})
})
{
Recurrence = new MonitorRecurrence(RecurrenceFrequency.Week,new RecurrentSchedule("UTC",new MonitorDayOfWeek[]
{
new MonitorDayOfWeek("1")
},new int[]
{
5
},new int[]
{
15
})),
}
})
{
    Notifications =
    {
    new AutoscaleNotification()
    {
    Email = new EmailNotification()
    {
    SendToSubscriptionAdministrator = true,
    SendToSubscriptionCoAdministrators = true,
    CustomEmails =
    {
    "gu@ms.com","ge@ns.net"
    },
    },
    Webhooks =
    {
    new WebhookNotification()
    {
    ServiceUri = new Uri("http://myservice.com"),
    Properties =
    {
    },
    }
    },
    }
    },
    IsEnabled = true,
    PredictiveAutoscalePolicy = new PredictiveAutoscalePolicy(PredictiveAutoscalePolicyScaleMode.Enabled),
    TargetResourceId = new ResourceIdentifier("/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc"),
    Tags =
    {
    ["key1"] = "value1",
    ["key2"] = "value2",
    },
};
ArmOperation<AutoscaleSettingResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, autoscaleSettingName, data);
AutoscaleSettingResource result = lro.Value;

// 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
AutoscaleSettingData 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

Sample Response

Status code:

200

{
  "id": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/microsoft.insights/autoscalesettings/MySetting",
  "name": "MySetting",
  "type": "Microsoft.Insights/autoscaleSettings",
  "location": "West US",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  },
  "properties": {
    "profiles": [
      {
        "name": "adios",
        "capacity": {
          "minimum": "1",
          "maximum": "10",
          "default": "1"
        },
        "rules": [
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT1M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 10,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Increase",
              "type": "ChangeCount",
              "value": "1",
              "cooldown": "PT5M"
            }
          },
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT2M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 15,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Decrease",
              "type": "ChangeCount",
              "value": "2",
              "cooldown": "PT6M"
            }
          }
        ],
        "fixedDate": {
          "timeZone": "UTC",
          "start": "2015-03-05T14:00:00Z",
          "end": "2015-03-05T14:30:00Z"
        }
      },
      {
        "name": "saludos",
        "capacity": {
          "minimum": "1",
          "maximum": "10",
          "default": "1"
        },
        "rules": [
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT1M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 10,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Increase",
              "type": "ChangeCount",
              "value": "1",
              "cooldown": "PT5M"
            }
          },
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT2M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 15,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Decrease",
              "type": "ChangeCount",
              "value": "2",
              "cooldown": "PT6M"
            }
          }
        ],
        "recurrence": {
          "frequency": "Week",
          "schedule": {
            "timeZone": "UTC",
            "days": [
              "1"
            ],
            "hours": [
              5
            ],
            "minutes": [
              15
            ]
          }
        }
      }
    ],
    "enabled": true,
    "name": "MySetting",
    "targetResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
    "predictiveAutoscalePolicy": {
      "scaleMode": "Enabled",
      "scaleLookAheadTime": null
    },
    "notifications": [
      {
        "operation": "Scale",
        "email": {
          "sendToSubscriptionAdministrator": true,
          "sendToSubscriptionCoAdministrators": true,
          "customEmails": [
            "gu@ms.com",
            "ge@ns.net"
          ]
        },
        "webhooks": [
          {
            "serviceUri": "http://myservice.com",
            "properties": {}
          }
        ]
      }
    ]
  }
}

Status code:

201

{
  "id": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/microsoft.insights/autoscalesettings/MySetting",
  "name": "MySetting",
  "type": "Microsoft.Insights/autoscaleSettings",
  "location": "West US",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  },
  "properties": {
    "profiles": [
      {
        "name": "adios",
        "capacity": {
          "minimum": "1",
          "maximum": "10",
          "default": "1"
        },
        "rules": [
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT1M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 10,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Increase",
              "type": "ChangeCount",
              "value": "1",
              "cooldown": "PT5M"
            }
          },
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT2M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 15,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Decrease",
              "type": "ChangeCount",
              "value": "2",
              "cooldown": "PT6M"
            }
          }
        ],
        "fixedDate": {
          "timeZone": "UTC",
          "start": "2015-03-05T14:00:00Z",
          "end": "2015-03-05T14:30:00Z"
        }
      },
      {
        "name": "saludos",
        "capacity": {
          "minimum": "1",
          "maximum": "10",
          "default": "1"
        },
        "rules": [
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT1M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 10,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Increase",
              "type": "ChangeCount",
              "value": "1",
              "cooldown": "PT5M"
            }
          },
          {
            "metricTrigger": {
              "metricName": "Percentage CPU",
              "metricResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
              "timeGrain": "PT2M",
              "statistic": "Average",
              "timeWindow": "PT5M",
              "timeAggregation": "Average",
              "operator": "GreaterThan",
              "threshold": 15,
              "dividePerInstance": false
            },
            "scaleAction": {
              "direction": "Decrease",
              "type": "ChangeCount",
              "value": "2",
              "cooldown": "PT6M"
            }
          }
        ],
        "recurrence": {
          "frequency": "Week",
          "schedule": {
            "timeZone": "UTC",
            "days": [
              "1"
            ],
            "hours": [
              5
            ],
            "minutes": [
              15
            ]
          }
        }
      }
    ],
    "enabled": true,
    "name": "MySetting",
    "targetResourceUri": "/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/TestingMetricsScaleSet/providers/Microsoft.Compute/virtualMachineScaleSets/testingsc",
    "predictiveAutoscalePolicy": {
      "scaleMode": "Enabled",
      "scaleLookAheadTime": null
    },
    "notifications": [
      {
        "operation": "Scale",
        "email": {
          "sendToSubscriptionAdministrator": true,
          "sendToSubscriptionCoAdministrators": true,
          "customEmails": [
            "gu@ms.com",
            "ge@ns.net"
          ]
        },
        "webhooks": [
          {
            "serviceUri": "http://myservice.com",
            "properties": {}
          }
        ]
      }
    ]
  }
}

定義

名稱	Description
AutoscaleErrorResponse	描述錯誤回應的格式。
AutoscaleNotification	自動調整通知。
AutoscaleProfile	自動調整配置檔。
AutoscaleSettingResource	自動調整設定資源。
ComparisonOperationType	用來比較計量數據和閾值的運算符。
createdByType	建立資源的身分識別類型。
EmailNotification	Email 自動調整事件的通知。
Error	錯誤物件。
MetricStatisticType	計量統計數據類型。 如何結合來自多個執行個體的度量。
MetricTrigger	會導致調整動作的觸發程序。
OperationType	與通知相關聯的作業及其值必須是“scale”
PredictiveAutoscalePolicy	啟用預測性自動調整的參數。
PredictiveAutoscalePolicyScaleMode	預測性自動調整模式
Recurrence	此設定檔開始的重複次數。 如果使用了 FixedDate 元素，就不會使用這個元素。
RecurrenceFrequency	週期頻率。 排程設定檔應該生效的頻率。 此值必須是 [週]，這表示每週將有一組相同的設定檔。 例如，若要設定每日排程，請將 排程 設定為每周的每一天。 frequency 屬性指定排程每周重複。
RecurrentSchedule	設定檔開始時的排程條件約束。
ScaleAction	調整動作的參數。
ScaleCapacity	可以在這個設定檔期間使用的執行個體數目。
ScaleDirection	縮放方向。 調整動作是否會增加或減少實例數目。
ScaleRule	規則，提供縮放動作的觸發程式和參數。
ScaleRuleMetricDimension	指定自動調整規則計量維度。
ScaleRuleMetricDimensionOperationType	維度運算子。 僅支援 『Equals』 和 『NotEquals』。 'Equals' 等於任何值。 'NotEquals' 不等於所有值
ScaleType	引發縮放規則時應該發生的動作類型。
systemData	與建立和上次修改資源相關的元數據。
TimeAggregationType	時間匯總類型。 收集的資料應如何隨著時間結合。 預設值為 Average。
TimeWindow	配置檔的特定日期時間。
WebhookNotification	自動調整事件的 Webhook 通知。

AutoscaleErrorResponse

描述錯誤回應的格式。

名稱	類型	Description
error	Error	錯誤物件。
systemData	systemData	與回應相關的系統元數據。

AutoscaleNotification

自動調整通知。

名稱	類型	Description
email	EmailNotification	電子郵件通知。
operation	OperationType	與通知相關聯的作業及其值必須是“scale”
webhooks	WebhookNotification[]	Webhook 通知的集合。

AutoscaleProfile

自動調整配置檔。

名稱	類型	Description
capacity	ScaleCapacity	此配置檔期間可以使用的實例數目。
fixedDate	TimeWindow	配置檔的特定日期時間。 如果使用了 Recurrence 元素，就不會使用這個元素。
name	string	配置檔的名稱。
recurrence	Recurrence	這個配置檔開始的重複時間。 如果使用了 FixedDate 元素，就不會使用這個元素。
rules	ScaleRule[]	提供調整動作之觸發程式和參數的規則集合。 最多可指定 10 個規則。

AutoscaleSettingResource

自動調整設定資源。

名稱	類型	預設值	Description
id	string		Azure 資源標識碼
location	string		資源位置
name	string		Azure 資源名稱
properties.enabled	boolean	False	已啟用的旗標。 指定是否要針對資源啟用自動調整。 預設值為 'false'。
properties.name	string		自動調整設定的名稱。
properties.notifications	AutoscaleNotification[]		通知的集合。
properties.predictiveAutoscalePolicy	PredictiveAutoscalePolicy		預測性自動調整原則模式。
properties.profiles	AutoscaleProfile[]		自動調整配置檔的集合，指定不同時段的不同縮放參數。 最多可指定 20 個設定檔。
properties.targetResourceLocation	string		應新增自動調整設定的資源位置。
properties.targetResourceUri	string		應加入自動調整設定之資源的資源標識碼。
systemData	systemData		與回應相關的系統元數據。
tags	object		取得或設定描述資源的索引鍵值組清單。 這些標記可用來在資源群組間檢視資源，以及對資源分組。 資源最多可提供15個標記。 每個標記的長度必須不超過 128 個字元，且長度不超過 256 個字元的值。
type	string		Azure 資源類型

ComparisonOperationType

用來比較計量數據和閾值的運算符。

名稱	類型	Description
Equals	string
GreaterThan	string
GreaterThanOrEqual	string
LessThan	string
LessThanOrEqual	string
NotEquals	string

createdByType

建立資源的身分識別類型。

名稱	類型	Description
Application	string
Key	string
ManagedIdentity	string
User	string

EmailNotification

Email 自動調整事件的通知。

名稱	類型	預設值	Description
customEmails	string[]		自訂電子郵件清單。 這個值可以是 Null 或空白，在此情況下會忽略此屬性。
sendToSubscriptionAdministrator	boolean	False	值，指出是否要將電子郵件傳送給訂用帳戶管理員。
sendToSubscriptionCoAdministrators	boolean	False	值，指出是否要傳送電子郵件給訂用帳戶共同管理員。

Error

錯誤物件。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
details	string	人類看得懂的錯誤詳細數據表示法。
message	string	人類看得懂的錯誤表示法。
target	string	特定錯誤的目標。

MetricStatisticType

計量統計數據類型。 如何結合來自多個執行個體的度量。

名稱	類型	Description
Average	string
Count	string
Max	string
Min	string
Sum	string

MetricTrigger

會導致調整動作的觸發程序。

名稱	類型	Description
dimensions	ScaleRuleMetricDimension[]	維度條件的清單。 例如：[{“DimensionName”：“AppName”，“Operator”：“Equals”，“Values”：[“App1”]}，{“DimensionName”：“Deployment”，“Operator”：“Equals”，“Values”：[“default”]}]。
dividePerInstance	boolean	值，指出計量是否應該除以每個實例。
metricName	string	定義規則監視之計量的名稱。
metricNamespace	string	定義規則監視之計量的命名空間。
metricResourceLocation	string	規則監視之資源的位置。
metricResourceUri	string	規則所監視之資源的資源標識碼。
operator	ComparisonOperationType	用來比較計量數據和閾值的運算符。
statistic	MetricStatisticType	計量統計數據類型。 如何結合來自多個執行個體的度量。
threshold	number	觸發縮放動作之計量的臨界值。
timeAggregation	TimeAggregationType	時間匯總類型。 收集的資料應如何隨著時間結合。 預設值為 Average。
timeGrain	string	規則監視的計量粒度。 必須是從度量的度量定義傳回的其中一個預先定義的值。 必須介於 12 小時與 1 分鐘之間。
timeWindow	string	收集實例數據的時間範圍。 此值必須大於度量集合中的延遲 (可能會因資源而有所不同)。 必須介於 12 小時與 5 分鐘之間。

OperationType

與通知相關聯的作業及其值必須是“scale”

名稱	類型	Description
Scale	string

PredictiveAutoscalePolicy

啟用預測性自動調整的參數。

名稱	類型	Description
scaleLookAheadTime	string	指定要事先啟動實例的時間量。 它必須介於 ISO 8601 格式的 1 分鐘到 60 分鐘之間。
scaleMode	PredictiveAutoscalePolicyScaleMode	預測性自動調整模式

PredictiveAutoscalePolicyScaleMode

預測性自動調整模式

名稱	類型	Description
Disabled	string
Enabled	string
ForecastOnly	string

Recurrence

此設定檔開始的重複次數。 如果使用了 FixedDate 元素，就不會使用這個元素。

名稱	類型	Description
frequency	RecurrenceFrequency	週期頻率。 排程設定檔應該生效的頻率。 此值必須是 [週]，這表示每週將有一組相同的設定檔。 例如，若要設定每日排程，請將 排程 設定為每周的每一天。 frequency 屬性指定排程每周重複。
schedule	RecurrentSchedule	配置文件開始時的排程條件約束。

RecurrenceFrequency

週期頻率。 排程設定檔應該生效的頻率。 此值必須是 [週]，這表示每週將有一組相同的設定檔。 例如，若要設定每日排程，請將 排程 設定為每周的每一天。 frequency 屬性指定排程每周重複。

名稱	類型	Description
Day	string
Hour	string
Minute	string
Month	string
None	string
Second	string
Week	string
Year	string

RecurrentSchedule

設定檔開始時的排程條件約束。

名稱	類型	Description
days	string[]	配置檔生效的天數集合。 可能的值為星期日到星期六。
hours	integer[]	配置檔生效的時數集合。 不支援在 24 小時制 (上午/下午 0 到 23 的值) 。
minutes	integer[]	設定檔生效的分鐘集合。
timeZone	string	配置檔時數的時區。 有效時區的一些範例包括：日期線標準時間、UTC-11、墨西哥標準時間、墨西哥標準時間、太平洋標準時間 (墨西哥) 、太平洋標準時間、美國 Mountain Standard Time、Mountain Standard Time (墨西哥) 、Mountain Standard Time、Central Standard Time、Central Standard Time、Central Standard Time (墨西哥) 、加拿大中部標準時間、 SA Pacific Standard Time、美國東部標準時間、美國東部標準時間、墨西哥標準時間、巴西標準時間、巴西中部標準時間、SA 西部標準時間、太平洋 SA 標準時間、Newfoundland 標準時間、E. 南美洲標準時間、阿根廷標準時間、SA 東部標準時間、Greenland 標準時間、蒙地維亞標準時間、蒙地亞標準時間、貝羅標準時間、 UTC-02、Mid-Atlantic 標準時間、Azores 標準時間、維德角標準時間、墨西哥標準時間、UTC、GMT 標準時間、Greenwich 標準時間、W. 歐洲標準時間、中部標準時間、中部標準時間、W. 非洲標準時間、北歐標準時間、GtB 標準時間、中東標準時間、北歐標準時間、西班牙標準時間、 阿拉伯標準時間、E. 歐洲標準時間、南非標準時間、FLE 標準時間、土耳其標準時間、以色列標準時間、亞美尼亞標準時間、阿拉伯標準時間、俄文標準時間、E. 非洲標準時間、英國標準時間、阿拉伯標準時間、亞塞亞標準時間、俄羅斯時區 3、亞塞亞標準時間、 喬治亞標準時間、Caucasus 標準時間、喬治亞標準時間、西歐標準時間、Ekaterin漢堡標準時間、印度標準時間、印度標準時間、東亞標準時間、中部標準時間、N.東亞標準時間、印度標準時間、SE 亞洲標準時間、北亞洲標準時間、北亞洲標準時間、北亞洲標準時間、 北亞洲標準時間、 新加坡標準時間、W. Australia Standard Time、Ta一標準時間、Ulaanbaatar Standard Time、東京標準時間、韓國標準時間、Yakutsk 標準時間、Cen。 澳大利亞標準時間、AUS 中部標準時間、E. 澳大利亞標準時間、AUS 東部標準時間、西太平洋標準時間、Tasmania 標準時間、Magadan 標準時間、Vladivostok 標準時間、俄羅斯時區 10、中部太平洋標準時間、俄羅斯時區 11、紐西蘭標準時間、UTC+12、法屬標準時間、卡達標準時間、卡達標準時間、Tonga 標準時間、西班牙標準時間、 Line Islands Standard Time

ScaleAction

調整動作的參數。

名稱	類型	預設值	Description
cooldown	string		此動作發生前最後一個調整動作之後要等候的時間量。 它必須介於 ISO 8601 格式的 1 周到 1 分鐘之間。
direction	ScaleDirection		縮放方向。 調整動作是否會增加或減少實例數目。
type	ScaleType		引發縮放規則時應該發生的動作類型。
value	string	1	調整動作所涉及的實例數目。 此值必須是 1 或更大。 預設值為 1。

ScaleCapacity

可以在這個設定檔期間使用的執行個體數目。

名稱	類型	Description
default	string	如果計量無法用於評估，將會設定的實例數目。 只有當目前的執行個體計數低於預設值時，才會使用預設值。
maximum	string	資源的實例數目上限。 實際的實例數目上限受限於訂用帳戶中可用的核心。
minimum	string	資源的實例數目下限。

ScaleDirection

縮放方向。 調整動作是否會增加或減少實例數目。

名稱	類型	Description
Decrease	string
Increase	string
None	string

ScaleRule

規則，提供縮放動作的觸發程式和參數。

名稱	類型	Description
metricTrigger	MetricTrigger	導致調整動作的觸發程式。
scaleAction	ScaleAction	調整動作的參數。

ScaleRuleMetricDimension

指定自動調整規則計量維度。

名稱	類型	Description
DimensionName	string	維度的名稱。
Operator	ScaleRuleMetricDimensionOperationType	維度運算子。 僅支援 『Equals』 和 『NotEquals』。 'Equals' 等於任何值。 'NotEquals' 不等於所有值
Values	string[]	維度值的清單。 例如：[“App1”，“App2”]。

ScaleRuleMetricDimensionOperationType

維度運算子。 僅支援 『Equals』 和 『NotEquals』。 'Equals' 等於任何值。 'NotEquals' 不等於所有值

名稱	類型	Description
Equals	string
NotEquals	string

ScaleType

引發縮放規則時應該發生的動作類型。

名稱	類型	Description
ChangeCount	string
ExactCount	string
PercentChangeCount	string
ServiceAllowedNextValue	string

systemData

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string	資源建立的時間戳 (UTC) 。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string	上次修改的資源時間戳 (UTC)
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

TimeAggregationType

時間匯總類型。 收集的資料應如何隨著時間結合。 預設值為 Average。

名稱	類型	Description
Average	string
Count	string
Last	string
Maximum	string
Minimum	string
Total	string

TimeWindow

配置檔的特定日期時間。

名稱	類型	Description
end	string	ISO 8601 格式之配置檔的結束時間。
start	string	ISO 8601 格式配置檔的開始時間。
timeZone	string	配置檔開始和結束時間的時區。 有效時區的一些範例包括：日期線標準時間、UTC-11、墨西哥標準時間、墨西哥標準時間、太平洋標準時間 (墨西哥) 、太平洋標準時間、美國 Mountain Standard Time、Mountain Standard Time (墨西哥) 、Mountain Standard Time、Central Standard Time、Central Standard Time、Central Standard Time (墨西哥) 、加拿大中部標準時間、 SA Pacific Standard Time、美國東部標準時間、美國東部標準時間、墨西哥標準時間、巴西標準時間、巴西中部標準時間、SA 西部標準時間、太平洋 SA 標準時間、Newfoundland 標準時間、E. 南美洲標準時間、阿根廷標準時間、SA 東部標準時間、Greenland 標準時間、蒙地維亞標準時間、蒙地亞標準時間、貝羅標準時間、 UTC-02、Mid-Atlantic 標準時間、Azores 標準時間、維德角標準時間、墨西哥標準時間、UTC、GMT 標準時間、Greenwich 標準時間、W. 歐洲標準時間、中部標準時間、中部標準時間、W. 非洲標準時間、北歐標準時間、GtB 標準時間、中東標準時間、北歐標準時間、西班牙標準時間、 阿拉伯標準時間、E. 歐洲標準時間、南非標準時間、FLE 標準時間、土耳其標準時間、以色列標準時間、亞美尼亞標準時間、阿拉伯標準時間、俄文標準時間、E. 非洲標準時間、英國標準時間、阿拉伯標準時間、亞塞亞標準時間、俄羅斯時區 3、亞塞亞標準時間、 喬治亞標準時間、Caucasus 標準時間、喬治亞標準時間、西歐標準時間、Ekaterin漢堡標準時間、印度標準時間、印度標準時間、東亞標準時間、中部標準時間、N.東亞標準時間、印度標準時間、SE 亞洲標準時間、北亞洲標準時間、北亞洲標準時間、北亞洲標準時間、 北亞洲標準時間、 新加坡標準時間、W. Australia Standard Time、Ta一標準時間、Ulaanbaatar Standard Time、東京標準時間、韓國標準時間、Yakutsk 標準時間、Cen。 澳大利亞標準時間、AUS 中部標準時間、E. 澳大利亞標準時間、AUS 東部標準時間、西太平洋標準時間、Tasmania 標準時間、Magadan 標準時間、Vladivostok 標準時間、俄羅斯時區 10、中部太平洋標準時間、俄羅斯時區 11、紐西蘭標準時間、UTC+12、法屬標準時間、卡達標準時間、卡達標準時間、Tonga 標準時間、西班牙標準時間、 Line Islands Standard Time

WebhookNotification

自動調整事件的 Webhook 通知。

名稱	類型	Description
properties	object	設定的屬性包。 這個值可以是空的。
serviceUri	string	要接收通知的服務位址。