Skip to content

Latest commit

 

History

History
50 lines (36 loc) · 2.39 KB

sam-property-httpapi-httpapidefinition.md

File metadata and controls

50 lines (36 loc) · 2.39 KB
Raw

HttpApiDefinition

An OpenAPI document defining the API.

Syntax

To declare this entity in your AWS Serverless Application Model (AWS SAM) template, use the following syntax.

YAML

  [Bucket](#sam-httpapi-httpapidefinition-bucket): String
  [Key](#sam-httpapi-httpapidefinition-key): String
  [Version](#sam-httpapi-httpapidefinition-version): String

Properties

Bucket The name of the Amazon S3 bucket where the OpenAPI file is stored.
Type: String
Required: Yes
AWS CloudFormation compatibility: This property is passed directly to the [Bucket](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigatewayv2-api-bodys3location.html#cfn-apigatewayv2-api-bodys3location-bucket) property of the AWS::ApiGatewayV2::Api BodyS3Location data type.

Key The Amazon S3 key of the OpenAPI file.
Type: String
Required: Yes
AWS CloudFormation compatibility: This property is passed directly to the [Key](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigatewayv2-api-bodys3location.html#cfn-apigatewayv2-api-bodys3location-key) property of the AWS::ApiGatewayV2::Api BodyS3Location data type.

Version For versioned objects, the version of the OpenAPI file.
Type: String
Required: No
AWS CloudFormation compatibility: This property is passed directly to the [Version](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigatewayv2-api-bodys3location.html#cfn-apigatewayv2-api-bodys3location-version) property of the AWS::ApiGatewayV2::Api BodyS3Location data type.

Examples

Definition Uri example

API Definition example

YAML

DefinitionUri:
  Bucket: mybucket-name
  Key: mykey-name
  Version: 121212