AWS::ApiGateway::BasePathMapping - AWS CloudFormation (original) (raw)

The AWS::ApiGateway::BasePathMapping resource creates a base path that clients who call your API must use in the invocation URL. Supported only for public custom domain names.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::ApiGateway::BasePathMapping",
  "Properties" : {
      "BasePath" : String,
      "DomainName" : String,
      "RestApiId" : String,
      "Stage" : String
    }
}

YAML

Type: AWS::ApiGateway::BasePathMapping
Properties:
  BasePath: String
  DomainName: String
  RestApiId: String
  Stage: String

Properties

BasePath

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

Required: No

Type: String

Update requires: Replacement

DomainName

The domain name of the BasePathMapping resource to be described.

Required: Yes

Type: String

Update requires: Replacement

RestApiId

The string identifier of the associated RestApi.

Required: No

Type: String

Update requires: No interruption

Stage

The name of the associated stage.

Required: No

Type: String

Update requires: No interruption

See also

• basepathmapping:create in the Amazon API Gateway REST API Reference

AWS::ApiGateway::Authorizer

AWS::ApiGateway::BasePathMappingV2

Did this page help you? - Yes

Thanks for letting us know we're doing a good job!

If you've got a moment, please tell us what we did right so we can do more of it.

Did this page help you? - No

Thanks for letting us know this page needs work. We're sorry we let you down.

If you've got a moment, please tell us how we can make the documentation better.