Mise à jour d'une version Canary - APIPasserelle Amazon
Mettre à jour une version de Canary à l'aide de la console API GatewayMettez à jour une version de Canary à l'aide du AWS CLI

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

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 stage:update en activant les nouvelles valeurs. canarySettings

Vous pouvez mettre à jour une version de Canary à l'aide de la console API Gateway, de la commande AWS CLI update-stage ou d'un. AWS SDK

Mettre à jour une version de Canary à l'aide de la console API Gateway

Pour utiliser la console API Gateway afin de mettre à jour les paramètres Canary existants sur une scène, procédez comme suit :

Pour mettre à jour les paramètres canary existants

  1. Connectez-vous à la console API Gateway et choisissez-en une existante RESTAPI.

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

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

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

  5. Activez ou désactivez la case à cocher Cache d'étape.

  6. Ajoutez, supprimez ou modifiez Variables d'étape Canary.

  7. Choisissez Save (Enregistrer).

Mettez à jour une version de Canary à l'aide du AWS CLI

Pour utiliser le AWS CLI pour mettre à jour un canari, appelez la update-stagecommande.

Pour activer ou désactiver l'utilisation d'un cache d'étape pour la version Canary, appelez la commande update-stage comme suit : 

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

Pour ajuster le pourcentage de trafic Canary, appelez update-stage pour remplacer la valeur de /canarySettings/percentTraffic de l'étape.

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

Pour mettre à jour des variables d'étape Canary, notamment en ajoutant, remplaçant ou supprimant une variable d'étape Canary :

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