Turn off a canary release - Amazon API Gateway
Turn off a canary release using the API Gateway consoleTurn off a canary release using the Amazon CLI
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Turn off a canary release

To turn off a canary release deployment is to set the canarySettings to null to remove it from the stage.

You can disable a canary release deployment using the API Gateway console, the Amazon CLI, or an Amazon SDK.

Turn off a canary release using the API Gateway console

To use the API Gateway console to turn off a canary release deployment, use the following steps:

To turn off a canary release deployment

  1. Sign in to the API Gateway console and choose an existing API in the main navigation pane.

  2. In the main navigation pane, choose Stages, and then choose an existing stage.

  3. Choose the Canary tab.

  4. Choose Delete.

  5. Confirm you want to delete the canary by choosing Delete.

As a result, the canarySettings property becomes null and is removed from the deployment stage. You can verify this using the Amazon CLI. For example, see Turn off a canary release using the Amazon CLI.

Turn off a canary release using the Amazon CLI

To use the Amazon CLI to turn off a canary release deployment, call the update-stage command as follows:

aws apigateway update-stage \
    --rest-api-id abcd1234 \
    --stage-name canary \
    --patch-operations '[{"op":"remove", "path":"/canarySettings"}]'

A successful response returns a payload similar to the following:

{
    "stageName": "prod", 
    "accessLogSettings": {
        ...
    }, 
    "cacheClusterEnabled": false, 
    "cacheClusterStatus": "NOT_AVAILABLE", 
    "deploymentId": "nfcn0x", 
    "lastUpdatedDate": 1511309280, 
    "createdDate": 1511152939, 
    "methodSettings": {
        ...
    }
}

As shown in the output, the canarySettings property is no longer present in the stage of a canary-disabled deployment.