• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Ações do AWS Auto Scaling

|View as Markdown (English)

Esta página fornece uma referência para as ações do AWS Auto Scaling disponíveis no catálogo de ações de automação de fluxo de trabalho. Use essas ações para gerenciar Auto Scaling Groups (ASGs) — anexar e desanexar instâncias, ajustar a capacidade, executar políticas de escalabilidade, gerenciar atualizações de instância, controlar processos de escalabilidade e consultar o estado do ASG.

Pré-requisitos

Para pré-requisitos e configuração de credenciais, consulte Configurar credenciais da AWS.

Anexar instâncias

O identificador da ação é aws.autoscaling.attachInstances.

Anexe uma ou mais instâncias de EC2 a um Auto Scaling group existente. Anexar instâncias aumenta a capacidade desejada pelo número anexado. É possível anexar até 20 instâncias por chamada. As instâncias devem estar no estado em execução ou interrompido, e a anexação não deve exceder o tamanho máximo do grupo.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

instanceIds

Lista

Obrigatório.

IDs de instâncias de EC2 para anexar.

["i-0123456789abcdef0", "i-0fedcba9876543210"]

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "success", "expression": ".success"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

O exemplo a seguir anexa uma instância de EC2 a um Auto Scaling group.

Exemplo de fluxo de trabalho

name: asg-attach-instances
workflowInputs:
arnRole:
type: String
asgName:
type: String
steps:
- name: attachInstances
type: action
action: aws.autoscaling.attachInstances
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: ${{ .workflowInputs.asgName }}
instanceIds:
- i-0123456789abcdef0
next: end

Desvincular instâncias

O identificador da ação é aws.autoscaling.detachInstances.

Desvincule uma ou mais instâncias de EC2 de um grupo do Auto Scaling. É possível desvincular até 20 instâncias por chamada. As instâncias devem estar no estado InService ou Standby. Se shouldDecrementDesiredCapacity for false, o ASG realiza o lançamento de instâncias de substituição para manter a capacidade desejada.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

instanceIds

Lista

Obrigatório.

IDs de instâncias de EC2 para desanexar.

["i-0123456789abcdef0"]

shouldDecrementDesiredCapacity

Boleano

Obrigatório.

Se

true

, reduz a capacidade desejada pelo número de instâncias desanexadas. Se

false

, o ASG realiza o lançamento de substituições.

true

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "activities", "expression": ".response.Activities"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Objeto de resposta da API da AWS. Consulte

detach_instances — documentação do Boto3

para ver a sintaxe completa da resposta.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir desvincula uma instância e diminui a capacidade desejada.

Exemplo de fluxo de trabalho

name: asg-detach-instances
workflowInputs:
arnRole:
type: String
steps:
- name: detachInstances
type: action
action: aws.autoscaling.detachInstances
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
instanceIds:
- i-0123456789abcdef0
shouldDecrementDesiredCapacity: true
next: end

Definir capacidade desejada

O identificador da ação é aws.autoscaling.setDesiredCapacity.

Atualize a contagem de instância desejada de um grupo do Auto Scaling. O novo valor deve estar entre MinSize e MaxSize do grupo. Se honorCooldown for true, a solicitação será rejeitada quando o ASG estiver em seu período de cooldown.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

desiredCapacity

Interno

Obrigatório.

Número de instâncias de destino. Deve estar entre

MinSize

e

MaxSize

do grupo.

3

honorCooldown

Boleano

Opcional.

Se

true

, rejeita a solicitação quando o ASG estiver em um período de espera. O padrão é

false

.

false

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "success", "expression": ".success"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Objeto de resposta da API da AWS. Consulte

set_desired_capacity — Boto3 documentation

para obter a sintaxe completa da resposta.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir define a capacidade desejada para 5 instâncias.

Exemplo de fluxo de trabalho

name: asg-set-capacity
workflowInputs:
arnRole:
type: String
steps:
- name: setDesiredCapacity
type: action
action: aws.autoscaling.setDesiredCapacity
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
desiredCapacity: 5
honorCooldown: false
next: end

Executar uma política de escalonamento

O identificador da ação é aws.autoscaling.executePolicy.

Execute uma política de escalabilidade nomeada em um grupo do Auto Scaling. A política já deve existir no grupo. Para políticas de escalabilidade em etapas, metricValue e breachThreshold podem substituir os limites da política. Se honorCooldown for true e o ASG estiver em cooldown, a chamada será bem-sucedida, mas nenhuma atividade de escalabilidade será acionada.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

policyName

Corda

Obrigatório.

Nome ou ARN da política de escalonamento a ser executada.

"my-scale-out-policy"

honorCooldown

Boleano

Opcional.

Se

true

e o ASG estiver em cooldown, a chamada será bem-sucedida, mas nenhuma atividade de escalonamento será acionada.

false

metricValue

Corda

Opcional.

Substituição do valor da métrica para políticas de escalabilidade em etapas.

"50.0"

breachThreshold

Corda

Opcional.

Substituição do limite de violação para políticas de escalabilidade em etapas.

"70.0"

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "success", "expression": ".success"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Objeto de resposta da API da AWS. Consulte

execute_policy — Boto3 documentation

para ver a sintaxe completa da resposta.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir executa uma política de scale-out nomeada.

Exemplo de fluxo de trabalho

name: asg-execute-policy
workflowInputs:
arnRole:
type: String
steps:
- name: executePolicy
type: action
action: aws.autoscaling.executePolicy
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
policyName: my-scale-out-policy
honorCooldown: false
next: end

Iniciar uma atualização de instância

O identificador da ação é aws.autoscaling.startInstanceRefresh.

Inicie uma substituição contínua de instâncias usando o modelo de lançamento ou configuração mais recente. Apenas uma atualização pode estar ativa por grupo por vez — se uma já estiver em andamento, a chamada falhará com InstanceRefreshInProgress. Use aws.autoscaling.describeInstanceRefreshes para consultar o status.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

estratégia

Corda

Opcional.

Estratégia de atualização.

"Rolling"

é o único valor compatível.

"Rolling"

preferências

Mapa

Opcional.

Preferências de atualização.

MinHealthyPercentage

controla quantas instâncias permanecem íntegras durante a substituição (padrão de 90%).

InstanceWarmup

define quanto tempo esperar depois que uma instância atinge

InService

antes de substituir o próximo lote.

{"MinHealthyPercentage": 90, "InstanceWarmup": 300}

desiredConfiguration

Mapa

Opcional.

Substitua o modelo de lançamento ou a configuração para esta atualização.

{"LaunchTemplate": {"LaunchTemplateId": "lt-0123456789abcdef0", "Version": "2"}}

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "instanceRefreshId", "expression": ".response.InstanceRefreshId"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Contém

InstanceRefreshId

(UUID de string) que identifica a atualização. Consulte

start_instance_refresh — documentação do Boto3

para obter a sintaxe de resposta completa.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir inicia uma atualização contínua de instância com um mínimo de 90% de instâncias íntegras.

Exemplo de fluxo de trabalho

name: asg-start-refresh
workflowInputs:
arnRole:
type: String
steps:
- name: startInstanceRefresh
type: action
action: aws.autoscaling.startInstanceRefresh
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
strategy: Rolling
preferences:
MinHealthyPercentage: 90
InstanceWarmup: 300
selectors:
- name: instanceRefreshId
expression: '.response.InstanceRefreshId'
next: end

Cancelar uma atualização de instância

O identificador da ação é aws.autoscaling.cancelInstanceRefresh.

Cancelar uma atualização de instância em andamento. Apenas uma atualização em andamento pode ser cancelada — chamar isso quando nenhuma atualização estiver ativa falha com ActiveInstanceRefreshNotFound. As instâncias já substituídas não são revertidas; use aws.autoscaling.rollbackInstanceRefresh para reverter as instâncias substituídas.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "instanceRefreshId", "expression": ".response.InstanceRefreshId"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Contém

InstanceRefreshId

da atualização cancelada. Consulte

cancel_instance_refresh — documentação do Boto3

para obter a sintaxe completa da resposta.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir cancela uma atualização de instância em andamento.

Exemplo de fluxo de trabalho

name: asg-cancel-refresh
workflowInputs:
arnRole:
type: String
steps:
- name: cancelRefresh
type: action
action: aws.autoscaling.cancelInstanceRefresh
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
selectors:
- name: instanceRefreshId
expression: '.response.InstanceRefreshId'
next: end

Reverter uma atualização de instância

O identificador da ação é aws.autoscaling.rollbackInstanceRefresh.

Reverta uma atualização de instância em andamento, revertendo as instâncias substituídas para seu modelo de lançamento ou configuração anterior. O grupo deve ter um checkpoint habilitado para suportar a reversão. Se nenhuma atualização for elegível para reversão, a chamada falhará com ActiveInstanceRefreshNotFound.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "instanceRefreshId", "expression": ".response.InstanceRefreshId"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Contém

InstanceRefreshId

da atualização revertida. Consulte

rollback_instance_refresh — Boto3 documentation

para obter a sintaxe completa da resposta.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir reverte uma atualização de instância em andamento.

Exemplo de fluxo de trabalho

name: asg-rollback-refresh
workflowInputs:
arnRole:
type: String
steps:
- name: rollbackRefresh
type: action
action: aws.autoscaling.rollbackInstanceRefresh
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
selectors:
- name: instanceRefreshId
expression: '.response.InstanceRefreshId'
next: end

Suspender processos de escalabilidade

O identificador da ação é aws.autoscaling.suspendProcesses.

Suspenda um ou mais processos de escalabilidade de um grupo do Auto Scaling. Use durante implantações ou janelas de manutenção para evitar atividades de escalabilidade indesejadas. Se omitir scalingProcesses, todos os processos serão suspensos. Os processos suspensos permanecem suspensos até serem retomados explicitamente com aws.autoscaling.resumeProcesses.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

scalingProcesses

Lista

Opcional.

Processos a serem suspensos. Omita para suspender todos os processos. Valores válidos:

Launch

,

Terminate

,

HealthCheck

,

ReplaceUnhealthy

,

AZRebalance

,

AlarmNotification

,

ScheduledActions

,

AddToLoadBalancer

,

InstanceRefresh

.

["Launch", "Terminate", "HealthCheck"]

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "success", "expression": ".success"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Objeto de resposta da API da AWS. Consulte

suspend_processes — documentação do Boto3

para ver a sintaxe completa da resposta.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir suspende os processos de Lançamento, Terminate e HealthCheck antes de uma implantação.

Exemplo de fluxo de trabalho

name: asg-suspend-for-deploy
workflowInputs:
arnRole:
type: String
steps:
- name: suspendProcesses
type: action
action: aws.autoscaling.suspendProcesses
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
scalingProcesses:
- Launch
- Terminate
- HealthCheck
next: end

Retomar processos de dimensionamento

O identificador da ação é aws.autoscaling.resumeProcesses.

Retome um ou mais processos de escalabilidade suspensos. Use após implantações ou janelas de manutenção para restaurar o comportamento normal de escalabilidade. Se omitir scalingProcesses, todos os processos suspensos serão retomados. Se nenhum processo estiver suspenso no momento, a chamada será bem-sucedida sem efeito.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

scalingProcesses

Lista

Opcional.

Processos a serem retomados. Omita para retomar todos os processos suspensos.

["Launch", "Terminate", "HealthCheck"]

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "success", "expression": ".success"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Objeto de resposta da API da AWS. Consulte

resume_processes — documentação do Boto3

para obter a sintaxe de resposta completa.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir retoma os processos de escalabilidade após uma implantação.

Exemplo de fluxo de trabalho

name: asg-resume-after-deploy
workflowInputs:
arnRole:
type: String
steps:
- name: resumeProcesses
type: action
action: aws.autoscaling.resumeProcesses
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
scalingProcesses:
- Launch
- Terminate
- HealthCheck
next: end

Encerrar uma instância em um grupo

O identificador da ação é aws.autoscaling.terminateInstanceInAutoScalingGroup.

Encerrar uma instância específica em um grupo do Auto Scaling respeitando os ganchos de ciclo de vida. Defina shouldDecrementDesiredCapacity como false para substituir a instância automaticamente, ou true para reduzir o grupo.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

instanceId

Corda

Obrigatório.

ID da instância de EC2 a ser encerrada.

"i-0123456789abcdef0"

shouldDecrementDesiredCapacity

Boleano

Obrigatório.

Se

true

, reduz a capacidade desejada em 1. Se

false

, o lançamento de uma instância de substituição é realizado automaticamente.

false

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "activityStatus", "expression": ".response.Activity.StatusCode"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Contém um objeto

Activity

com

ActivityId

,

StatusCode

e

Progress

. Consulte

terminate_instance_in_auto_scaling_group — documentação do Boto3

para ver a sintaxe completa da resposta.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir encerra uma instância não íntegra e realiza o lançamento de uma substituta.

Exemplo de fluxo de trabalho

name: asg-terminate-unhealthy-instance
workflowInputs:
arnRole:
type: String
steps:
- name: terminateInstance
type: action
action: aws.autoscaling.terminateInstanceInAutoScalingGroup
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
instanceId: i-0123456789abcdef0
shouldDecrementDesiredCapacity: false
selectors:
- name: activityStatus
expression: '.response.Activity.StatusCode'
next: end

Mover instâncias para standby

O identificador da ação é aws.autoscaling.enterStandby.

Mova uma ou mais instâncias para o modo de espera, retirando-as da rotação ativa sem encerrá-las. Use para manutenção em instâncias específicas. Combine com aws.autoscaling.exitStandby para retornar as instâncias ao serviço.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

instanceIds

Lista

Opcional.

ID da instância para mover para o modo de espera. Omita para mover todas as instâncias.

["i-0123456789abcdef0"]

shouldDecrementDesiredCapacity

Boleano

Obrigatório.

Se

true

, reduz a capacidade desejada pelo número de instâncias que entram em espera.

true

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "activities", "expression": ".response.Activities"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Contém uma matriz

Activities

que descreve a transição para o modo de espera de cada instância. Consulte

enter_standby — documentação do Boto3

para ver a sintaxe completa da resposta.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir move uma instância para o modo de espera para manutenção.

Exemplo de fluxo de trabalho

name: asg-enter-standby
workflowInputs:
arnRole:
type: String
steps:
- name: enterStandby
type: action
action: aws.autoscaling.enterStandby
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
instanceIds:
- i-0123456789abcdef0
shouldDecrementDesiredCapacity: true
next: end

Sair do modo de espera

O identificador da ação é aws.autoscaling.exitStandby.

Retorna uma ou mais instâncias do modo de espera de volta à rotação ativa. Emparelhe com aws.autoscaling.enterStandby após a conclusão da manutenção. Se você omitir instanceIds, todas as instâncias em espera retornarão ao serviço.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

instanceIds

Lista

Opcional.

IDs da instância para retornar à rotação ativa. Omita para retirar todas as instâncias de espera.

["i-0123456789abcdef0"]

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "activities", "expression": ".response.Activities"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Contém uma matriz

Activities

que descreve o retorno de cada instância ao serviço. Consulte

exit_standby — documentação do Boto3

para ver a sintaxe de resposta completa.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir retorna uma instância do modo de espera após a manutenção.

Exemplo de fluxo de trabalho

name: asg-exit-standby
workflowInputs:
arnRole:
type: String
steps:
- name: exitStandby
type: action
action: aws.autoscaling.exitStandby
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
instanceIds:
- i-0123456789abcdef0
next: end

Criar ou atualizar uma ação agendada

O identificador da ação é aws.autoscaling.putScheduledUpdateGroupAction.

Crie ou atualize uma ação de escalabilidade programada para um grupo do Auto Scaling. Use recurrence para programações baseadas em cron ou startTime para alterações únicas. Combine com aws.autoscaling.deleteScheduledAction para remover ações.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

scheduledActionName

Corda

Obrigatório.

Nome da ação programada para criar ou atualizar.

"scale-down-nights"

startTime

Corda

Opcional.

timestamp UTC ISO 8601 para quando a ação entrar em vigor.

"2024-06-01T20:00:00Z"

endTime

Corda

Opcional.

Timestamp UTC ISO 8601 para quando a ação recorrente é interrompida.

"2024-12-31T23:59:59Z"

recorrência

Corda

Opcional.

Expressão cron para programações recorrentes.

"0 20 * * *"

timeZone

Corda

Opcional.

Fuso horário da IANA para a expressão cron de recorrência.

"America/New_York"

minSize

Interno

Opcional.

Tamanho mínimo do grupo a ser aplicado no horário agendado.

1

maxSize

Interno

Opcional.

Tamanho máximo do grupo a ser aplicado no horário agendado.

10

desiredCapacity

Interno

Opcional.

Capacidade desejada a ser aplicada no horário programado.

2

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "success", "expression": ".success"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Objeto de resposta da API da AWS. Consulte

put_scheduled_update_group_action — documentação do Boto3

para obter a sintaxe de resposta completa.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir cria uma ação de redução de escala noturna.

Exemplo de fluxo de trabalho

name: asg-create-scheduled-action
workflowInputs:
arnRole:
type: String
steps:
- name: putScheduledAction
type: action
action: aws.autoscaling.putScheduledUpdateGroupAction
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
scheduledActionName: scale-down-nights
recurrence: "0 20 * * *"
timeZone: America/New_York
desiredCapacity: 2
minSize: 1
next: end

Excluir uma ação agendada

O identificador da ação é aws.autoscaling.deleteScheduledAction.

Exclua uma ação de escalonamento programada de um grupo do Auto Scaling. Apenas uma ação pode ser excluída por chamada. Se o nome da ação não existir, a chamada falhará com ValidationError. A exclusão de uma ação não afeta nenhuma atividade de escalonamento já em andamento.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

scheduledActionName

Corda

Obrigatório.

Nome da ação agendada a ser excluída.

"scale-down-nights"

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "success", "expression": ".success"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Objeto de resposta da API da AWS. Consulte

delete_scheduled_action — documentação do Boto3

para obter a sintaxe de resposta completa.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir exclui uma ação de escalabilidade agendada.

Exemplo de fluxo de trabalho

name: asg-delete-scheduled-action
workflowInputs:
arnRole:
type: String
steps:
- name: deleteScheduledAction
type: action
action: aws.autoscaling.deleteScheduledAction
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
scheduledActionName: scale-down-nights
next: end

Atualize um grupo do Auto Scaling

O identificador da ação é aws.autoscaling.updateAutoScalingGroup.

Atualize a configuração de um grupo do Auto Scaling existente — tamanho mínimo/máximo, capacidade desejada, configurações de verificação de integridade, modelo de lançamento e muito mais. Use o mapa parameters para passar quaisquer campos adicionais da API boto3 update_auto_scaling_group não listados abaixo.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling para atualizar.

"my-asg"

minSize

Interno

Opcional.

Novo tamanho mínimo do grupo.

1

maxSize

Interno

Opcional.

Novo tamanho máximo do grupo.

10

desiredCapacity

Interno

Opcional.

Nova contagem de instâncias desejada.

3

defaultCooldown

Interno

Opcional.

Período de espera padrão em segundos.

300

healthCheckType

Corda

Opcional.

Tipo de verificação de integridade. Valores permitidos:

EC2

,

ELB

.

"ELB"

healthCheckGracePeriod

Interno

Opcional.

Segundos após o lançamento da instância antes do início das verificações de integridade.

300

parâmetro

Mapa

Opcional.

Quaisquer campos adicionais do boto3

update_auto_scaling_group

não listados acima.

{"LaunchTemplate": {"LaunchTemplateId": "lt-0123456789abcdef0", "Version": "$Latest"}, "TerminationPolicies": ["OldestInstance"]}

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "success", "expression": ".success"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Objeto de resposta da API da AWS. Consulte

update_auto_scaling_group — Boto3 documentation

para ver a sintaxe de resposta completa.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir atualiza os limites mínimo/máximo, o tipo de verificação de integridade e o modelo de lançamento.

Exemplo de fluxo de trabalho

name: asg-update-group
workflowInputs:
arnRole:
type: String
steps:
- name: updateAutoScalingGroup
type: action
action: aws.autoscaling.updateAutoScalingGroup
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
minSize: 2
maxSize: 20
desiredCapacity: 5
healthCheckType: ELB
healthCheckGracePeriod: 300
parameters:
LaunchTemplate:
LaunchTemplateId: lt-0123456789abcdef0
Version: $Latest
TerminationPolicies:
- OldestInstance
next: end

Descrever grupos do Auto Scaling

O identificador da ação é aws.autoscaling.describeAutoScalingGroups.

Descreve um ou mais grupos do Auto Scaling, retornando a configuração e o estado da instância. Se você omitir autoScalingGroupNames, todos os grupos na região serão retornados. Use maxRecords e nextToken para paginar grandes conjuntos de resultados.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupNames

Lista

Opcional.

Nomes dos grupos a serem descritos. Omita para retornar todos os grupos na região.

["my-asg", "my-other-asg"]

maxRecords

Interno

Opcional.

Número máximo de grupos a serem retornados. Máximo de 100.

10

nextToken

Corda

Opcional.

Token de paginação de uma resposta anterior.

"abcdefgh"

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "desiredCapacity", "expression": ".response.AutoScalingGroups[0].DesiredCapacity"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Contém uma matriz

AutoScalingGroups

com a configuração e o estado da instância para cada grupo. Consulte

describe_auto_scaling_groups — documentação do Boto3

para obter a sintaxe de resposta completa.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir recupera a capacidade desejada, o mínimo, o máximo e a contagem de instância de um grupo.

Exemplo de fluxo de trabalho

name: asg-describe-group
workflowInputs:
arnRole:
type: String
steps:
- name: describeGroups
type: action
action: aws.autoscaling.describeAutoScalingGroups
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupNames:
- my-asg
selectors:
- name: desiredCapacity
expression: '.response.AutoScalingGroups[0].DesiredCapacity'
- name: minSize
expression: '.response.AutoScalingGroups[0].MinSize'
- name: maxSize
expression: '.response.AutoScalingGroups[0].MaxSize'
- name: instanceCount
expression: '.response.AutoScalingGroups[0].Instances | length'
next: end

Descrever atualizações de instância

O identificador da ação é aws.autoscaling.describeInstanceRefreshes.

Descreve o status de uma ou mais atualizações de instância para um grupo do Auto Scaling. Use para consultar uma atualização iniciada por aws.autoscaling.startInstanceRefresh. Se omitir instanceRefreshIds, todas as atualizações do grupo serão retornadas, as mais recentes primeiro. Atualizações concluídas, canceladas e com falha são retidas no histórico.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Obrigatório.

Nome do grupo do Auto Scaling.

"my-asg"

instanceRefreshIds

Lista

Opcional.

IDs de atualizações específicas a serem descritas. Omita para obter todas as atualizações do grupo.

["08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"]

maxRecords

Interno

Opcional.

Número máximo de atualizações a serem retornadas. Padrão 50, máx. 100.

10

nextToken

Corda

Opcional.

Token de paginação de uma resposta anterior.

"abcdefgh"

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "status", "expression": ".response.InstanceRefreshes[0].Status"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Contém uma matriz

InstanceRefreshes

com

Status

,

PercentageComplete

e outros detalhes de atualização. Consulte

describe_instance_refreshes — Boto3 documentation

para ver a sintaxe de resposta completa.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir consulta o status de uma atualização iniciada em uma etapa anterior.

Exemplo de fluxo de trabalho

name: asg-poll-refresh
workflowInputs:
arnRole:
type: String
steps:
- name: describeRefresh
type: action
action: aws.autoscaling.describeInstanceRefreshes
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
instanceRefreshIds:
- ${{ .steps.startRefresh.outputs.instanceRefreshId }}
selectors:
- name: refreshStatus
expression: '.response.InstanceRefreshes[0].Status'
- name: percentComplete
expression: '.response.InstanceRefreshes[0].PercentageComplete'
next: end

Descrever atividades de dimensionamento

O identificador da ação é aws.autoscaling.describeScalingActivities.

Descreva as atividades de escalonamento de um grupo do Auto Scaling, incluindo eventos em andamento e concluídos recentemente. Se você omitir activityIds, todas as atividades do grupo serão retornadas, com as mais recentes primeiro. As atividades incluem eventos de redução e expansão bem-sucedidos e com falha.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Opcional.

Nome do grupo para consulta. Omita para retornar atividades em todos os grupos.

"my-asg"

activityIds

Lista

Opcional.

IDs de atividades específicas a serem retornadas.

["3b05db05-2f6e-4e86-af95-29f1f4c2a2b7"]

includeDeletedGroups

Boleano

Opcional.

Se

true

, inclui atividades de grupos excluídos.

false

maxRecords

Interno

Opcional.

Número máximo de atividades a serem retornadas. Máximo de 100.

10

nextToken

Corda

Opcional.

Token de paginação de uma resposta anterior.

"abcdefgh"

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "latestStatus", "expression": ".response.Activities[0].StatusCode"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Contém uma matriz

Activities

com os campos

ActivityId

,

StatusCode

,

Cause

e de tempo. Consulte

describe_scaling_activities — documentação do Boto3

para ver a sintaxe completa da resposta.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir recupera as 5 atividades de escalonamento mais recentes.

Exemplo de fluxo de trabalho

name: asg-check-activities
workflowInputs:
arnRole:
type: String
steps:
- name: describeActivities
type: action
action: aws.autoscaling.describeScalingActivities
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
maxRecords: 5
selectors:
- name: latestActivity
expression: '.response.Activities[0].StatusCode'
next: end

Descrever ações programadas

O identificador da ação é aws.autoscaling.describeScheduledActions.

Descreva as ações de escalonamento programadas para um grupo do Auto Scaling. Se você omitir scheduledActionNames, todas as ações do grupo serão retornadas. Filtre por startTime e endTime para restringir os resultados a uma janela de tempo — esses filtros são ignorados quando scheduledActionNames é fornecido.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

awsRoleArn

Corda

Opcional.

ARN da função do IAM. O executor assume essa função via STS para se autenticar na AWS. Recomendado em vez de credenciais estáticas. Pelo menos um campo de autenticação é obrigatório.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Corda

Opcional.

ID da chave de acesso da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional.

Chave de acesso secreta da AWS. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional.

Token de sessão da AWS para credenciais temporárias. Deve ser passado como uma referência de segredo.

${{ :secrets:awsSessionToken }}

região

Corda

Obrigatório.

Região da AWS onde o grupo do Auto Scaling está localizado.

"us-east-1"

autoScalingGroupName

Corda

Opcional.

Nome do grupo para consulta. Omita para listar ações em todos os grupos.

"my-asg"

scheduledActionNames

Lista

Opcional.

Nomes de ações específicas a serem retornadas. Nomes desconhecidos são ignorados silenciosamente.

["scale-down-nights", "scale-up-mornings"]

startTime

Corda

Opcional.

Limite inferior de timestamp UTC ISO 8601 para filtrar resultados.

"2024-01-01T00:00:00Z"

endTime

Corda

Opcional.

Limite superior do timestamp UTC ISO 8601 para filtrar resultados.

"2024-12-31T23:59:59Z"

maxRecords

Interno

Opcional.

Número máximo de ações a serem retornadas. Máximo de 100.

10

nextToken

Corda

Opcional.

Token de paginação de uma resposta anterior.

"abcdefgh"

selectors

Lista

Opcional.

Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "scheduledActions", "expression": ".response.ScheduledUpdateGroupActions"}]

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída

Tipo

Descrição

response

Objeto

Contém uma matriz

ScheduledUpdateGroupActions

com os campos name, recurrence, timezone e capacity para cada ação. Consulte

describe_scheduled_actions — Boto3 documentation

para ver a sintaxe completa da resposta.

success

Boleano

true

se a ação foi bem-sucedida,

false

caso contrário.

errorMessage

Corda

Mensagem de erro se a ação falhar.

null

em caso de sucesso.

O exemplo a seguir lista todas as ações agendadas para um grupo.

Exemplo de fluxo de trabalho

name: asg-list-scheduled-actions
workflowInputs:
arnRole:
type: String
steps:
- name: describeScheduledActions
type: action
action: aws.autoscaling.describeScheduledActions
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
selectors:
- name: scheduledActions
expression: '.response.ScheduledUpdateGroupActions'
next: end
Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.