AWS::ApiGateway::Resource - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::ApiGateway::Resource

The AWS::ApiGateway::Resource resource creates a resource in an API.

Syntax

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

JSON

{ "Type" : "AWS::ApiGateway::Resource", "Properties" : { "ParentId" : String, "PathPart" : String, "RestApiId" : String } }

YAML

Type: AWS::ApiGateway::Resource Properties: ParentId: String PathPart: String RestApiId: String

Properties

ParentId

The parent resource's identifier.

Required: Yes

Type: String

Update requires: Replacement

PathPart

The last path segment for this resource.

Required: Yes

Type: String

Update requires: Replacement

RestApiId

The string identifier of the associated RestApi.

Required: Yes

Type: String

Update requires: Replacement

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the resource ID, such as abc123.

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

ResourceId

The ID for the resource. For example: abc123.

Examples

Create resource

The following example creates a stack resource for the MyApi API.

JSON

{ "Stack": { "Type": "AWS::ApiGateway::Resource", "Properties": { "RestApiId": { "Ref": "MyApi" }, "ParentId": { "Fn::GetAtt": [ "MyApi", "RootResourceId" ] }, "PathPart": "stack" } } }

YAML

Stack: Type: 'AWS::ApiGateway::Resource' Properties: RestApiId: !Ref MyApi ParentId: !GetAtt - MyApi - RootResourceId PathPart: stack

See also