本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS IoT SiteWise 透過界面 VPC 端點存取
<a name="vpc-endpoint-access"></a>

當您建立介面端點時，我們會產生端點特定的 DNS 主機名稱，供您用來與之通訊 AWS IoT SiteWise。預設會啟用私有 DNS 選項。如需詳細資訊，請參閱《*Amazon VPC 使用者指南*》中的[使用私有託管區域](https://docs.aws.amazon.com/vpc/latest/userguide/AmazonDNS-concepts.html#vpc-private-hosted-zones)。

*如果您為端點啟用私有 DNS*，您可以透過下列其中一個 VPC 端點向 提出 API AWS IoT SiteWise 請求。
+ 對於**資料平面 API **操作，請使用下列端點：將{{區域}}取代為您的 AWS 區域。

  ```
  data.iotsitewise.{{region}}.amazonaws.com
  ```
+ 對於**控制平面 API **操作，請使用下列端點：將{{區域}}取代為您的 AWS 區域。

  ```
  api.iotsitewise.{{region}}.amazonaws.com
  ```

*如果您停用端點的私有 DNS*，您必須執行下列動作，才能 AWS IoT SiteWise 透過端點存取 ：

1. 在 API 請求中指定 VPC 端點 URL。
   + 對於**資料平面 API **操作，請使用下列端點 URL。將 {{vpc-endpoint-id}} 和{{區域}}取代為您的 VPC 端點 ID 和區域。

     ```
     {{vpc-endpoint-id}}.data.iotsitewise.{{region}}.vpce.amazonaws.com
     ```
   + 對於**控制平面 API **操作，請使用下列端點 URL。將 {{vpc-endpoint-id}} 和{{區域}}取代為您的 VPC 端點 ID 和區域。

     ```
     {{vpc-endpoint-id}}.api.iotsitewise.{{region}}.vpce.amazonaws.com
     ```

1. 停用主機字首注入。當您呼叫每個 API 操作時， AWS CLI and AWS SDKs會在服務端點前面加上各種主機字首。當您指定 VPC 端點 AWS IoT SiteWise 時，此功能會導致 AWS CLI AWS SDKs 產生不適用於 URLs。
**重要**  
您無法在 AWS CLI 或 中停用主機字首注入 AWS Tools for PowerShell。這表示如果您停用私有 DNS，則無法使用這些工具 AWS IoT SiteWise 透過 VPC 端點存取 。啟用私有 DNS 以使用 AWS CLI 或 AWS IoT SiteWise 透過端點 AWS Tools for PowerShell 存取 。

   如需如何在 AWS SDKs 中停用主機字首注入的詳細資訊，請參閱每個 SDK 的下列文件章節：
   + [適用於 C\+\+ 的 AWS SDK](https://sdk.amazonaws.com/cpp/api/LATEST/struct_aws_1_1_client_1_1_client_configuration.html#a3579c1a2f2e1c9d54e99c59d27643499)
   + [適用於 Go 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config.WithDisableEndpointHostPrefix)
   + [適用於 Go 的 AWS SDK](https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/config) v2
   + [適用於 Java 的 AWS SDK](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html#setDisableHostPrefixInjection-boolean-)
   + [AWS SDK for Java 2.x](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/client/config/SdkAdvancedClientOption.html)
   + [適用於 JavaScript 的 AWS SDK](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html#hostPrefixEnabled-property)
   + [適用於 .NET 的 AWS SDK](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Runtime/TClientConfig.html)
   + [適用於 PHP 的 AWS SDK](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.AwsClient.html#___construct)
   + [適用於 Python (Boto3) 的 AWS SDK](https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html)
   + [適用於 Ruby 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoTSiteWise/Client.html#initialize-instance_method)

如需詳細資訊，請參閱《 *AWS PrivateLink 指南*》中的[使用介面 VPC 端點存取 AWS 服務](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#access-service-though-endpoint)。