sam list endpoints - Amazon Serverless Application Model
UsageOptionsExamples
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).

sam list endpoints

This page provides reference information for the Amazon Serverless Application Model Command Line Interface (Amazon SAM CLI) sam list endpoints subcommand.

For an introduction to the Amazon SAM CLI, see What is the Amazon SAM CLI?

The sam list endpoints subcommand displays a list of cloud and local endpoints from your Amazon CloudFormation stack. You can interact with these resources through the sam local and sam sync commands.

Amazon Lambda and Amazon API Gateway resource types are supported with this command.

Note

Custom domains are supported when configured for your Amazon API Gateway resources. This command will output the custom domain instead of the default endpoint.

Usage

$ sam list endpoints <options>

Options

--config-env TEXT

The environment name specifying the default parameter values in the configuration file to use.

Default value: default

For more information about configuration files, see Amazon SAM CLI configuration file.

--config-file TEXT

The path and file name of the configuration file containing default parameter values to use.

Default value: samconfig.toml in current working directory.

For more information about configuration files, see Amazon SAM CLI configuration file.

--debug

Turn on debug logging to print debug messages generated by the Amazon SAM CLI with timestamps.

--help, -h

Show this message and exit.

--output [json|table]

Specify the format to output results.

Default value: table

--profile TEXT

Select a specific profile from your credential file to get Amazon credentials.

--region TEXT

Set the Amazon region of the service. For example, us-east-1.

--save-params

Save the parameters that you provide at the command line to the Amazon SAM configuration file.

--stack-name TEXT

Name of the deployed Amazon CloudFormation stack. The stack name can be found in your application's samconfig.toml file or designated configuration file.

When this option is not specified, local resources defined in your template will display.

--template-file, --template, -t PATH

Amazon SAM template file.

Default value: template.[yaml|yml|json]

Examples

Display an output, in json format, of deployed resource endpoints from your Amazon CloudFormation stack named test-stack.

$ sam list endpoints --stack-name test-stack --output json
			
[
  {
    "LogicalResourceId": "HelloWorldFunction",
    "PhysicalResourceId": "sam-app-test-list-HelloWorldFunction-H85Y7yIV7ZLq",
    "CloudEndpoint": "https://zt55oi7kbljxjmcoahsj3cknwu0rposq.lambda-url.us-east-1.on.aws/",
    "Methods": "-"
  },
  {
    "LogicalResourceId": "ServerlessRestApi",
    "PhysicalResourceId": "uj80uoe2o2",
    "CloudEndpoint": [
      "https://uj80uoe2o2.execute-api.us-east-1.amazonaws.com/Prod",
      "https://uj80uoe2o2.execute-api.us-east-1.amazonaws.com/Stage"
    ],
    "Methods": [
      "/hello['get']"
    ]
  }
]