Esta página proporciona una referencia de las acciones de AWS EC2 disponibles en el catálogo de acciones de automatización del flujo de trabajo. Utilice estas acciones para administrar instancias EC2, volúmenes y snapshots de EBS, direcciones IP de Elastic, Amazon Machine Images (AMI), grupos de seguridad, pares de claves y etiquetas de recursos de EC2.
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 de AWS para obtener información sobre cómo crear usuarios y roles de IAM, y configurar credenciales de AWS estáticas y de sesión para la integración con las acciones de AWS de automatización de flujos de trabajo.
Instancia de ejecución
El identificador de la acción es aws.ec2.runInstances.
Lanza el número especificado de instancias utilizando una AMI para la que tiene permisos. Si no especifica un ID de subred, se utiliza la subred de VPC predeterminada. Si alguna AMI tiene un código de producto al que el usuario no se ha suscrito, la solicitud falla.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se realizará el lanzamiento de las instancias. |
|
| Cadena | Obligatorio. El ID de la AMI a usar para la instancia. |
|
| Cadena | Obligatorio. El tipo de instancia que se usará para la instancia. |
|
| En t | Obligatorio. Número mínimo de instancias a lanzar. |
|
| En t | Obligatorio. Número máximo de instancias a lanzar. |
|
| Mapa | Opcional. Parámetros adicionales de la API de boto3 para la llamada run_instances. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
Sugerencia
El mapa parameters acepta cualquier argumento opcional disponible en la API de boto3, lo que le permite construir requests dinámicamente.
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de run_instances . |
| Booleano |
o
|
| Cadena |
|
Describe una instancia
El identificador de la acción es aws.ec2.describeInstances.
Describe la instancia especificada o todas las instancias.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentran las instancias. |
|
| Lista | Opcional. Lista de ID de las instancias a describir. |
|
| Lista | Opcional. Filtros para aplicar a la solicitud de descripción. |
|
| Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
| En t | Opcional. Número máximo de resultados a devolver. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de describe_instances . |
| Booleano |
o
|
| Cadena |
|
Importante
Si especifica ID de las instancias, la salida incluye información solo para las instancias especificadas. Si especifica filtros, la salida incluye información solo para aquellas instancias que cumplen con los criterios del filtro. Si no especifica ninguno, la salida incluye información para todas las instancias. El parámetro instanceIds no se puede utilizar junto con maxResults.
Reiniciar instancias
El identificador de la acción es aws.ec2.startInstances.
Inicia una instancia respaldada por Amazon EBS que detuviste previamente.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentran las instancias. |
|
| Lista | Obligatorio. Lista de ID de las instancias a iniciar. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de start_instances . |
| Booleano |
o
|
| Cadena |
|
Detener instancias
El identificador de la acción es aws.ec2.stopInstances.
Detiene una instancia respaldada por Amazon EBS.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentran las instancias. |
|
| Lista | Obligatorio. Lista de ID de la instancia para detener. |
|
| Booleano | Opcional. Hibernate la instancia en lugar de detenerla. Predeterminado:
. |
|
| Booleano | Opcional. Forzar la detención de la instancia. Predeterminado:
. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de stop_instances . |
| Booleano |
o
|
| Cadena |
|
Solicitar el reinicio de una instancia
El identificador de la acción es aws.ec2.rebootInstances.
Solicita el reinicio de las instancias especificadas. Esta operación es asincrónica —solo pone en cola una solicitud para reiniciar las instancias especificadas. La operación se realiza correctamente si las instancias son válidas y le pertenecen. Se ignoran las solicitudes para reiniciar instancias terminadas. Si una instancia no se apaga correctamente en unos pocos minutos, Amazon EC2 realiza un reinicio forzado.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentran las instancias. |
|
| Lista | Obligatorio. Lista de ID de la instancia para reiniciar. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de reboot_instances . |
| Booleano |
o
|
| Cadena |
|
Apagar instancias
El identificador de la acción es aws.ec2.terminateInstances.
Apaga las instancias especificadas. Esta operación es idempotente —si termina una instancia más de una vez, cada llamada se realiza correctamente. Si especifica varias instancias y la solicitud falla (por ejemplo, debido a un único ID de la instancia incorrecto), no se termina ninguna de las instancias.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentran las instancias. |
|
| Lista | Obligatorio. ID de las instancias a terminar. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de terminate_instances . |
| Booleano |
o
|
| Cadena |
|
Crear una instantánea de EBS
El identificador de la acción es aws.ec2.createSnapshot.
Crea una instantánea de un volumen de EBS y la almacena en Amazon S3. Puede utilizar instantáneas para copias de seguridad, para hacer copias de volúmenes de EBS y para guardar datos antes de apagar una instancia. La ubicación del volumen de EBS de origen determina dónde puede crear la instantánea.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentra el volumen de EBS. |
|
| Cadena | Obligatorio. El ID del volumen de EBS del que se creará la instantánea. |
|
| Cadena | Opcional. Una descripción para la instantánea. |
|
| Cadena | Opcional. El nombre de recurso de Amazon (ARN) del Outpost en el que se creará la instantánea. |
|
| Lista | Opcional. Etiquetas para aplicar a la instantánea en el momento de la creación. |
|
| Cadena | Opcional. La ubicación de la instantánea. Valores válidos:
,
. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de create_snapshot . |
| Booleano |
o
|
| Cadena |
|
Eliminar una instantánea
El identificador de la acción es aws.ec2.deleteSnapshot.
Elimina la instantánea especificada. No puede eliminar una instantánea del dispositivo raíz de un volumen de EBS utilizado por una AMI registrada —primero debe anular el registro de la AMI antes de poder eliminar la instantánea.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentra el snapshot. |
|
| Cadena | Obligatorio. El ID de la instantánea para eliminar. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | No hay cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de delete_snapshot . |
| Booleano |
o
|
| Cadena |
|
Asignar una dirección IP Elastic
El identificador de la acción es aws.ec2.allocateAddress.
Asigna una nueva dirección IP Elastic para usar con instancias EC2 en una VPC.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se asigna la dirección. |
|
| Cadena | Opcional. Alcance de la dirección. Utilice
para instancias de VPC. |
|
| Cadena | Opcional. Una dirección IP Elastic específica para recuperar que liberó anteriormente. |
|
| Cadena | Opcional. Limita el grupo desde el cual se anuncia la dirección IP. |
|
| Lista | Opcional. Etiquetas aplicadas a la dirección en el momento de la asignación. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de allocate_address . |
| Booleano |
o
|
| Cadena |
|
Asociar una dirección IP Elastic
El identificador de la acción es aws.ec2.associateAddress.
Asocia una dirección IP Elastic con una instancia EC2 o una interfaz de red.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se realiza la asociación. |
|
| Cadena | Opcional. El ID de asignación de IP Elastic que se va a asociar. Úselo con
o
para instancias de VPC. |
|
| Cadena | Opcional. La instancia con la que se asociará la dirección. |
|
| Cadena | Opcional. Alternativa a
para direcciones de EC2-Classic. |
|
| Cadena | Opcional. Interfaz de red objetivo en lugar de una instancia. |
|
| Cadena | Opcional. Una IP privada específica en la interfaz de red con la cual asociarse. |
|
| Booleano | Opcional. Permitir que la dirección se mueva de una asociación existente. Predeterminado:
. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
Importante
Solo ciertas combinaciones de identificadores son válidas. Para instancias de VPC, use allocationId con instanceId o networkInterfaceId. Para instancias de EC2-Classic, use publicIp con instanceId. No mezcle las dos formas.
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 para associate_address . |
| Booleano |
o
|
| Cadena |
|
Desasociar una dirección IP Elastic
El identificador de la acción es aws.ec2.disassociateAddress.
Desasocia una dirección IP Elastic de su instancia o interfaz de red actual.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde existe la asociación. |
|
| Cadena | Opcional. El ID de asociación devuelto por
. Úselo para direcciones de VPC. |
|
| Cadena | Opcional. Alternativa a
para direcciones de EC2-Classic. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
Importante
Use exactamente un identificador que coincida con el dominio en el que se asoció la dirección. Para direcciones de VPC, use associationId. Para direcciones de EC2-Classic, use publicIp.
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Sin cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de disassociate_address . |
| Booleano |
o
|
| Cadena |
|
Liberar una dirección IP Elastic
El identificador de la acción es aws.ec2.releaseAddress.
Libera una dirección IP Elastic y la devuelve al grupo de AWS. La dirección ya debe estar desasociada antes de poder liberarla.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se asigna la dirección. |
|
| Cadena | Opcional. El ID de asignación de la dirección de la VPC a liberar. |
|
| Cadena | Opcional. Alternativa a
para direcciones de EC2-Classic. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | No hay cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de release_address . |
| Booleano |
o
|
| Cadena |
|
Describir direcciones IP Elastic
El identificador de la acción es aws.ec2.describeAddresses.
Describe las direcciones IP Elastic y sus asociaciones actuales.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS para consultar. |
|
| Lista | Opcional. Restringir los resultados a estas direcciones IP públicas. |
|
| Lista | Opcional. Restringir los resultados a estos ID de asignación. |
|
| Lista | Opcional. Filtros de AWS para aplicar a la consulta. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de describe_addresses . |
| Booleano |
o
|
| Cadena |
|
Crear etiquetas
El identificador de la acción es aws.ec2.createTags.
Agrega o sobrescribe etiquetas en cualquier recurso de EC2 —instancias, volúmenes, instantáneas, grupos de seguridad, AMI, etc. Una etiqueta existente con la misma clave se sobrescribe.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentran los recursos. |
|
| Lista | Obligatorio. ID de los recursos de EC2 para etiquetar. |
|
| Lista | Obligatorio. Pares de valor principal de etiqueta para aplicar. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | No hay cuerpo de respuesta en caso de éxito. Consulte la referencia de create_tags de boto3 . |
| Booleano |
o
|
| Cadena |
|
Eliminar etiquetas
El identificador de la acción es aws.ec2.deleteTags.
Elimina etiquetas de cualquier recurso de EC2. Omita el campo tags para eliminar todas las etiquetas de los recursos especificados.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentran los recursos. |
|
| Lista | Obligatorio. ID de los recursos de EC2 de los que se eliminarán las etiquetas. |
|
| Lista | Opcional. Etiquetas para eliminar. Omita
para eliminar la clave independientemente de su valor. Omita el campo por completo para eliminar todas las etiquetas. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Sin cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de delete_tags . |
| Booleano |
o
|
| Cadena |
|
Describir etiquetas
El identificador de la acción es aws.ec2.describeTags.
Describe las etiquetas en cualquier tipo de recurso de EC2, con filtrado opcional por ID de recurso, tipo de recurso, clave o valor.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS para consultar. |
|
| Lista | Opcional. Filtros de AWS aplicados a la consulta. Filtre por
,
,
o
. |
|
| Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
| En t | Opcional. Número máximo de etiquetas a devolver por página. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de describe_tags . |
| Booleano |
o
|
| Cadena |
|
Crear un volumen
El identificador de la acción es aws.ec2.createVolume.
Crea un nuevo volumen de EBS en una zona de disponibilidad determinada. Un volumen solo se puede asociar a una instancia en la misma zona de disponibilidad.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se crea el volumen. |
|
| Cadena | Obligatorio. La zona de disponibilidad en la que se creará el volumen. |
|
| En t | Opcional. Tamaño del volumen en GiB. Obligatorio si no se proporciona
. |
|
| Cadena | Opcional. Tipo de volumen de EBS. Valores válidos:
,
,
,
,
,
,
. Por defecto:
. |
|
| Cadena | Opcional. Snapshot desde el cual restaurar el volumen. |
|
| En t | Opcional. IOPS provisionadas. Solo válido para volúmenes
,
y
. |
|
| En t | Opcional. Rendimiento en MiB/s. Solo válido para volúmenes
. |
|
| Lista | Opcional. Etiquetas aplicadas al volumen en el momento de la creación. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de create_volume . |
| Booleano |
o
|
| Cadena |
|
Eliminar un volumen
El identificador de la acción es aws.ec2.deleteVolume.
Elimina un volumen de EBS. El volumen debe estar en el estado available (completamente desconectado) antes de poder eliminarlo.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentra el volumen. |
|
| Cadena | Obligatorio. El ID del volumen a eliminar. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | No hay cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de delete_volume . |
| Booleano |
o
|
| Cadena |
|
Adjuntar un volumen
El identificador de la acción es aws.ec2.attachVolume.
Adjunta un volumen de EBS a una instancia EC2 en ejecución o detenida. El volumen y la instancia deben estar en la misma zona de disponibilidad.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentran el volumen y la instancia. |
|
| Cadena | Obligatorio. El ID del volumen para adjuntar. Debe estar en el estado
. |
|
| Cadena | Obligatorio. La instancia a la que se va a adjuntar. Debe ser
o
. |
|
| Cadena | Obligatorio. El nombre de dispositivo con el que se expone el volumen en la instancia. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de attach_volume . |
| Booleano |
o
|
| Cadena |
|
Desasociar un volumen
El identificador de la acción es aws.ec2.detachVolume.
Desvincula un volumen de EBS de una instancia EC2.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentra el volumen. |
|
| Cadena | Obligatorio. El ID del volumen para desconectar. |
|
| Cadena | Opcional. Limita la desconexión a una instancia específica. Útil cuando el volumen tiene asociación múltiple. |
|
| Cadena | Opcional. Limita la desconexión a un nombre de dispositivo específico en la instancia. |
|
| Booleano | Opcional. Fuerza la desconexión sin desmontar del SO invitado. Puede causar pérdida de datos o corrupción del sistema de archivos. Predeterminado:
. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de detach_volume . |
| Booleano |
o
|
| Cadena |
|
Modificar un volumen
El identificador de la acción es aws.ec2.modifyVolume.
Redimensiona un volumen de EBS o cambia su tipo de volumen, IOPS o rendimiento. Los volúmenes de EBS solo se pueden ampliar, nunca reducir.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentra el volumen. |
|
| Cadena | Obligatorio. El ID del volumen a modificar. |
|
| En t | Opcional. Nuevo tamaño en GiB. |
|
| Cadena | Opcional. Nuevo tipo de volumen. |
|
| En t | Opcional. Nuevas IOPS aprovisionadas. Solo válido para volúmenes
,
y
. |
|
| En t | Opcional. Nuevo rendimiento en MiB/s. Solo válido para volúmenes
. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de modify_volume . |
| Booleano |
o
|
| Cadena |
|
Describir volúmenes
El identificador de la acción es aws.ec2.describeVolumes.
Describe los volúmenes de EBS y su estado de conexión.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS para consultar. |
|
| Lista | Opcional. Restringir los resultados a ID de volumen específicos. Omitir para describir todos los volúmenes en la región. |
|
| Lista | Opcional. Filtros del lado del servidor, por ejemplo, por
,
o
. |
|
| Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
| En t | Opcional. Número máximo de volúmenes a devolver por página. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de describe_volumes . |
| Booleano |
o
|
| Cadena |
|
Copiar una instantánea
El identificador de la acción es aws.ec2.copySnapshot.
Copia un snapshot de EBS a otra región para copias de seguridad y recuperación ante desastres. El campo region especifica la región de destino.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. La región de destino a la que se copia el snapshot. |
|
| Cadena | Obligatorio. El ID de la instantánea para copiar. |
|
| Cadena | Obligatorio. La región en la que reside actualmente el snapshot de origen. |
|
| Cadena | Opcional. Descripción aplicada a la nueva instantánea. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de copy_snapshot . |
| Booleano |
o
|
| Cadena |
|
Describir instantáneas
El identificador de la acción es aws.ec2.describeSnapshots.
Describe los snapshots de EBS por propietario, volumen o criterios de filtro.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS para consultar. |
|
| Lista | Opcional. Restringir los resultados a ID de instantáneas específicos. |
|
| Lista | Opcional. Filtrar por propietario de la instantánea. Utilice
para devolver solo las instantáneas propiedad de la cuenta que realiza la llamada. |
|
| Lista | Opcional. Filtros de AWS, por ejemplo, por volumen, estado o etiqueta. |
|
| Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
| En t | Opcional. Número máximo de snapshots a devolver por página. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de describe_snapshots . |
| Booleano |
o
|
| Cadena |
|
Crear una imagen
El identificador de la acción es aws.ec2.createImage.
Crea una Amazon Machine Image (AMI) a partir de una instancia EC2 en ejecución o detenida.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentra la instancia. |
|
| Cadena | Obligatorio. La instancia EC2 desde la cual capturar la imagen. |
|
| Cadena | Obligatorio. Nombre para la nueva AMI. Debe ser único dentro de la región. |
|
| Cadena | Opcional. Descripción de formato libre para la AMI. |
|
| Booleano | Opcional. Cuando es
, AWS apaga y reinicia la instancia para garantizar una imagen coherente con el sistema de archivos. Establezca
para omitir el reinicio a costa de la coherencia de la imagen. Por defecto:
. |
|
| Lista | Opcional. Etiquetas aplicadas a la nueva AMI y a sus instantáneas en el momento de la creación. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de create_image . |
| Booleano |
o
|
| Cadena |
|
Copiar una imagen
El identificador de la acción es aws.ec2.copyImage.
Copia una Amazon Machine Image (AMI) a otra región para la recuperación ante desastres o despliegues multirregión. El campo region especifica la región de destino.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. La región de destino en la que se crea la copia. |
|
| Cadena | Obligatorio. La AMI a copiar. |
|
| Cadena | Obligatorio. La región que contiene actualmente la AMI de origen. |
|
| Cadena | Opcional. Nombre para la nueva AMI en la región de destino. |
|
| Cadena | Opcional. Descripción de formato libre para la AMI copiada. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de copy_image . |
| Booleano |
o
|
| Cadena |
|
Anular el registro de una imagen
El identificador de la acción es aws.ec2.deregisterImage.
Anula el registro de una Amazon Machine Image (AMI) de su propiedad. Anular el registro de una AMI no elimina sus instantáneas de EBS de respaldo —elimínelas por separado para dejar de incurrir en costos de almacenamiento.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde está registrada la AMI. |
|
| Cadena | Obligatorio. La AMI para anular el registro. Debe ser una AMI propiedad de la cuenta que realiza la llamada. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de deregister_image . |
| Booleano |
o
|
| Cadena |
|
Describir imágenes
El identificador de la acción es aws.ec2.describeImages.
Describe las Amazon Machine Images propiedad de su cuenta, compartidas con ella o públicas para ella.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS para consultar. |
|
| Lista | Opcional. Restringir los resultados a ID de AMI específicos. |
|
| Lista | Opcional. Limitar los resultados por propietario. Acepta un ID de cuenta de AWS,
,
o
. |
|
| Lista | Opcional. Filtros del lado del servidor, por ejemplo, por
,
o
. |
|
| Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
| En t | Opcional. Número máximo de AMI a devolver por página. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 para describe_images . |
| Booleano |
o
|
| Cadena |
|
Describir el estado de la instancia
El identificador de la acción es aws.ec2.describeInstanceStatus.
Describe el estado de una o más instancias EC2, incluidas las comprobaciones de estado del sistema y de la instancia, y los eventos programados.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS para consultar. |
|
| Lista | Opcional. ID de la instancia para comprobar. Si se omite, se devuelven todas las instancias. |
|
| Booleano | Opcional. Cuando es
, incluye instancias en estados distintos al de ejecución. Por defecto:
. |
|
| Lista | Opcional. Filtros de AWS para aplicar a la consulta. |
|
| Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
| En t | Opcional. Número máximo de resultados a devolver por página. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de describe_instance_status . |
| Booleano |
o
|
| Cadena |
|
Describir los tipos de instancia
El identificador de la acción es aws.ec2.describeInstanceTypes.
Describe las especificaciones (vCPU, memoria, red, almacenamiento) de los tipos de instancia de EC2.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS para consultar. |
|
| Lista | Opcional. Tipos de instancia específicos para describir. |
|
| Lista | Opcional. Filtros de AWS para aplicar a la consulta. |
|
| Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
| En t | Opcional. Número máximo de resultados a devolver por página. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 para describe_instance_types . |
| Booleano |
o
|
| Cadena |
|
Modificar un atributo de instancia
El identificador de la acción es aws.ec2.modifyInstanceAttribute.
Modifica un único atributo de una instancia EC2, como el tipo de instancia, la protección de terminación, los datos de usuario o la comprobación de origen/destino.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentra la instancia. |
|
| Cadena | Obligatorio. La instancia cuyo atributo se está modificando. |
|
| Mapa | Obligatorio. El atributo a modificar en el formato que espera la API de AWS. Solo se puede modificar un atributo por llamada. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
Importante
Solo se puede modificar un atributo por llamada. Cada atributo tiene una forma diferente en el mapa parameters —por ejemplo, {"InstanceType": {"Value": "t3.large"}} para cambiar el tipo de instancia o {"DisableApiTermination": {"Value": true}} para habilitar la protección de terminación. La mayoría de los atributos requieren que la instancia se detenga primero.
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | No hay cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de modify_instance_attribute . |
| Booleano |
o
|
| Cadena |
|
Habilitar el monitoreo detallado
El identificador de la acción es aws.ec2.monitorInstances.
Habilita el monitoreo detallado de CloudWatch (métricas de 1 minuto) para una o más instancias EC2.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentran las instancias. |
|
| Lista | Obligatorio. ID de las instancias en las que habilitar el monitoreo detallado. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 para monitor_instances . |
| Booleano |
o
|
| Cadena |
|
Desactivar monitoreo detallado
El identificador de la acción es aws.ec2.unmonitorInstances.
Desactiva el monitoreo detallado de CloudWatch para una o más instancias EC2, volviendo a las métricas estándar de 5 minutos.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentran las instancias. |
|
| Lista | Obligatorio. ID de las instancias en las que se desactivará el monitoreo detallado. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de unmonitor_instances . |
| Booleano |
o
|
| Cadena |
|
Obtener salida de la consola
El identificador de la acción es aws.ec2.getConsoleOutput.
Recupera la salida de la consola de una instancia EC2 para diagnósticos de arranque y resolución de problemas. La salida está codificada en base64.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentra la instancia. |
|
| Cadena | Obligatorio. La instancia desde la cual recuperar la salida de la consola. |
|
| Booleano | Opcional. Cuando es
, devuelve la última salida incluso si todavía se está procesando. Por defecto:
. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 para get_console_output . |
| Booleano |
o
|
| Cadena |
|
Obtener datos de contraseña de Windows
El identificador de la acción es aws.ec2.getPasswordData.
Recupera la contraseña de administrador cifrada para una instancia EC2 de Windows. Devuelve un campo PasswordData vacío para instancias que no son de Windows.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se encuentra la instancia. |
|
| Cadena | Obligatorio. La instancia de Windows de la cual recuperar los datos de la contraseña. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de get_password_data . |
| Booleano |
o
|
| Cadena |
|
Importar un par de claves
El identificador de la acción es aws.ec2.importKeyPair.
Importa una clave pública existente a EC2 como un par de claves. AWS solo almacena la clave pública —la clave privada nunca sale de su control.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde está registrado el par de claves. |
|
| Cadena | Obligatorio. Nombre único bajo el cual registrar el par de claves importado. |
|
| Cadena | Obligatorio. La clave pública a importar. Páselo como un secreto. |
|
| Lista | Opcional. Etiquetas aplicadas al par de claves en el momento de la importación. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de import_key_pair . |
| Booleano |
o
|
| Cadena |
|
Eliminar un par de claves
El identificador de la acción es aws.ec2.deleteKeyPair.
Elimina un par de claves de EC2. Proporcione keyName o keyPairId.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde existe el par de claves. |
|
| Cadena | Opcional. Nombre del par de claves para eliminar. Proporcione
o
. |
|
| Cadena | Opcional. ID del par de claves a eliminar. Proporcione
o
. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Sin cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de delete_key_pair . |
| Booleano |
o
|
| Cadena |
|
Describir pares de claves
El identificador de la acción es aws.ec2.describeKeyPairs.
Describe los pares de claves de EC2 en una cuenta y región.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS para consultar. |
|
| Lista | Opcional. Restringir los resultados a estos nombres de pares de claves. |
|
| Lista | Opcional. Restrinja los resultados a estos ID de pares de claves. |
|
| Lista | Opcional. Filtros de AWS, por ejemplo, por
o etiqueta. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de describe_key_pairs . |
| Booleano |
o
|
| Cadena |
|
Crear un grupo de seguridad
El identificador de la acción es aws.ec2.createSecurityGroup.
Crea un nuevo grupo de seguridad de EC2 en una VPC.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde se crea el grupo de seguridad. |
|
| Cadena | Obligatorio. Nombre para el nuevo grupo de seguridad. Debe ser único dentro de la VPC. |
|
| Cadena | Obligatorio. Descripción del grupo de seguridad. |
|
| Cadena | Opcional. VPC en la cual crear el grupo. El valor predeterminado es la VPC predeterminada de la región. |
|
| Lista | Opcional. Etiquetas aplicadas al grupo en el momento de la creación. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de create_security_group . |
| Booleano |
o
|
| Cadena |
|
Eliminar un grupo de seguridad
El identificador de la acción es aws.ec2.deleteSecurityGroup.
Elimina un grupo de seguridad de EC2. Proporcione groupId (preferido) o groupName.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde existe el grupo de seguridad. |
|
| Cadena | Opcional. El grupo de seguridad que se va a eliminar. Funciona para cualquier VPC. Preferido sobre
. |
|
| Cadena | Opcional. Alternativa a
. Solo válido para grupos en la VPC predeterminada. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | No hay cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de delete_security_group . |
| Booleano |
o
|
| Cadena |
|
Describir grupos de seguridad
El identificador de la acción es aws.ec2.describeSecurityGroups.
Describe los grupos de seguridad de EC2 y sus reglas de entrada y salida.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS para consultar. |
|
| Lista | Opcional. Restrinja los resultados a ID de grupos de seguridad específicos. |
|
| Lista | Opcional. Restringir los resultados por nombre de grupo. Solo válido para grupos en la VPC predeterminada. |
|
| Lista | Opcional. Filtros de AWS, por ejemplo, por
,
o
. |
|
| Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
| En t | Opcional. Número máximo de grupos a devolver por página. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Consulte la referencia de boto3 de describe_security_groups . |
| Booleano |
o
|
| Cadena |
|
Agregar una regla de entrada
El identificador de la acción es aws.ec2.authorizeSecurityGroupIngress.
Agrega una regla de entrada a un grupo de seguridad de EC2.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde existe el grupo de seguridad. |
|
| Cadena | Obligatorio. El grupo de seguridad al que se agregará la regla de entrada. |
|
| Cadena | Opcional. Formato plano. Úselo con
,
y
para una sola regla de IPv4. |
|
| En t | Opcional. Formato plano. Inicio del rango de puertos. |
|
| En t | Opcional. Forma plana. Fin del rango de puertos. |
|
| Cadena | Opcional. Formato plano. Bloque CIDR de origen permitido por la regla. |
|
| Lista | Opcional. Formato estructurado. Requerido para múltiples reglas en una llamada, descripciones de reglas, rangos de IPv6, listas de prefijos o grupos de seguridad de origen. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
Sugerencia
Esta acción admite dos formas de regla —elija una por llamada. La forma plana (ipProtocol, fromPort, toPort, cidrIp) es una abreviatura para una única regla de IPv4. Use ipPermissions para múltiples reglas, descripciones, rangos de IPv6, listas de prefijos o grupos de seguridad de origen.
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | No hay cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de authorize_security_group_ingress . |
| Booleano |
o
|
| Cadena |
|
Eliminar una regla de entrada
El identificador de la acción es aws.ec2.revokeSecurityGroupIngress.
Elimina una regla de entrada de un grupo de seguridad de EC2. La especificación de la regla debe coincidir exactamente con una regla existente.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde existe el grupo de seguridad. |
|
| Cadena | Obligatorio. El grupo de seguridad del cual eliminar la regla de entrada. |
|
| Cadena | Opcional. Forma plana. Use con
,
y
. |
|
| En t | Opcional. Formato plano. Inicio del rango de puertos. |
|
| En t | Opcional. Forma plana. Fin del rango de puertos. |
|
| Cadena | Opcional. Forma plana. Bloque CIDR de origen de la regla que se está eliminando. |
|
| Lista | Opcional. Formato estructurado. Requerido para revocar múltiples reglas en una llamada, o reglas en rangos de IPv6, listas de prefijos o grupos de seguridad de origen. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Sin cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de revoke_security_group_ingress . |
| Booleano |
o
|
| Cadena |
|
Agregar una regla de salida
El identificador de la acción es aws.ec2.authorizeSecurityGroupEgress.
Agrega una regla de salida a un grupo de seguridad de EC2 mediante la forma estructurada ipPermissions.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde existe el grupo de seguridad. |
|
| Cadena | Obligatorio. El grupo de seguridad al que se agregará la regla de salida. |
|
| Lista | Obligatorio. Las reglas de salida que se agregarán en formato estructurado. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
Importante
A diferencia de las acciones de reglas de entrada, esta acción no admite la forma de parámetro plano (cidrIp, ipProtocol, fromPort, toPort). La API AuthorizeSecurityGroupEgress de AWS rechaza esos parámetros por completo. Todas las reglas de salida deben usar la lista ipPermissions estructurada.
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | No hay cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de authorize_security_group_egress . |
| Booleano |
o
|
| Cadena |
|
Eliminar una regla de salida
El identificador de la acción es aws.ec2.revokeSecurityGroupEgress.
Elimina una regla de salida de un grupo de seguridad de EC2. La especificación de la regla debe coincidir exactamente con una regla existente. Un uso común es eliminar la regla de salida predeterminada que permite todo que AWS asocia a cada nuevo grupo de seguridad.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Obligatorio. Región de AWS donde existe el grupo de seguridad. |
|
| Cadena | Obligatorio. El grupo de seguridad del que se eliminará la regla de salida. |
|
| Lista | Obligatorio. Las reglas de salida a eliminar en el formato estructurado. Debe coincidir exactamente con las reglas existentes. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
Importante
A diferencia de las acciones de reglas de entrada, esta acción no admite la forma de parámetro plano (cidrIp, ipProtocol, fromPort, toPort). Todas las reglas de salida deben usar la lista estructurada ipPermissions.
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | No hay cuerpo de respuesta en caso de éxito. Consulte la referencia de boto3 de revoke_security_group_egress . |
| Booleano |
o
|
| Cadena |
|