Objekte löschen

Sie können die AWS IoT SiteWise Konsole verwenden oder API um ein Asset zu löschen.

Bevor Sie eine Komponente löschen können, müssen Sie zunächst die Zuordnung der ihr untergeordneten Komponenten und ihre Zuordnung zu der ihr übergeordneten Komponente aufheben. Weitere Informationen finden Sie unter Anlagen zuordnen und deren Zuordnung aufheben. Wenn Sie AWS Command Line Interface (AWS CLI) verwenden, können Sie die ListAssociatedAssetsOperation verwenden, um die untergeordneten Elemente einer Anlage aufzulisten.

Wenn Sie eine Komponente löschen, ist der Status so lange DELETING, bis die Änderungen weitergegeben werden. Weitere Informationen finden Sie unter Komponenten- und Modellzustände. Nachdem die Komponente gelöscht wurde, können Sie sie nicht mehr abfragen. Wenn Sie dies tun, wird eine HTTP 404-Antwort API zurückgegeben.

Wichtig

AWS IoT SiteWise löscht alle Eigenschaftsdaten für gelöschte Objekte.

Löscht ein Asset (Konsole)

Sie können die AWS IoT SiteWise Konsole verwenden, um ein Asset zu löschen.

So löschen Sie ein Asset (Konsole)

1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

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

3. Wählen Sie die zu löschende Komponente aus.

   Tipp

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

4. Wenn die Komponente über Zugehörige Komponenten verfügt, löschen Sie jede Komponente. Sie können den Namen einer Komponente auswählen, um zu ihrer Seite zu navigieren, auf der Sie sie löschen können.

5. Wählen Sie auf der Seite der Komponente Löschen aus.

6. Gehen Sie im Dialogfeld „Asset löschen“ wie folgt vor:

   1. Geben Sie Delete ein, um den Löschvorgang zu bestätigen.

   2. Wählen Sie Löschen.

Löschen Sie ein Asset (AWS CLI)

Sie können das AWS Command Line Interface (AWS CLI) verwenden, um ein Asset zu löschen.

Verwenden Sie die DeleteAssetOperation, um ein Asset zu löschen. Geben Sie den folgenden Parameter an:

• assetId— Die ID des Assets. Dies ist die tatsächliche ID im UUID Format oder die, externalId:myExternalId falls sie eine hat. Weitere Informationen finden Sie unter Referenzobjekte mit externen IDs im AWS IoT SiteWise -Benutzerhandbuch.

Um ein Asset zu löschen (AWS CLI)

1. Führen Sie den folgenden Befehl aus, um die Hierarchien der Komponente aufzulisten. Ersetzen asset-id mit der ID oder der externen ID des Assets:

   aws iotsitewise describe-asset --asset-id asset-id

   Die Operation gibt eine Antwort zurück, die Details der Komponente enthält. Die Antwort enthält eine assetHierarchies Liste mit der folgenden Struktur:

   {
     ...
     "assetHierarchies": [
       {
         "id": "String",
         "name": "String"
       }
     ],
     ...
   }

   Weitere Informationen finden Sie in der DescribeAssetOperation.

2. Führen Sie für jede Hierarchie den folgenden Befehl aus, um die untergeordneten Komponenten der Komponente aufzulisten, die dieser Hierarchie zugeordnet sind. Ersetzen asset-id mit der ID oder externen ID des Assets und hierarchy-id mit der ID oder externen ID der Hierarchie.

   aws iotsitewise list-associated-assets \
     --asset-id asset-id \
     --hierarchy-id hierarchy-id

   Weitere Informationen finden Sie in der ListAssociatedAssetsOperation.

3. Führen Sie den folgenden Befehl aus, um jede zugeordnete Komponente zu löschen und dann die Komponente zu löschen. Ersetzen asset-id mit der ID oder externen ID des Assets.

   aws iotsitewise delete-asset --asset-id asset-id