無線裝置的目的地的 AWS IoT Wireless API 操作

您可為 LoRaWAN 和 Sidewalk 裝置的目的地執行下列 API 操作：

下列各節展示如何取得、列出、更新及和刪除目的地。如需建立目的地的相關資訊，請參閱 為您的 Sidewalk 終端裝置新增目的地。

取得目的地的相關資訊

您可使用 GetDestination API 操作，以取得您新增至 AWS IoT Wireless 帳戶中的目的地相關資訊。提供目的地名稱作為 API 的輸入。API 接著將會傳回與所指定識別符相符之目的地的資訊。

下列顯示範例 CLI 命令：

aws iotwireless get-destination --name SidewalkDestination

執行此命令會傳回您目的地的參數。

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination",
    "Name": "SidewalkDestination",
    "Expression": "IoTWirelessRule",
    "ExpressionType": "RuleName",
    "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole"
}

更新您目的地的屬性

使用 UpdateDestination API 操作，來更新您為 AWS IoT Wireless 新增至帳戶的目的地屬性。下列顯示了更新描述屬性的範例 CLI 命令：

aws iotwireless update-destination --name SidewalkDestination \
    --description "Destination for messages processed using IoTWirelessRule"

列出 AWS 帳戶 中的目的地

使用 ListDestinations API 操作，在 AWS 帳戶 中列出您新增至 AWS IoT Wireless 的目的地。如要篩選清單，以便僅傳回 LoRaWAN 和 Sidewalk 終端裝置的目的地，請使用 WirelessDeviceType 參數。

下列顯示範例 CLI 命令：

aws iotwireless list-destinations --wireless-device-type "Sidewalk"

執行此命令會傳回您新增的目的地清單，包括其 Amazon Resource Name (ARN)。如要擷取有關特定目的地的其他詳細資訊，請使用 GetDestination API。

{
    "DestinationList": [
        {
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination",
            "Name": "IoTWirelessDestination",
            "Expression": "IoTWirelessRule",
            "Description": "Destination for messages processed using IoTWirelessRule",
            "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole"
        },
        {
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination2",
            "Name": "IoTWirelessDestination2",
            "Expression": "IoTWirelessRule2",
            "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole"
        }
    ]
}

從您的 AWS 帳戶 刪除目的地

如要刪除目的地，請將要刪除的目的地名稱作為輸入傳遞給 DeleteDestination API 操作。下列顯示範例 CLI 命令：

aws iotwireless delete-destination --name "SidewalkDestination"

此命令不會產生任何輸出。您可使用 GetDestination API 或 ListDestinations API 操作來驗證目的地是否已從您的帳戶中移除。