View a markdown version of this page

Erstellen und Verwalten von Befehlen - AWS IoT Core
Erstellen Sie eine BefehlsressourceRuft Informationen zu einem Befehl abListen Sie Befehle in Ihrem auf AWS-KontoAktualisieren Sie eine BefehlsressourceVerwerfen Sie eine Befehlsressource oder stellen Sie sie wieder herLöschen Sie eine Befehlsressource

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.

Erstellen und Verwalten von Befehlen

Verwenden Sie AWS IoT Device Management Befehle, um wiederverwendbare Fernaktionen zu konfigurieren oder sofortige Anweisungen an Geräte zu senden. Erstellen und verwalten Sie Befehle über die AWS IoT Konsole oder mithilfe der AWS CLI.

Erstellen Sie eine Befehlsressource

Geben Sie beim Erstellen eines Befehls die folgenden Informationen an:

  • Allgemeine Informationen

    Geben Sie eine eindeutige Befehls-ID an, um den Befehl zu identifizieren, wenn Sie ihn auf Zielgeräten ausführen. Geben Sie optional einen Anzeigenamen, eine Beschreibung und Tags für die Verwaltung an.

  • Nutzlast

    Geben Sie für statische Befehle eine Payload an, die Geräteaktionen definiert. Geben Sie den Payload-Formattyp für eine korrekte Geräteinterpretation an.

    Dynamische Befehle finden Sie im Payload-Vorlagenattribut.

  • Payload-Vorlage

    Stellen Sie für dynamische Befehle ein PayloadTemplate mit Platzhaltern und Parametern bereit. Geben Sie optional auch Bedingungen andefaultValue. AWS IoT Device Management Befehle ersetzen Platzhalter zur Laufzeit. Fehlende Parameter verwenden ihren DefaultValue. Alle Werte müssen definierte Bedingungen erfüllen.

    Die folgenden Platzhaltertypen werden unterstützt, bei denen zwischen Groß- und Kleinschreibung unterschieden wird:

    • ${aws:iot:commandexecution::parameter:parameter1}— Ein Platzhalter für den Wert eines Parameters mit dem Namen. parameter1

    • ${aws:iot:commandexecution::executionTimeoutSec}— Ein Platzhalter für den Timeout-Parameter für die Befehlsausführung, der zur Laufzeit bereitgestellt wird.

Befehle vorbehalten Topics verwenden ein Format, das auf dem Payload-Formattyp basiert.

  • Verwenden Sie für application/json application/cbor unsere Inhaltstypen dieses Anforderungsthema:

    $aws/commands/<devices>/<DeviceID>/executions/+/request/<PayloadFormat>

  • Verwenden Sie für andere Inhaltstypen oder ein nicht spezifiziertes Format dieses Anforderungsthema. Das Payload-Format wird im MQTT-Nachrichtenheader angezeigt.

    $aws/commands/<devices>/<DeviceID>/executions/+/request

Das Antwort-Topic für Befehle verwendet json unser cbor Format unabhängig vom Payload-Typ. <PayloadFormat>muss json oder cbor sein:

$aws/commands/<devices>/<DeviceID>/executions/<ExecutionId>/response/<PayloadFormat>

In den folgenden Abschnitten werden Überlegungen zum Payload-Format und die Befehlserstellung über die Konsole beschrieben.

Payload-Format für statische Befehle

Die Payload unterstützt jedes Format bis zu 32 KB. Geben Sie den Payload-Formattyp für eine sichere und korrekte Geräteinterpretation an.

Geben Sie den Payload-Formattyp mithilfe des type/subtype Formats an (z. B. application/json oderapplication/cbor). Standard: application/octet-stream. Unterstützte Formate finden Sie unter Allgemeine MIME-Typen.

Dynamisches Payload-Format für Befehle

Das PayloadTemplate muss ein gültiges JSON mit mindestens einem Platzhalter sein, bis zu 32 KB.

Für den AwsJsonSubstitution Präprozessor sendet AWS IoT Device Management Commands Benachrichtigungen im JSON- oder CBOR-Format, basierend auf der Präprozessorkonfiguration.

Wie erstelle ich einen Befehl (Konsole)

Um einen Befehl von der Konsole aus zu erstellen, gehen Sie zu Command Hub und gehen Sie wie folgt vor:

  1. Wählen Sie Befehl erstellen.

  2. Geben Sie eine eindeutige Befehls-ID an.

  3. (Optional) Geben Sie Anzeigenamen, Beschreibung und Tags an.

  4. Laden Sie die Payload-Datei hoch, die Geräteaktionen enthält. Geben Sie den Payload-Formattyp für die korrekte Geräteinterpretation an.

  5. (Optional) Bei JSON-Payload-Vorlagen mit Platzhaltern werden die Parameter in der Inline-Tabelle zur Bearbeitung vorab ausgefüllt.

  6. (Optional) Konfigurieren Sie den Parameterwerttyp (erforderlich), den Standardwert und die Bedingungen.

  7. Wählen Sie Befehl „Erstellen“.

Verwenden Sie den CreateCommand API- oder create-command CLI-Befehl, um einen Befehl zu erstellen.

Nutzlast des Befehls

Stellen Sie eine statische Nutzlast oder eine Payload-Vorlage bereit. Statische Payloads sind Base64-kodiert. Bei Payload-Vorlagen wird die endgültige Payload zur Laufzeit mithilfe von Parameterwerten generiert. Geräte verarbeiten die Payload und führen bestimmte Aktionen aus. Geben Sie den Payload-Inhaltstyp für den korrekten Geräteempfang an.

Anmerkung

Payloads können nach der Befehlserstellung nicht geändert werden. Erstellen Sie einen neuen Befehl, um die Payload zu ändern.

Beispiel einer IAM-Richtlinie

Bevor Sie diesen API-Vorgang verwenden, stellen Sie sicher, dass Ihre IAM-Richtlinie Sie autorisiert, diese Aktion auf dem Gerät durchzuführen. Das folgende Beispiel zeigt eine IAM-Richtlinie, die dem Benutzer die Berechtigung zum Ausführen der Aktion gewährt. CreateCommand

Ersetzen Sie in diesem Beispiel:

  • regionmit Ihrem AWS-Region, z. B. us-east-1

  • account-idmit Ihrer AWS-Konto Nummer, wie z. 123456789012 B.

  • command-idmit einer eindeutigen Kennung für Ihre AWS IoT Befehls-ID, z. LockDoor B. Wenn Sie mehr als einen Befehl senden möchten, können Sie diese Befehle in der IAM-Richtlinie im Abschnitt Ressource angeben.

{
    "Version":"2012-10-17",
    "Statement": {
        "Action": "iot:CreateCommand",
        "Effect": "Allow",
        "Resource": "arn:aws:iot:us-east-1:123456789012:command/command-id"
    }
}

Beispiel für die Erstellung statischer Befehle

Das folgende Beispiel zeigt, wie Sie einen statischen Befehl erstellen können. Ersetzen Sie je nach Anwendung:

  • <command-id>mit einer eindeutigen Kennung für den Befehl. Um beispielsweise die Tür Ihres Hauses zu verriegeln, können Sie Folgendes angebenLockDoor. Wir empfehlen, dass Sie UUID verwenden. Sie können auch alphanumerische Zeichen wie „-“ und „_“ verwenden.

  • (Optional) <display-name> und<description>, das sind optionale Felder, die Sie verwenden können, um einen benutzerfreundlichen Namen und eine aussagekräftige Beschreibung für den Befehl anzugeben, z. B. Lock the doors of my home

  • namespace, mit denen Sie den Namespace des Befehls angeben können. Das muss es sein. AWS-IoT Informationen zur Verwendung dieser Funktion für AWS IoT FleetWise finden Sie unter Remote-Befehle

  • payloadenthält Informationen über die Payload, die Sie bei der Ausführung des Befehls verwenden möchten, und über deren Inhaltstyp.

aws iot create-command \ 
    --command-id <command-id> \
    --display-name <display-name> \
    --description <description> \ 
    --namespace AWS-IoT \ 
    --payload '{"content":"eyAibWVzc2FnZSI6ICJIZWxsbyBJb1QiIH0=","contentType":"application/json"}'

Wenn Sie diesen Befehl ausführen, wird eine Antwort generiert, die die ID und den ARN (Amazon-Ressourcenname) des Befehls enthält. Wenn Sie den LockDoor Befehl beispielsweise bei der Erstellung angegeben haben, zeigt das Folgende eine Beispielausgabe für die Ausführung des Befehls.

{
    "commandId": "LockDoor",
    "commandArn": "arn:aws:iot:us-east-1:123456789012:command/LockDoor"
}

Beispiel für die dynamische Befehlserstellung

Das folgende Beispiel zeigt, wie Sie einen dynamischen Befehl erstellen können. Ersetzen Sie je nach Anwendung:

  • <command-id>mit einer eindeutigen Kennung für den Befehl. Um beispielsweise den Lichtstromstatus festzulegen, können Sie Folgendes angebenLight_Power_Status. Wir empfehlen die Verwendung von UUID. Sie können auch alphanumerische Zeichen wie „-“ und „_“ verwenden.

  • (Optional) <display-name> und<description>, das sind optionale Felder, die Sie verwenden können, um einen benutzerfreundlichen Namen und eine aussagekräftige Beschreibung für den Befehl anzugeben, z. B. Turn a light ON or OFF

  • namespace, mit denen Sie den Namespace des Befehls angeben können. Das muss es sein. AWS-IoT Informationen zur Verwendung dieser Funktion für AWS IoT FleetWise finden Sie unter Remote-Befehle

  • payloadTemplateenthält die JSON-formatierte Playload-Vorlage mit Platzhaltern.

  • preprocessorenthält die Konfiguration für den Präprozessor, die bestimmt, wie das PayloadTemplate verarbeitet werden muss.

  • mandatoryParameterenthält die Parameter, die den Platzhaltern im PayloadTemplate entsprechen, ihren Typ, ihre Standardwerte und Bedingungen.

aws iot create-command \
    --command-id Light_Power_Status \
    --description "Turn a light ON or OFF" \
    --namespace AWS-IoT \
    --payload-template '{"powerStatus":"${aws:iot:commandexecution::parameter:powerStatus}"}' \
    --preprocessor awsJsonSubstitution={outputFormat=JSON} \
    --mandatory-parameters "name=powerStatus, defaultValue={S=OFF}, valueConditions=[{comparisonOperator=IN_SET, operand={strings=['ON','OFF']}}]"

Wenn Sie diesen Befehl ausführen, wird eine Antwort generiert, die die ID und den ARN (Amazon-Ressourcenname) des Befehls enthält. Wenn Sie den Light_Power_Status Befehl beispielsweise bei der Erstellung angegeben haben, zeigt das Folgende eine Beispielausgabe für die Ausführung des Befehls.

{
    "commandId": "Light_Power_Status",
    "commandArn": "arn:aws:iot:us-east-1:123456789012:command/Light_Power_Status"
}

Ruft Informationen zu einem Befehl ab

Nachdem Sie einen Befehl erstellt haben, können Sie Informationen dazu von der AWS IoT Konsole abrufen und den verwenden AWS CLI. Sie können die folgenden Informationen abrufen.

  • Die Befehls-ID, der Amazon-Ressourcenname (ARN), ein beliebiger Anzeigename und eine Beschreibung, die Sie für den Befehl angegeben haben.

  • Der Befehlsstatus, der angibt, ob ein Befehl auf dem Zielgerät ausgeführt werden kann oder ob er veraltet ist oder gelöscht wurde.

  • Die Payload oder PayloadTemplate, die Sie bereitgestellt haben.

  • Der Präprozessor, den Sie bereitgestellt haben.

  • Die obligatorischen Parameter, die Sie angegeben haben.

  • Die Uhrzeit, zu der der Befehl erstellt und zuletzt aktualisiert wurde.

Um einen Befehl von der Konsole abzurufen, gehen Sie zum Command Hub der AWS IoT Konsole und wählen Sie dann den Befehl aus, den Sie erstellt haben, um dessen Details anzuzeigen.

Zusätzlich zu den Befehlsdetails können Sie den Befehlsverlauf einsehen, der Informationen über die Ausführung des Befehls auf dem Zielgerät enthält. Nachdem Sie diesen Befehl auf dem Gerät ausgeführt haben, finden Sie auf dieser Registerkarte Informationen zu den Ausführungen.

Verwenden Sie den API-Vorgang der GetCommand HTTP-Steuerungsebene oder den get-command AWS CLI Befehl, um Informationen über eine Befehlsressource abzurufen. Sie müssen den Befehl bereits mit der CreateCommand API-Anforderung oder der create-command CLI erstellt haben.

Beispiel einer IAM-Richtlinie

Bevor Sie diesen API-Vorgang verwenden, stellen Sie sicher, dass Ihre IAM-Richtlinie Sie autorisiert, diese Aktion auf dem Gerät auszuführen. Das folgende Beispiel zeigt eine IAM-Richtlinie, die dem Benutzer die Berechtigung zum Ausführen der Aktion gewährt. GetCommand

Ersetzen Sie in diesem Beispiel:

  • regionmit Ihrem AWS-Region, z. B. us-east-1

  • account-idmit Ihrer AWS-Konto Nummer, wie z. 123456789023 B.

  • command-idmit Ihrer AWS IoT eindeutigen Befehlskennung, z. B. LockDoor oderLight_Power_Status. Wenn Sie mehr als einen Befehl abrufen möchten, können Sie diese Befehle in der IAM-Richtlinie im Abschnitt Ressource angeben.

{
    "Version":"2012-10-17",
    "Statement": {
        "Action": "iot:GetCommand",
        "Effect": "Allow",
        "Resource": "arn:aws:iot:us-east-1:123456789012:command/command-id"
    }
}

Rufen Sie ein Befehlsbeispiel ab (AWS CLI)

Das folgende Beispiel zeigt, wie Sie Informationen zu einem Befehl mithilfe von abrufen get-command AWS CLI. Ersetzen Sie je nach Anwendung <command-id> durch den Bezeichner für den Befehl, für den Sie Informationen abrufen möchten. Sie können diese Informationen der Antwort der create-command CLI entnehmen.

aws iot get-command --command-id <command-id>

Wenn Sie diesen Befehl ausführen, wird eine Antwort generiert, die Informationen über den Befehl, die Nutzlast und den Zeitpunkt seiner Erstellung und letzten Aktualisierung enthält. Es enthält auch Informationen, die angeben, ob ein Befehl veraltet ist oder gelöscht wird.

Der folgende Code zeigt beispielsweise eine Beispielantwort. 

{
    "commandId": "LockDoor",
    "commandArn": "arn:aws:iot:<region>:<account>:command/LockDoor",
    "namespace": "AWS-IoT",
    "payload":{
        "content": "eyAibWVzc2FnZSI6ICJIZWxsbyBJb1QiIH0=",
        "contentType": "application/json"
    },
    "createdAt": "2024-03-23T00:50:10.095000-07:00",
    "lastUpdatedAt": "2024-03-23T00:50:10.095000-07:00",
    "deprecated": false,
    "pendingDeletion": false
}

Listen Sie Befehle in Ihrem auf AWS-Konto

Nachdem Sie Befehle erstellt haben, können Sie die Befehle, die Sie in Ihrem Konto erstellt haben, einsehen. In der Liste finden Sie Informationen zu:

  • Die Befehls-ID und alle Anzeigenamen, die Sie für die Befehle angegeben haben.

  • Der Amazon-Ressourcenname (ARN) der Befehle.

  • Der Befehlsstatus, der angibt, ob die Befehle auf dem Zielgerät ausgeführt werden können oder ob sie veraltet sind.

    Anmerkung

    In der Liste werden nicht angezeigt, welche aus Ihrem Konto gelöscht werden. Wenn die Befehle noch gelöscht werden müssen, können Sie die Details für diese Befehle weiterhin anhand ihrer Befehls-ID anzeigen.

  • Die Uhrzeit, zu der die Befehle erstellt und zuletzt aktualisiert wurden.

In der AWS IoT Konsole finden Sie die Liste der Befehle, die Sie erstellt haben, und deren Details, indem Sie zum Command Hub gehen.

Verwenden Sie die ListCommands API-Operation oder die list-commands CLI, um die von Ihnen erstellten Befehle aufzulisten.

Beispiel einer IAM-Richtlinie

Bevor Sie diesen API-Vorgang verwenden, stellen Sie sicher, dass Ihre IAM-Richtlinie Sie autorisiert, diese Aktion auf dem Gerät auszuführen. Das folgende Beispiel zeigt eine IAM-Richtlinie, die dem Benutzer die Berechtigung zum Ausführen der Aktion gewährt. ListCommands

Ersetzen Sie in diesem Beispiel:

  • regionmit Ihrem AWS-Region, z. B. us-east-1

  • account-idmit Ihrer AWS-Konto Nummer, wie z. 123456789012 B.

{
    "Version":"2012-10-17",
    "Statement": {
        "Action": "iot:ListCommands",
        "Effect": "Allow",
        "Resource": "arn:aws:iot:us-east-1:123456789012:command/*"
    }
}

Listen Sie die Befehle in Ihrem Kontobeispiel auf

Der folgende Befehl zeigt, wie Sie Befehle in Ihrem Konto auflisten.

aws iot list-commands --namespace "AWS-IoT"

Wenn Sie diesen Befehl ausführen, wird eine Antwort generiert, die eine Liste der von Ihnen erstellten Befehle, den Zeitpunkt der Erstellung der Befehle und die letzte Aktualisierung enthält. Außerdem werden Informationen zum Befehlsstatus bereitgestellt, die angeben, ob ein Befehl veraltet ist oder auf dem Zielgerät ausgeführt werden kann. Weitere Informationen zu den verschiedenen Status und den Gründen für den Status finden Sie unter. Status der Befehlsausführung

Aktualisieren Sie eine Befehlsressource

Nachdem Sie einen Befehl erstellt haben, können Sie den Anzeigenamen und die Beschreibung des Befehls aktualisieren.

Anmerkung

Die Payload für den Befehl kann nicht aktualisiert werden. Um diese Informationen zu aktualisieren oder eine geänderte Nutzlast zu verwenden, müssen Sie einen neuen Befehl erstellen.

Um einen Befehl von der Konsole aus zu aktualisieren, wechseln Sie zum Command Hub der AWS IoT Konsole und führen Sie die folgenden Schritte aus.

  1. Um eine vorhandene Befehlsressource zu aktualisieren, wählen Sie den Befehl aus, den Sie aktualisieren möchten, und wählen Sie dann unter Aktionen die Option Bearbeiten aus.

  2. Geben Sie den Anzeigenamen und die Beschreibung an, die Sie verwenden möchten, sowie alle Name-Wert-Paare als Tags für Ihren Befehl.

  3. Wählen Sie Bearbeiten, um den Befehl mit den neuen Einstellungen zu speichern.

Verwenden Sie die API-Operation der UpdateCommand Steuerungsebene oder die update-command AWS CLI , um eine Befehlsressource zu aktualisieren. Mit dieser API können Sie:

  • Bearbeiten Sie den Anzeigenamen und die Beschreibung eines Befehls, den Sie erstellt haben.

  • Verwerfen Sie eine Befehlsressource oder stellen Sie einen Befehl wieder her, der bereits veraltet ist.

Beispiel einer IAM-Richtlinie

Bevor Sie diesen API-Vorgang verwenden, stellen Sie sicher, dass Ihre IAM-Richtlinie Sie autorisiert, diese Aktion auf dem Gerät durchzuführen. Das folgende Beispiel zeigt eine IAM-Richtlinie, die dem Benutzer die Berechtigung zum Ausführen der Aktion gewährt. UpdateCommand

Ersetzen Sie in diesem Beispiel:

  • regionmit Ihrem AWS-Region, z. B. us-east-1

  • account-idmit Ihrer AWS-Konto Nummer, wie z. 123456789012 B.

  • command-idmit Ihrer AWS IoT eindeutigen Befehlskennung, z. LockDoor B. Wenn Sie mehr als einen Befehl abrufen möchten, können Sie diese Befehle in der IAM-Richtlinie im Abschnitt Ressource angeben.

{
    "Version":"2012-10-17",
    "Statement": {
        "Action": "iot:UpdateCommand",
        "Effect": "Allow",
        "Resource": "arn:aws:iot:us-east-1:123456789012:command/command-id"
    }
}

Aktualisieren Sie die Informationen zu einem Befehl — Beispiele (AWS CLI)

Das folgende Beispiel zeigt, wie Sie Informationen zu einem Befehl mithilfe des update-command AWS CLI Befehls aktualisieren. Hinweise dazu, wie Sie diese API verwenden können, um eine Befehlsressource zu deaktivieren oder wiederherzustellen, finden Sie unter. Aktualisieren Sie eine Befehlsressource (CLI)

Das Beispiel zeigt, wie Sie den Anzeigenamen und die Beschreibung eines Befehls aktualisieren können. Ersetzen Sie ihn je nach Anwendung <command-id> durch den Bezeichner für den Befehl, für den Sie Informationen abrufen möchten.

aws iot update-command \ 
    --command-id <command-id>    
    --displayname <display-name> \
    --description <description>

Wenn Sie diesen Befehl ausführen, wird eine Antwort generiert, die die aktualisierten Informationen über den Befehl und die Uhrzeit der letzten Aktualisierung enthält. Der folgende Code zeigt ein Beispiel für eine Anforderung und Antwort zur Aktualisierung des Anzeigenamens und der Beschreibung eines Befehls, der den AC ausschaltet.

aws iot update-command \ 
    --command-id <LockDoor> \ 
    --displayname <Secondary lock door> \
    --description <Locks doors to my home>

Wenn Sie diesen Befehl ausführen, wird die folgende Antwort generiert.

{
    "commandId": "LockDoor",
    "commandArn": "arn:aws:iot:us-east-1:123456789012:command/LockDoor",
    "displayName": "Secondary lock door",
    "description": "Locks doors to my home",
    "lastUpdatedAt": "2024-05-09T23:15:53.899000-07:00"
}

Verwerfen Sie eine Befehlsressource oder stellen Sie sie wieder her

Wenn Sie einen Befehl erstellt haben und den Befehl nicht mehr verwenden möchten, können Sie ihn als veraltet markieren. Wenn Sie einen Befehl als veraltet markieren, werden alle ausstehenden Befehlsausführungen auf dem Zielgerät weiter ausgeführt, bis sie den Terminalstatus erreichen. Sobald ein Befehl veraltet ist und Sie ihn verwenden möchten, z. B. um eine neue Befehlsausführung an das Zielgerät zu senden, müssen Sie ihn wiederherstellen.

Anmerkung

Sie können einen veralteten Befehl nicht bearbeiten oder neue Ausführungen dafür ausführen. Um neue Befehle auf dem Gerät auszuführen, müssen Sie es wiederherstellen, sodass sich der Befehlsstatus in Verfügbar ändert.

Weitere Informationen zum Verwerfen und Wiederherstellen eines Befehls sowie Überlegungen dazu finden Sie unter. Kennzeichnen einer Befehlsressource als veraltet

Löschen Sie eine Befehlsressource

Wenn Sie einen Befehl nicht mehr verwenden möchten, können Sie ihn dauerhaft aus Ihrem Konto entfernen. Wenn die Löschaktion erfolgreich ist:

  • Wenn der Befehl für eine Dauer, die länger als das maximale Timeout von 12 Stunden ist, veraltet ist, wird der Befehl sofort gelöscht.

  • Wenn der Befehl nicht veraltet ist oder für eine kürzere Dauer als das maximale Timeout veraltet ist, befindet sich der Befehl in einem Status. pending deletion Er wird nach Ablauf des maximalen Timeouts von 12 Stunden automatisch von Ihrem Konto entfernt.

Anmerkung

Der Befehl wird möglicherweise gelöscht, auch wenn Befehlsausführungen ausstehen. Der Befehl befindet sich im Status Ausstehender Löschvorgang und wird automatisch aus Ihrem Konto entfernt.

Um einen Befehl von der Konsole zu löschen, wechseln Sie zum Command Hub der AWS IoT Konsole und führen Sie die folgenden Schritte aus.

  1. Wählen Sie den Befehl aus, den Sie löschen möchten, und wählen Sie dann unter Aktionen die Option Löschen aus.

  2. Bestätigen Sie, dass Sie den Befehl löschen möchten, und wählen Sie dann Löschen aus.

Der Befehl wird zum Löschen markiert und nach 12 Stunden dauerhaft aus Ihrem Konto entfernt.

Verwenden Sie den API-Vorgang der DeleteCommand HTTP-Steuerungsebene oder den delete-command AWS CLI Befehl, um eine Befehlsressource zu löschen. Wenn die Löschaktion erfolgreich ist, wird ein HTTP-Wert statusCode von 204 oder 202 angezeigt, und der Befehl wird nach Ablauf der maximalen Timeout-Dauer von 12 Stunden automatisch aus Ihrem Konto gelöscht. Im Fall des Status 204 bedeutet dies, dass der Befehl gelöscht wurde.

Beispiel einer IAM-Richtlinie

Bevor Sie diesen API-Vorgang verwenden, stellen Sie sicher, dass Ihre IAM-Richtlinie Sie autorisiert, diese Aktion auf dem Gerät auszuführen. Das folgende Beispiel zeigt eine IAM-Richtlinie, die dem Benutzer die Berechtigung zum Ausführen der Aktion gewährt. DeleteCommand

Ersetzen Sie in diesem Beispiel:

  • regionmit Ihrem AWS-Region, z. B. us-east-1

  • account-idmit Ihrer AWS-Konto Nummer, wie z. 123456789012 B.

  • command-idmit Ihrer AWS IoT eindeutigen Befehlskennung, z. LockDoor B. Wenn Sie mehr als einen Befehl abrufen möchten, können Sie diese Befehle in der IAM-Richtlinie im Abschnitt Ressource angeben.

{
    "Version":"2012-10-17",
    "Statement": {
        "Action": "iot:DeleteCommand",
        "Effect": "Allow",
        "Resource": "arn:aws:iot:us-east-1:123456789012:command/command-id"
    }
}

Löschen Sie ein Beispiel für einen Befehl (AWS CLI)

Die folgenden Beispiele zeigen, wie Sie einen Befehl mithilfe des delete-command AWS CLI Befehls löschen. Ersetzen Sie ihn je nach Anwendung <command-id> durch den Bezeichner für den Befehl, den Sie löschen.

aws iot delete-command --command-id <command-id>

Wenn die API-Anfrage erfolgreich ist, generiert der Befehl den Statuscode 202 oder 204. Sie können die GetCommand API verwenden, um zu überprüfen, ob der Befehl in Ihrem Konto nicht mehr existiert.