本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# sam list endpoints
<a name="sam-cli-command-reference-sam-list-endpoints"></a>

本页提供 AWS Serverless Application Model 命令行界面 (AWS SAMCLI) `sam list endpoints` 子命令的参考信息。

有关简介 AWS SAMCLI，请参阅 [那是什么 AWS SAMCLI？](what-is-sam-overview.md#what-is-sam-cli)

`sam list endpoints`子命令显示 CloudFormation 堆栈中的云端和本地端点列表。您可以通过 **sam local** 和 **sam sync** 命令与这些资源进行交互。

AWS Lambda 此命令支持 Amazon API Gateway 资源类型。

**注意**  
如果为 Amazon API Gateway 资源配置了自定义域，则这些域受支持。此命令会输出自定义域而不是默认端点。

## 用法
<a name="sam-cli-command-reference-sam-list-endpoints-usage"></a>

```
$ sam list endpoints <options>
```

## 选项
<a name="sam-cli-command-reference-sam-list-endpoints-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-env"></a>
在配置文件中指定要使用的默认参数值的环境名称。  
*默认值*：`default`  
有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-file"></a>
包含要使用的默认参数值的配置文件的路径和文件名。  
*默认值*：当前工作目录中 `samconfig.toml`。  
有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--debug`  <a name="sam-cli-command-reference-sam-list-endpoints-options-debug"></a>
启用调试日志记录，以打印由 AWS SAM CLI 生成的带有时间戳的调试消息。

`--help, -h`  <a name="sam-cli-command-reference-sam-list-endpoints-options-help"></a>
显示此消息并退出。

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-endpoints-options-output"></a>
指定输出结果的格式。  
*默认值*：`table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-profile"></a>
从您的凭证文件中选择一个特定的个人资料以获取 AWS 凭证。

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-region"></a>
设置服务的 AWS 区域。例如 `us-east-1`。

`--save-params`  <a name="sam-cli-command-reference-sam-list-endpoints-options-save-params"></a>
将您在命令行中提供的参数保存到 AWS SAM 配置文件中。

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-stack-name"></a>
已部署 CloudFormation 堆栈的名称。可在应用程序的 `samconfig.toml` 文件或指定的配置文件中找到堆栈名称。  
如果未指定此选项，则会显示模板中定义的本地资源。

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-endpoints-options-template"></a>
AWS SAM 模板文件。  
*默认值*：`template.[yaml|yml|json]`

## 示例
<a name="sam-cli-command-reference-sam-list-endpoints-examples"></a>

以 json 格式显示名为的 CloudFormation 堆栈中已部署的资源端点的输出`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']"
    ]
  }
]
```