View a markdown version of this page

Aktualisieren Sie die Attributwerte - AWS IoT SiteWise

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.

Aktualisieren Sie die Attributwerte

Komponenten übernehmen die Attribute ihres Komponentenmodells, einschließlich des Standardwerts des Attributs. In bestimmten Fällen möchten Sie u. U. das Standardattribut des Komponentenmodells beibehalten, z. B. für die Eigenschaft des Komponentenherstellers. In anderen Fällen möchten Sie u. U. das übernommene Attribut aktualisieren, beispielsweise für den Breiten- und Längengrad einer Komponente.

Updating an attribute value (console)

Sie können die AWS IoT SiteWise Konsole verwenden, um den Wert einer Attributeigenschaft zu aktualisieren.

So aktualisieren Sie den Wert eines Attributs (Konsole)

  1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

  2. Wählen Sie im linken Navigationsbereich Komponenten aus.

  3. Wählen Sie die Komponente aus, für die Sie ein Attribut aktualisieren möchten.

    Tipp

    Sie können eine Komponentenhierarchie mithilfe des Pfeilsymbols erweitern, um nach Ihrer Komponente zu suchen.

  4. Wählen Sie Bearbeiten aus.

  5. Suchen Sie das zu aktualisierende Attribut und geben Sie dann den neuen Wert ein.

    AWS IoT SiteWise Screenshot der Seite „Asset bearbeiten“ mit einem hervorgehobenen Attributwert.

  6. Wählen Sie Speichern.

Updating an attribute value (AWS CLI)

Sie können das AWS Command Line Interface (AWS CLI) verwenden, um einen Attributwert zu aktualisieren.

Um dieses Verfahren abzuschließen, müssen Sie die assetId Ihrer Komponenten und die propertyId Ihrer Eigenschaft kennen. Sie können auch die externe ID verwenden. Wenn Sie ein Asset erstellt haben und es nicht kennenassetId, verwenden Sie die ListAssets API, um alle Assets für ein bestimmtes Modell aufzulisten. Verwenden Sie die DescribeAsset Operation, um die Eigenschaften Ihres Assets einschließlich der Eigenschaften-IDs anzuzeigen.

Verwenden Sie die Operation BatchPutAssetPropertyValue, um Attributwerte zu Ihrer Komponente zuzuweisen. Mit dieser Operation können Sie mehrere Attribute gleichzeitig festlegen. Die Nutzlast dieser Operation enthält eine Liste von Einträgen, jeweils mit der Komponenten-ID, der Eigenschafts-ID und dem Attributwert.

Um den Wert eines Attributs zu aktualisieren (AWS CLI)

  1. Erstellen Sie eine Datei namens batch-put-payload.json und kopieren Sie das folgende JSON-Objekt in die Datei. In diesem Nutzlast-Beispiel wird veranschaulicht, wie der Breiten- und Längengrad einer Windturbine festgelegt wird. Aktualisieren Sie die IDs, Werte und Zeitstempel, um die Nutzlast für Ihren Anwendungsfall zu ändern.

    {
  "entries": [
    {
      "entryId": "windfarm3-turbine7-latitude",
      "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
      "propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "propertyValues": [
        {
          "value": {
            "doubleValue": 47.6204
          },
          "timestamp": {
            "timeInSeconds": 1575691200
          }
        }
      ]
    },
    {
      "entryId": "windfarm3-turbine7-longitude",
      "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
      "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
      "propertyValues": [
        {
          "value": {
            "doubleValue": 122.3491
          },
          "timestamp": {
            "timeInSeconds": 1575691200
          }
        }
      ]
    }
  ]
}

    • Jeder Eintrag in der Nutzlast enthält eine entryId, die Sie als eindeutige Zeichenfolge definieren können. Bei fehlgeschlagenen Anforderungseinträgen enthält jeder Fehler die entryId der entsprechenden Anforderung, woran Sie erkennen können, welche Anforderungen zu wiederholen sind.

    • Um einen Attributwert festzulegen, können Sie für jede Attributeigenschaft eine Zeitstempelqualitätswert-Struktur (TQV) in die Liste von propertyValues aufnehmen. Diese Struktur muss den neuen value und den aktuellen timestamp enthalten.

      • value— Eine Struktur, die je nach Art der festzulegenden Eigenschaft eines der folgenden Felder enthält:

        • booleanValue

        • doubleValue

        • integerValue

        • stringValue

        • nullValue

      • timestamp— Eine Struktur, die die aktuelle Unix-Epochenzeit in Sekunden enthält,timeInSeconds. AWS IoT SiteWise lehnt alle Datenpunkte mit Zeitstempeln ab, die in der Vergangenheit länger als 7 Tage oder in der Zukunft neuer als 5 Minuten existierten.

    Weitere Informationen zum Vorbereiten einer Nutzlast für BatchPutAssetPropertyValue finden Sie unter Daten aufnehmen mit AWS IoT SiteWise APIs.

  2. Führen Sie den folgenden Befehl aus, um die Attributwerte an folgende Adresse zu senden: AWS IoT SiteWise

    aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json