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

Um nó agendado é um nó predefinido. Você pode invocar a API CreateScheduledTask para criar um nó agendado que executa uma regra de dimensionamento especificada em um horário especificado. Isso permite o dimensionamento automático de recursos de computação para atender aos requisitos de negócios, controlando os custos.

Descrição da operação

Se o acionamento de um nó agendado para executar uma regra de dimensionamento falhar porque uma atividade de dimensionamento está em andamento ou o grupo de dimensionamento está desativado, o nó agendado tentará acionar novamente de forma automática dentro do período LaunchExpirationTime. Caso contrário, o acionamento agendado será cancelado.
Se vários nós agendados acionarem regras de dimensionamento para o mesmo grupo de dimensionamento aproximadamente ao mesmo tempo, os detalhes das atividades de dimensionamento acionadas serão os seguintes:
- Grupos de dimensionamento com Configurações para o número esperado de instâncias: As atividades de dimensionamento acionadas por vários nós agendados são classificadas como atividades de dimensionamento paralelas. Por exemplo, se vários nós agendados forem executados aproximadamente ao mesmo tempo, o grupo de dimensionamento poderá acionar vários eventos de atividade de dimensionamento paralela simultaneamente.
- Grupos de dimensionamento sem Configurações para o número esperado de instâncias: O nó agendado acionado mais cedo executa a atividade de dimensionamento primeiro. Como um grupo de dimensionamento pode ter apenas uma atividade de dimensionamento por vez, os nós agendados subsequentes tentarão acionar novamente o agendamento de forma automática dentro do período LaunchExpirationTime. Se um nó agendado subsequente ainda estiver tentando novamente dentro do período LaunchExpirationTime após a conclusão da atividade de dimensionamento anterior, a regra de dimensionamento do nó agendado será executada para acionar a atividade de dimensionamento correspondente.
Os nós agendados suportam os dois métodos de dimensionamento a seguir:
- Use o parâmetro ScheduledAction para especificar a regra de dimensionamento a ser executada.
- Use o parâmetro ScalingGroupId para especificar o número de instâncias no grupo de dimensionamento.
Nota
Você não pode especificar ScheduledAction e ScalingGroupId ao mesmo tempo.

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

create

*ScalingGroup

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região à qual a tarefa agendada pertence.	cn-qingdao
ScheduledTaskName	string	Não	O nome da tarefa agendada. O nome deve ter de 2 a 64 caracteres. Deve começar com uma letra, dígito ou caractere chinês e pode conter letras, dígitos, caracteres chineses, sublinhados (_), hifens (-) e pontos (.). O nome deve ser exclusivo na mesma região e conta. Valor padrão: o valor de ScheduledTaskId.	scheduled****
Description	string	Não	A descrição da tarefa agendada. A descrição deve ter de 2 a 200 caracteres.	Test scheduled task.
ScheduledAction	string	Não	O identificador exclusivo da regra de dimensionamento a ser executada quando a tarefa agendada for acionada. Após especificar `ScheduledAction`, o método de dimensionamento da tarefa agendada será selecionar uma regra de dimensionamento existente. Você não pode especificar `ScheduledAction` e `ScalingGroupId` ao mesmo tempo.	ari:acs:ess:cn-hangzhou:140692647**:scalingrule/asr-bp12tcnol686y1ik**
RecurrenceEndTime	string	Não	A hora de término da tarefa agendada que é executada repetidamente. Especifique a hora no padrão ISO 8601 no formato de hora UTC. Formato: AAAA-MM-DDThh:mmZ. Você não pode especificar uma hora posterior a 365 dias a partir da data de criação.	2014-08-17T16:55Z
LaunchTime	string	Não	A hora em que a tarefa agendada é acionada. Especifique a hora no padrão ISO 8601 no formato de hora UTC. Formato: AAAA-MM-DDThh:mmZ. Você não pode especificar uma hora posterior a 90 dias a partir da data de criação. Se você especificar `RecurrenceType`, a hora especificada por este parâmetro será a hora padrão para execução recorrente. Se você não especificar `RecurrenceType`, a tarefa será executada uma vez na data e hora especificadas.	2014-08-17T16:52Z
RecurrenceType	string	Não	O tipo de recorrência da tarefa agendada. Valores válidos: Daily: A tarefa agendada é executada uma vez a cada número especificado de dias. Weekly: A tarefa agendada é executada em dias especificados de cada semana. Monthly: A tarefa agendada é executada em dias especificados de cada mês. Cron: A tarefa agendada é executada com base na expressão cron especificada. Você deve especificar `RecurrenceType` e `RecurrenceValue`.	Daily
RecurrenceValue	string	Não	O valor de recorrência da tarefa agendada. Se `RecurrenceType` estiver definido como `Daily`, você poderá inserir apenas um valor. Valores válidos: 1 a 31. Se `RecurrenceType` estiver definido como `Weekly`, você poderá inserir vários valores separados por vírgulas (,). Por exemplo, os valores para domingo, segunda-feira, terça-feira, quarta-feira, quinta-feira, sexta-feira e sábado são `0,1,2,3,4,5,6`. Se `RecurrenceType` estiver definido como `Monthly`, o formato é `A-B`. Valores válidos de A e B: 1 a 31. B deve ser maior ou igual a A. Se `RecurrenceType` estiver definido como `Cron`, o valor representa a hora UTC. Ele suporta uma expressão de cinco campos para minutos, horas, dias, meses e semanas. Suporta curingas como vírgulas (,), pontos de interrogação (?), hifens (-), asteriscos (*), sinais de número (#), barras (/), L e W. Você deve especificar `RecurrenceType` e `RecurrenceValue`.	1
TaskEnabled	boolean	Não	Especifica se a tarefa agendada deve ser iniciada. Valores válidos: true: Inicia a tarefa. false: Interrompe a tarefa. Valor padrão: true.	true
LaunchExpirationTime	integer	Não	O período durante o qual a tarefa agendada tenta acionar novamente após a falha na operação de acionamento. Unidade: segundos. Valores válidos: 0 a 1800. Valor padrão: 600.	600
MinValue	integer	Não	O número mínimo de instâncias no grupo de dimensionamento quando o método de dimensionamento da tarefa agendada é especificar o número de instâncias no grupo de dimensionamento.	0
MaxValue	integer	Não	O número máximo de instâncias no grupo de dimensionamento quando o método de dimensionamento da tarefa agendada é especificar o número de instâncias no grupo de dimensionamento.	10
DesiredCapacity	integer	Não	O número esperado de instâncias no grupo de dimensionamento quando o método de dimensionamento da tarefa agendada é especificar o número de instâncias no grupo de dimensionamento. Nota O grupo de dimensionamento deve suportar o número esperado de instâncias. Isso significa que `DesiredCapacity` deve ser especificado quando o grupo de dimensionamento é criado.	10
ScalingGroupId	string	Não	O ID do grupo de dimensionamento para o qual você deseja modificar o número de instâncias quando a tarefa agendada for acionada. Após especificar `ScalingGroupId`, o método de dimensionamento da tarefa agendada será especificar o número de instâncias no grupo de dimensionamento. Você deve especificar um valor para pelo menos um dos seguintes parâmetros: `MinValue`, `MaxValue` e `DesiredCapacity`. Você não pode especificar `ScheduledAction` e `ScalingGroupId` ao mesmo tempo.	asg-bp18p2yfxow2dloq****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
ScheduledTaskId	string	O ID da tarefa agendada. O ID é gerado pelo sistema e é globalmente exclusivo.	edRtShc57WGXdt8TlPbr****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScheduledTaskId": "edRtShc57WGXdt8TlPbr****"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.