As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# AWS CodePipeline invocar referência de ação
Você usa uma ação de CodePipeline invocação para simplificar o acionamento de execuções de pipeline downstream e a transmissão de variáveis de pipeline e revisões de origem entre pipelines.
**nota**
Essa ação é compatível somente para pipelines tipo V2.
**Topics**
+ [Tipo de ação](#action-reference-PipelineInvoke-type)
+ [Parâmetros de configuração](#action-reference-PipelineInvoke-parameters)
+ [Input artifacts (Artefatos de entrada)](#action-reference-PipelineInvoke-input)
+ [Artefatos de saída](#action-reference-PipelineInvoke-output)
+ [Permissões da política de função de serviço para a CodePipeline ação de invocação](#action-reference-PipelineInvoke-permissions-action)
+ [Declaração de ação](#action-reference-PipelineInvoke-example)
+ [Consulte também](#action-reference-PipelineInvoke-links)
## Tipo de ação
+ Categoria: `Invoke`
+ Proprietário: `AWS`
+ Fornecedor: `CodePipeline`
+ Versão: `1`
## Parâmetros de configuração
**PipelineName**
Obrigatório: Sim
O nome do pipeline que, ao ser executado, iniciará o pipeline de destino atual. Você já deve ter criado o pipeline de invocação. A ação iniciará o pipeline `s3-pipeline-test` (de destino) quando o pipeline (invocação) chamado `my-s3-pipeline` iniciar uma execução.
**SourceRevisions**
Obrigatório: não
As revisões de origem que você deseja que o pipeline de destino use quando for iniciado pelo pipeline de invocação. Por exemplo, uma ação de origem do S3 fornece variáveis de saída, como ID da versão e chave do objeto do S3. Você pode especificar um valor de revisão a ser usado quando o pipeline for invocado.
Para a CLI, você especifica as revisões de origem como uma string JSON serializada. Para obter mais informações sobre como usar substituições de revisão de código-fonte, consulte o [SourceRevisionOverride](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_SourceRevisionOverride.html)Guia da *CodePipeline API*.
O mapeamento usa um formato de string conforme mostrado no seguinte exemplo:
```
[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]
```
**Variáveis**
Obrigatório: não
Os nomes e os valores de variáveis com os quais você deseja que a ação seja compatível.
Para a CLI, você especifica variáveis como uma string JSON serializada. Para obter mais informações sobre o uso de variáveis de pipeline, consulte [PipelineVariable](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_PipelineVariable.html)o *Guia CodePipeline da API*.
O mapeamento usa um formato de string conforme mostrado no seguinte exemplo:
```
[{"name":"VAR1","value":"VALUE1"}]
```
A imagem a seguir mostra um exemplo da ação adicionada a um pipeline no console.
![\[Um pipeline com uma origem S3 e um estágio de compilação que inclui a ação invocar do pipeline\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/example-pipeline-invoke-run.png)
A imagem a seguir mostra um exemplo da página **Editar** da ação. No exemplo a seguir, o pipeline chamado `s3-pipeline-test` tem uma ação invocar de pipeline configurada conforme mostrado no console. A ação iniciará o pipeline `s3-pipeline-test` quando o pipeline chamado `my-s3-pipeline` concluir uma execução. O exemplo mostra que a substituição da revisão da origem pela substituição da origem S3\$1OBJECT\$1VERSION\$1ID pelo valor de revisão especificado de `zq8mjNYEexample`.
![\[A página Editar ação de um novo pipeline com a ação invocar do pipeline\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/example-pipeline-invoke-edit.png)
## Input artifacts (Artefatos de entrada)
+ **Número de artefatos:** `0`
+ **Descrição:** os artefatos de entrada não se aplicam a esse tipo de ação.
## Artefatos de saída
+ **Número de artefatos:** `0`
+ **Descrição:** os artefatos de saída não se aplicam a esse tipo de ação.
## Permissões da política de função de serviço para a CodePipeline ação de invocação
Quando CodePipeline executa a ação, a política CodePipeline de função de serviço exige a `codepipeline:StartPipelineExecution` permissão, com escopo adequado até o ARN do recurso do pipeline, a fim de manter o acesso com menos privilégios.
```
{
"Sid": "StatementForPipelineInvokeAction",
"Effect": "Allow",
"Action": "codepipeline:StartPipelineExecution",
"Resource": [
"arn:aws:codepipeline:{{region}}:{{AccountId}}:{{pipelineName}}"
]
}
```
## Declaração de ação
------
#### [ 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\"}]"
}
},
```
------
## Consulte também
Os recursos relacionados a seguir podem ajudar você à medida que trabalha com esta ação.
+ [Iniciar um pipeline com uma substituição da revisão de origem](pipelines-trigger-source-overrides.md)— Esta seção descreve o início de um pipeline com revisões de origem manualmente ou por meio do transformador de entrada de EventBridge eventos.