Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # YAML de la acción invocar de AWS Lambda A continuación, encontrará una definición en YAML de la acción **invocar de AWS Lambda **. Para obtener información sobre cómo utilizar esta acción, consulte [Invocación de una función de Lambda mediante un flujo de trabajo](lam-invoke-action.md). Esta definición de acción existe como una sección dentro de un archivo de definición de flujo de trabajo más amplio. Para obtener más información acerca de este archivo, consulte [Definición de flujo de trabajo en YAML](workflow-reference.md). **nota** La mayoría de las propiedades de YAML que se muestran a continuación tienen elementos de interfaz de usuario correspondientes en el editor visual. Para buscar un elemento de la interfaz de usuario, use **Ctrl\$1F**. El elemento aparecerá en la lista con su propiedad de YAML asociada. ``` # The workflow definition starts here. # See Propiedades de nivel superior for details. Name: MyWorkflow SchemaVersion: 1.0 Actions: # The action definition starts here. LambdaInvoke\$1nn: Identifier: aws/lambda-invoke@v1 DependsOn: - dependent-action Compute: Type: EC2 | Lambda Fleet: fleet-name Timeout: timeout-minutes Inputs: # Specify a source or an artifact, but not both. Sources: - source-name-1 Artifacts: - request-payload Variables: - Name: variable-name-1 Value: variable-value-1 - Name: variable-name-2 Value: variable-value-2 Environment: Name: environment-name Connections: - Name: account-connection-name Role: iam-role-name Configuration: Function: my-function|function-arn AWSRegion: us-west-2 # Specify RequestPayload or RequestPayloadFile, but not both. RequestPayload: '{"firstname": "Li", lastname: "Jean", "company": "ExampleCo", "team": "Development"}' RequestPayloadFile: my/request-payload.json ContinueOnError: true|false LogType: Tail|None ResponseFilters: '{"name": ".name", "company": ".department.company"}' Outputs: Artifacts: - Name: lambda_artifacts Files: - "lambda-response.json" ``` ## LambdaInvoke (Obligatorio) Especifique el nombre de la acción. Todos los nombres de las acciones deben ser únicos dentro del flujo de trabajo. Los nombres de las acciones están limitados a caracteres alfanuméricos (a-z, A-Z y 0-9), guiones (-) y guiones bajos (\$1). No se permiten espacios. No puede utilizar comillas para permitir caracteres especiales ni espacios en los nombres de las acciones. Predeterminado: `Lambda_Invoke_Action_Workflow_nn`. Interfaz de usuario correspondiente: pestaña Configuración/**Nombre de la acción** ## Identifier (*LambdaInvoke*/**Identifier**) (Obligatorio) Identifica la acción. No cambie esta propiedad a menos que desee cambiar la versión. Para obtener más información, consulte [Especificación de la versión de la acción que se va a utilizar](workflows-action-versions.md). Predeterminado: `aws/lambda-invoke@v1`. Interfaz de usuario correspondiente: Diagrama de flujo de trabajo/LambdaInvoke\$1nn/etiqueta **aws/lambda-invoke@v1** ## DependsOn (*LambdaInvoke*/**DependsOn**) (Opcional) Especifique la acción, el grupo de acciones o la puerta que debe ejecutarse correctamente para que esta acción se ejecute. Para obtener más información sobre la funcionalidad “depende de”, consulte [Secuenciación de acciones](workflows-depends-on.md). Interfaz de usuario correspondiente: pestaña Entradas/**Depende de (opcional)** ## Compute (*LambdaInvoke*/**Compute**) (Opcional) El motor de computación utilizado para ejecutar las acciones del flujo de trabajo. Puede especificar el motor de computación en el nivel del flujo de trabajo o en el nivel de acción, pero no en ambos. Cuando se especifica en el nivel de flujo de trabajo, la configuración del motor de computación se aplica a todas las acciones definidas en el flujo de trabajo. En el nivel de flujo de trabajo, también puede ejecutar varias acciones en la misma instancia. Para obtener más información, consulte [Uso compartido de recursos de computación entre acciones](compute-sharing.md). Interfaz de usuario correspondiente: *ninguna* ## Type (*LambdaInvoke*/Compute/**Type**) (Obligatorio si se incluye [Compute](#lam.invoke.computename)) El tipo de motor de computación. Puede utilizar uno de los siguientes valores: + **EC2**(editor visual) o (editor YAML`EC2`) Optimizado para ofrecer flexibilidad durante las ejecuciones de acciones. + **Lambda** (editor visual) o `Lambda` (editor de YAML) Velocidades de inicio de acciones optimizadas. Para obtener más información sobre los tipos de computación, consulte [Tipos de computación](workflows-working-compute.md#compute.types). Interfaz de usuario correspondiente: pestaña Configuración/**Tipo de computación** ## Fleet (*LambdaInvoke*/Compute/**Fleet**) (Opcional) Especifique la máquina o la flota que ejecutará el flujo de trabajo o las acciones del flujo de trabajo. Con las flotas bajo demanda, cuando se inicia una acción, el flujo de trabajo aprovisiona los recursos que necesita y las máquinas se destruyen cuando finaliza la acción. Ejemplos de flotas bajo demanda: `Linux.x86-64.Large`, `Linux.x86-64.XLarge`. Para obtener más información sobre las flotas bajo demanda, consulte [Propiedades de las flotas bajo demanda](workflows-working-compute.md#compute.on-demand). Con las flotas aprovisionadas, configura un conjunto de máquinas dedicadas para ejecutar las acciones del flujo de trabajo. Estas máquinas permanecen inactivas, listas para procesar acciones de forma inmediata. Para obtener más información sobre las flotas aprovisionadas, consulte [Propiedades de flotas aprovisionadas](workflows-working-compute.md#compute.provisioned-fleets). Si `Fleet` se omite, el valor predeterminado es `Linux.x86-64.Large`. Interfaz de usuario correspondiente: pestaña Configuración/**Flota de computación** ## Timeout (*LambdaInvoke*/**Timeout**) (Obligatorio) Especifique la cantidad de tiempo en minutos (editor YAML) o en horas y minutos (editor visual) que la acción puede ejecutarse antes de que CodeCatalyst finalice la acción. El mínimo es 5 minutos y el máximo se describe en [Cuotas para flujos de trabajo en CodeCatalyst](workflows-quotas.md). El tiempo de espera predeterminado es el mismo que el tiempo de espera máximo. Interfaz de usuario correspondiente: pestaña Configuración/**Tiempo de espera (opcional)** ## Inputs (*LambdaInvoke*/**Inputs**) (Obligatorio) La sección `Inputs` define los datos que la acción **invocar en AWS Lambda ** necesita durante la ejecución de un flujo de trabajo. **nota** Solo se permite una entrada (ya sea un código fuente o un artefacto) para cada acción **invocar en AWS Lambda **. Las variables no se contabilizan en este total. Interfaz de usuario correspondiente: pestaña **Entradas** ## Sources (*LambdaInvoke*/Inputs/**Sources**) (Obligatorio si [RequestPayloadFile](#lam.invoke.request.payload.file)se proporciona) Si quiere pasar un archivo JSON de carga útil de solicitud a la acción **invocar en AWS Lambda ** y ese archivo de carga útil está almacenado en un repositorio de código fuente, especifique la etiqueta de ese repositorio. Actualmente, la única etiqueta admitida es `WorkflowSource`. Si el archivo de carga útil de solicitud no está incluido en un repositorio de código fuente, debe residir en un artefacto generado por otra acción. Para obtener más información sobre el archivo de carga útil, consulte [RequestPayloadFile](#lam.invoke.request.payload.file). **nota** En lugar de especificar un archivo de carga útil, puede añadir el código JSON de la carga útil directamente en la acción mediante la propiedad `RequestPayload`. Para obtener más información, consulte [RequestPayload](#lam.invoke.request.payload). Para obtener más información sobre orígenes, consulte [Conexión de repositorios de código fuente a flujos de trabajo](workflows-sources.md). Interfaz de usuario correspondiente: pestaña Entradas/**Orígenes (opcional)** ## Artifacts - input (*LambdaInvoke*/Inputs/**Artifacts**) (Obligatorio si [RequestPayloadFile](#lam.invoke.request.payload.file)se proporciona) Si desea pasar un archivo JSON de carga útil de solicitud a la acción **invocar en AWS Lambda ** y ese archivo de carga útil está contenido en un [artefacto de salida](build-action-ref.md#build.outputs.artifacts) de una acción anterior, especifique aquí ese artefacto. Para obtener más información sobre el archivo de carga útil, consulte [RequestPayloadFile](#lam.invoke.request.payload.file). **nota** En lugar de especificar un archivo de carga útil, puede añadir el código JSON de la carga útil directamente en la acción mediante la propiedad `RequestPayload`. Para obtener más información, consulte [RequestPayload](#lam.invoke.request.payload). Para obtener más información sobre los artefactos, incluidos ejemplos, consulte [Cómo compartir artefactos y archivos entre acciones](workflows-working-artifacts.md). Interfaz de usuario correspondiente: pestaña Configuración/**Artefactos (opcional)** ## Variables - input (*LambdaInvoke*/Inputs/**Variables**) (Opcional) Especifique una secuencia de name/value pares que defina las variables de entrada que desea poner a disposición de la acción. Los nombres de variables están limitados a caracteres alfanuméricos (a-z, A-Z y 0-9), guiones (-) y guiones bajos (\$1). No se permiten espacios. No puede utilizar comillas para permitir caracteres especiales ni espacios en los nombres de variables. Para obtener más información sobre las variables, incluidos ejemplos, consulte [Uso de variables en flujos de trabajo](workflows-working-with-variables.md). Interfaz de usuario correspondiente: pestaña Entradas/**Variables (opcional)** ## Environment (*LambdaInvoke*/**Environment**) (Obligatorio) Especifique el CodeCatalyst entorno que se va a utilizar con la acción. La acción se conecta a Cuenta de AWS la Amazon VPC opcional especificada en el entorno elegido. La acción utiliza la función de IAM predeterminada especificada en el entorno para conectarse a Cuenta de AWS, y utiliza la función de IAM especificada en la [conexión de Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) para conectarse a la Amazon VPC. **nota** Si el rol de IAM predeterminado no tiene los permisos necesarios para la acción, puede configurarla para que utilice un rol diferente. Para obtener más información, consulte [Cambio del rol de IAM de una acción](deploy-environments-switch-role.md). Para obtener más información sobre los entornos, consulte [Implementación en Cuentas de AWS y VPCs](deploy-environments.md) y [Creación de un entorno](deploy-environments-creating-environment.md). Interfaz de usuario correspondiente: pestaña Configuración/**Entorno** ## Name (*LambdaInvoke*/Environment/**Name**) (Obligatorio si se incluye [Environment](#lam.invoke.environment)) Especifique el nombre del entorno existente que desea asociar a la acción. Interfaz de usuario correspondiente: pestaña Configuración/**Entorno** ## Connections (*LambdaInvoke*/Environment/**Connections**) (Opcional en las versiones más recientes de la acción; obligatorio en las versiones más antiguas) Especifique la conexión de cuenta que desee asociar a la acción. Puede especificar un máximo de una conexión de cuenta en `Environment`. Si no especifica una conexión de cuenta: + La acción utiliza la Cuenta de AWS conexión y la función de IAM predeterminada especificadas en el entorno de la consola. CodeCatalyst Para obtener información sobre cómo añadir una conexión de cuenta y un rol de IAM predeterminado al entorno, consulte [Creación de un entorno](deploy-environments-creating-environment.md). + El rol de IAM predeterminado debe incluir las políticas y los permisos que requiere la acción. Para determinar cuáles son esas políticas y permisos, consulte la descripción de la propiedad **Role** en la documentación de la definición de YAML de la acción. Para obtener más información sobre las conexiones de cuenta, consulte [Permitir el acceso a AWS los recursos con conexión Cuentas de AWS](ipa-connect-account.md). Para obtener más información sobre cómo añadir una conexión de cuenta a un entorno, consulte [Creación de un entorno](deploy-environments-creating-environment.md). Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción. + (Versiones más recientes) ¿tab/Environment/WhatLa configuración está lista? *my-environment* **/menú de tres puntos/ Cambiar rol** + **(Versiones anteriores) Pestaña de configuración/' '/ conexión de cuenta Environment/account/role AWS ** ## Name (*LambdaInvoke*/Environment/Connections/**Name**) (Obligatorio si se incluye [Connections](#lam.invoke.environment.connections)) Especifique el nombre de la conexión de cuenta. Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción. + (Versiones más recientes) ¿La configuración está lista? tab/Environment/What *my-environment* **/menú de tres puntos/ Cambiar rol** + **(Versiones anteriores) Pestaña de configuración/' '/ conexión de cuenta Environment/account/role AWS ** ## Role (*LambdaInvoke*/Environment/Connections/**Role**) (Obligatorio si se incluye [Connections](#lam.invoke.environment.connections)) Especifique el nombre de la función de IAM que la acción de **AWS Lambda invocación** utiliza para acceder a la función AWS Lambda e invocarla. Asegúrese de haber [agregado el rol a su CodeCatalyst espacio](ipa-connect-account-addroles.md) y de que el rol incluya las siguientes políticas. Si no especifica un rol de IAM, la acción utilizará el rol de IAM predeterminado que aparece en el [entorno](deploy-environments.md) de la consola. CodeCatalyst Si usa el rol predeterminado en el entorno, asegúrese de que tenga las siguientes políticas. + La siguiente política de permisos: **aviso** Limite los permisos a los que se muestran en la siguiente política. El uso de un rol con permisos más amplios puede suponer un riesgo de seguridad. + La siguiente política de confianza personalizada: **nota** Puede usar el rol `CodeCatalystWorkflowDevelopmentRole-spaceName` con esta acción, si así lo desea. Para obtener más información acerca de este rol, consulte [Creación del rol **CodeCatalystWorkflowDevelopmentRole-*spaceName*** para su cuenta y su espacio](ipa-iam-roles.md#ipa-iam-roles-service-create). Tenga en cuenta que el rol `CodeCatalystWorkflowDevelopmentRole-spaceName` tiene permisos de acceso total, lo que puede suponer un riesgo para la seguridad. Le recomendamos que utilice este rol solo en tutoriales y situaciones en las que la seguridad no sea un problema. Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción. + (Versiones más recientes) ¿tab/Environment/WhatLa configuración está lista? *my-environment* **/menú de tres puntos/ Cambiar rol** + **(Versiones anteriores) Pestaña de configuración/' '/ Rol Environment/account/role** ## Configuration (*LambdaInvoke*/**Configuration**) (Obligatorio) Una sección en la que puede definir las propiedades de configuración de la acción. Interfaz de usuario correspondiente: pestaña **Configuración** ## Function (*LambdaInvoke*/Configuration/**Function**) (Obligatorio) Especifique la AWS Lambda función que invocará esta acción. Puede especificar el nombre de la función o su Nombre de recurso de Amazon (ARN). Encontrará el nombre o el ARN en la consola de Lambda. **nota** La AWS cuenta en la que reside la función Lambda puede ser diferente de la cuenta especificada en. `Connections:` Interfaz de usuario correspondiente: pestaña Configuración/**Función** ## AWSRegion (*LambdaInvoke*/Configuration/**AWSRegion**) (Obligatorio) Especifique la AWS región en la que reside AWS Lambda la función. Para obtener una lista de códigos de región, consulte [Puntos de conexión regionales](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) en la *Referencia general de AWS*. Interfaz de usuario correspondiente: pestaña Configuración/**Bucket de destino (opcional)** ## RequestPayload (*LambdaInvoke*/Configuration/**RequestPayload**) (Opcional) Si quiere pasar una carga útil de solicitud a la acción **invocar en AWS Lambda **, especifique aquí la carga útil de solicitud, en formato JSON. Ejemplo de carga útil de solicitud: ``` '{ "key": "value" }' ``` Si no desea pasar una carga útil de solicitud a la función de Lambda, omita esta propiedad. **nota** Puede especificar `RequestPayload` o `RequestPayloadFile`, pero no ambos. Para obtener más información sobre la carga útil de solicitud, consulte el tema [Invocar](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html) en la *Referencia de la API de AWS Lambda *. Interfaz de usuario correspondiente: pestaña Configuración/**Carga útil de solicitud (opcional)** ## RequestPayloadFile (*LambdaInvoke*/Configuration/**RequestPayloadFile**) (Opcional) Si quiere pasar una carga útil de solicitud a la acción **invocar en AWS Lambda **, especifique aquí la ruta a esa carga útil de solicitud. El archivo debe estar en formato JSON. El archivo de carga útil de la solicitud puede residir en un repositorio de código fuente o en un artefacto de una acción anterior. La ruta del archivo hace referencia al directorio raíz del repositorio de código fuente o del artefacto. Si no desea pasar una carga útil de solicitud a la función de Lambda, omita esta propiedad. **nota** Puede especificar `RequestPayload` o `RequestPayloadFile`, pero no ambos. Para obtener más información sobre el archivo de carga útil de solicitud, consulte el tema [Invocar](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html) en la *Referencia de la API de AWS Lambda *. Interfaz de usuario correspondiente: pestaña Configuración/**Archivo de carga útil de solicitud (opcional)** ## ContinueOnError (*LambdaInvoke*/Configuration/**RequestPayloadFile**) (Opcional) Especifique si desea marcar la acción **invocar en AWS Lambda ** como realizada correctamente aunque haya un error en la función de AWS Lambda invocada. Valore la posibilidad de poner esta propiedad en `true` para permitir que se inicien las acciones posteriores del flujo de trabajo a pesar del error en Lambda. El valor predeterminado es que la acción falle si la función de Lambda falla (“desactivado” en el editor visual o `false` en el editor YAML). Interfaz de usuario correspondiente: pestaña Configuración/**Continuar en caso de error** ## LogType (*LambdaInvoke*/Configuration/**LogType**) (Opcional) Especifique si desea incluir los registros de errores en la respuesta de la función de Lambda después de invocarla. Puede ver estos registros en la pestaña **Registros** de la acción de **invocación de Lambda** en la consola. CodeCatalyst Los valores posibles son los que se indican a continuación. + `Tail`: devolver registros + `None`: no devolver registros El valor predeterminado es **Cola**. Para obtener más información sobre el tipo de registro, consulte el tema [Invocar](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html) en la *Referencia de la API de AWS Lambda *. Para obtener más información acerca de cómo visualizar los archivos de registro, consulte [Visualización del estado y los detalles de la ejecución de un flujo de trabajo](workflows-view-run.md). Interfaz de usuario correspondiente: pestaña Configuración/**Tipo de registro** ## ResponseFilters (*LambdaInvoke*/Configuration/**ResponseFilters**) (Opcional) Especifique qué claves de la carga útil de respuesta de Lambda desea convertir en variables de salida. Luego, puede hacer referencia a las variables de salida en acciones posteriores del flujo de trabajo. Para obtener más información sobre las variables de CodeCatalyst, consulte. [Uso de variables en flujos de trabajo](workflows-working-with-variables.md) Por ejemplo, si la carga útil de respuesta tiene el siguiente aspecto: ``` responsePayload = { "name": "Saanvi", "location": "Seattle", "department": { "company": "Amazon", "team": "AWS" } } ``` y los filtros de respuesta son similares a lo siguiente: ``` Configuration: ... ResponseFilters: '{"name": ".name", "company": ".department.company"}' ``` la acción generará las siguientes variables de salida: | Clave | Valor | | --- | --- | | name | Saanvi | | company | Amazon | A continuación, puede hacer referencia a las variables `name` y `company` en acciones posteriores. Si no especifica ninguna clave en `ResponseFilters`, la acción convierte cada clave de nivel superior de la respuesta de Lambda en una variable de salida. Para obtener más información, consulte [Variables de invocar en AWS Lambda](lam-invoke-action-variables.md). Valore la posibilidad de utilizar filtros de respuesta para limitar las variables de salida generadas a las que realmente desee utilizar. Interfaz de usuario correspondiente: pestaña Configuración/**Filtros de respuesta (opcional)** ## Outputs (*LambdaInvoke*/**Outputs**) (Opcional) Define los datos que necesita una acción durante la ejecución de un flujo de trabajo. Interfaz de usuario correspondiente: pestaña **Salidas** ## Artifacts (*LambdaInvoke*/Outputs/**Artifacts**) (Opcional) Especifique el nombre de los artefactos generados por la acción. Puede hacer referencia a estos artefactos como entrada en otras acciones. Para obtener más información sobre los artefactos, incluidos ejemplos, consulte [Cómo compartir artefactos y archivos entre acciones](workflows-working-artifacts.md). Interfaz de usuario correspondiente: pestaña Salidas/Artefactos/**Nombre del artefacto de compilación** ## Name (*LambdaInvoke*/Outputs/Artifacts/**Name**) (Opcional) Especifique el nombre del artefacto que contendrá la carga útil de respuesta de Lambda devuelta por la función de Lambda. El valor predeterminado es `lambda_artifacts`. Si no especifica un artefacto, la carga útil de la respuesta de Lambda se puede ver en los registros de la acción, que están disponibles en la pestaña Registros de **la** acción en la consola. CodeCatalyst Para obtener más información acerca de cómo visualizar los archivos de registro, consulte [Visualización del estado y los detalles de la ejecución de un flujo de trabajo](workflows-view-run.md). Interfaz de usuario correspondiente: pestaña Salidas/Artefactos/**Nombre del artefacto de compilación** ## Files (*LambdaInvoke*/Outputs/Artifacts/**Files**) (Opcional) Especifique los archivos que desee incluir en el artefacto. Debe especificar `lambda-response.json` para incluir el archivo de carga útil de respuesta de Lambda. Interfaz de usuario correspondiente: pestaña Salidas/Artefactos/**Archivos producidos por compilación**