Skip to content

Api Gateway  >  Operations  >  create_base_path_mapping

create_base_path_mapping

Operation

create_base_path_mapping async

create_base_path_mapping(input: CreateBasePathMappingInput, plugins: list[Plugin] | None = None) -> CreateBasePathMappingOutput

Creates a new BasePathMapping resource.

Parameters:

Name Type Description Default
input CreateBasePathMappingInput

An instance of CreateBasePathMappingInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
CreateBasePathMappingOutput

An instance of CreateBasePathMappingOutput.

Input

CreateBasePathMappingInput dataclass

Requests API Gateway to create a new BasePathMapping resource.

Attributes

base_path class-attribute instance-attribute
base_path: str | None = None

The base path name that callers of the API must provide as part of the URL after the domain name. This value must be unique for all of the mappings across a single API. Specify '(none)' if you do not want callers to specify a base path name after the domain name.

domain_name class-attribute instance-attribute
domain_name: str | None = None

The domain name of the BasePathMapping resource to create.

domain_name_id class-attribute instance-attribute
domain_name_id: str | None = None

The identifier for the domain name resource. Required for private custom domain names.

rest_api_id class-attribute instance-attribute
rest_api_id: str | None = None

The string identifier of the associated RestApi.

stage class-attribute instance-attribute
stage: str | None = None

The name of the API's stage that you want to use for this mapping. Specify '(none)' if you want callers to explicitly specify the stage name after any base path name.

Output

CreateBasePathMappingOutput dataclass

Represents the base path that callers of the API must provide as part of the URL after the domain name.

Attributes

base_path class-attribute instance-attribute
base_path: str | None = None

The base path name that callers of the API must provide as part of the URL after the domain name.

rest_api_id class-attribute instance-attribute
rest_api_id: str | None = None

The string identifier of the associated RestApi.

stage class-attribute instance-attribute
stage: str | None = None

The name of the associated stage.