AWS IoT TwinMaker 和介面 VPC 端點 (AWS PrivateLink)

您可以在虛擬私有雲端 (VPC) 和 之間建立私有連線， AWS IoT TwinMaker 方法是建立介面 VPC 端點。介面端點由 提供支援AWS PrivateLink，您可以使用 來私下存取 AWS IoT TwinMaker APIs，而無需網際網路閘道、網路地址轉譯 (NAT) 裝置、VPN 連線或 AWS Direct Connect 連線。VPC 中的執行個體不需要公有 IP 地址即可與 AWS IoT TwinMaker APIs 通訊。VPC 與 之間的流量 AWS IoT TwinMaker 不會離開 Amazon 網路。

每個介面端點都是由您子網路中的一或多個彈性網路介面表示。

如需詳細資訊，請參閱 Amazon VPC 使用者指南中的 Interface Word 端點 (Word AWS PrivateLink)。 VPC

AWS IoT TwinMaker VPC 端點的考量

在您設定介面 VPC 端點之前 AWS IoT TwinMaker，請檢閱 Amazon VPC 使用者指南中的介面端點屬性和限制。

AWS IoT TwinMaker 支援從您的 API 呼叫其所有 VPC 動作。

• 對於資料平面 API 操作，請使用下列端點：

  data.iottwinmaker.region.amazonaws.com

  資料平面 API 操作包括下列項目：

  • GetPropertyValue

  • GetPropertyValueHistory

  • BatchPutPropertyValues

• 針對控制平面 API 操作，請使用下列端點：

  api.iottwinmaker.region.amazonaws.com

  支援的控制平面 API 操作包括下列各項：

  • CreateComponentType

  • CreateEntity

  • CreateScene

  • CreateWorkspace

  • DeleteComponentType

  • DeleteEntity

  • DeleteScene

  • DeleteWorkspace

  • GetComponentType

  • GetEntity

  • GetScene

  • GetWorkspace

  • ListComponentTypes

  • ListComponentTypes

  • ListEntities

  • ListScenes

  • ListTagsForResource

  • ListWorkspaces

  • TagResource

  • UntagResource

  • UpdateComponentType

  • UpdateEntity

  • UpdateScene

  • UpdateWorkspace

為 建立介面 VPC 端點 AWS IoT TwinMaker

您可以使用 Amazon VPC 主控台或 AWS Command Line Interface () 來建立 AWS IoT TwinMaker 服務的 VPC 端點AWS CLI。如需詳細資訊，請參閱 Amazon VPC 使用者指南中的建立介面端點。

建立使用以下服務名稱 AWS IoT TwinMaker 的 VPC 端點。

• 對於資料平面 API 操作，請使用下列服務名稱：

  com.amazonaws.region.iottwinmaker.data

• 對於控制平面 API 操作，請使用下列服務名稱：

  com.amazonaws.region.iottwinmaker.api

如果您為端點啟用私有 DNS，您可以使用 AWS IoT TwinMaker 區域的預設 DNS 名稱向 提出 API 請求，例如 iottwinmaker.us-east-1.amazonaws.com。

如需詳細資訊，請參閱 Amazon VPC 使用者指南中的透過介面端點存取服務。

下列區域支援AWS IoT TwinMaker PrivateLink ：

• us-east-1

  下列可用區域支援 ControlPlane 服務：use1-az1、 use1-az2和 use1-az6。

  下列可用區域支援 DataPlane 服務：use1-az1、 use1-az2和 use1-az4。

• us-west-2

  下列可用區域支援 ControlPlane 和 DataPlane 服務：usw2-az1、 usw2-az2和 usw2-az3。

• eu-west-1

• eu-central-1

• ap-southeast-1

• ap-southeast-2

如需可用區域的詳細資訊，請參閱 AWS 資源 - AWS Resource Access Manager 的可用區域IDs。

AWS IoT TwinMaker 透過介面 VPC 端點存取

當您建立介面端點時， AWS IoT TwinMaker 會產生端點特定的 DNS 主機名稱，供您用來與之通訊 AWS IoT TwinMaker。預設會啟用私有 DNS 選項。如需詳細資訊，請參閱 Amazon VPC 使用者指南中的使用私有託管區域。

如果您為端點啟用私有 DNS，您可以透過下列其中一個 API 端點向 AWS IoT TwinMaker 提出 VPC 請求。

• 針對資料平面 API 操作，請使用下列端點。取代 region 您的 AWS 區域。

  data.iottwinmaker.region.amazonaws.com

• 針對控制平面 API 操作，請使用下列端點。取代 region 您的 AWS 區域。

  api.iottwinmaker.region.amazonaws.com

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

• 在 VPC 請求URL中指定 Word 端點 API。

  • 針對資料平面 API 操作，請使用下列端點 URL。Replace (取代) vpc-endpoint-id 和 region 您的 VPC 端點 ID 和區域。

    vpc-endpoint-id.data.iottwinmaker.region.vpce.amazonaws.com

  • 對於控制平面 API 操作，請使用下列端點 URL。Replace (取代) vpc-endpoint-id 和 region 您的 VPC 端點 ID 和區域。

    vpc-endpoint-id.api.iottwinmaker.region.vpce.amazonaws.com

• 停用主機字首注入。當您呼叫每個 AWS SDKs 操作時， AWS CLI andAPI 會在服務端點前面加上各種主機字首。當您指定 URLs 端點 AWS IoT TwinMaker 時，這會導致 AWS CLI 和 AWS SDKs 產生無效的 VPC。

  重要

  您無法在 AWS CLI 或 中停用主機字首注入 AWS Tools for PowerShell。這表示如果您已停用私有 DNS，則無法使用 AWS CLI 或 AWS IoT TwinMaker 透過 VPC 端點 AWS Tools for PowerShell 存取 。如果您想要使用這些工具 AWS IoT TwinMaker 透過端點存取 ，請啟用私有 DNS。

  如需如何在 SDKs 中 AWS 停用主機字首注入的詳細資訊，請參閱下列每個 SDK 文件章節：

  • AWS SDK for C++

  • AWS SDK for Go

  • AWS SDK for Go v2

  • AWS SDK for Java

  • AWS SDK for Java 2.x

  • AWS SDK for JavaScript

  • AWS SDK for .NET

  • AWS SDK for PHP

  • AWS SDK for Python (Boto3)

  • AWS SDK for Ruby

如需詳細資訊，請參閱 Amazon VPC 使用者指南中的透過介面端點存取服務。

為 建立 VPC 端點政策 AWS IoT TwinMaker

您可以將端點政策連接至控制 存取權的 VPC 端點 AWS IoT TwinMaker。此政策會指定下列資訊：

• 可執行動作的主體。

• 可執行的動作。

• 可供執行動作的資源。

如需詳細資訊，請參閱 Amazon VPC 使用者指南中的使用 Word 端點控制對 服務的存取。 VPC

範例： AWS IoT TwinMaker 動作的 VPC 端點政策

以下是 的端點政策範例 AWS IoT TwinMaker。當連接至端點時，此政策會授予123456789012所有資源iottwinmakeradmin上 AWS 帳戶中 IAM 使用者的所列 AWS IoT TwinMaker 動作的存取權。

{
   "Statement":[ 
      {
        "Principal": {
            "AWS": "arn:aws:iam::123456789012:user/role"
                },
         "Resource": "*",
         "Effect":"Allow",
         "Action":[
            "iottwinmaker:CreateEntity",
            "iottwinmaker:GetScene",
            "iottwinmaker:ListEntities"
         ]
        }
    ]
}