View a markdown version of this page

AWS IoT TwinMaker 和接口 VPC 终端节点 (AWS PrivateLink) - AWS IoT TwinMaker
注意事项 AWS IoT TwinMaker VPC 端点为创建接口 VPC 终端节点 AWS IoT TwinMaker访问 AWS IoT TwinMaker 通过接口 VPC 终端节点为创建 VPC 终端节点策略 AWS IoT TwinMaker

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

AWS IoT TwinMaker 和接口 VPC 终端节点 (AWS PrivateLink)

您可通过创建 VPC 接口端点在虚拟私有云 (VPC) 和 AWS IoT TwinMaker 之间创建私有连接。接口终端节点由其提供支持 AWS PrivateLink，您无需互联网网关、网络地址转换 (NAT) 设备、VPN 连接或 AWS 直接连接即可私下访问 AWS IoT TwinMaker API。 AWS IoT TwinMaker 通过其接口端点同时支持 IPv4 和 IPv6（双栈）。您的 VPC 中的实例不需要公有 IP 地址即可与 AWS IoT TwinMaker API 通信。您的 VPC 和之间的流量 AWS IoT TwinMaker 不会离开亚马逊网络。

每个接口端点均由子网中的一个或多个弹性网络接口表示。

有关更多信息，请参阅《Amazon VPC 用户指南》中的接口 VPC 端点 (AWS PrivateLink)。

注意事项 AWS IoT TwinMaker VPC 端点

在为其设置接口 VPC 终端节点之前 AWS IoT TwinMaker，请查看 Amazon VPC 用户指南中的接口终端节点属性和限制。

AWS IoT TwinMaker 支持从您的 VPC 调用其所有 API 操作。

为创建接口 VPC 终端节点 AWS IoT TwinMaker

您可以使用亚马逊 VPC 控制台或 AWS Command Line Interface (AWS CLI) 为该 AWS IoT TwinMaker 服务创建 VPC 终端节点。有关更多信息，请参阅《Amazon VPC User Guide》中的 Creating an interface endpoint。

使用以下服务名称为 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-az1use1-az2、和use1-az6。

    以下可用区域支持该 DataPlane 服务：use1-az1use1-az2、和use1-az4。

  • us-west-2

    以下可用区域支持 ControlPlane 和 DataPlane 服务：usw2-az1usw2-az2、和usw2-az3。

  • eu-west-1

  • eu-central-1

  • ap-southeast-1

  • ap-southeast-2

有关可用区域的更多信息，请参阅资源的可用区 ID- AWSAWS 资源访问管理器。

访问 AWS IoT TwinMaker 通过接口 VPC 终端节点

当您创建接口终端节点时， AWS IoT TwinMaker 会生成特定于端点的 DNS 主机名，可用于与之通信。 AWS IoT TwinMaker默认情况下启用私有 DNS。有关更多信息，请参阅 Amazon VPC 用户指南中的使用私有托管区域。

如果为端点启用私有 DNS，则可以通过以下 VPC 端点向 AWS IoT TwinMaker 发出 API 请求。

  • 对于数据面板 API 操作，请使用以下端点。将 region 替换为您的 AWS 区域。

    data.iottwinmaker.region.amazonaws.com

  • 对于控制面板 API 操作，请使用以下端点。将 region 替换为您的 AWS 区域。

    api.iottwinmaker.region.amazonaws.com

如果您为端点禁用私有 DNS，则必须执行以下操作，才能通过端点访问 AWS IoT TwinMaker ：

  • 在 API 请求中指定 VPC 端点 URL。

    • 对于数据平面 API 操作，请使用以下端点 URL。将vpc-endpoint-id和region替换为您的 VPC 终端节点 ID 和区域。

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

    • 对于控制平面 API 操作，请使用以下端点 URL。将vpc-endpoint-id和region替换为您的 VPC 终端节点 ID 和区域。

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

  • 禁用主机前缀注入功能。当您调用每个 API 操作时， AWS CLI 和 AWS SDK 会在服务端点前添加各种主机前缀。 AWS IoT TwinMaker 当您指定 VPC 终端节点时，这会导致 AWS CLI 和 AWS 软件开发工具包生成无效的 URL。

    重要

    您无法在 AWS CLI 或 AWS Tools for PowerShell中禁用主机前缀注入。这意味着，如果您禁用了私有 DNS，您将无法使用 AWS CLI 或 AWS Tools for PowerShell AWS IoT TwinMaker 通过 VPC 终端节点进行访问。如果您想使用这些工具 AWS IoT TwinMaker 通过终端节点进行访问，请启用私有 DNS。

    有关如何禁用 AWS SDK 中的主机前缀注入的更多信息，请参阅以下文档中关于 SDK 的部分：

有关更多信息，请参阅《Amazon VPC 用户指南》中的通过接口端点访问服务。

为创建 VPC 终端节点策略 AWS IoT TwinMaker

您可以为 VPC 端点附加控制对 AWS IoT TwinMaker的访问的端点策略。该策略指定以下信息：

  • 可执行操作的主体。

  • 可执行的操作。

  • 可对其执行操作的资源。

有关更多信息，请参阅《Amazon VPC 用户指南》中的使用 VPC 端点控制对服务的访问。

示例：的 VPC 终端节点策略 AWS IoT TwinMaker actions

以下是的端点策略示例 AWS IoT TwinMaker。当连接到终端节点时，此策略向 AWS 账户中的 IAM 用户iottwinmakeradmin授予对所有资源123456789012上列出的 AWS IoT TwinMaker 操作的访问权限。

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