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

Aciona o escalonamento elástico com base em uma regra de ajuste especificada.

Descrição da operação

Antes de chamar esta operação, certifique-se de que as seguintes condições sejam atendidas:
- O grupo de escalonamento está no estado Active.
- Nenhuma atividade de escalonamento está em andamento no grupo de escalonamento.
Se nenhuma atividade de escalonamento estiver em andamento no grupo de escalonamento, esta operação pode ignorar o tempo de cooldown e acionar diretamente uma atividade de escalonamento.
Se o número de instâncias ECS a serem adicionadas com base na regra de escalonamento mais o número atual de instâncias no grupo de escalonamento (Total Capacity) for maior que o número máximo de instâncias (MaxSize), a atividade de escalonamento será executada com Total Capacity definido como MaxSize.
Se o número atual de instâncias no grupo de escalonamento (Total Capacity) menos o número de instâncias ECS a serem removidas com base na regra de escalonamento for menor que o número mínimo de instâncias (MinSize), a atividade de escalonamento será executada com Total Capacity definido como MinSize.

Uma resposta bem-sucedida indica apenas que o Auto Scaling aceitou a solicitação e pode executar a atividade de escalonamento. Isso não significa que a atividade de escalonamento será bem-sucedida. Você pode verificar o status de execução da atividade de escalonamento com base no ScalingActivityId retornado.

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:ScaleWithAdjustment

update

*ScalingGroup

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ScalingGroupId	string	Sim	O ID do grupo de escalonamento.	asg-j6c1o397427hyjdc****
AdjustmentType	string	Sim	O método de ajuste da atividade de escalonamento. Valores válidos: QuantityChangeInCapacity: adiciona ou remove um número especificado de instâncias ECS. PercentChangeInCapacity: adiciona ou remove uma porcentagem especificada de instâncias ECS. TotalCapacity: ajusta o número de instâncias ECS no grupo de escalonamento atual para um valor especificado.	QuantityChangeInCapacity
AdjustmentValue	integer	Sim	O valor de ajuste da atividade de escalonamento. O número de instâncias ECS ajustadas em uma única atividade de escalonamento não pode exceder 1000. Caso contrário, o ajuste falhará. Valores válidos para diferentes métodos de ajuste: QuantityChangeInCapacity: -1000 a 1000. PercentChangeInCapacity: -100 a 10000. TotalCapacity: 0 a 2000.	100
MinAdjustmentMagnitude	integer	Não	O número mínimo de instâncias a ajustar em uma atividade de escalonamento. Este parâmetro entra em vigor somente quando `AdjustmentType` está definido como `PercentChangeInCapacity`.	1
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação e evitar envios repetidos. O valor é gerado pelo cliente e deve ser único entre diferentes solicitações. O valor pode ter até 64 caracteres ASCII e não pode conter caracteres não ASCII.	123e4567-e89b-12d3-a456-42665544****
SyncActivity	boolean	Não	Especifica se a atividade de escalonamento deve ser executada de forma síncrona. Este parâmetro é válido apenas para grupos de escalonamento que possuem o número esperado de instâncias configurado. Valores válidos: true: execução síncrona. A regra de escalonamento aciona diretamente a atividade de escalonamento do grupo de escalonamento. false: execução assíncrona. Quando o número esperado de instâncias no grupo de escalonamento é modificado, a atividade de escalonamento não é acionada imediatamente. O sistema aguarda até detectar uma diferença entre o número esperado de instâncias e o número atual de instâncias no grupo de escalonamento e, em seguida, aciona a atividade de escalonamento. Nota Para mais informações sobre o número esperado de instâncias, consulte Número esperado de instâncias. Valor padrão: false.	false
Overrides	object	Não	Os parâmetros de substituição para scale-out em grupos de escalonamento do tipo ECI.
Cpu	number	Não	O número de vCPUs no nível da instância. Unidade: cores.	2
Memory	number	Não	O tamanho da memória no nível da instância. Unidade: GiB.	4
UserData	string	Não
ContainerOverride	array<object>	Não	Os parâmetros de substituição para a lista de contêineres.
	array<object>	Não	Os parâmetros de substituição para a lista de contêineres.
Command	array	Não	Os comandos de inicialização do contêiner. Um máximo de 20 comandos é suportado. Cada comando pode conter até 256 caracteres.
	string	Não	Os comandos de inicialização do contêiner. Um máximo de 20 comandos é suportado. Cada comando pode conter até 256 caracteres.	sleep
Memory	number	Não	O tamanho da memória do contêiner. Unidade: GiB.	4
Arg	array	Não	Os argumentos para os comandos de inicialização do contêiner. Um máximo de 10 argumentos é suportado.
	string	Não	Os argumentos para os comandos de inicialização do contêiner. Um máximo de 10 argumentos é suportado.	arg
Cpu	number	Não	O número de vCPUs do contêiner. Unidade: cores.	2
EnvironmentVar	array<object>	Não	A lista de informações de variáveis de ambiente.
	object	Não	A lista de informações de variáveis de ambiente.
Value	string	Não	The value of the environment variable. The value can be 0 to 256 characters in length.	/usr/local/tomcat
Key	string	Não	The name of the environment variable. The name must be 1 to 128 characters in length. The name must match the format `[0-9a-zA-Z]` and can contain underscores (_). It cannot start with a digit.	PATH
Name	string	Não	O nome do contêiner. Se você deseja substituir os parâmetros do contêiner, deve especificar o nome do contêiner. Os parâmetros do contêiner podem ser substituídos somente quando o nome do contêiner corresponde ao nome do contêiner na configuração de escalonamento.	container-1
LifecycleHookContext	object	Não	As informações de contexto do lifecycle hook.
DisableLifecycleHook	boolean	Não	Especifica se todos os recursos de lifecycle hook devem ser desativados para a atividade de escalonamento. Valores válidos: true: desativado. false: não desativado.	false
IgnoredLifecycleHookIds	array	Não	A lista de IDs de lifecycle hook a serem desativados para a atividade de escalonamento.
	string	Não	A lista de IDs de lifecycle hook a serem desativados para a atividade de escalonamento.	ash-bp14zolna43z266bq***
LifecycleHookResult	string	Não
ActivityMetadata	string	Não	Os metadados da atividade de escalonamento.	{"key":"value"}
ExecutionMode	string	Não	O modo de execução. Valores válidos: None: não especificado. O escalonamento normal é executado. PlanOnly: o escalonamento não é acionado. Apenas o planejamento elástico é executado, e os resultados do planejamento são retornados em PlanResult, incluindo tipo de instância, ID da zona, método de cobrança e o número de instâncias a serem criadas. Valor padrão: None.	PlanOnly

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta para acionar o escalonamento elástico com base em uma regra de ajuste especificada.
ScalingActivityId	string	O ID da atividade de escalonamento.	asa-bp175o6f6ego3r2j****
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
ActivityType	string	O tipo da atividade de escalonamento. Se `ActivityType` estiver definido como `CapacityChange`, a atividade de escalonamento correspondente ao `ScalingActivityId` retornado apenas modifica o número esperado de instâncias no grupo de escalonamento sem executar o escalonamento imediatamente. Escopo aplicável: grupos de escalonamento com o número esperado de instâncias configurado.	CapacityChange
PlanResult	object	Os resultados do planejamento elástico retornados quando ExecutionMode está definido como PlanOnly.
ResourceAllocations	array<object>	As informações de alocação de recursos nos resultados do planejamento elástico.
	object
ZoneId	string	The zone ID.	cn-beijing-g
InstanceType	string	The instance type.	ecs.u1-c1m8.large
SpotStrategy	string	The preemption policy of the instance. Valid values: NoSpot: a pay-as-you-go instance. SpotWithPriceLimit: a spot instance with a maximum price limit. SpotAsPriceGo: a spot instance priced at the market price at the time of purchase.	NoSpot
Amount	integer	The number of instances.	1
InstanceChargeType	string	The billing method. Valid values: Prepaid: subscription. Postpaid: pay-as-you-go.	Postpaid

Exemplos

Resposta de sucesso

JSON formato

{
  "ScalingActivityId": "asa-bp175o6f6ego3r2j****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ActivityType": "CapacityChange",
  "PlanResult": {
    "ResourceAllocations": [
      {
        "ZoneId": "cn-beijing-g",
        "InstanceType": "ecs.u1-c1m8.large",
        "SpotStrategy": "NoSpot",
        "Amount": 1,
        "InstanceChargeType": "Postpaid"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
403	Forbidden.Forbidden	Operation Forbidden

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.