CreateScalingGroup - Auto Scaling: Central de Documentação do Alibaba Cloud

Cria um grupo de escalonamento para ajustar automaticamente a capacidade de computação adicionando ou removendo instâncias com base nos requisitos e políticas de negócios.

Descrição da operação

Um grupo de escalonamento é uma coleção de instâncias ECS que compartilham os mesmos cenários comuns.

O número de grupos de escalonamento que você pode criar em uma região depende do seu uso do Auto Scaling. Acesse o Quota Center para verificar a cota para o número total de grupos de escalonamento.

Um grupo de escalonamento não entra em vigor imediatamente após ser criado. Você deve invocar a operação EnableScalingGroup para ativar o grupo de escalonamento antes que ele possa acionar uma atividade de escalonamento e executar regras de escalonamento.

O grupo de escalonamento, as instâncias associadas do Classic Load Balancer (CLB) e as instâncias associadas do ApsaraDB RDS devem residir na mesma região. Para mais informações, consulte Regiões e zonas.

Se você associar instâncias CLB ao grupo de escalonamento, o Auto Scaling adiciona automaticamente as instâncias ECS no grupo de escalonamento aos grupos de servidores de backend das instâncias CLB. Você pode especificar os grupos de servidores aos quais as instâncias ECS são adicionadas. Os seguintes tipos de grupos de servidores são suportados:

Grupo de servidores padrão: contém instâncias ECS que aceitam solicitações de frontend. Se um listener não tiver configurações para um grupo de servidores virtuais ou um grupo de servidores primário/secundário, as solicitações serão encaminhadas para as instâncias ECS no grupo de servidores padrão por padrão.
Grupo de servidores virtuais: usado quando você precisa encaminhar solicitações diferentes para servidores de backend diferentes, ou encaminhar solicitações com base em nomes de domínio e URLs.

Nota

Se você especificar tanto o grupo de servidores padrão quanto vários grupos de servidores virtuais, as instâncias ECS serão adicionadas a todos esses grupos de servidores.

Depois que uma instância é adicionada a um grupo de servidores de backend de uma instância CLB, o peso padrão da instância é 50. A instância CLB deve atender às seguintes condições:

A instância CLB deve estar no estado Active. Você pode chamar a operação DescribeLoadBalancers para visualizar o status da instância CLB.
As verificações de integridade devem estar ativadas para todos os listeners configurados na instância CLB. Caso contrário, a criação do grupo de escalonamento falhará.

Se você associar grupos de servidores do Application Load Balancer (ALB), grupos de servidores do Network Load Balancer (NLB) ou grupos de servidores do Gateway Load Balancer (GWLB) ao grupo de escalonamento, o Auto Scaling adiciona automaticamente as instâncias ECS no grupo de escalonamento como servidores de backend aos grupos de servidores ALB, NLB ou GWLB para processar solicitações de acesso distribuídas pelas instâncias ALB, NLB ou GWLB. Você pode especificar vários grupos de servidores ALB, NLB ou GWLB, mas os grupos de servidores devem pertencer à mesma VPC que o grupo de escalonamento. Para mais informações, consulte AttachAlbServerGroups ou AttachServerGroups.

Se você associar instâncias do ApsaraDB RDS ao grupo de escalonamento, o Auto Scaling adiciona automaticamente os endereços IP internos das instâncias ECS no grupo de escalonamento às listas de permissões das instâncias do ApsaraDB RDS. As instâncias do ApsaraDB RDS devem atender às seguintes condições:

A instância do ApsaraDB RDS deve estar no estado Running. Você pode chamar a operação DescribeDBInstances para visualizar o status da instância do ApsaraDB RDS.
O número de endereços IP na lista de permissões da instância do ApsaraDB RDS não pode exceder o limite superior. Para mais informações, consulte Configurar uma lista de permissões na documentação do ApsaraDB RDS.

Se o parâmetro MultiAZPolicy do grupo de escalonamento estiver definido como COST_OPTIMIZED:

Quando os parâmetros OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity e SpotInstancePools são especificados, o método de alocação de instâncias sob a política de otimização de custos é especificado. Este método de alocação é priorizado durante o scale-out e o scale-in.
Quando o parâmetro OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity ou SpotInstancePools não é especificado, as instâncias são criadas apenas da maneira mais econômica sob a política de otimização de custos. Neste modo, você não pode criar instâncias usando garantias de elasticidade ou reservas de capacidade, e não pode especificar o vSwitch ao qual as interfaces de rede elásticas (ENIs) secundárias pertencem.

Se você configurar tags propagáveis para o grupo de escalonamento, o que significa que Tags.Propagate está definido como true:

As tags no grupo de escalonamento são propagadas apenas para instâncias recém-criadas, não para instâncias que já estão em execução no grupo de escalonamento.
Se você especificar tags de instância na configuração de escalonamento e optar por propagar as tags do grupo de escalonamento para a instância, todas as tags coexistirão.
Se uma tag na configuração de escalonamento e uma tag propagável no grupo de escalonamento tiverem a mesma chave de tag, o valor da tag na configuração de escalonamento terá precedência.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ess:CreateScalingGroup

create

*ScalingGroup.

acs:ess:{#regionId}:{#accountId}:scalinggroup/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ScalingGroupName	string	Não	O nome do grupo de escalonamento. O nome deve ser exclusivo dentro de uma região. O nome deve ter de 2 a 64 caracteres e pode conter dígitos, sublinhados (_), hifens (-) e pontos (.). Deve começar com um dígito, uma letra ou um caractere chinês. Valor padrão: o valor de ScalingGroupId.	scalinggroup****
LaunchTemplateId	string	Não	O ID do modelo de inicialização da instância, que é usado para especificar que o grupo de escalonamento obtém as informações de configuração de inicialização do modelo de inicialização da instância.	lt-m5e3ofjr1zn1aw7****
LaunchTemplateVersion	string	Não	A versão do modelo de inicialização da instância. Valores válidos: Um número de versão específico do modelo. Default: usa sempre a versão padrão do modelo. Latest: usa sempre a versão mais recente do modelo.	Default
InstanceId	string	Não	O ID da instância. Ao criar um grupo de escalonamento, as informações de configuração necessárias são obtidas da instância especificada, e a criação automática de uma configuração de escalonamento é realizada.	i-28wt4****
RegionId	string	Sim	O ID da região do grupo de escalonamento.	cn-qingdao
MinSize	integer	Sim	O número mínimo de instâncias no grupo de escalonamento. Quando o número de instâncias no grupo de escalonamento for menor que o valor de MinSize, o Auto Scaling realiza a criação automática de instâncias. Nota O valor de MinSize deve ser menor ou igual ao valor de MaxSize.	2
MaxSize	integer	Sim	O número máximo de instâncias no grupo de escalonamento. Quando o número de instâncias no grupo de escalonamento for maior que o valor de MaxSize, o Auto Scaling remove instâncias automaticamente. O intervalo de valores de MaxSize depende do seu uso do Auto Scaling. Acesse o Quota Center para verificar a cota para o número máximo de instâncias em um único grupo de escalonamento. Se a cota para o número máximo de instâncias em um único grupo de escalonamento for 2000, o intervalo de valores de MaxSize será de 0 a 2000.	20
DefaultCooldown	integer	Não	O tempo de resfriamento após o término de uma atividade de escalonamento (adição ou remoção de instâncias). Valores válidos: 0 a 86400. Unidade: segundos. Durante o tempo de resfriamento, o grupo de escalonamento não executa outras atividades de escalonamento. Este parâmetro entra em vigor apenas para atividades de escalonamento acionadas por tarefas acionadas por eventos do CloudMonitor. Valor padrão: 300.	300
LoadBalancerIds	string	Não	Os IDs das instâncias do Classic Load Balancer (CLB). O valor pode ser uma matriz JSON que contém vários IDs de instâncias CLB separados por vírgulas (,). O número total de instâncias CLB que podem ser associadas a um único grupo de escalonamento depende do seu uso do Auto Scaling. Acesse o Quota Center para verificar a cota para o número total de instâncias de load balancer que podem ser associadas a um único grupo de escalonamento.	["lb-bp1u7etiogg38yvwz**", "lb-bp168cqrux9ai9l7f", "lb-bp1jv3m9zvj22ufxp**"]
DBInstanceIds	string	Não	Os IDs das instâncias do ApsaraDB RDS. O valor pode ser uma matriz JSON que contém vários IDs de instâncias do ApsaraDB RDS separados por vírgulas (,). O número total de instâncias do ApsaraDB RDS que podem ser associadas a um único grupo de escalonamento depende do seu uso do Auto Scaling. Acesse o Quota Center para verificar a cota para o número total de instâncias do ApsaraDB RDS que podem ser associadas a um único grupo de escalonamento.	["rm-bp142f86de0t7**", "rm-bp18l1z42ar4o", "rm-bp1lqr97h4aqk**"]
RemovalPolicies	array	Não	A política de filtragem da política de scale-in de instâncias. Valores válidos: OldestInstance: remove as instâncias ECS que foram adicionadas ao grupo de escalonamento no ponto mais antigo no tempo. NewestInstance: remove as instâncias ECS que foram adicionadas ao grupo de escalonamento no ponto mais recente no tempo. OldestScalingConfiguration: remove as instâncias ECS que foram criadas com base na configuração de escalonamento mais antiga. CustomPolicy: remove instâncias ECS com base em uma função de política de scale-in personalizada. A configuração de escalonamento mencionada em OldestScalingConfiguration refere-se à fonte de configuração da instância no grupo de escalonamento, incluindo configurações de escalonamento e modelos de inicialização. CustomPolicy só pode ser definido como a primeira política de remoção. Se você especificar CustomPolicy, também deverá especificar o parâmetro CustomPolicyARN. Nota A remoção de instâncias ECS de um grupo de escalonamento também é afetada pela política de escalonamento multizona (MultiAZPolicy) do grupo de escalonamento. Para mais informações, consulte Configurar uma política combinada para remoção de instâncias.
	string	Não	A política de filtragem da política de scale-in de instâncias. Valores válidos: OldestInstance: remove as instâncias ECS que foram adicionadas ao grupo de escalonamento no ponto mais antigo no tempo. NewestInstance: remove as instâncias ECS que foram adicionadas ao grupo de escalonamento no ponto mais recente no tempo. OldestScalingConfiguration: remove as instâncias ECS que foram criadas com base na configuração de escalonamento mais antiga. CustomPolicy: remove instâncias ECS com base em uma função de política de scale-in personalizada. A configuração de escalonamento mencionada em OldestScalingConfiguration refere-se à fonte de configuração da instância no grupo de escalonamento, incluindo configurações de escalonamento e modelos de inicialização. CustomPolicy só pode ser definido como a primeira política de remoção. Se você especificar CustomPolicy, também deverá especificar o parâmetro CustomPolicyARN. Nota A remoção de instâncias ECS de um grupo de escalonamento também é afetada pela política de escalonamento multizona (MultiAZPolicy) do grupo de escalonamento. Para mais informações, consulte Configurar uma política combinada para remoção de instâncias.	OldestScalingConfiguration
VSwitchId	string	Não	O ID do vSwitch. Após a especificação deste parâmetro, o tipo de rede do grupo de escalonamento será VPC. Nota Se nem o parâmetro VSwitchId nem o parâmetro VSwitchIds for especificado para o grupo de escalonamento, o tipo de rede do grupo de escalonamento será a rede clássica por padrão.	vsw-bp14zolna43z266bq****
MultiAZPolicy	string	Não	A política de escalonamento multizona para instâncias ECS no grupo de escalonamento. Valores válidos: PRIORITY: os vSwitches especificados por VSwitchIds são priorizados. O Auto Scaling tenta prioritariamente escalonar instâncias na zona onde reside o vSwitch de maior prioridade. Se o escalonamento falhar, o Auto Scaling tenta automaticamente escalonar instâncias na zona onde reside o próximo vSwitch de maior prioridade. COST_OPTIMIZED: durante o scale-out, o Auto Scaling tenta criar instâncias ECS em ordem crescente de preço unitário de vCPU. Durante o scale-in, o Auto Scaling tenta remover instâncias ECS em ordem decrescente de preço unitário de vCPU. Se a configuração de escalonamento tiver configurações para vários tipos de instância que usam o método de faturamento spot, as instâncias spot serão criadas preferencialmente. Você pode usar o parâmetro CompensateWithOnDemand para especificar se deve tentar criar automaticamente instâncias pay-as-you-go quando instâncias spot não puderem ser criadas devido a estoque insuficiente ou outros motivos. Nota COST_OPTIMIZED entra em vigor apenas quando a configuração de escalonamento especifica vários tipos de instância ou usa instâncias spot. BALANCE: aloca instâncias ECS uniformemente entre as múltiplas zonas especificadas para o grupo de escalonamento. Se a distribuição ficar desequilibrada entre as zonas devido a estoque insuficiente ou outros motivos, você pode invocar a operação RebalanceInstance para equilibrar os recursos. Nota Se o parâmetro MultiAZPolicy estiver definido como BALANCE, o efeito será o mesmo de quando o parâmetro MultiAZPolicy está definido como COMPOSABLE e o parâmetro AzBalance está definido como true. COMPOSABLE: um padrão combinado que permite combinar as políticas de escalonamento multizona anteriores para instâncias ECS conforme necessário. Você também pode especificar parâmetros adicionais para controlar a capacidade do grupo de escalonamento de maneira mais granular. Valor padrão: PRIORITY.	PRIORITY
HealthCheckType	string	Não	O padrão de verificação de integridade do grupo de escalonamento. Valores válidos: NONE: desativa as verificações de integridade. ECS: realiza verificações de integridade nas instâncias no grupo de escalonamento. Este valor é usado para ativar verificações de integridade de instância para grupos de escalonamento ECS e ECI. LOAD_BALANCER: determina o status de integridade das instâncias com base nos resultados da verificação de integridade do load balancer. O CLB não é suportado. Valor padrão: ECS. Nota Para ativar tanto as verificações de integridade da instância quanto as verificações de integridade do load balancer, use o parâmetro HealthCheckTypes.	ECS
ScalingPolicy	string	Não	O padrão de revogação do grupo de escalonamento. Valores válidos: recycle: define o padrão de revogação do grupo de escalonamento como o padrão de desligamento e revogação. release: define o padrão de revogação do grupo de escalonamento como o padrão de liberação. forcerelease: define o padrão de revogação do grupo de escalonamento como o padrão de liberação forçada. Nota Se você selecionar forcerelease, o sistema libera forçadamente as instâncias no estado Running durante as atividades de scale-in. Liberar forçadamente uma instância é equivalente a uma operação de desligamento, que apaga dados temporários na memória e no armazenamento da instância. Os dados não podem ser recuperados. Prossiga com cautela. forcerecycle: define o padrão de revogação do grupo de escalonamento como o padrão de desligamento e revogação forçados. Nota Se você selecionar forcerecycle, o sistema desliga forçadamente as instâncias no estado Running durante as atividades de scale-in. Desligar forçadamente uma instância é equivalente a uma operação de desligamento, que apaga dados temporários na memória e no armazenamento da instância. Os dados não podem ser recuperados. Prossiga com cautela. O parâmetro ScalingPolicy especifica o padrão de revogação do grupo de escalonamento, mas a ação específica executada quando uma instância é removida do grupo de escalonamento é determinada pelo parâmetro RemovePolicy de RemoveInstances. Para mais informações, consulte RemoveInstances.	recycle
ClientToken	string	Não	O token do cliente que é usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que ele seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Garantir idempotência.	123e4567-e89b-12d3-a456-42665544****
OnDemandBaseCapacity	integer	Não	O número mínimo de instâncias pay-as-you-go necessárias no grupo de escalonamento. Valores válidos: 0 a 1000. Quando o número de instâncias pay-as-you-go for menor que este valor, as instâncias pay-as-you-go serão criadas preferencialmente.	30
OnDemandPercentageAboveBaseCapacity	integer	Não	A porcentagem de instâncias pay-as-you-go entre as instâncias extras que excedem o número mínimo de instâncias pay-as-you-go (OnDemandBaseCapacity) necessárias no grupo de escalonamento. Valores válidos: 0 a 100.	20
SpotInstanceRemedy	boolean	Não	Especifica se deve ativar a política do Auto Scaling para complementar instâncias spot. Após a ativação deste recurso, quando uma mensagem do sistema indicando que uma instância spot será revogada for recebida, o grupo de escalonamento tenta criar uma nova instância para substituir a instância spot a ser revogada.	true
CompensateWithOnDemand	boolean	Não	Especifica se deve tentar criar automaticamente instâncias pay-as-you-go para atender ao número necessário de instâncias ECS quando o parâmetro MultiAZPolicy estiver definido como COST_OPTIMIZED e instâncias spot suficientes não puderem ser criadas devido a restrições de preço ou estoque. Valores válidos: true: permite a criação. false: não permite a criação. Valor padrão: true.	true
SpotInstancePools	integer	Não	O número de tipos de instância disponíveis. O grupo de escalonamento cria instâncias spot uniformemente entre vários tipos de instância com o menor custo. Valores válidos: 1 a 10.	5
DesiredCapacity	integer	Não	O número esperado de instâncias no grupo de escalonamento. O grupo de escalonamento mantém automaticamente o número de instâncias no número esperado. O valor não pode ser maior que MaxSize ou menor que MinSize.	5
GroupDeletionProtection	boolean	Não	Especifica se deve ativar a proteção contra exclusão para o grupo de escalonamento. Valores válidos: true: ativa a proteção contra exclusão para o grupo de escalonamento. Neste caso, o grupo de escalonamento não pode ser excluído. false: desativa a proteção contra exclusão para o grupo de escalonamento. Valor padrão: false.	true
GroupType	string	Não	O tipo de instâncias gerenciadas pelo grupo de escalonamento. Valores válidos: ECS: o grupo de escalonamento gerencia instâncias ECS. ECI: o grupo de escalonamento gerencia instâncias ECI. Valor padrão: ECS.	ECS
ContainerGroupId	string	Não	O ID da instância do ECI, que é o ID do grupo de contêineres.	eci-uf6fonnghi50u374****
VSwitchIds	array	Não	Os IDs de um ou mais vSwitches. Se você usar o parâmetro VSwitchIds, o parâmetro VSwitchId será ignorado. Após a especificação deste parâmetro, o tipo de rede do grupo de escalonamento será VPC. Ao especificar vários vSwitches: Os vSwitches devem pertencer à mesma VPC. Os vSwitches podem pertencer a zonas diferentes. Os vSwitches são priorizados em ordem crescente de números, onde 1 indica a prioridade mais alta. Se as instâncias não puderem ser criadas na zona onde reside um vSwitch de maior prioridade, o sistema seleciona automaticamente o próximo vSwitch de maior prioridade para criar instâncias. Nota Se nem o parâmetro VSwitchId nem o parâmetro VSwitchIds for especificado para o grupo de escalonamento, o tipo de rede do grupo de escalonamento será a rede clássica por padrão.
	string	Não	Os IDs de um ou mais vSwitches. Se você usar o parâmetro VSwitchIds, o parâmetro VSwitchId será ignorado. Após a especificação deste parâmetro, o tipo de rede do grupo de escalonamento será VPC. Ao especificar vários vSwitches: Os vSwitches devem pertencer à mesma VPC. Os vSwitches podem pertencer a zonas diferentes. Os vSwitches são priorizados em ordem crescente de números, onde 1 indica a prioridade mais alta. Se as instâncias não puderem ser criadas na zona onde reside um vSwitch de maior prioridade, o sistema seleciona automaticamente o próximo vSwitch de maior prioridade para criar instâncias. Nota Se nem o parâmetro VSwitchId nem o parâmetro VSwitchIds for especificado para o grupo de escalonamento, o tipo de rede do grupo de escalonamento será a rede clássica por padrão.	vsw-bp14zolna43z266bq****
LifecycleHooks	array<object>	Não	A lista de informações dos hooks de ciclo de vida.
	object	Não	A lista de informações dos hooks de ciclo de vida.
DefaultResult	string	Não	A próxima ação a ser executada após o término do estado de espera. Valores válidos: CONTINUE: continua a resposta à atividade de scale-out ou scale-in. ABANDON: libera diretamente as instâncias criadas pela atividade de scale-out ou remove diretamente as instâncias na atividade de scale-in do grupo de escalonamento. Quando uma atividade de scale-in (SCALE_IN) ocorre no grupo de escalonamento e vários hooks de ciclo de vida são acionados, os estados de espera acionados por outros hooks de ciclo de vida terminam antecipadamente quando o estado de espera acionado pelo hook de ciclo de vida cujo DefaultResult está definido como ABANDON termina. Em outros casos, a próxima ação está sujeita à próxima ação do último estado de espera que termina. Valor padrão: CONTINUE.	CONTINUE
LifecycleHookName	string	Não	O nome do hook de ciclo de vida. O nome não pode ser modificado após ser especificado. Se você não especificar este parâmetro, o valor padrão será o mesmo que o ID do hook de ciclo de vida.	lifecyclehook****
LifecycleTransition	string	Não	O tipo de atividade de escalonamento à qual o hook de ciclo de vida se aplica. Valores válidos: SCALE_OUT: atividades de scale-out do grupo de escalonamento. SCALE_IN: atividades de scale-in do grupo de escalonamento. Nota Se você especificar um hook de ciclo de vida para o grupo de escalonamento, este parâmetro é obrigatório e outros parâmetros relacionados são opcionais.	SCALE_OUT
NotificationMetadata	string	Não	As informações de string fixa para o estado de espera da atividade de escalonamento. O valor pode ter até 4.096 caracteres. Cada vez que o Auto Scaling envia uma mensagem para o destinatário da notificação, ele também envia o valor predefinido do parâmetro NotificationMetadata para ajudar você a gerenciar e marcar diferentes tipos de mensagens de notificação. O parâmetro NotificationMetadata entra em vigor apenas quando você também especifica o parâmetro NotificationArn.	Test
NotificationArn	string	Não	A identidade do destinatário da notificação para o hook de ciclo de vida. Filas ou tópicos do Simple Message Queue (anteriormente MNS) são suportados. O formato do valor do parâmetro é acs:ess:{region}:{account-id}:{resource-relative-id}. region: a região onde o grupo de escalonamento reside. account-id: o ID da conta Alibaba Cloud. Exemplos: Fila MSMQ: acs:ess:{region}:{account-id}:queue/{queuename}. Tópico MSMQ: acs:ess:{region}:{account-id}:topic/{topicname}.	acs:ess:cn-hangzhou:1111111111:queue/queue2
HeartbeatTimeout	integer	Não	O tempo de espera configurado pelo hook de ciclo de vida para a atividade do grupo de escalonamento. Após o tempo limite do estado de espera, a próxima ação é executada. Valores válidos: 30 a 21600. Unidade: segundos. Depois de criar um hook de ciclo de vida, você pode chamar RecordLifecycleActionHeartbeat para estender o tempo de espera da instância, ou chamar CompleteLifecycleAction para encerrar o estado de espera da atividade de escalonamento antecipadamente. Valor padrão: 600.	600
VServerGroups	array<object>	Não	A coleção de informações sobre os grupos de servidores virtuais associados ao grupo de escalonamento.
	array<object>	Não	A coleção de informações sobre os grupos de servidores virtuais associados ao grupo de escalonamento.
VServerGroupAttributes	array<object>	Não	Os atributos do grupo de servidores de backend.
	object	Não	Os atributos do grupo de servidores de backend.
VServerGroupId	string	Não	O ID do grupo de servidores virtuais.	rsp-bp1443g77****
Weight	integer	Não	O peso da instância como um servidor de backend após o Auto Scaling adicionar a instância ao grupo de servidores virtuais. Um peso maior indica que mais solicitações de acesso são alocadas para a instância. Se o peso for 0, a instância não recebe solicitações de acesso. Valores válidos: 0 a 100. Valor padrão: 50.	100
Port	integer	Não	O número da porta usado pela instância após o Auto Scaling adicionar a instância ao grupo de servidores virtuais. Valores válidos: 1 a 65535.	22
LoadBalancerId	string	Não	O ID da instância do Classic Load Balancer (CLB) à qual o grupo de servidores virtuais pertence.	lb-bp1u7etiogg38yvwz****
Tags	array<object>	Não	A coleção de informações de tags para o grupo de escalonamento.
	object	Não	A coleção de informações de tags para o grupo de escalonamento.
Key	string	Não	A chave da tag do grupo de escalonamento.	Department
Value	string	Não	O valor da tag do grupo de escalonamento.	Finance
Propagate	boolean	Não	Especifica se a tag é uma tag propagável. Valores válidos: true: as tags no grupo de escalonamento são propagadas apenas para instâncias recém-criadas, não para instâncias que já estão em execução no grupo de escalonamento. false: as tags no grupo de escalonamento não são propagadas para as instâncias. Valor padrão: false.	false
LaunchTemplateOverrides	array<object>	Não	As informações do tipo de instância que estendem o modelo de inicialização.
	object	Não	As informações do tipo de instância que estendem o modelo de inicialização.
InstanceType	string	Não	Quando você precisar que o grupo de escalonamento escale com base na capacidade do tipo de instância, especifique tanto este parâmetro quanto LaunchTemplateOverrides.WeightedCapacity. Este parâmetro é usado para especificar o tipo de instância, que substitui o tipo de instância no modelo de inicialização. Nota Este parâmetro entra em vigor apenas quando o parâmetro LaunchTemplateId especifica um modelo de inicialização. Valores válidos de InstanceType: tipos de instância ECS disponíveis.	ecs.c5.xlarge
WeightedCapacity	integer	Não	Quando você precisar que o grupo de escalonamento escale com base na capacidade do tipo de instância, especifique este parâmetro após especificar LaunchTemplateOverrides.InstanceType. Este parâmetro é usado para especificar o peso do tipo de instância, que indica a capacidade representada por uma única instância do tipo de instância no grupo de escalonamento. Um peso maior indica que menos instâncias deste tipo de instância são necessárias para atender à capacidade esperada. Como métricas de desempenho, como o número de vCPUs e o tamanho da memória, variam entre os tipos de instância, você pode configurar pesos diferentes para diferentes tipos de instância com base em seus requisitos. Exemplo: Capacidade atual: 0. Capacidade esperada: 6. Capacidade do tipo de instância ecs.c5.xlarge: 4. Para atender à capacidade esperada, o grupo de escalonamento escala duas instâncias ecs.c5.xlarge para você. Nota Durante o scale-out, a capacidade do grupo de escalonamento não pode exceder a soma da capacidade máxima (MaxSize) e o peso máximo do tipo de instância. Valores válidos de WeightedCapacity: 1 a 500.	4
SpotPriceLimit	number	Não	Este parâmetro é usado para especificar o preço máximo de lance para o tipo de instância que substitui o modelo de inicialização (ou seja, LaunchTemplateOverride.InstanceType). Nota Este parâmetro entra em vigor apenas quando o parâmetro LaunchTemplateId especifica um modelo de inicialização.	0.025
AlbServerGroups	array<object>	Não	As informações sobre os grupos de servidores ALB.
	object	Não	As informações sobre os grupos de servidores ALB.
AlbServerGroupId	string	Não	O ID do grupo de servidores ALB. Um grupo de escalonamento suporta um número limitado de grupos de servidores ALB associados. Para visualizar ou solicitar manualmente um aumento de cota, acesse o Centro de Cotas.	sgp-ddwb0y0g6y9bjm****
Weight	integer	Não	O peso da instância como servidor de backend após o Auto Scaling adicionar a instância ao grupo de servidores ALB. Um peso maior indica que mais solicitações de acesso são distribuídas para a instância. Se o peso for 0, a instância não recebe solicitações de acesso. Valores válidos: 0 a 100.	100
Port	integer	Não	O número da porta usada pela instância após o Auto Scaling adicionar a instância ao grupo de servidores ALB. Valores válidos: 1 a 65535.	22
ServerGroups	array<object>	Não	As informações sobre os grupos de servidores do load balancer. Nota Você não pode especificar as mesmas configurações de grupo de servidores em AlbServerGroups e ServerGroups ao mesmo tempo.
	object	Não	As informações sobre os grupos de servidores do load balancer.
ServerGroupId	string	Não	O ID do grupo de servidores.	sgp-5yc3bd9lfyh*****
Type	string	Não	O tipo do grupo de servidores. Valores válidos: ALB: Application Load Balancer (ALB). NLB: Network Load Balancer (NLB). GWLB: Gateway Load Balancer (GWLB).	ALB
Weight	integer	Não	O peso da instância como servidor de backend após o Auto Scaling adicionar a instância ao grupo de servidores. Valores válidos: 0 a 100. Um peso maior indica que mais solicitações de acesso são alocadas para a instância. Se o peso for 0, a instância não recebe solicitações de acesso. Nota Este parâmetro é obrigatório para load balancers ALB e NLB. Você não pode configurar este parâmetro para load balancers GWLB.	100
Port	integer	Não	O número da porta usada pela instância após o Auto Scaling adicionar a instância ao grupo de servidores. Valores válidos: 1 a 65535.	22
AzBalance	boolean	Não	Especifica se a capacidade do grupo de escalonamento é distribuída uniformemente entre várias zonas. Este parâmetro só entra em vigor quando o parâmetro `MultiAZPolicy` é definido como `COMPOSABLE`. Valores válidos: true: A capacidade do grupo de escalonamento é distribuída uniformemente entre várias zonas. false: A capacidade do grupo de escalonamento não é distribuída uniformemente entre várias zonas. Nota Se o parâmetro `MultiAZPolicy` for definido como `COMPOSABLE` e o parâmetro `AzBalance` for definido como `true`, o efeito será o mesmo que definir o parâmetro `MultiAZPolicy` como `BALANCE`. Valor padrão: false.	false
AllocationStrategy	string	Não	A política de alocação de capacidade, que determina como o grupo de escalonamento seleciona os tipos de instância disponíveis para atender aos requisitos de capacidade. A política de distribuição de capacidade se aplica às capacidades pay-as-you-go e spot. Este parâmetro só entra em vigor quando o parâmetro `MultiAZPolicy` é definido como `COMPOSABLE`. Valores válidos: priority: cria instâncias com base na ordem dos tipos de instância configurados. lowestPrice: cria instâncias com base no preço unitário por vCPU dos tipos de instância em ordem crescente. Valor padrão: priority.	priority
SpotAllocationStrategy	string	Não	A política de distribuição de capacidade spot. Você pode usar este parâmetro para especificar separadamente a política de distribuição para a capacidade spot. Este parâmetro só entra em vigor quando o parâmetro `MultiAZPolicy` é definido como `COMPOSABLE`. Valores válidos: priority: cria instâncias com base na ordem dos tipos de instância configurados. lowestPrice: cria instâncias com base no preço unitário por vCPU dos tipos de instância em ordem crescente. Valor padrão: priority.	lowestPrice
SyncAlarmRuleToCms	boolean	Não	Nota Este parâmetro não está disponível.	false
MaxInstanceLifetime	integer	Não	O tempo de vida máximo de uma instância no grupo de escalonamento. Unidade: segundos. Valores válidos: 86400 a Integer.maxValue. Valor padrão: null.	86400
CustomPolicyARN	string	Não	O ARN da função para a política de scale-in personalizada. Este parâmetro só entra em vigor quando a primeira política de remoção em RemovalPolicies é definida como CustomPolicy.	acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_policy.LATEST/functions/ess_custom_terminate_policy_name
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o grupo de escalonamento recém-criado pertence. Nota Este parâmetro especifica o grupo de recursos para o grupo de escalonamento recém-criado. Se você não especificar este parâmetro, o grupo de escalonamento pertencerá ao grupo de recursos padrão.	rg-123******
LoadBalancerConfigs	array<object>	Não	A lista de configurações do load balancer.
	object	Não	A lista de configurações do CLB (anteriormente SLB).
LoadBalancerId	string	Não	O ID da instância CLB (anteriormente SLB).	lb-2zen1olhfg9yw3f4q****
Weight	integer	Não	O peso da instância como servidor de backend após o Auto Scaling adicionar a instância ao grupo de servidores CLB. Um peso maior indica que mais solicitações de acesso são distribuídas para a instância. Se o peso for 0, a instância não recebe solicitações de acesso. Valores válidos: 0 a 100.	10
HealthCheckTypes	array	Não	Os modos de verificação de integridade do grupo de escalonamento. Nota Você pode especificar vários valores para este parâmetro para ativar várias opções de verificação de integridade. Se o parâmetro `HealthCheckType` for especificado, este parâmetro será ignorado.
	string	Não	Os modos de verificação de integridade do grupo de escalonamento. Valores válidos: NONE: Nenhuma verificação de integridade é realizada. ECS: As verificações de integridade são realizadas nas instâncias no grupo de escalonamento. Os grupos de escalonamento ECS e ECI usam este valor para ativar as verificações de integridade da instância. LOAD_BALANCER: O status de integridade das instâncias é determinado com base nos resultados da verificação de integridade do load balancer (o CLB não é suportado no momento). Valor padrão: ECS.	ECS
DBInstances	array<object>	Não	A lista de bancos de dados associados ao grupo de escalonamento.
	object	Não	As informações de configuração do banco de dados associado ao grupo de escalonamento.
DBInstanceId	string	Não	O ID da instância de banco de dados.	rm-m5eqju85s45mu0***
Type	string	Não	O tipo do banco de dados. Valores válidos: RDS Redis MongoDB Valor padrão: RDS.	RDS
AttachMode	string	Não	O modo de associação entre o grupo de escalonamento e o banco de dados. Valores válidos: SecurityIp: Modo de lista de permissões de IP. As instâncias de scale-out são adicionadas automaticamente à lista de permissões de IP do banco de dados. Apenas os bancos de dados ApsaraDB RDS suportam este modo. SecurityGroup: Modo de grupo de segurança. O grupo de segurança da configuração de escalonamento é adicionado à lista de permissões de grupo de segurança do banco de dados para permitir que as instâncias no grupo de segurança acessem o banco de dados.	SecurityIp
StopInstanceTimeout	integer	Não	O período de tempo limite para aguardar a parada de uma instância ECS durante um processo de scale-in. Unidade: segundos. Valores válidos: 30 a 240. Nota Este parâmetro só entra em vigor durante um processo de scale-in quando ScalingPolicy é definido como release. Se este parâmetro for especificado, o sistema aguardará no máximo o período StopInstanceTimeout para que a instância pare. Após o término do período de tempo limite, o processo de scale-in continua independentemente de a instância ter parado ou não. Se este parâmetro não for especificado, o sistema aguardará por um longo período para que a instância pare. O processo de scale-in continua somente após a instância parar. Se a instância não conseguir parar, o processo de scale-in será revertido e o scale-in falhará.	60
CapacityOptions	object	Não	As opções de capacidade.
OnDemandBaseCapacity	integer	Não	O número mínimo de instâncias pay-as-you-go necessárias no grupo de escalonamento. Quando o número de instâncias pay-as-you-go no grupo de escalonamento for menor que este valor, o sistema criará instâncias pay-as-you-go prioritariamente. Valores válidos: 0 a 1000. Quando o parâmetro `MultiAZPolicy` é definido como `COMPOSABLE`, o valor padrão é 0.	30
OnDemandPercentageAboveBaseCapacity	integer	Não	A porcentagem de instâncias pay-as-you-go entre as instâncias excedentes após o grupo de escalonamento atender ao número mínimo de instâncias pay-as-you-go especificado por `OnDemandBaseCapacity`. Valores válidos: 0 a 100. Quando o parâmetro `MultiAZPolicy` é definido como `COMPOSABLE`, o valor padrão é 100.	20
CompensateWithOnDemand	boolean	Não	Especifica se devem ser criadas automaticamente instâncias pay-as-you-go para atender ao número necessário de instâncias ECS quando o parâmetro `MultiAZPolicy` é definido como `COST_OPTIMIZED` e não é possível criar instâncias spot suficientes devido a motivos de preço ou estoque. Valores válidos: true: Permitido. false: Não permitido. Valor padrão: true.	true
SpotAutoReplaceOnDemand	boolean	Não	Especifica se devem ser usadas instâncias spot para substituir a capacidade pay-as-you-go quando `CompensateWithOnDemand` está ativado e a proporção de instâncias pay-as-you-go excede o valor de `OnDemandPercentageAboveBaseCapacity`. Em cenários comuns em que `CompensateWithOnDemand` rebaixa instâncias spot para instâncias pay-as-you-go devido a motivos de estoque ou preço de instâncias spot, este parâmetro tenta usar instâncias spot para substituir a capacidade pay-as-you-go excedente para evitar a retenção de longo prazo de instâncias pay-as-you-go. Valores válidos: true: Permitido. false: Não permitido. Valor padrão: false.	false
PriceComparisonMode	string	Não	O modo de comparação de preços para a política de otimização de custos do grupo de escalonamento. Valores válidos: PricePerUnit: compara preços com base no preço por unidade de capacidade. A capacidade de uma instância no grupo de escalonamento é igual ao peso definido para o tipo de instância. O peso padrão é 1, o que significa que uma instância ECS ocupa uma unidade de capacidade. PricePerVCpu: compara preços com base no preço por vCPU. Valor padrão: PricePerUnit.	PricePerUnit
BalanceMode	string	Não	O modo de balanceamento de zona. Este parâmetro só entra em vigor quando o modo de balanceamento de zona está ativado. Valores válidos: BalancedBestEffort: Quando a criação de recursos falha em uma zona, o sistema recorre a outras zonas para garantir a entrega de recursos com melhor esforço. BalancedOnly: Quando a criação de recursos falha em uma zona, o sistema não recorre a outras zonas. A atividade de scale-out é parcialmente bem-sucedida para evitar um desequilíbrio excessivo de recursos entre as zonas. Valor padrão: BalancedBestEffort.	BalancedBestEffort
AutoRebalance	boolean	Não	Especifica se o balanceamento automático deve ser ativado para o grupo de escalonamento. Este parâmetro só entra em vigor quando BalancedOnly está ativado para o balanceamento de zona. Valores válidos: false: O balanceamento automático está desativado. true: O balanceamento automático está ativado. O grupo de escalonamento detecta automaticamente a capacidade entre as zonas. Quando a capacidade está desequilibrada, o grupo de escalonamento realiza proativamente scale-out ou scale-in para rebalancear a capacidade entre as zonas. Valor padrão: false.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
ScalingGroupId	string	O ID do grupo de escalonamento.	asg-bp14wlu85wrpchm0****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingGroupId": "asg-bp14wlu85wrpchm0****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
404	ResourceNotAvailable.VPCNetwork	The specified zone does not support vpc network or sold out.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.