Todos os produtos
Search
Central de documentação

Auto Scaling:RecordLifecycleActionHeartbeat

Última atualização: Jul 03, 2026

Estende a janela de tempo em que as instâncias do Elastic Compute Service (ECS) permanecem no estado Pending. Se o período atual no estado Pending não for suficiente para concluir operações personalizadas na instância ECS, chame a operação RecordLifecycleActionHeartbeat para prolongá-lo. Ao chamar esta operação, especifique lifecycleHookId, lifecycleActionToken e heartbeatTimeout para estender a janela de tempo da instância ECS desejada.

Notas de uso

Chame esta operação apenas quando a instância ECS desejada entrar no estado Pending.

Uma instância ECS pode permanecer no estado Pending por até seis horas. A cada entrada nesse estado, é possível estender a janela de tempo de permanência no estado Pending até 20 vezes.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

RecordLifecycleActionHeartbeat

A operação a ser executada. Defina o valor como RecordLifecycleActionHeartbeat.

lifecycleHookId

String

Sim

ash-bp1fxuqyi98w0aib****

O ID do hook de ciclo de vida.

lifecycleActionToken

String

Sim

F324B880-900E-4968-85DD-81691113****

O token de ação do hook de ciclo de vida. Obtenha o token na página de detalhes da fila do Simple Message Queue (SMQ, anteriormente MNS) especificada para o hook de ciclo de vida.

Também é possível chamar a operação DescribeLifecycleActions para obter o token de ação do hook de ciclo de vida.

Caso tenha especificado um tópico SMQ para o hook de ciclo de vida, obtenha o token no tópico MNS.

heartbeatTimeout

Integer

Não

600

A janela de tempo em que a instância ECS permanece no estado Pending. Quando essa janela termina, o Auto Scaling executa a ação padrão. Valores válidos: 30 a 21600. Unidade: segundos.

Após crie um hook de ciclo de vida, chame esta operação para estender a janela de tempo em que a instância ECS desejada permanece no estado Pending. Alternativamente, utilize a operação CompleteLifecycleAction para remover a instância ECS do estado Pending antecipadamente.

Valor padrão: 600.

RegionId

String

Não

cn-hangzhou

O ID da região do grupo de dimensionamento.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ess.aliyuncs.com/?Action=RecordLifecycleActionHeartbeat
&lifecycleHookId=ash-bp1fxuqyi98w0aib****
&lifecycleActionToken=F324B880-900E-4968-85DD-81691113****
&heartbeatTimeout=600
&RegionId=cn-hangzhou
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<RecordLifecycleActionHeartbeatResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</RecordLifecycleActionHeartbeatResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.

Código de status HTTP

Código de erro

Descrição

Descrição

400

InvalidParamter

The specified value of parameter is not valid.

O valor atribuído a um parâmetro é inválido.

400

LifecycleHookIdAndLifecycleActionToken.Invalid

The specified lifecycleActionToken and LifecycleHookId you provided does not match any in process lifecycle action.

O valor atribuído a lifecycleActionToken não corresponde ao valor de LifecycleHookId.

400

LifecycleAction.TimeExceeded

The specified parameter heartbeatTime exceed lifecycleAction max suspend time.

Uma instância ECS pode permanecer no estado Pending por um máximo de horas fixas.

400

LifecycleAction.RecordTimesExceeded

The specified lifecycleAction exceed lifecycleAction max record times.

Cada vez que uma instância ECS permanece no estado Pending, esta operação só pode ser chamada até 20 vezes.