Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

特定于服务的端点

特定于服务的端点配置提供了一个选项，可使用您应 API 的请求使用您选择的端点，并保持该选择。这些设置可以灵活地支持本地端点、VPC 端点和第三方本地 Amazon 开发环境。不同的端点可分别用于测试环境和生产环境。您可以为个别 Amazon Web Services指定端点 URL。

使用环境变量来配置端点

要将所有服务的请求路由到自定义端点 URL，请设置 AWS_ENDPOINT_URL 全局环境变量。

export AWS_ENDPOINT_URL=http://localhost:4567

要将针对特定终端节点 URL 的请求路由 Amazon Web Service 到自定义终端节点 URL，请使用AWS_ENDPOINT_URL_<SERVICE>环境变量。 Amazon DynamoDB 有一serviceId个DynamoDB。对于此服务，端点 URL 环境变量为 AWS_ENDPOINT_URL_DYNAMODB。此端点优先于在 AWS_ENDPOINT_URL 中为此服务设置的全局端点。

export AWS_ENDPOINT_URL_DYNAMODB=http://localhost:5678

再举一个例子， Amazon Elastic Beanstalk 有一serviceId个Elastic Beanstalk。标 Amazon Web Service 识符基于 API 模型，将所有空格serviceId替换为下划线，并将所有字母改为大写。为设置适用于此服务的端点，相应的环境变量为 AWS_ENDPOINT_URL_ELASTIC_BEANSTALK。有关特定于服务的所有环境变量的列表，请参阅特定于服务的端点的标识符。

export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:5567

使用共享 config 文件配置端点

在共享 config 文件中，endpoint_url 用于不同位置以实现不同的功能。

以下示例使用 services 定义来配置用于 Amazon S3 的特定于服务的端点 URL 和用于其他所有服务的自定义全局端点：

[profile dev-s3-specific-and-global]
endpoint_url = http://localhost:1234
services = s3-specific

[services s3-specific]
s3 = 
  endpoint_url = https://play.min.io:9000

单个配置文件可以为多个服务配置端点。此示例说明如何在同一配置文件中为 Amazon S3 设置服务特定的终端节点 URL。 Amazon Elastic Beanstalk Amazon Elastic Beanstalk 有一serviceId个Elastic Beanstalk。标 Amazon Web Service 识符基于 API 模型，将所有空格serviceId替换为下划线，并将所有字母小写。因此，服务标识符密钥变为 elastic_beanstalk 且已开始在线设置该服务 elastic_beanstalk = 。有关 services 节中要使用的所有服务标识符密钥的列表，请参阅特定于服务的端点的标识符。

[services testing-s3-and-eb]
s3 = 
  endpoint_url = http://localhost:4567
elastic_beanstalk = 
  endpoint_url = http://localhost:8000

[profile dev]
services = testing-s3-and-eb

“服务配置”节可以在多个配置文件中使用。例如，两个配置文件在更改其他配置文件属性时可以使用相同的 services 定义：

[services testing-s3]
s3 = 
  endpoint_url = https://localhost:4567

[profile testing-json]
output = json
services = testing-s3

[profile testing-text]
output = text
services = testing-s3

使用基于角色的凭证在配置文件中配置端点

如果您的配置文件具有基于角色的凭证，而这些凭证是通过 IAM 代入角色功能的 source_profile 参数配置的，则开发工具包仅使用所指定配置文件的服务配置。它不使用关联有角色的配置文件。例如，使用以下共享 config 文件：

[profile A]
credential_source = Ec2InstanceMetadata
endpoint_url = https://profile-a-endpoint.aws/

[profile B]
source_profile = A
role_arn = arn:aws:iam::123456789012:role/roleB
services = profileB

[services profileB]
ec2 = 
  endpoint_url = https://profile-b-ec2-endpoint.aws

如果您使用配置文件 B 并在代码中调用 Amazon EC2，则端点将解析为 https://profile-b-ec2-endpoint.aws。如果您的代码向其他任何服务发出请求，则端点解析将不遵循任何自定义逻辑。该端点不会解析到配置文件 A 中定义的全局端点。要使全局端点对配置文件 B 生效，您需要直接在配置文件 B 中设置 endpoint_url。有关 source_profile 设置的更多信息，请参阅代入角色凭证提供者。

设置的优先级

该功能设置为可以同时使用，但每项服务只有一个值会优先使用。对于对给定的 API 调用 Amazon Web Service，使用以下顺序来选择值：

与 Amazon SDK 的兼容性

以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。 Amazon SDK for Java 和 Amazon SDK for Kotlin 唯一支持任何 JVM 系统属性设置。