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.
# AWS CodePipeline invocar referencia de acción
La acción de CodePipeline invocación se utiliza para simplificar la activación de las ejecuciones de canalizaciones posteriores y el paso de variables de canalización y revisiones de fuentes entre canalizaciones.
**nota**
Esta acción solo se admite para canalizaciones de tipo V2.
**Topics**
+ [Tipo de acción](#action-reference-PipelineInvoke-type)
+ [Parámetros de configuración](#action-reference-PipelineInvoke-parameters)
+ [Artefactos de entrada](#action-reference-PipelineInvoke-input)
+ [Artefactos de salida](#action-reference-PipelineInvoke-output)
+ [Política de rol de servicio: permisos para la acción de CodePipeline invocación](#action-reference-PipelineInvoke-permissions-action)
+ [Declaración de acciones](#action-reference-PipelineInvoke-example)
+ [Véase también](#action-reference-PipelineInvoke-links)
## Tipo de acción
+ Categoría: `Invoke`
+ Propietario: `AWS`
+ Proveedor: `CodePipeline`
+ Versión: `1`
## Parámetros de configuración
**PipelineName**
Obligatorio: sí
El nombre de la canalización que, al ejecutarse, iniciará la canalización de destino actual. Debe haber creado previamente la canalización de invocación. La acción iniciará la canalización `s3-pipeline-test` (de destino) cuando la canalización (de invocación) denominada `my-s3-pipeline` inicie una ejecución.
**SourceRevisions**
Obligatorio: no
Las revisiones de origen que desea que utilice la canalización de destino cuando la inicie la canalización que la invoca. Por ejemplo, una acción de origen de S3 proporciona variables de salida como el ID de versión de S3 y la clave de objeto. Puede especificar un valor de revisión que se utilizará cuando se invoque la canalización.
Para la CLI, especifique las revisiones de origen como una cadena JSON serializada. *Para obtener más información sobre el uso de las anulaciones de revisiones de código fuente, consulta [SourceRevisionOverride](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_SourceRevisionOverride.html)la Guía de API. CodePipeline *
La asignación utiliza el formato de cadena que se muestra en el siguiente ejemplo:
```
[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]
```
**Variables**
Obligatorio: no
Los nombres y valores de las variables que desea que admita la acción.
Para la CLI, las variables se especifican como una cadena JSON serializada. Para obtener más información sobre el uso de variables de canalización, consulta [PipelineVariable](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_PipelineVariable.html)la *Guía de la CodePipeline API*.
La asignación utiliza el formato de cadena que se muestra en el siguiente ejemplo:
```
[{"name":"VAR1","value":"VALUE1"}]
```
En la siguiente imagen, se muestra un ejemplo de la acción que se agregó a una canalización en la consola.
![\[Una canalización con un origen de S3 y una etapa de compilación que incluye la acción de invocación de la canalización\]](http://docs.aws.amazon.com/es_es/codepipeline/latest/userguide/images/example-pipeline-invoke-run.png)
En la siguiente imagen, se muestra un ejemplo de la página **Editar** de la acción. En el siguiente ejemplo, la canalización con el nombre `s3-pipeline-test` tiene una acción de invocación de canalización configurada como se muestra para la consola. La acción iniciará la canalización `s3-pipeline-test` cuando la canalización denominada `my-s3-pipeline` inicie una ejecución. En el ejemplo, se muestra la anulación de revisión de origen para la anulación de origen S3\$1OBJECT\$1VERSION\$1ID con un valor de revisión especificado de `zq8mjNYEexample`.
![\[La página Editar acción de una nueva canalización con la acción de invocación de la canalización\]](http://docs.aws.amazon.com/es_es/codepipeline/latest/userguide/images/example-pipeline-invoke-edit.png)
## Artefactos de entrada
+ **Número de artefactos:** `0`
+ **Descripción:** los artefactos de entrada no se aplican a este tipo de acción.
## Artefactos de salida
+ **Número de artefactos:** `0`
+ **Descripción:** los artefactos de salida no se aplican a este tipo de acción.
## Política de rol de servicio: permisos para la acción de CodePipeline invocación
Cuando CodePipeline se ejecuta la acción, la política de rol de CodePipeline servicio requiere el `codepipeline:StartPipelineExecution` permiso, que se extiende adecuadamente al ARN del recurso de canalización para mantener el acceso con el mínimo de privilegios.
```
{
"Sid": "StatementForPipelineInvokeAction",
"Effect": "Allow",
"Action": "codepipeline:StartPipelineExecution",
"Resource": [
"arn:aws:codepipeline:{{region}}:{{AccountId}}:{{pipelineName}}"
]
}
```
## Declaración de acciones
------
#### [ YAML ]
```
name: Invoke-pipeline
actionTypeId:
category: Invoke
owner: AWS
provider: CodePipeline
version: '1'
runOrder: 2
configuration:
PipelineName: my-s3-pipeline
SourceRevisions: '[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]'
Variables: '[{"name":"VAR1","value":"VALUE1"}]'
```
------
#### [ JSON ]
```
{
"name": "Invoke-pipeline",
"actionTypeId": {
"category": "Invoke",
"owner": "AWS",
"provider": "CodePipeline",
"version": "1"
},
"runOrder": 2,
"configuration": {
"PipelineName": "my-s3-pipeline",
"SourceRevisions": "[{\"actionName\":\"Source\",\"revisionType\":\"S3_OBJECT_VERSION_ID\",\"revisionValue\":\"zq8mjNEXAMPLE"}]",
"Variables": "[{\"name\":\"VAR1\",\"value\":\"VALUE1\"}]"
}
},
```
------
## Véase también
Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta acción.
+ [Iniciar una canalización con una anulación de revisión de código fuente](pipelines-trigger-source-overrides.md)— En esta sección se describe cómo iniciar una canalización con revisiones de fuentes de forma manual o mediante el transformador de entrada de EventBridge eventos.