Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# AWS CodePipeline memanggil referensi tindakan
<a name="action-reference-PipelineInvoke"></a>

Anda menggunakan tindakan CodePipeline pemanggilan untuk menyederhanakan pemicu eksekusi pipa hilir dan meneruskan variabel pipeline dan revisi sumber antar pipeline.

**catatan**  
Tindakan ini hanya didukung untuk pipeline tipe V2.

**Topics**
+ [Tipe tindakan](#action-reference-PipelineInvoke-type)
+ [Parameter konfigurasi](#action-reference-PipelineInvoke-parameters)
+ [Artefak masukan](#action-reference-PipelineInvoke-input)
+ [Artefak keluaran](#action-reference-PipelineInvoke-output)
+ [Izin kebijakan peran layanan untuk tindakan CodePipeline pemanggilan](#action-reference-PipelineInvoke-permissions-action)
+ [Deklarasi tindakan](#action-reference-PipelineInvoke-example)
+ [Lihat juga](#action-reference-PipelineInvoke-links)

## Tipe tindakan
<a name="action-reference-PipelineInvoke-type"></a>
+ Kategori: `Invoke`
+ Pemilik: `AWS`
+ Penyedia: `CodePipeline`
+ Versi: `1`

## Parameter konfigurasi
<a name="action-reference-PipelineInvoke-parameters"></a>

**PipelineName**  
Wajib: Ya  
Nama pipa yang akan, setelah berjalan, memulai pipa target saat ini. Anda harus sudah membuat pipeline pemanggilan. Tindakan akan memulai pipeline `s3-pipeline-test` (target) saat pipeline (pemanggilan) bernama `my-s3-pipeline` memulai eksekusi.

**SourceRevisions**  
Wajib: Tidak  
Revisi sumber yang Anda inginkan untuk digunakan pipeline target saat dimulai oleh pipeline pemanggilan. Misalnya, aksi sumber S3 menyediakan variabel keluaran seperti ID Versi S3 dan Kunci Objek. Anda dapat menentukan nilai revisi yang akan digunakan saat pipeline dipanggil.   
Untuk CLI, Anda menentukan revisi sumber sebagai string JSON serial. *Untuk informasi selengkapnya tentang penggunaan penggantian revisi sumber, lihat [SourceRevisionOverride](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_SourceRevisionOverride.html)di Panduan API. CodePipeline *  
Pemetaan menggunakan format string seperti yang ditunjukkan pada contoh berikut:  

```
[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]
```

**Variabel**  
Wajib: Tidak  
Nama dan nilai variabel yang Anda ingin tindakan untuk mendukung.  
Untuk CLI, Anda menentukan variabel sebagai string JSON serial. Untuk informasi selengkapnya tentang penggunaan variabel pipeline, lihat [PipelineVariable](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_PipelineVariable.html)di *Panduan CodePipeline API*.  
Pemetaan menggunakan format string seperti yang ditunjukkan pada contoh berikut:  

```
[{"name":"VAR1","value":"VALUE1"}]
```

Gambar berikut menunjukkan contoh tindakan yang ditambahkan ke pipeline di konsol. 

![\[Pipeline dengan sumber S3 dan tahap pembuatan yang menyertakan aksi pemanggilan pipeline\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/example-pipeline-invoke-run.png)


Gambar berikut menunjukkan contoh halaman **Edit** untuk tindakan tersebut. Dalam contoh berikut, pipeline bernama `s3-pipeline-test` memiliki tindakan pemanggilan pipeline yang dikonfigurasi seperti yang ditunjukkan untuk konsol. Tindakan akan memulai `s3-pipeline-test` pipeline ketika pipeline bernama `my-s3-pipeline` menyelesaikan eksekusi. Contoh menunjukkan bahwa penggantian revisi sumber untuk penggantian sumber S3\$1OBJECT\$1VERSION\$1ID dengan nilai revisi tertentu dari. `zq8mjNYEexample`

![\[Halaman tindakan Edit untuk pipeline baru dengan tindakan pemanggilan pipeline\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/example-pipeline-invoke-edit.png)


## Artefak masukan
<a name="action-reference-PipelineInvoke-input"></a>
+ **Jumlah artefak:** `0`
+ **Deskripsi:** Artefak masukan tidak berlaku untuk jenis tindakan ini.

## Artefak keluaran
<a name="action-reference-PipelineInvoke-output"></a>
+ **Jumlah artefak:** `0` 
+ **Deskripsi:** Artefak keluaran tidak berlaku untuk jenis tindakan ini.

## Izin kebijakan peran layanan untuk tindakan CodePipeline pemanggilan
<a name="action-reference-PipelineInvoke-permissions-action"></a>

Saat CodePipeline menjalankan tindakan, kebijakan peran CodePipeline layanan memerlukan `codepipeline:StartPipelineExecution` izin, yang dicakup dengan tepat ke ARN sumber daya pipeline untuk mempertahankan akses dengan hak istimewa paling sedikit.

```
 {
            "Sid": "StatementForPipelineInvokeAction",
            "Effect": "Allow",
            "Action": "codepipeline:StartPipelineExecution",
            "Resource": [
                "arn:aws:codepipeline:{{region}}:{{AccountId}}:{{pipelineName}}"
            ]
        }
```

## Deklarasi tindakan
<a name="action-reference-PipelineInvoke-example"></a>

------
#### [ 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\"}]"
    }
},
```

------

## Lihat juga
<a name="action-reference-PipelineInvoke-links"></a>

Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan tindakan ini.
+  [Mulai pipeline dengan penggantian revisi sumber](pipelines-trigger-source-overrides.md)— Bagian ini menjelaskan memulai pipa dengan revisi sumber secara manual atau melalui transformator input EventBridge peristiwa.