avance
Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!
Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras políticas de prelanzamiento.
Esta página proporciona una referencia completa de las acciones de AWS EC2 disponibles en el catálogo de acciones de automatización del flujo de trabajo. Estas acciones le permiten crear instancias de EC2 y gestionar instantáneas.
Requisitos previos
Antes de emplear las acciones AWS en la automatización del flujo de trabajo, cerciorar de tener lo siguiente:
- Una cuenta de AWS con las licencias adecuadas.
- Credenciales de AWS configuradas (credenciales de usuario de IAM, ARN de rol de IAM o credenciales de sesión).
- Las licencias IAM necesarios para los servicios específicos de AWS que planea emplear.
Consulte Configurar credenciales AWS para obtener información sobre cómo crear usuarios y roles de IAM, y configurar credenciales AWS estáticas y de sesión para la integración con acciones de automatización de flujo de trabajo AWS.
Lanza el número especificado de instancias empleando una AMI para la que tengas licencias.
Puede especificar varias opciones o dejar las opciones predeterminadas. Se aplican las siguientes reglas:
Si no especifica un ID de subred, elegiremos una subred predeterminada de su VPC predeterminada para usted. Si no tiene una VPC predeterminada, debe especificar una ID de subred en la solicitud.
Si alguna de las AMI tiene asociado un código de producto al que el usuario no se suscribió, la solicitud falla.
Campo de entrada
Opcionalidad
Tipo
Ejemplo
awsRoleArn
Opcional
Cadena
arn:aws:iam::123456789012:role/my-workflow-roleawsAccessKeyId
Opcional
Cadena
${{ :secrets:<awsAccessKeyId> }}awsSecretAccessKey
Opcional
Cadena
${{ :secrets:<awsSecretAccessKey> }}awsSessionToken
Opcional
Cadena
${{ :secrets:<awsSessionToken> }}región
Requerido
Cadena
region: "us-east-2"imageId
Requerido
Cadena
"ami-0ca4d5db4872d0c28"instanceType
Requerido
Cadena
"t2.micro"minCount
Requerido
En t
1maxCount
Requerido
En t
10parámetro
Opcional
Mapa
{"EbsOptimized": false,"TagSpecifications": [{"ResourceType": "instance","Tags": [{"Key": "Name","Value": "My-Web-Server"}]}}selectores
Opcional
Lista
[{\"name\": \"response\", \"expression\": \".response\"}, {\"name\": \"success\", \"expression\": \".success\"}, {\"name\": \"errorMessage\", \"expression\": \".errorMessage\"}]Importante
Para admitir una amplia gama de entradas, el mapa
parametersacepta cualquier argumento opcional disponible. Esto permite construir requests de forma dinámica agregando múltiples campos.Campo de salida
Tipo
Ejemplo
response
Objeto
La sintaxis de respuesta se puede consultar en la documentación de run_instances - Boto3 1.40.50.
éxito
Booleano
success: true | falsemensaje de error
Cadena
errorMessage: ""Ejemplo de flujo de trabajo
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
Describe la instancia especificada o todas las instancias.
Campo de entrada | Opcionalidad | Tipo | Ejemplo |
|---|---|---|---|
awsRoleArn | Opcional | Cadena |
|
awsAccessKeyId | Opcional | Cadena |
|
awsSecretAccessKey | Opcional | Cadena |
|
awsSessionToken | Opcional | Cadena |
|
región | Requerido | Cadena |
|
instanceIds | Opcional | Lista |
|
filtros | Opcional | Lista |
|
nextToken | Opcional | Cadena |
|
resultados máximos | Opcional | En t | 100 |
selectores | Opcional | Lista |
|
Importante
En la entrada de acción se debe proporcionar al menos una de las credenciales de AWS (corta, larga, rol), donde el rol tiene prioridad sobre las demás.
Campo de salida | Tipo | Ejemplo |
|---|---|---|
response | Objeto | La sintaxis de respuesta puede consultar como describe_instances. |
éxito | Booleano |
|
mensaje de error | Cadena |
|
Importante
- Si especifica el ID de la instancia, la salida incluye información solo para la instancia especificada.
- Si especifica filtros, la salida incluye información solo para aquellas instancias que cumplen con los criterios del filtro.
- Si no especifica el ID de la instancia ni los filtros, la salida incluye información para todas las instancias.
- El parámetro
instanceIdsno se puede emplear conmaxResults.
Ejemplo de flujo de trabajo |
|---|
|
Inicia una instancia respaldada por Amazon EBS que detuviste previamente.
Campo de entrada | Opcionalidad | Tipo | Ejemplo |
|---|---|---|---|
awsRoleArn | Opcional | Cadena |
|
awsAccessKeyId | Opcional | Cadena |
|
awsSecretAccessKey | Opcional | Cadena |
|
awsSessionToken | Opcional | Cadena |
|
región | Requerido | Cadena |
|
instanceIds | Requerido | Lista |
|
selectores | Opcional | Lista |
|
Sugerencia
En la entrada de acción, se debe proporcionar al menos una de las credenciales de AWS (corta, larga o de rol), donde la de rol tiene prioridad sobre las demás.
Campo de salida | Tipo | Ejemplo |
|---|---|---|
response | Objeto | La sintaxis de respuesta se puede consultar en la documentación de `start_instances` de Boto3 1.40.50. |
éxito | Booleano |
|
mensaje de error | Cadena |
|
Ejemplo de flujo de trabajo |
|---|
|
Detiene una instancia respaldada por Amazon EBS
Campo de entrada | Opcionalidad | Tipo | Ejemplo |
|---|---|---|---|
awsRoleArn | Opcional | Cadena |
|
awsAccessKeyId | Opcional | Cadena |
|
awsSecretAccessKey | Opcional | Cadena |
|
awsSessionToken | Opcional | Cadena |
|
región | Requerido | Cadena |
|
instanceIds | Requerido | Lista |
|
hibernar | Opcional | Booleano | verdadero o falso (predeterminado:
) |
fuerza | Opcional | Booleano | verdadero o falso (predeterminado:
) |
selectores | Opcional | Lista |
|
Importante
En la entrada de acción, se debe proporcionar al menos una de las credenciales de AWS (corta, larga o de rol), donde la de rol tiene prioridad sobre las demás.
Campo de salida | Tipo | Ejemplo |
|---|---|---|
response | Objeto | La sintaxis de respuesta se puede consultar como stop_instances |
éxito | Booleano |
|
mensaje de error | Cadena |
|
Ejemplo de flujo de trabajo |
|---|
|
Aplicar un resetear de la instancia especificada. Esta operación es asincrónica; simplemente pone en cola una solicitud para resetear la instancia especificada. La operación tiene éxito si las instancias son válidas y le pertenecen. Las solicitudes para resetear una instancia terminada se ignoran.
Si una instancia no se apaga correctamente en unos minutos, Amazon EC2 realiza un resetear forzado.
Campo de entrada | Opcionalidad | Tipo | Ejemplo |
|---|---|---|---|
awsRoleArn | Opcional | Cadena |
|
awsAccessKeyId | Opcional | Cadena |
|
awsSecretAccessKey | Opcional | Cadena |
|
awsSessionToken | Opcional | Cadena |
|
región | Requerido | Cadena |
|
instanceIds | Requerido | Lista |
|
selectores | Opcional | Lista |
|
Importante
En la entrada de acción, se debe proporcionar al menos una de las credenciales de AWS (corta, larga o de rol), donde la de rol tiene prioridad sobre las demás.
Campo de salida | Tipo | Ejemplo |
|---|---|---|
response | Objeto | |
éxito | Booleano |
|
mensaje de error | Cadena |
|
Ejemplo de flujo de trabajo |
|---|
|
Cierra la instancia especificada. Esta operación es idempotente; si finaliza una instancia más de una vez, cada llamada tendrá éxito.
Si se especifican varias instancias y la solicitud falla (por ejemplo, debido a un único ID de instancia incorrecto), ninguna de las instancias se termina.
Campo de entrada | Opcionalidad | Tipo | Ejemplo |
|---|---|---|---|
awsRoleArn | Opcional | Cadena |
|
awsAccessKeyId | Opcional | Cadena |
|
awsSecretAccessKey | Opcional | Cadena |
|
awsSessionToken | Opcional | Cadena |
|
región | Requerido | Cadena |
|
instanceIds | Requerido | Lista |
|
selectores | Opcional | Lista |
|
Importante
En la entrada de acción, se debe proporcionar al menos una de las credenciales de AWS (corta, larga o de rol), donde la de rol tiene prioridad sobre las demás.
Campo de salida | Tipo | Ejemplo |
|---|---|---|
response | Objeto | La sintaxis de respuesta se puede consultar en la documentación de terminate_instances - Boto3 1.40.50. |
éxito | Booleano |
|
mensaje de error | Cadena |
|
Ejemplo de flujo de trabajo |
|---|
|
Crea una instantánea de un volumen EBS y la almacena en Amazon S3. Puede emplear instantáneas para realizar copias de seguridad, realizar copias de volúmenes EBS y almacenar datos antes de apagar una instancia.
La ubicación del volumen EBS de origen determina dónde puede crear la instantánea.
Campo de entrada | Opcionalidad | Tipo | Ejemplo |
|---|---|---|---|
awsRoleArn | Opcional | Cadena |
|
awsAccessKeyId | Opcional | Cadena |
|
awsSecretAccessKey | Opcional | Cadena |
|
awsSessionToken | Opcional | Cadena |
|
región | Requerido | Cadena |
|
descripción | Opcional | Cadena |
|
puesto avanzadoArn | Opcional | Cadena |
|
ID de volumen | Requerido | Cadena |
|
Especificaciones de la etiqueta | Opcional | Lista |
|
ubicación | Opcional | Cadena |
|
selectores | Opcional | Lista |
|
Importante
Se debe proporcionar al menos una de las credenciales de AWS (corta, larga, rol), donde el rol tiene prioridad sobre las demás.
Campo de salida | Tipo | Ejemplo |
|---|---|---|
response | Objeto | La sintaxis de respuesta puede consultar como create_snapshot. |
éxito | Booleano |
|
mensaje de error | Cadena |
|
Elimina la instantánea especificada.
No se puede eliminar una instantánea del dispositivo raíz de un volumen EBS empleado por una AMI registrada. Primero debe anular el registro de la AMI antes de poder eliminar la instantánea.
Campo de entrada | Opcionalidad | Tipo | Ejemplo |
|---|---|---|---|
awsRoleArn | Opcional | Cadena |
|
awsAccessKeyId | Opcional | Cadena |
|
awsSecretAccessKey | Opcional | Cadena |
|
awsSessionToken | Opcional | Cadena |
|
región | Requerido | Cadena |
|
snapshotId | Requerido | Cadena |
|
selectores | Opcional | Cadena |
|
Sugerencia
Se debe proporcionar al menos una de las credenciales de AWS (corta, larga, rol), donde el rol tiene prioridad sobre las demás.
Campo de salida | Tipo | Ejemplo |
|---|---|---|
response | Objeto | No hay respuesta en caso de La sintaxis de respuesta se puede consultar en la documentación de delete_snapshot - Boto3 1.40.55. |
éxito | Booleano |
|
mensaje de error | Cadena |
|
Ejemplo de flujo de trabajo |
|---|
|
Invoca un agente de AWS Bedrock.
Campo de entrada | Opcionalidad | Tipo | Ejemplo |
|---|---|---|---|
awsRoleArn | Opcional | Cadena |
|
awsAccessKeyId | Opcional | Cadena |
|
awsSecretAccessKey | Opcional | Cadena |
|
awsSessionToken | Opcional | Cadena |
|
región | Requerido | Cadena |
|
ID del agente | Requerido | Cadena |
|
ID de alias del agente | Requerido | Cadena |
|
sessionId | Opcional | Cadena |
|
texto de entrada | Requerido | Cadena |
|
parámetro | Opcional | Mapa | |
selectores | Opcional | Lista |
|
Campo de salida | Tipo | Ejemplo |
|---|---|---|
response | Objeto | |
éxito | Booleano |
|
mensaje de error | Cadena |
|
Ejemplo de flujo de trabajo |
|---|
|