加入 AWS IoT Core for LoRaWAN 控制平面 API 端點 - AWS IoT Wireless

加入 AWS IoT Core for LoRaWAN 控制平面 API 端點

您可以使用 AWS IoT Core for LoRaWAN 控制平面 API 端點與 AWS IoT Wireless API 互動。例如,您可使用此端點來執行 SendDataToWirelessDevice API,將資料從 AWS IoT 傳送至 LoRaWAN 裝置。如需詳細資訊,請參閱 AWS IoT Core for LoRaWAN 控制平面 API 端點

您可以使用 Amazon VPC 中託管的用戶端,存取 AWS PrivateLink 提供的控制平面端點。您可以使用這些端點,透過 Virtual Private Cloud (VPC) 中的介面端點連接至 AWS IoT Wireless API,而不是透過公有網際網路進行連接。

建立您的 Amazon VPC 和子網路

在可以連接到介面端點之前,您必須建立 VPC 和子網路。然後,將在您的子網路中啟動 EC2 執行個體,您可以使用該執行個體連接到介面端點。

若要建立您的 VPC:

  1. 導覽至 Amazon VPC 主控台的 VPC (VPC) 頁面,然後選擇 Create VPC (建立 VPC)。

  2. Create VPC (建立 VPC) 頁面上:

    • 輸入 VPC Name tag - optional (VPC 名稱標籤 - 選用) 的名稱 (例如,VPC-A)。

    • 在 IPv4 CIDR 區塊中輸入 VPC 的 IPv4 位址範圍 (例如,10.100.0.0/16)。

  3. 保留其他欄位的預設值,然後選擇 Create VPC (建立 VPC)。

若要建立您的子網路:

  1. 導覽至 Amazon VPC 主控台的 Subnets (子網路) 頁面,然後選擇 Create subnet (建立子網路)。

  2. Create subnet (建立子網路) 頁面上:

    • 針對 VPC ID,選擇您稍早建立的 VPC (例如,VPC-A)。

    • 輸入 Subnet name (子網路名稱) 的名稱(例如,Private subnet)。

    • 為您的子網路選擇 Availability Zone (可用區域)。

    • IPv4 CIDR block (IPv4 CIDR 區塊) 中輸入子網路的 IP 地址區塊 (例如,10.100.0.0/24)。

  3. 若要建立子網路並將其新增至 VPC,請選擇 Create subnet (建立子網路)。

如需詳細資訊,請參閱使用 VPC 和子網路

在子網路中啟動 Amazon EC2 執行個體

若要啟動您的 EC2 執行個體:

  1. 導覽至 Amazon EC2 主控台,然後選擇 Launch Instance (啟動執行個體)。

  2. 針對 AMI,選擇 Amazon Linux 2 AMI (HVM), SSD Volume Type (Amazon Linux 2 AMI (HVM),SSD 磁碟區類型),然後選擇 t2 micro 執行個體類型。若要設定執行個體詳細資訊,請選擇 Next (下一步)。

  3. Configure Instance Details (設定執行個體詳細資訊) 頁面中:

    • 針對 Network (網路),選擇您稍早建立的 VPC (例如,VPC-A)。

    • 針對 Subnet (子網路),選擇您稍早建立的子網路 (例如,Private subnet)。

    • 針對 IAM role (IAM 角色),選擇角色 AWSIoTWirelessFullAccess 將完整存取政策授予 AWS IoT Core for LoRaWAN。如需詳細資訊,請參閱 AWSIoTWirelessFullAccess 政策摘要

    • 針對 Assume Private IP (採用私有 IP),使用 IP 地址,例如,10.100.0.42

  4. 選擇 Next: Add Storage (下一步:新增儲存體),然後選擇 Next:Add tags (下一步:新增標籤)。您可以選擇性地新增任何標籤,與您的 EC2 執行個體建立關聯。選擇 Next: Configure Security Group (下一步:設定安全群組)

  5. Configure Security Group (設定安全群組) 頁面中,設定要允許的安全群組:

    • 將來源的 All TCP (所有 TCP) 開啟為 10.200.0.0/16

    • 將來源的 All ICMP - IPV4 (所有 ICMP - IPV4) 開啟為 10.200.0.0/16

  6. 若要檢閱執行個體詳細資訊並啟動 EC2 執行個體,請選擇 Review and Launch (檢閱並發佈)。

如需詳細資訊,請參閱 Amazon EC2 Linux 執行個體入門

建立 Amazon VPC 介面端點

您可以為 VPC 建立 VPC 端點,然後可以透過 EC2 API 來存取該端點。若要建立端點:

  1. 導覽至 VPC Endpoints (端點) 主控台,然後選擇 Create Endpoint (建立端點)。

  2. Create Endpoint (建立端點) 頁面中,指定下列資訊。

    • 選擇服務類別AWS 服務

    • 針對 Service Name (服務名稱),輸入關鍵字 iotwireless 進行搜尋。在顯示的 iotwireless 服務清單中,請為您的區域選擇控制平面 API 端點。端點的格式為 com.amazonaws.region.iotwireless.api

    • 針對 VPCSubnets (子網路),選擇要在其中建立端點的 VPC,以及要在其中建立端點網路的可用區域 (AZ)。

      注意

      iotwireless 服務可能無法支援所有可用區域。

    • 針對 Enable DNS name (啟用 DNS 名稱),選擇 Enable for this endpoint (為此端點啟用)。

      選擇此選項會自動解析 DNS,並在 Amazon Route 53 Public Data Plane 中建立路由,以便您稍後用來測試連線的 API 將通過 Privatelink 端點。

    • 針對 Security group (安全群組),選擇要與端點網路介面建立關聯的安全群組。

    • 您可以選擇性地新增或移除標籤。標籤是您用來與端點建立關聯的名稱值對。

  3. 若要建立 VPC 端點,請選擇 Create endpoint (建立端點)。

測試您與介面端點的連線

您可以使用 SSH 存取 Amazon EC2 執行個體,然後使用 AWS CLI 以連接至 Privatelink 介面端點。

在您連接至介面端點之前,請遵循在 Linux 上安裝、更新和解除安裝 AWS CLI 第 2 版中描述的指示來下載最新的 AWS CLI 版本。

下列範例顯示如何使用 CLI 來測試您與介面端點的連線。

aws iotwireless create-service-profile \ --endpoint-url https://api.iotwireless.region.amazonaws.com \ --name='test-privatelink'

下列顯示執行命令的範例。

Response: { "Arn": "arn:aws:iotwireless:region:acct_number:ServiceProfile/1a2345ba-4c5d-67b0-ab67-e0c8342f2857", "Id": "1a2345ba-4c5d-67b0-ab67-e0c8342f2857" }

同樣地,您可以執行下列命令,來取得服務設定檔資訊或列出所有服務設定檔。

aws iotwireless get-service-profile \ --endpoint-url https://api.iotwireless.region.amazonaws.com --id="1a2345ba-4c5d-67b0-ab67-e0c8342f2857"

下列顯示 list-device-profiles 命令的範例。

aws iotwireless list-device-profiles \ --endpoint-url https://api.iotwireless.region.amazonaws.com