aws apigatewayv2 create-stage

Creates a Stage for an API. AWS CLI reference

1 example 11 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To create a stage

The following create-stage example creates a stage named dev for an API.

aws apigatewayv2 create-stage --api-id a1b2c3d4 --stage-name devIdentify

--api-idThe API identifier.

--stage-nameThe name of the stage.

Its output

{
    "CreatedDate": "2020-04-06T23:23:46Z",
    "DefaultRouteSettings": {
        "DetailedMetricsEnabled": false
    },
    "LastUpdatedDate": "2020-04-06T23:23:46Z",
    "RouteSettings": {},
    "StageName": "dev",
    "StageVariables": {},
    "Tags": {}
}

For more information, see Working with stages for HTTP APIs in the Amazon API Gateway Developer Guide.

Options

11 in the AWS CLI reference

--access-log-settingsSettings for logging access in this stage.

--api-idThe API identifier.

--auto-deploySpecifies whether updates to an API automatically trigger a new deployment.

--client-certificate-idThe identifier of a client certificate for a Stage.

--default-route-settingsThe default route settings for the stage.

--deployment-idThe deployment identifier of the API stage.

--descriptionThe description for the API stage.

--route-settingsRoute settings for the stage, by routeKey.

--stage-nameThe name of the stage.

--stage-variablesA map that defines the stage variables for a Stage.

--tagsThe collection of tags.