Amazon IoT SiteWise 和接口 VPC 终端节点 (Amazon PrivateLink) - Amazon IoT SiteWise
Amazon IoT SiteWise VPC 终端节点的注意事项为 Amazon IoT SiteWise创建接口 VPC 端点Amazon IoT SiteWise 通过接口 VPC 终端节点进行访问为创建 VPC 终端节点策略 Amazon IoT SiteWise
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Amazon IoT SiteWise 和接口 VPC 终端节点 (Amazon PrivateLink)

您可通过创建 VPC 接口端点在虚拟私有云 (VPC) 和 Amazon IoT SiteWise 之间创建私有连接。接口端点由一项技术提供支持 Amazon PrivateLink，无需互联网网关、NAT 设备、VPN 连接或 Amazon Direct Connect 连接即可使用该技术私密访问 Amazon IoT SiteWise API 操作。您的 VPC 中的实例不需要公有 IP 地址即可与 Amazon IoT SiteWise API 操作通信。您的 VPC 和 VPC 之间的流量 Amazon IoT SiteWise 不会离开 Amazon 网络。

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

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

Amazon IoT SiteWise VPC 终端节点的注意事项

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

Amazon IoT SiteWise 支持从您的 VPC 调用以下 Amazon IoT SiteWise API 操作：

为 Amazon IoT SiteWise创建接口 VPC 端点

您可以为 Amazon IoT SiteWise 服务创建 VPC 终端节点。您可以使用 Amazon VPC 控制台或 Amazon Command Line Interface (Amazon CLI)。有关更多信息，请参阅《Amazon VPC 用户指南》中的创建接口端点。

使用以下服务名称之一 Amazon IoT SiteWise 为创建 VPC 终端节点：

  • 对于数据面板 API 操作，请使用以下服务名称：

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

  • 对于控制面板 API 操作，请使用以下服务名称：

    com.cn.amazonaws.cn-north-1.iotsitewise.api

Amazon IoT SiteWise 通过接口 VPC 终端节点进行访问

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

如果为端点启用私有 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 ：

  • 在 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

  • 禁用主机前缀注入功能。当您调用每个 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 VPC 用户指南》中的通过接口端点访问服务。

为创建 VPC 终端节点策略 Amazon IoT SiteWise

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

  • 可执行操作的主体。

  • 可执行的操作。

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

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

示例：用于 Amazon IoT SiteWise 操作的 VPC 终端节点策略

以下是的终端节点策略示例 Amazon IoT SiteWise。当连接到终端节点时，此策略授予用户访问iotsitewiseadmin在 Amazon Web Services 账户 123456789012 中列出的对指定资产的 Amazon IoT SiteWise 操作的访问权限。

{
    "Statement": [
        {
            "Action": [
                "iotsitewise:CreateAsset",
                "iotsitewise:ListGateways",
                "iotsitewise:ListTagsForResource"
            ],
            "Effect": "Allow",
            "Resource": "arn:aws:iotsitewise:cn-north-1:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
            "Principal": {
                "AWS": [
                    "123456789012:user/iotsitewiseadmin"
                ]
            }
        }
    ]
}