# 取得裝置 JSON 檔案，進行佈建
將 Sidewalk 裝置新增至適用於 Amazon Sidewalk 的 AWS IoT Core 後，請下載包含佈建終端裝置所需資訊的 JSON 檔案。您可以使用 AWS IoT 主控台或 AWS CLI 來擷取此資訊。如需有關如何佈建裝置的詳細資訊，請參閱《Amazon Sidewalk 文件》**中的[佈建和註冊您的終端裝置](https://docs.sidewalk.amazon/provisioning/)。
## 取得 JSON 檔案 (主控台)
如要取得 JSON 檔案，以佈建您的 Sidewalk 裝置：
1. 請移至 [Sidewalk 裝置中樞](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk)。
1. 選擇您新增至適用於 Amazon Sidewalk 的 AWS IoT Core 的裝置，以檢視其詳細資訊。
1. 在您新增裝置的詳細資料頁面中選擇**下載裝置 JSON 檔案**，以取得 JSON 檔案。
將會下載 `certificate.json` 檔案，其包含佈建終端裝置所需的資訊。下列顯示範本 JSON 檔案。其包含裝置憑證、私有金鑰、Sidewalk 製造序號 (SMSN) 和 `DeviceTypeID`。
```
{
"p256R1": "{{grg8izXoVvQ86cPVm0GMyWuZYHEBbbH ... DANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw==}}",
"eD25519": "{{grg8izXoVvQ86cPVm0GMyWuZYHEBbbHD ... UiZmntHiUr1GfkTOFMYqRB+Aw==}}",
"metadata": {
"devicetypeid": "{{fe98}}",
"applicationDeviceArn": "arn:aws:iotwireless:{{us-east-1}}:{{123456789012}}:WirelessDevice/{{897ce68e-3ca2-4ed0-85a2-30b0666c4052}}",
"applicationDeviceId": "{{897ce68e-3ca2-4ed0-85a2-30b0666c4052}}",
"smsn": "{{82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A}}",
"devicePrivKeyP256R1": "{{3e704bf8d319b3a475179f1d68c60737b28c708f845d0198f2d00d00c88ee018}}",
"devicePrivKeyEd25519": "{{17dacb3a46ad9a42d5c520ca5f47f0167f59ce54d740aa13918465faf533b8d0}}"
},
"applicationServerPublicKey": "{{5ce29b89c2e3ce6183b41e75fe54e45f61b8bb320efbdd2abd7aefa5957a316b}}"
}
```
在 Sidewalk 裝置的詳細資訊頁面中，您也會看到下列相關資訊：
+ 裝置 ID、其 Amazon Resource Name (ARN)，及裝置與之關聯的任何 AWS IoT 物件的相關詳細資訊。
+ 裝置設定檔和目的地詳細資訊。
+ 從裝置所收到最後一則上行訊息的時間。
+ 指出您裝置是否已佈建或註冊的狀態。
## 取得 JSON 檔案 (CLI)
如要使用適用於 Amazon Sidewalk 的 AWS IoT Core API 或 AWS CLI 取得 JSON 檔案來佈建 Sidewalk 終端裝置，請將擷取裝置設定檔和無線裝置相關資訊的 API 回應以 JSON 檔案形式暫存為 {{`wireless_device.json`}} 和 {{`device_profile.json`}} 等檔案。您將會使用它們佈建您的 Sidewalk 裝置。
下列顯示如何擷取 JSON 檔案。
**Topics**
+ [步驟 1：取得裝置設定檔資訊作為 JSON 檔案](#iot-sidewalk-profile-get)
+ [步驟 2：取得 Sidewalk 裝置資訊作為 JSON 檔案](#iot-sidewalk-get-device)
### 步驟 1：取得裝置設定檔資訊作為 JSON 檔案
使用 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html) API 操作或 [https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html) CLI 命令，以取得您為適用於 Amazon Sidewalk 的 AWS IoT Core 新增至帳戶之裝置設定檔的相關資訊。如要擷取裝置設定檔的相關資訊，請指定設定檔 ID。
接著，API 將會傳回與所指定識別符與裝置 ID 相符之裝置設定檔的資訊。您可將此回應資訊另存為檔案，並為其命名，如 {{`device_profile.json`}}。
下列顯示範例 CLI 命令：
```
aws iotwireless get-device-profile \
--id "{{12345678-a1b2-3c45-67d8-e90fa1b2c34d}}" > {{device_profile.json}}
```
執行此命令會傳回裝置設定檔的參數、應用程式伺服器公有金鑰，和 `DeviceTypeID`。下列顯示 JSON 檔案，其包含來自 API 的範例回應資訊。如需有關 API 回應中參數的詳細資訊，請參閱 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html)。
**`GetDeviceProfile` API 回應 (`{{device_profile.json}}` 的內容)**
```
{
"Arn": "arn:aws:iotwireless:{{us-east-1}}:{{123456789012}}:DeviceProfile/{{12345678-a1b2-3c45-67d8-e90fa1b2c34d}}",
"Id": "{{12345678-a1b2-3c45-67d8-e90fa1b2c34d}}",
"Name": {{"Sidewalk_profile"}},
"LoRaWAN": null,
"Sidewalk":
{
"ApplicationServerPublicKey": "{{a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234}}",
"DAKCertificateMetadata": [
{
"DeviceTypeId: "{{fe98}}",
"CertificateId": {{"43564A6D2D50524F544F54595045"}},
"FactorySupport": false,
"MaxAllowedSignature": 1000
}
],
"QualificationStatus": false
}
}
```
### 步驟 2：取得 Sidewalk 裝置資訊作為 JSON 檔案
使用 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html) API 操作或 [https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html) CLI 命令，以取得您為適用於 Amazon Sidewalk 的 AWS IoT Core 新增至帳戶之 Sidewalk 裝置的相關資訊。如要取得終端裝置的相關資訊，請提供您在新增裝置時取得的無線裝置識別符。
接著，API 將會傳回與所指定識別符及裝置 ID 相符之裝置的資訊。將此回應資訊儲存為 JSON 檔案。為檔案提供一個有意義的名稱，例如 {{`wireless_device.json`}}。
下列顯示使用 CLI 執行命令的範例：
```
aws iotwireless get-wireless-device --identifier-type WirelessDeviceId \
--identifier {{"23456789-abcd-0123-bcde-fabc012345678"}} > {{wireless_device.json}}
```
執行此命令會傳回裝置詳細資訊、裝置憑證、私有金鑰和 Sidewalk 製造序號 (SMSN)。下列會顯示執行此命令的範例輸出。如需有關 API 回應中參數的詳細資訊，請參閱 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html)。
**`GetWirelessDevice` API 回應 (`{{wireless_device.json}}` 的內容)**
```
{
"Arn": "arn:aws:iotwireless:{{us-east-1}}:{{123456789012}}:WirelessDevice/{{23456789-abcd-0123-bcde-fabc012345678}}",
"Id": "{{23456789-abcd-0123-bcde-fabc012345678}}",
"DestinationName": {{"SidewalkDestination"}},
"Type": "Sidewalk",
"Sidewalk": {
"CertificateId": {{"4C7438772D50524F544F54595045"}},
"DeviceCertificates": [
{
"SigningAlg": "Ed25519",
"Value": {{"hDdkJw9L2uMCORjImjMHqzNR6nYYh6QKncSl5GthQNl7NKe4ounb5UMQtLjnm7zOUPYOqghCeVOLCBUiQe2ZiMBEW18JDUXIhffPobqZgohK91+LKFJ10X/F+GeltcafZcFKhS+O5NPcVNR/fHYaf/cn5iUbRwlz/T+ODXvGdwkBkgDyFgoUJgn7JdzFjaneE5qzTWXUbL79i1sXToGGjP8hiD9jJhidPWhIswleydAWgO1OZGA4CjzIaSGVM1VtaLB0VDphAkEpjMkZrtVDH3S8U1vDZTVi6YSbnkYZgfWv/uMMBfgAeL8Tdv5LkFIPIB3ZX9zt8zzmAuFRzI4MuNjWfIDnOF6AKu37WWU6/QYhZoQrW9D/wndiCcsRGl+ANn367r/HE02Re4DOiCfs9f2rjc4LT1LKt7g/KW2ii+W+9HYvvY0bBAI+AHx6Cx4j+djabTsvrgW2k6NU2zUSM7bdDP3z2a2+Z4WzBji/jYwt/OP8rpsy5Ee4ywXUfCsfQ0rKOr0zay6yh27p3I3MZle2oCO4JIlqK0VbIQqsXzSSyp6XXS0lhmuGugZ1AAADGz+gFBeX/ZNN8VJwnsNfgzj4me1HgVJdUo4W9kvx9cr2jHWkC3Oj/bdBTh1+yBjOC53yHlQK/l1GHrEWiWPPnE434LRxnWkwr8EHD4oieJxC8fkIxkQfj+gHhU79Z+oAAYAAAzsnf9SDIZPoDXF0TdC9POqTgld0oXDl2XPaVD4CvvLearrOSlFv+lsNbC4rgZn23MtIBM/7YQmJwmQ+FXRup6Tkubg1hpz04J/09dxg8UiZmntHiUr1GfkTOFMYqRB+Aw=="}}
},
{
"SigningAlg": "P256r1",
"Value": {{"hDdkJw9L2uMCORjImjMHqzNR6nYYh6QKncSl5GthQNmHmGU8a+SOqDXWwDNt3VSntpbTTQl7cMIusqweQo+JPXXWElbGh7eaxPGz4ZeF5yM2cqVNUrQr1lX/6lZ+OLuycrFrLzzB9APi0NIMLqV/Rt7XJssHQs2RPcT1ul/2XVpa6ztULJeQi2JwhTb/k48wbh/EvafG/ibrIBIx9v7/dwGRAPKHq7Uwb9hHnhpa8qNOUtjeUdIwJNh9vCBFX9s22t4PdortoFxbXo9C149PDDD4wqUHJGYlCsVX/Sqqjf7Aug3h5dwdYN6cDgsuuiOm0+aBcXBGpkh7OxVxlwXkIP+11dt23TkrSUKd0B01sc9Mc/0yEBCzx5RutKBwsefzyOl4vQX3AHgV7oD/XV73THMgGiDxQ55CPaaxN/pm791VkQ76BSZaBeF+Su6tg0k/eQneklt8Du5uqkyBHVxy8MvxsBIMZ73vIFwUrLHjDeq3+nOOyQqSBMnrHKU2mAwN3zb2LolwjPkKNOh1+NNnv99L2pBcNCnhnoBULWmWAZNXJpMx9QrcSwI9AHylcgUbGQJgf9Ryun+BgewzYNdWrXyKkp4O3ZDa4f+5SVWvbY5eyDDXcohvz/OcCtuRjAkzKBCvIjBDnCv1McjVdCO3+utizGntfhAo1RZstnOoRkgVF2WuMT9IrUmzYximuTXUmWtjyFSTqgNBZwHWUTlMmjlpLCVzZQWM4zOisXUAAALPsP34BS6EzJO5AsS5pC7QTpjBtAbLN9SdXOT9w4H1x8Nkp0ujLxWRN37IEy0V9DrPK2w1g74uqWPfUPnSBjtvM55JnQpmm23WQNvHa1Vr6zmWDjzjHpcNirPbzXyBlKEhkX4xylaSMnm4UrVXtAMaAJ/csC4HPTKr3dazdvEkhwGAAAIFByCjSp/5WHc4AhsyjMvKCsZQiKgiI8ECwjfXBaSZdY4zYsRlO3FC428H1atrFChFCZT0Bqt5LPXD38bMSB+vAUJiP8XqiEdXeqf2mYMJ5ykoDpwkve/cUQfPpjzFQlQfvwjBwiJDANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw=="}}
}
],
"DeviceProfileId": {{"0ff5b0c6-f149-4498-af34-21993acd52a7"}},
"PrivateKeys": [
{
"SigningAlg": "Ed25519",
"Value": {{"2c24d4572327f23b9bef38097137c29224a9e979081b3d90124ac9dfa477934e"}}
},
{
"SigningAlg": "P256r1",
"Value": {{"38d526f29cfaf142f596deca187bd809ef71bc13435eedc885b63bb825d63def"}}
}
],
"SidewalkManufacturingSn": {{"843764270F4BDAE3023918C89A3307AB3351EA761887A40A9DC4A5E46B6140D9"}},
"Status": "PROVISIONED"
},
...
}
```
## 後續步驟
暫時儲存 JSON 檔案 {{`wireless_device.json`}} 和 {{`device_profile.json`}}，因為您會在下一個步驟中使用這些檔案來佈建和註冊您的終端裝置以連線至硬體平台。如需詳細資訊，請參閱《Amazon Sidewalk 文件》**中的[佈建和註冊您的終端裝置](https://docs.sidewalk.amazon/provisioning/)。