pulumi-aws-kotlin/com.pulumi.aws.apigatewayv2.kotlin/StageArgs

StageArgs

data class StageArgs(val accessLogSettings: Output<StageAccessLogSettingsArgs>? = null, val apiId: Output<String>? = null, val autoDeploy: Output<Boolean>? = null, val clientCertificateId: Output<String>? = null, val defaultRouteSettings: Output<StageDefaultRouteSettingsArgs>? = null, val deploymentId: Output<String>? = null, val description: Output<String>? = null, val name: Output<String>? = null, val routeSettings: Output<List<StageRouteSettingArgs>>? = null, val stageVariables: Output<Map<String, String>>? = null, val tags: Output<Map<String, String>>? = null) : ConvertibleToJava<StageArgs>

Manages an Amazon API Gateway Version 2 stage. More information can be found in the Amazon API Gateway Developer Guide.

Example Usage

Basic

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.apigatewayv2.Stage;
import com.pulumi.aws.apigatewayv2.StageArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var example = new Stage("example", StageArgs.builder()
            .apiId(aws_apigatewayv2_api.example().id())
            .build());
    }
}

Import

aws_apigatewayv2_stage can be imported by using the API identifier and stage name, e.g.,

$ pulumi import aws:apigatewayv2/stage:Stage example aabbccddee/example-stage

Constructors

StageArgs

constructor(accessLogSettings: Output<StageAccessLogSettingsArgs>? = null, apiId: Output<String>? = null, autoDeploy: Output<Boolean>? = null, clientCertificateId: Output<String>? = null, defaultRouteSettings: Output<StageDefaultRouteSettingsArgs>? = null, deploymentId: Output<String>? = null, description: Output<String>? = null, name: Output<String>? = null, routeSettings: Output<List<StageRouteSettingArgs>>? = null, stageVariables: Output<Map<String, String>>? = null, tags: Output<Map<String, String>>? = null)

Properties

accessLogSettings

val accessLogSettings: Output<StageAccessLogSettingsArgs>? = null

Settings for logging access in this stage. Use the aws.apigateway.Account resource to configure permissions for CloudWatch Logging.

apiId

val apiId: Output<String>? = null

API identifier.

autoDeploy

val autoDeploy: Output<Boolean>? = null

Whether updates to an API automatically trigger a new deployment. Defaults to false. Applicable for HTTP APIs.

clientCertificateId

val clientCertificateId: Output<String>? = null

Identifier of a client certificate for the stage. Use the aws.apigateway.ClientCertificate resource to configure a client certificate. Supported only for WebSocket APIs.

defaultRouteSettings

val defaultRouteSettings: Output<StageDefaultRouteSettingsArgs>? = null

Default route settings for the stage.

deploymentId

val deploymentId: Output<String>? = null

Deployment identifier of the stage. Use the aws.apigatewayv2.Deployment resource to configure a deployment.

description

val description: Output<String>? = null

Description for the stage. Must be less than or equal to 1024 characters in length.

name

val name: Output<String>? = null

Name of the stage. Must be between 1 and 128 characters in length. The following arguments are optional: