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

# Perbarui rilis kenari
<a name="update-canary-deployment"></a>

 Setelah rilis kenari diterapkan, Anda mungkin ingin menyesuaikan persentase lalu lintas kenari atau mengaktifkan atau menonaktifkan penggunaan cache panggung untuk mengoptimalkan kinerja pengujian. Anda juga dapat memodifikasi variabel tahap yang digunakan dalam rilis kenari saat konteks eksekusi diperbarui. [Untuk melakukan pembaruan seperti itu, panggil operasi [https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateStage.html](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateStage.html) dengan nilai baru di CanarySettings.](https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html#canarySettings) 

Anda dapat memperbarui rilis canary menggunakan konsol API Gateway, perintah AWS CLI [tahap pembaruan, atau SDK](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html). AWS 

**Topics**
+ [Memperbarui rilis kenari menggunakan konsol API Gateway](#update-canary-deployment-using-console)
+ [Perbarui rilis kenari menggunakan AWS CLI](#update-canary-deployment-using-cli)

## Memperbarui rilis kenari menggunakan konsol API Gateway
<a name="update-canary-deployment-using-console"></a>

Untuk menggunakan konsol API Gateway untuk memperbarui setelan canary yang ada di panggung, lakukan hal berikut:

**Untuk memperbarui pengaturan kenari yang ada**

1.  Masuk ke konsol API Gateway dan pilih REST API yang ada.

1.  Di panel navigasi utama, pilih **Tahapan**, lalu pilih tahap yang ada.

1.  Pilih tab **Canary**, lalu pilih **Edit**. Anda mungkin perlu memilih tombol panah kanan untuk menampilkan tab **Canary**. 

1.  Perbarui **distribusi Permintaan** dengan menambah atau mengurangi jumlah persentase antara 0,0 dan 100,0, inklusif. 

1.  Pilih atau hapus **Stage cache** kotak centang. 

1.  Menambahkan, menghapus, atau memodifikasi **variabel tahap Canary**.

1.  Pilih **Simpan**.

## Perbarui rilis kenari menggunakan AWS CLI
<a name="update-canary-deployment-using-cli"></a>

Untuk menggunakan AWS CLI untuk memperbarui kenari, gunakan [https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html)perintah dan modifikasi operasi tambalan untuk setiap parameter kenari.

Perintah [update-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html) berikut diperbarui jika kenari menggunakan cache panggung:

```
aws apigateway update-stage \
    --rest-api-id {rest-api-id} \
    --stage-name '{stage-name}' \
    --patch-operations op=replace,path=/canarySettings/useStageCache,value=true
```

Perintah [tahap pembaruan berikut memperbarui](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html) persentase lalu lintas kenari:

```
aws apigateway update-stage \
    --rest-api-id {rest-api-id} \
    --stage-name '{stage-name}' \
    --patch-operations op=replace,path=/canarySettings/percentTraffic,value=25.0
```

[Pembaruan-tahap berikut memperbarui variabel tahap tahap](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html). Contoh ini menunjukkan cara membuat variabel stage baru bernama`newVar`, mengganti variabel `var2` stage, dan menghapus variabel `var1` stage:

```
aws apigateway update-stage  \
    --rest-api-id {rest-api-id} \
    --stage-name '{stage-name}'  \
    --patch-operations '[{                                      
        "op": "replace",                                        
        "path": "/canarySettings/stageVariableOverrides/newVar", 
        "value": "newVal"                                      
      }, { 
        "op": "replace",                                        
        "path": "/canarySettings/stageVariableOverrides/var2",   
        "value": "val4"                                        
      }, {                                                      
        "op": "remove",                                         
        "path": "/canarySettings/stageVariableOverrides/var1"    
      }]'
```

Anda dapat memperbarui semua hal di atas dengan menggabungkan operasi menjadi satu `patch-operations` nilai:

```
aws apigateway update-stage  \
    --rest-api-id {rest-api-id} \
    --stage-name '{stage-name}' \
    --patch-operations '[{                                       
        "op": "replace",                                         
        "path": "/canarySettings/percentTraffic",                        
        "value": "20.0"                                          
    }, {                                                         
        "op": "replace",                                         
        "path": "/canarySettings/useStageCache",                        
        "value": "true"                                          
    }, {                                                         
        "op": "remove",                                          
        "path": "/canarySettings/stageVariableOverrides/var1"    
    }, {                                                         
        "op": "replace",                                         
        "path": "/canarySettings/stageVariableOverrides/newVar", 
        "value": "newVal"                                        
    }, {                                                         
        "op": "replace",                                         
        "path": "/canarySettings/stageVariableOverrides/val2",   
        "value": "val4"                                          
      }]'
```