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

# 访问Amazon IoT SiteWise通过接口 VPC 终端节点
<a name="vpc-endpoint-access"></a>

当您创建接口终端节点时，我们会生成特定于终端节点的 DNS 主机名，您可以用来与之通信。Amazon IoT SiteWise默认情况下启用私有 DNS。有关更多信息，请参阅 *Amazon VPC 用户指南*中的[使用私有托管区域](https://docs.amazonaws.cn/vpc/latest/userguide/AmazonDNS-concepts.html#vpc-private-hosted-zones)。

*如果您为终端节点启用私有 DNS*，则可以通过以下 VPC 终端节点之一向Amazon IoT SiteWise发出 API 请求。
+ 对于**数据层面** API 操作，请使用以下端点：

  ```
  data.iotsitewise.cn-north-1.amazonaws.com.cn
  ```
+ 对于**控制平面** API 操作，请使用以下端点：

  ```
  data.iotsitewise.cn-north-1.amazonaws.com.cn
  ```

*如果您为终端节点禁用私有 DNS*，则必须执行以下操作才能Amazon IoT SiteWise通过终端节点进行访问：

1. 在 API 请求中指定 VPC 端点 url。
   + 对于**数据面板** API 操作，请使用以下端点 url。将{{vpc-endpoint-id}}替换为您的 VPC 终端节点 ID 。

     ```
     {{vpc-endpoint-id}}.data.iotsitewise.cn-north-1.vpce.amazonaws.com.cn
     ```
   + 对于**控制面板** API 操作，请使用以下端点 url。将{{vpc-endpoint-id}}替换为您的 VPC 终端节点 ID 。

     ```
     {{vpc-endpoint-id}}.api.iotsitewise.cn-north-1.vpce.amazonaws.com.cn
     ```

1. 禁用主机前缀注入功能。当您调用每个 API 操作时，Amazon CLI和 Amazon SDK 会在服务端点前面加上各种主机前缀。此功能会导致Amazon CLI和Amazon软件开发工具包生成在您指定 VPC 终端节点Amazon IoT SiteWise时无效的 URL。
**重要**  
您无法在Amazon CLI或中禁用主机前缀注入Amazon Tools for PowerShell。这意味着，如果您禁用私有 DNS，则无法使用这些工具Amazon IoT SiteWise通过 VPC 终端节点进行访问。允许私有 DNS 使用Amazon CLI或Amazon IoT SiteWise通过终端节点Amazon Tools for PowerShell进行访问。

   有关如何在 SDK 中禁用主机前缀注入的更多信息，请参阅每个 Amazon SDK 的以下文档部分：
   + [Amazon SDK for C\+\+](https://sdk.amazonaws.com/cpp/api/LATEST/struct_aws_1_1_client_1_1_client_configuration.html#a3579c1a2f2e1c9d54e99c59d27643499)
   + [适用于 Go 的 Amazon SDK](https://docs.amazonaws.cn/sdk-for-go/api/aws/#Config.WithDisableEndpointHostPrefix)
   + [适用于 Go 的 Amazon SDK](https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/config) v2
   + [Amazon SDK for Java](https://docs.amazonaws.cn/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html#setDisableHostPrefixInjection-boolean-)
   + [Amazon SDK for Java 2.x](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/client/config/SdkAdvancedClientOption.html)
   + [Amazon SDK for JavaScript](https://docs.amazonaws.cn/AWSJavaScriptSDK/latest/AWS/Config.html#hostPrefixEnabled-property)
   + [Amazon SDK for .NET](https://docs.amazonaws.cn/sdkfornet/v4/apidocs/items/Runtime/TClientConfig.html)
   + [适用于 PHP 的 Amazon SDK](https://docs.amazonaws.cn/aws-sdk-php/v3/api/class-Aws.AwsClient.html#___construct)
   + [Amazon SDK for Python (Boto3)](https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html)
   + [适用于 Ruby 的 Amazon SDK](https://docs.amazonaws.cn/sdk-for-ruby/v3/api/Aws/IoTSiteWise/Client.html#initialize-instance_method)

有关更多信息，请参阅*Amazon PrivateLink指南*中的[使用接口 VPC 终端节点访问Amazon服务](https://docs.amazonaws.cn/vpc/latest/privatelink/create-interface-endpoint.html#access-service-though-endpoint)。