// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`CreateStage`](crate::operation::create_stage::builders::CreateStageFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`access_log_settings(AccessLogSettings)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::access_log_settings) / [`set_access_log_settings(Option<AccessLogSettings>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_access_log_settings):<br>required: **false**<br><p>Settings for logging access in this stage.</p><br>
    ///   - [`api_id(impl Into<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::api_id) / [`set_api_id(Option<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_api_id):<br>required: **true**<br><p>The API identifier.</p><br>
    ///   - [`auto_deploy(bool)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::auto_deploy) / [`set_auto_deploy(Option<bool>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_auto_deploy):<br>required: **false**<br><p>Specifies whether updates to an API automatically trigger a new deployment. The default value is false.</p><br>
    ///   - [`client_certificate_id(impl Into<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::client_certificate_id) / [`set_client_certificate_id(Option<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_client_certificate_id):<br>required: **false**<br><p>The identifier of a client certificate for a Stage. Supported only for WebSocket APIs.</p><br>
    ///   - [`default_route_settings(RouteSettings)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::default_route_settings) / [`set_default_route_settings(Option<RouteSettings>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_default_route_settings):<br>required: **false**<br><p>The default route settings for the stage.</p><br>
    ///   - [`deployment_id(impl Into<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::deployment_id) / [`set_deployment_id(Option<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_deployment_id):<br>required: **false**<br><p>The deployment identifier of the API stage.</p><br>
    ///   - [`description(impl Into<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_description):<br>required: **false**<br><p>The description for the API stage.</p><br>
    ///   - [`route_settings(impl Into<String>, RouteSettings)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::route_settings) / [`set_route_settings(Option<HashMap::<String, RouteSettings>>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_route_settings):<br>required: **false**<br><p>Route settings for the stage, by routeKey.</p><br>
    ///   - [`stage_name(impl Into<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::stage_name) / [`set_stage_name(Option<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_stage_name):<br>required: **true**<br><p>The name of the stage.</p><br>
    ///   - [`stage_variables(impl Into<String>, impl Into<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::stage_variables) / [`set_stage_variables(Option<HashMap::<String, String>>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_stage_variables):<br>required: **false**<br><p>A map that defines the stage variables for a Stage. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&amp;=,]+.</p><br>
    ///   - [`tags(impl Into<String>, impl Into<String>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::tags) / [`set_tags(Option<HashMap::<String, String>>)`](crate::operation::create_stage::builders::CreateStageFluentBuilder::set_tags):<br>required: **false**<br><p>The collection of tags. Each tag element is associated with a given resource.</p><br>
    /// - On success, responds with [`CreateStageOutput`](crate::operation::create_stage::CreateStageOutput) with field(s):
    ///   - [`access_log_settings(Option<AccessLogSettings>)`](crate::operation::create_stage::CreateStageOutput::access_log_settings): <p>Settings for logging access in this stage.</p>
    ///   - [`api_gateway_managed(Option<bool>)`](crate::operation::create_stage::CreateStageOutput::api_gateway_managed): <p>Specifies whether a stage is managed by API Gateway. If you created an API using quick create, the $default stage is managed by API Gateway. You can't modify the $default stage.</p>
    ///   - [`auto_deploy(Option<bool>)`](crate::operation::create_stage::CreateStageOutput::auto_deploy): <p>Specifies whether updates to an API automatically trigger a new deployment. The default value is false.</p>
    ///   - [`client_certificate_id(Option<String>)`](crate::operation::create_stage::CreateStageOutput::client_certificate_id): <p>The identifier of a client certificate for a Stage. Supported only for WebSocket APIs.</p>
    ///   - [`created_date(Option<DateTime>)`](crate::operation::create_stage::CreateStageOutput::created_date): <p>The timestamp when the stage was created.</p>
    ///   - [`default_route_settings(Option<RouteSettings>)`](crate::operation::create_stage::CreateStageOutput::default_route_settings): <p>Default route settings for the stage.</p>
    ///   - [`deployment_id(Option<String>)`](crate::operation::create_stage::CreateStageOutput::deployment_id): <p>The identifier of the Deployment that the Stage is associated with. Can't be updated if autoDeploy is enabled.</p>
    ///   - [`description(Option<String>)`](crate::operation::create_stage::CreateStageOutput::description): <p>The description of the stage.</p>
    ///   - [`last_deployment_status_message(Option<String>)`](crate::operation::create_stage::CreateStageOutput::last_deployment_status_message): <p>Describes the status of the last deployment of a stage. Supported only for stages with autoDeploy enabled.</p>
    ///   - [`last_updated_date(Option<DateTime>)`](crate::operation::create_stage::CreateStageOutput::last_updated_date): <p>The timestamp when the stage was last updated.</p>
    ///   - [`route_settings(Option<HashMap::<String, RouteSettings>>)`](crate::operation::create_stage::CreateStageOutput::route_settings): <p>Route settings for the stage, by routeKey.</p>
    ///   - [`stage_name(Option<String>)`](crate::operation::create_stage::CreateStageOutput::stage_name): <p>The name of the stage.</p>
    ///   - [`stage_variables(Option<HashMap::<String, String>>)`](crate::operation::create_stage::CreateStageOutput::stage_variables): <p>A map that defines the stage variables for a stage resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&amp;=,]+.</p>
    ///   - [`tags(Option<HashMap::<String, String>>)`](crate::operation::create_stage::CreateStageOutput::tags): <p>The collection of tags. Each tag element is associated with a given resource.</p>
    /// - On failure, responds with [`SdkError<CreateStageError>`](crate::operation::create_stage::CreateStageError)
    pub fn create_stage(&self) -> crate::operation::create_stage::builders::CreateStageFluentBuilder {
        crate::operation::create_stage::builders::CreateStageFluentBuilder::new(self.handle.clone())
    }
}