Hinweis zum Ende des Supports: Am 31. Mai 2026 AWS endet der Support für AWS Panorama. Nach dem 31. Mai 2026 können Sie nicht mehr auf die AWS Panorama Konsole oder AWS Panorama die Ressourcen zugreifen. Weitere Informationen finden Sie unter [AWS Panorama Ende des Supports](https://docs.aws.amazon.com/panorama/latest/dev/panorama-end-of-support.html).
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Appliances mit der AWS Panorama API verwalten
Sie können Appliance-Verwaltungsaufgaben mit der AWS Panorama API automatisieren.
## Geräte anzeigen
Verwenden Sie die [ListDevices](https://docs.aws.amazon.com/panorama/latest/api/API_ListDevices.html)API IDs, um eine Liste der Geräte mit Gerät zu erhalten.
```
$ aws panorama list-devices
"Devices": [
{
"DeviceId": "device-4tafxmplhtmzabv5lsacba4ere",
"Name": "my-appliance",
"CreatedTime": 1652409973.613,
"ProvisioningStatus": "SUCCEEDED",
"LastUpdatedTime": 1652410973.052,
"LeaseExpirationTime": 1652842940.0
}
]
}
```
Verwenden Sie die [DescribeDevice](https://docs.aws.amazon.com/panorama/latest/api/API_DescribeDevice.html)API, um weitere Informationen zu einer Appliance zu erhalten.
```
$ aws panorama describe-device --device-id device-4tafxmplhtmzabv5lsacba4ere
{
"DeviceId": "device-4tafxmplhtmzabv5lsacba4ere",
"Name": "my-appliance",
"Arn": "arn:aws:panorama:us-west-2:123456789012:device/device-4tafxmplhtmzabv5lsacba4ere",
"Type": "PANORAMA_APPLIANCE",
"DeviceConnectionStatus": "ONLINE",
"CreatedTime": 1648232043.421,
"ProvisioningStatus": "SUCCEEDED",
"LatestSoftware": "4.3.55",
"CurrentSoftware": "4.3.45",
"SerialNumber": "GFXMPL0013023708",
"Tags": {},
"CurrentNetworkingStatus": {
"Ethernet0Status": {
"IpAddress": "192.168.0.1/24",
"ConnectionStatus": "CONNECTED",
"HwAddress": "8C:XM:PL:60:C5:88"
},
"Ethernet1Status": {
"IpAddress": "--",
"ConnectionStatus": "NOT_CONNECTED",
"HwAddress": "8C:XM:PL:60:C5:89"
}
},
"LeaseExpirationTime": 1652746098.0
}
```
## Aktualisieren Sie die Appliance-Software
Wenn die `LatestSoftware` Version neuer als die ist`CurrentSoftware`, können Sie das Gerät aktualisieren. Verwenden Sie die [CreateJobForDevices](https://docs.aws.amazon.com/panorama/latest/api/API_CreateJobForDevices.html)API, um einen over-the-air (OTA-) Aktualisierungsjob zu erstellen.
```
$ aws panorama create-job-for-devices --device-ids device-4tafxmplhtmzabv5lsacba4ere \
--device-job-config '{"OTAJobConfig": {"ImageVersion": "4.3.55"}}' --job-type OTA
{
"Jobs": [
{
"JobId": "device-4tafxmplhtmzabv5lsacba4ere-0",
"DeviceId": "device-4tafxmplhtmzabv5lsacba4ere"
}
]
}
```
In einem Skript können Sie das Feld „Image-Version“ in der Job-Konfigurationsdatei mit Bash-String-Manipulation füllen.
**Example [check-updates.sh](https://github.com/awsdocs/aws-panorama-developer-guide/blob/main/util-scripts/check-updates.sh)**
```
apply_update() {
DEVICE_ID=$1
NEW_VERSION=$2
CONFIG='{"OTAJobConfig": {"ImageVersion": "NEW_VERSION"}}'
CONFIG=${CONFIG/NEW_VERSION/$NEW_VERSION}
aws panorama create-job-for-devices --device-ids ${DEVICE_ID} --device-job-config "${CONFIG}" --job-type OTA
}
```
Die Appliance lädt die angegebene Softwareversion herunter und aktualisiert sich selbst. Beobachten Sie den Fortschritt des Updates mit der [DescribeDeviceJob](https://docs.aws.amazon.com/panorama/latest/api/API_DescribeDeviceJob.html)API.
```
$ aws panorama describe-device-job --job-id device-4tafxmplhtmzabv5lsacba4ere-0
{
"JobId": "device-4tafxmplhtmzabv5lsacba4ere-0",
"DeviceId": "device-4tafxmplhtmzabv5lsacba4ere",
"DeviceArn": "arn:aws:panorama:us-west-2:559823168634:device/device-4tafxmplhtmzabv5lsacba4ere",
"DeviceName": "my-appliance",
"DeviceType": "PANORAMA_APPLIANCE",
"ImageVersion": "4.3.55",
"Status": "REBOOTING",
"CreatedTime": 1652410232.465
}
```
Um eine Liste aller laufenden Jobs zu erhalten, verwenden Sie den [ListDevicesJobs](https://docs.aws.amazon.com/panorama/latest/api/API_ListDevicesJobs.html).
```
$ aws panorama list-devices-jobs
{
"DeviceJobs": [
{
"DeviceName": "my-appliance",
"DeviceId": "device-4tafxmplhtmzabv5lsacba4ere",
"JobId": "device-4tafxmplhtmzabv5lsacba4ere-0",
"CreatedTime": 1652410232.465
}
]
}
```
Ein Beispielskript, das nach Updates sucht und diese anwendet, finden Sie unter [check-updates.sh](https://github.com/awsdocs/aws-panorama-developer-guide/blob/main/util-scripts/check-updates.sh) im GitHub Repository dieses Handbuchs.
## Starten Sie die Geräte neu
Verwenden Sie die [CreateJobForDevices](https://docs.aws.amazon.com/panorama/latest/api/API_CreateJobForDevices.html)API, um eine Appliance neu zu starten.
```
$ aws panorama create-job-for-devices --device-ids device-4tafxmplhtmzabv5lsacba4ere --job-type REBOOT
{
"Jobs": [
{
"JobId": "device-4tafxmplhtmzabv5lsacba4ere-0",
"DeviceId": "device-4tafxmplhtmzabv5lsacba4ere"
}
]
}
```
In einem Skript können Sie eine Liste von Geräten abrufen und eines auswählen, das interaktiv neu gestartet werden soll.
**Example [reboot-device.sh](https://github.com/awsdocs/aws-panorama-developer-guide/blob/main/util-scripts/reboot-device.sh) — Verwendung**
```
$ ./reboot-device.sh
Getting devices...
0: device-53amxmplyn3gmj72epzanacniy my-se70-1
1: device-6talxmpl5mmik6qh5moba6jium my-manh-24
Choose a device
1
Reboot device device-6talxmpl5mmik6qh5moba6jium? (y/n)y
{
"Jobs": [
{
"DeviceId": "device-6talxmpl5mmik6qh5moba6jium",
"JobId": "device-6talxmpl5mmik6qh5moba6jium-8"
}
]
}
```