Erstellen eines Auftrags aus AWS verwalteten Vorlagen mithilfe der AWS Management Console

Verwenden Sie die AWS Management Console , um Informationen zu AWS verwalteten Vorlagen abzurufen und einen Auftrag mithilfe dieser Vorlagen zu erstellen. Anschließend können Sie den von Ihnen erstellten Auftrag als Ihre eigene benutzerdefinierte Vorlage speichern.

Abrufen von Details von verwalteten Vorlagen

Informationen zu den verschiedenen verwalteten Vorlagen, die zur Verwendung verfügbar sind, erhalten Sie über die - AWS IoT Konsole.

1. Um Ihre verfügbaren verwalteten Vorlagen anzuzeigen, gehen Sie zum Hub Auftragsvorlagen der - AWS IoT Konsole und wählen Sie die Registerkarte Verwaltete Vorlagen.

2. Zum Anzeigen von Details wählen Sie eine verwaltete Vorlage aus.

Die Seite Details enthält die folgenden Informationen:

• Name, Beschreibung und Amazon-Ressourcenname (ARN) der verwalteten Vorlage.

• Die Umgebung, in der die Remote-Operationen ausgeführt werden können, z. B. Linux.

• Das JSON-Auftragsdokument, das den Pfad zum Auftragshandler und zu den Befehlen angibt, die auf dem Gerät ausgeführt werden sollen. Beispielsweise wird im Folgenden ein Auftragsdokument als Beispiel für die Vorlage AWS-Reboot gezeigt. Die Vorlage zeigt den Pfad zum Auftragshandler und zum Shell-Skript reboot.sh, die der Auftragshandler ausführen muss, um das Gerät neu zu starten.

  {
    "version": "1.0",
    "steps": [
      {
        "action": {
          "name": "Reboot",
          "type": "runHandler",
          "input": {
            "handler": "reboot.sh",
            "path": "${aws:iot:parameter:pathToHandler}"
          },
          "runAsUser": "${aws:iot:parameter:runAsUser}"
        }
      }
    ]
  }

  Weitere Informationen zum Auftragsdokument und den zugehörigen Parametern für verschiedene Remote-Aktionen finden Sie unter Verwaltete Vorlagen für Remote-Aktionen und Auftragsdokumente.

• Die neueste Version des Auftragsdokuments.

Erstellen Sie einen Auftrag mit verwalteten Vorlagen

Sie können die - AWS Managementkonsole verwenden, um eine - AWS verwaltete Vorlage auszuwählen, die zum Erstellen eines Auftrags verwendet werden soll. In diesem Abschnitt erfahren Sie mehr darüber.

Sie können auch den Workflow zur Auftragserstellung starten und dann die AWS verwaltete Vorlage auswählen, die Sie beim Erstellen des Auftrags verwenden möchten. Weitere Informationen zu diesem Workflow finden Sie unter Erstellen und verwalten Sie Jobs mithilfe desAWS Management Console.

1. Wählen Sie Ihre AWS verwaltete Vorlage

   Gehen Sie zum Hub Auftragsvorlagen der AWS IoT Konsole , wählen Sie die Registerkarte Verwaltete Vorlagen und wählen Sie dann Ihre Vorlage aus.

2. Erstellen Sie einen Auftrag mit Ihrer verwalteten Vorlage

   1. Wählen Sie auf der Seite Details Ihrer Vorlage die Option Auftrag erstellen aus.

      Die Konsole wechselt zum Schritt Benutzerdefinierte Auftragseigenschaften des Workflows Auftrag erstellen, in dem Ihre Vorlagenkonfiguration hinzugefügt wurde.

   2. Geben Sie einen eindeutigen alphanumerischen Auftragsnamen sowie optional eine Beschreibung und Tags ein und wählen Sie dann Weiter aus.

   3. Wählen Sie die Objekte oder Objektgruppen als Auftragsziele aus, die Sie in diesem Auftrag ausführen möchten.

   4. Im Bereich Auftragsdokument wird Ihre Vorlage mit ihren Konfigurationseinstellungen und Eingabeparametern angezeigt. Geben Sie Werte für die Eingabeparameter in die von Ihnen ausgewählten Vorlage ein. Wenn Sie beispielsweise die Vorlage AWS-Download-File gewählt haben:

      • Geben Sie für DownloadUrl die URL der Datei ein, die heruntergeladen werden soll, zum Beispiel: https://example.com/index.html.

      • Geben Sie für FilePath den Pfad auf dem Gerät ein, in dem die heruntergeladene Datei gespeichert werden soll, zum Beispiel: path/to/file.

      Sie können optional auch Werte für die Parameter runAsUser und pathToHandler eingeben. Weitere Informationen zu den Eingabeparametern für jede Vorlage finden Sie unter Verwaltete Vorlagen für Remote-Aktionen und Auftragsdokumente.

   5. Wählen Sie auf der Seite Auftragskonfiguration den Auftragstyp als kontinuierlichen Auftrag oder Snapshot-Auftrag aus. Ein Snapshot-Auftrag ist abgeschlossen, wenn er seine Ausführung auf den Zielgeräten und Zielgruppen abgeschlossen hat. Ein kontinuierlicher Auftrag gilt für Objektgruppen und wird auf jedem Gerät ausgeführt, das Sie einer bestimmten Zielgruppe hinzufügen.

   6. Fügen Sie weitere Konfigurationen für Ihren Auftrag hinzu und überprüfen und erstellen Sie dann Ihren Auftrag. Weitere Informationen zum Arbeiten mit zusätzlichen Konfigurationen finden Sie unter:

      • Konfigurationen für Auftrags-Rollout, Planung und Abbruch

      • Timeout bei der Auftragsausführung und Wiederholungskonfigurationen

Erstellen Sie benutzerdefinierte Jobvorlagen aus verwalteten Vorlagen

Sie können eine - AWS verwaltete Vorlage und einen benutzerdefinierten Auftrag als Ausgangspunkt verwenden, um Ihre eigene benutzerdefinierte Auftragsvorlage zu erstellen. Um eine benutzerdefinierte Auftragsvorlage zu erstellen, erstellen Sie zunächst einen Auftrag aus Ihrer AWS verwalteten Vorlage, wie im vorherigen Abschnitt beschrieben.

Anschließend können Sie den benutzerdefinierten Auftrag als Vorlage speichern, um Ihre eigene benutzerdefinierte Auftragsvorlage zu erstellen. Zum Speichern als Vorlage:

1. Gehen Sie zum Auftrags-Hub der - AWS IoT Konsole und wählen Sie den Auftrag aus, der Ihre verwaltete Vorlage enthält.

2. Wählen Sie die Option Als Auftragsvorlage speichern und erstellen Sie dann Ihre benutzerdefinierte Auftragsvorlage. Weitere Informationen zum Erstellen einer benutzerdefinierten Auftragsvorlage finden Sie unter Erstellen einer Auftragsvorlage anhand eines vorhandenen Auftrags.