---
title: Azure RM - Autoscale
slug: homologacao-atmosphere/azure-rm-autoscale
description: Learn how to create and delete an autoscale configuration with this comprehensive document. Discover the essential parameters like enabling autoscaling, location, name, notifications, profiles, resource group, state, and target. Dive deeper into the subfi
docTags:
createdAt: 2021-05-20T14:42:45.000Z
---
## Resumo
- Crie, exclua uma configuração de dimensionamento automático.
## Parâmetros
| **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** |
| ---------------------------- | -------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| enabled | boolean | Escolhas:
- false
- true
(default) | Especifica se o escalonamento automático está habilitado para o recurso. |
| location | string | | Localização do recurso. |
| name - *required* | string | | Nome do recurso. |
| notifications | string | | A coleção de notificações. |
| password | string | | Senha de usuário do Active Directory. Use ao autenticar com um usuário do Active Directory em vez do principal de serviço. |
| profiles | string | | A coleção de perfis de dimensionamento automático que especificam diferentes parâmetros de dimensionamento para diferentes períodos de tempo. No máximo 20 perfis podem ser especificados. |
| resource\_group - *required* | string | | Grupo de recursos do recurso. |
| state | string | Escolhas:
- present
(default)
- absent | Afirme o estado da rede virtual. Use present para criar ou atualizar e absent para excluir. |
| target | string | | Identificador do recurso para aplicar a configuração de escalonamento automático. Pode ser a string de identificação do recurso. Também pode ser um dict que contém o nome, subscription\_id, namespace, tipos, resource\_group do recurso. |
### Subcampos da opção notifications
| **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** |
| ------------------------------------------ | -------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| custom\_emails | string | | A lista de e-mails personalizados. Este valor pode ser nulo ou vazio, caso em que este atributo será ignorado. |
| send\_to\_subscription\_administrator | boolean | Escolhas:
- false
(default)
- true | Um valor que indica se enviar e-mail ao administrador de assinatura. |
| send\_to\_subscription\_co\_administrators | boolean | Escolhas:
- false
(default)
- true | Um valor que indica se enviar e-mail para coadministradores de assinatura. |
| webhooks | string | | A lista de uri do serviço de notificações de webhook. |
### Subcampos da opção profiles
| **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** |
| --------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| count - *required* | string | | Número de instâncias que serão definidas se as métricas não estiverem disponíveis para avaliação. O padrão é usado apenas se a contagem de instâncias atual for inferior ao padrão. |
| fixed\_date\_end | string | | Término de data e hora específico para o perfil. Este elemento não é usado se o elemento de recorrência for usado. |
| fixed\_date\_start | string | | Início de data e hora específico para o perfil. Este elemento não é usado se o elemento de recorrência for usado. |
| fixed\_date\_timezone | string | | Fuso horário de data e hora específico para o perfil. Este elemento não é usado se o elemento de recorrência for usado. |
| max\_count | string | | Número máximo de instâncias para o recurso. O número máximo real de instâncias é limitado pelos núcleos disponíveis na assinatura. |
| min\_count | string | | Número mínimo de instâncias para o recurso. |
| name - required | string | | Nome do perfil. |
| recurrence\_days | string | | Os dias de repetição em que este perfil começa. Este elemento não é usado se o elemento FixedDate for usado. |
| recurrence\_frequency | string | Escolhas:
- None
(default)
- Second
- Minute
- Hour
- Day
- Week
- Month
- Year | Com que frequência o perfil de programação deve entrar em vigor. Se esse valor for Semana, significa que cada semana terá o mesmo conjunto de perfis. Este elemento não é usado se o elemento FixedDate for usado. |
| recurrence\_hours | string | | As horas de repetição em que este perfil começa. Este elemento não é usado se o elemento FixedDate for usado. |
| recurrence\_mins | string | | Os minutos dos tempos de repetição em que este perfil começa. Este elemento não é usado se o elemento FixedDate for usado. |
| recurrence\_timezone | string | | Fuso horário de tempos de repetição em que este perfil começa. Este elemento não é usado se o elemento FixedDate for usado. |
| rules | string | | A coleção de regras que fornecem os gatilhos e parâmetros para a ação de dimensionamento. No máximo 10 regras podem ser especificadas. |
### Subcampos da subopção rules
| **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** |
| ------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| cooldown | string | | A quantidade de tempo (minutos) de espera desde a última ação de dimensionamento antes que essa ação ocorra. Deve ser entre 1 \~ 10080. |
| direction | string | Escolhas:
- Increase
- Decrease | Se a ação de dimensionamento aumenta ou diminui o número de instâncias. |
| metric\_name - *required* | string | | Nome da métrica que define o que a regra monitora. |
| metric\_resource\_uri | string | | Identificador de recurso do recurso que a regra monitora. |
| operator | string | Escolhas:
- Equals
- NotEquals
- GreaterThan
(default)
- GreaterThanOrEqual
- LessThan
- LessThanOrEqual | Operador que é usado para comparar os dados da métrica e o limite. |
| statistic | string | Escolhas:
- Average
(default)
- Min
- Max
- Sum | Como as métricas de várias instâncias são combinadas. |
| threshold | string | 70
(default) | Limite da métrica que dispara a ação de escala. |
| time\_aggregation | string | Escolhas:
- Average
(default)
- Minimum
- Maximum
- Total
- Count | Como os dados coletados devem ser combinados ao longo do tempo. |
| time\_grain - *required* | string | | A granularidade (minutos) das métricas que a regra monitora. Deve ser um dos valores predefinidos retornados das definições de métrica para a métrica. Deve estar entre 1 \~ 720. |
| time\_window - *required* | string | | O intervalo de tempo (minutos) em que os dados da instância são coletados. Esse valor deve ser maior do que o atraso na coleta de métricas, que pode variar de recurso para recurso. Deve ser entre 5 \~ 720. |
| type | string | Escolhas:
- PercentChangeCount
(default)
- ExactCount
- ChangeCount | Tipo de ação que deve ocorrer quando a regra de escala é disparada. |
| value | string | | Número de instâncias envolvidas na ação de dimensionamento. Este valor deve ser 1 ou maior. |
## Exemplos
```yaml
# Exemplo: Crie uma escala automática
- azure_rm_autoscale:
target: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVmss"
enabled: true
profiles:
- count: '1'
recurrence_days:
- Monday
name: Auto created scale condition
recurrence_timezone: China Standard Time
recurrence_mins:
- '0'
min_count: '1'
max_count: '1'
recurrence_frequency: Week
recurrence_hours:
- '18'
name: scale
resource_group: myResourceGroup
# Exemplo: Crie uma escala automática com perfil complicado
- azure_rm_autoscale:
target: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets
/myVmss"
enabled: true
profiles:
- count: '1'
recurrence_days:
- Monday
name: Auto created scale condition 0
rules:
- Time_aggregation: Average
time_window: 10
direction: Increase
metric_name: Percentage CPU
metric_resource_uri: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtua
lMachineScaleSets/vmss"
value: '1'
threshold: 70
cooldown: 5
time_grain: 1
statistic: Average
operator: GreaterThan
type: ChangeCount
max_count: '1'
recurrence_mins:
- '0'
min_count: '1'
recurrence_timezone: China Standard Time
recurrence_frequency: Week
recurrence_hours:
- '6'
notifications:
- email_admin: True
email_co_admin: False
custom_emails:
- yuwzho@microsoft.com
name: scale
resource_group: myResourceGroup
# Exemplo: Estado atual do recurso
- azure_rm_autoscale:
state: absent
resource_group: myResourceGroup
name: scale
```
## Valores retornados
| **Chave** | **Tipo** | **Retornado quando** | **Descrição** |
| --------- | ---------- | -------------------- | ----------------------- |
| state | dictionary | Sempre | Estado atual do recurso |