visualização
Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!
Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.
Esta página fornece uma referência completa para as ações do AWS EC2 disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações permitem que você crie instâncias do EC2 e gerencie snapshots.
Pré-requisitos
Antes de usar as ações AWS na automação do fluxo de trabalho, certifique-se de ter:
- Uma conta da AWS com as permissões apropriadas.
- Credenciais da AWS configuradas (credenciais de usuário do IAM, ARN da função do IAM ou credenciais de sessão).
- As permissões IAM necessárias para os serviços específicos da AWS que você planeja usar.
Consulte Configurar credenciais AWS para obter informações sobre como criar usuários e funções do IAM e configurar credenciais estáticas e de sessão AWS para integração com as ações de automação de fluxo de trabalho AWS.
lançamento o número especificado de instâncias usando uma AMI para a qual você tem permissões.
Você pode especificar várias opções ou manter as opções padrão. Aplicam-se as seguintes regras:
Se você não especificar um ID de sub-rede, escolheremos uma sub-rede padrão da sua VPC padrão. Se você não tiver uma VPC padrão, deverá especificar um ID de sub-rede na solicitação.
Se alguma das AMIs tiver um código de produto associado para o qual o usuário não se inscreveu, a solicitação falhará.
Campo de entrada
Opcionalidade
Tipo
Exemplo
awsRoleArn
Opcional
Corda
arn:aws:iam::123456789012:role/my-workflow-roleawsAccessKeyId
Opcional
Corda
${{ :secrets:<awsAccessKeyId> }}awsSecretAccessKey
Opcional
Corda
${{ :secrets:<awsSecretAccessKey> }}awsSessionToken
Opcional
Corda
${{ :secrets:<awsSessionToken> }}região
Obrigatório
Corda
region: "us-east-2"imageId
Obrigatório
Corda
"ami-0ca4d5db4872d0c28"instanceType
Obrigatório
Corda
"t2.micro"minCount
Obrigatório
Interno
1maxCount
Obrigatório
Interno
10parâmetro
Opcional
Mapa
{"EbsOptimized": false,"TagSpecifications": [{"ResourceType": "instance","Tags": [{"Key": "Name","Value": "My-Web-Server"}]}}seletores
Opcional
Lista
[{\"name\": \"response\", \"expression\": \".response\"}, {\"name\": \"success\", \"expression\": \".success\"}, {\"name\": \"errorMessage\", \"expression\": \".errorMessage\"}]Importante
Para suportar uma ampla gama de entradas, o mapa
parametersaceita qualquer argumento opcional disponível. Isso permite que você construa requests dinamicamente adicionando vários campos.Campo de saída
Tipo
Exemplo
response
Objeto
A sintaxe de resposta pode ser consultada em: run_instances - Documentação do Boto3 1.40.50
sucesso
Boleano
success: true | falsemensagem de erro
Corda
errorMessage: ""Exemplo de fluxo de trabalho
name: ec2_run_instanceworkflowInputs:arnRole:type: Stringrequired: truesteps:- name: RunInstancetype: actionaction: aws.ec2.runInstancesversion: '1'inputs:awsRoleArn: ${{.workflowInputs.arnRole}}region: us-east-2imageId: ami-0ca4d5db4872d0c28instanceType: t2.microminCount: 1maxCount: 1parameters:EbsOptimized: falseTagSpecifications:- ResourceType: instanceTags:- Key: NameValue: My-Test-Instanceselectors:- name: instanceIdexpression: .response.Instances[0].InstanceId
Descreve a instância especificada ou todas as instâncias.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
instanceIds | Opcional | Lista |
|
filtros | Opcional | Lista |
|
nextToken | Opcional | Corda |
|
maxResultados | Opcional | Interno | 100 |
seletores | Opcional | Lista |
|
Importante
Na entrada de ações, pelo menos uma das credenciais da AWS (curta, longa ou função) deve ser fornecida, sendo que a função tem precedência sobre as demais.
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | Objeto | A sintaxe de resposta pode ser consultada em describe_instances. |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Importante
- Se você especificar o ID da instância, a saída incluirá informações apenas para a instância especificada.
- Se você especificar filtros, a saída incluirá informações apenas para as instâncias que atendem aos critérios do filtro.
- Se você não especificar o ID da instância ou filtros, a saída incluirá informações para todos os membros.
- O parâmetro
instanceIdsnão pode ser usado commaxResults.
Exemplo de fluxo de trabalho |
|---|
|
Inicia uma instância com suporte do Amazon EBS que você havia interrompido anteriormente.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
instanceIds | Obrigatório | Lista |
|
seletores | Opcional | Lista |
|
Dica
No campo de entrada de ação, pelo menos uma das credenciais da AWS (curta, longa ou função) deve ser fornecida, sendo que a função tem precedência sobre as demais.
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | Objeto | A sintaxe de resposta pode ser consultada na documentação do Boto3 1.40.50, que trata de `start_instances`. |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Exemplo de fluxo de trabalho |
|---|
|
Interrompe uma instância com suporte do Amazon EBS.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
instanceIds | Obrigatório | Lista |
|
hibernar | Opcional | Boleano | verdadeiro ou falso (Padrão:
) |
vigor | Opcional | Boleano | verdadeiro ou falso (Padrão:
) |
seletores | Opcional | Lista |
|
Importante
No campo de entrada de ação, pelo menos uma das credenciais da AWS (curta, longa ou função) deve ser fornecida, sendo que a função tem precedência sobre as demais.
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | Objeto | A sintaxe de resposta pode ser referida como stop_instances |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Exemplo de fluxo de trabalho |
|---|
|
Solicita a reinicialização da instância especificada. Esta operação é assíncrona; ela apenas enfileira uma solicitação para reiniciar a instância especificada. A operação será bem-sucedida se as instâncias forem válidas e pertencerem a você. As solicitações de reinicialização encerradas instantaneamente são ignoradas.
Se uma instância não for desligada corretamente em alguns minutos, o Amazon EC2 realiza uma reinicialização forçada.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
instanceIds | Obrigatório | Lista |
|
seletores | Opcional | Lista |
|
Importante
No campo de entrada de ação, pelo menos uma das credenciais da AWS (curta, longa ou função) deve ser fornecida, sendo que a função tem precedência sobre as demais.
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | Objeto | |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Exemplo de fluxo de trabalho |
|---|
|
Desativa a instância especificada. Essa operação é idempotente; se você encerrar uma instância mais de uma vez, cada chamada será bem-sucedida.
Se você especificar várias instâncias e a solicitação falhar (por exemplo, devido a um único ID da instância incorreto), nenhuma das instâncias será encerrada.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
instanceIds | Obrigatório | Lista |
|
seletores | Opcional | Lista |
|
Importante
No campo de entrada de ação, pelo menos uma das credenciais da AWS (curta, longa ou função) deve ser fornecida, sendo que a função tem precedência sobre as demais.
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | Objeto | A sintaxe de resposta pode ser consultada em terminate_instances - documentação do Boto3 1.40.50 |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Exemplo de fluxo de trabalho |
|---|
|
Cria um instantâneo de um volume EBS e o armazena no Amazon S3. Você pode usar snapshots para backups, para fazer cópias de volumes EBS e salvar dados antes de desligar uma instância.
A localização do volume EBS de origem determina onde você pode criar o snapshot.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
descrição | Opcional | Corda |
|
posto avançadoArn | Opcional | Corda |
|
volumeId | Obrigatório | Corda |
|
Especificações da tag | Opcional | Lista |
|
localização | Opcional | Corda |
|
seletores | Opcional | Lista |
|
Importante
É necessário fornecer pelo menos uma das credenciais da AWS (curta, longa ou de função), sendo que a função tem precedência sobre as demais.
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | Objeto | A sintaxe de resposta pode ser consultada em create_snapshot. |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Exclui o instantâneo especificado.
Não é possível excluir um snapshot do dispositivo raiz de um volume EBS usado por uma AMI registrada. Primeiro você precisa cancelar o registro da AMI antes de poder excluir o snapshot.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
snapshotId | Obrigatório | Corda |
|
seletores | Opcional | Corda |
|
Dica
É necessário fornecer pelo menos uma das credenciais da AWS (curta, longa ou função), sendo que a função tem precedência sobre as demais.
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | Objeto | Sem resposta em caso de A sintaxe da resposta pode ser consultada na documentação do delete_snapshot - Boto3 1.40.55. |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Exemplo de fluxo de trabalho |
|---|
|
Invoca um agente do AWS Bedrock.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
ID do agente | Obrigatório | Corda |
|
agentAliasId | Obrigatório | Corda |
|
sessionId | Opcional | Corda |
|
texto_de_entrada | Obrigatório | Corda |
|
parâmetro | Opcional | Mapa | |
seletores | Opcional | Lista |
|
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | Objeto | |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Exemplo de fluxo de trabalho |
|---|
|