Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Mise à jour d’une version Canary
<a name="update-canary-deployment"></a>

 Après avoir déployé une version Canary, vous pouvez souhaiter ajuster le pourcentage du trafic Canary ou activer/désactiver l’utilisation d’un cache d’étape pour optimiser les performances de test. Vous pouvez également modifier les variables d’étape utilisées dans la version Canary lors de la mise à jour du contexte d’exécution. Pour effectuer de telles mises à jour, appelez l’opération [https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateStage.html](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateStage.html) avec des nouvelles valeurs dans [canarySettings](https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html#canarySettings). 

Vous pouvez mettre à jour une version de Canary à l'aide de la console API Gateway, de la commande AWS CLI [update-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html) ou d'un AWS SDK.

**Topics**
+ [Mise à jour d’une version Canary à l’aide de la console API Gateway](#update-canary-deployment-using-console)
+ [Mettez à jour une version de Canary à l'aide du AWS CLI](#update-canary-deployment-using-cli)

## Mise à jour d’une version Canary à l’aide de la console API Gateway
<a name="update-canary-deployment-using-console"></a>

Pour mettre à jour les paramètres Canary existants d’une étape à l’aide de la console API Gateway, procédez comme suit :

**Pour mettre à jour les paramètres canary existants**

1.  Connectez-vous à la console API Gateway et choisissez l’API REST existante.

1.  Dans le volet de navigation principal, choisissez **Étapes**, puis choisissez une étape existante.

1.  Choisissez l’onglet **Canary**, puis **Modifier**. Vous devrez peut-être choisir la flèche droite pour afficher l'onglet **Canary**. 

1.  Mettez à jour **Distribution de demande** en augmentant ou en diminuant la valeur de pourcentage entre 0,0 et 100,0 (inclus). 

1.  Activez ou désactivez la case à cocher **Cache d’étape**. 

1.  Ajoutez, supprimez ou modifiez **Variables d’étape Canary**.

1.  Choisissez **Enregistrer**.

## Mettez à jour une version de Canary à l'aide du AWS CLI
<a name="update-canary-deployment-using-cli"></a>

Pour mettre AWS CLI à jour un canari, utilisez la [https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html)commande et modifiez l'opération de correctif pour chaque paramètre du canari.

La commande [update-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html) suivante effectue une mise à jour si le canary utilise le cache de l’étape :

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

La commande [update-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html) suivante met à jour le pourcentage de trafic canary :

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

La commande [update-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html) suivante met à jour les variables de l’étape. L’exemple suivant montre comment créer une variable d’étape nommée `newVar`, remplacer la variable d’étape `var2` et supprimer la variable d’étape `var1` :

```
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"    
      }]'
```

Vous pouvez mettre à jour tout ce qui précède en combinant les opérations dans une même valeur `patch-operations` :

```
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"                                          
      }]'
```