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.
# AWS IoT SiteWise Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS IoT SiteWise.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `associate-assets`
Das folgende Codebeispiel zeigt, wie Sie`associate-assets`.
**AWS CLI**
**So ordnen Sie eine untergeordnete Komponente einer übergeordneten zu**
Im folgenden Beispiel für `associate-assets` wird eine Windturbinenkomponente einer Windparkkomponente zugeordnet, wobei das Windturbinen-Komponentenmodell als Hierarchie im Windpark-Komponentenmodell existiert.
```
aws iotsitewise associate-assets \
--asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \
--hierarchy-id a1b2c3d4-5678-90ab-cdef-77777EXAMPLE \
--child-asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Assets zuordnen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/add-associated-assets.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [AssociateAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/associate-assets.html)in der *AWS CLI Befehlsreferenz.*
### `batch-associate-project-assets`
Das folgende Codebeispiel zeigt die Verwendung`batch-associate-project-assets`.
**AWS CLI**
**So ordnen Sie eine Komponente einem Projekt zu**
Im folgenden Beispiel für `batch-associate-project-assets` wird eine Windpark-Komponente einem Projekt zugeordnet.
```
aws iotsitewise batch-associate-project-assets \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
--asset-ids a1b2c3d4-5678-90ab-cdef-44444EXAMPLE
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Hinzufügen von Assets zu Projekten](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/add-assets-to-projects-sd.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [BatchAssociateProjectAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/batch-associate-project-assets.html)in der *AWS CLI Befehlsreferenz*.
### `batch-disassociate-project-assets`
Das folgende Codebeispiel zeigt die Verwendung`batch-disassociate-project-assets`.
**AWS CLI**
**So heben Sie die Zuordnung einer Komponente zu einem Projekt auf**
Im folgenden Beispiel für `batch-disassociate-project-assets` wird die Zuordnung einer Windpark-Komponente zu einem Projekt aufgehoben.
```
aws iotsitewise batch-disassociate-project-assets \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
--asset-ids a1b2c3d4-5678-90ab-cdef-44444EXAMPLE
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Hinzufügen von Assets zu Projekten](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/add-assets-to-projects-sd.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [BatchDisassociateProjectAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/batch-disassociate-project-assets.html)in der *AWS CLI Befehlsreferenz*.
### `batch-put-asset-property-value`
Das folgende Codebeispiel zeigt die Verwendung`batch-put-asset-property-value`.
**AWS CLI**
**So senden Sie Daten an Komponenteneigenschaften**
Im folgenden Beispiel für `batch-put-asset-property-value` werden Leistungs- und Temperaturdaten an die Eigenschaften der Komponente gesendet, die durch Eigenschaftsaliase identifiziert sind.
```
aws iotsitewise batch-put-asset-property-value \
--cli-input-json file://batch-put-asset-property-value.json
```
Inhalt von `batch-put-asset-property-value.json`:
```
{
"entries": [
{
"entryId": "1575691200-company-windfarm-3-turbine-7-power",
"propertyAlias": "company-windfarm-3-turbine-7-power",
"propertyValues": [
{
"value": {
"doubleValue": 4.92
},
"timestamp": {
"timeInSeconds": 1575691200
},
"quality": "GOOD"
}
]
},
{
"entryId": "1575691200-company-windfarm-3-turbine-7-temperature",
"propertyAlias": "company-windfarm-3-turbine-7-temperature",
"propertyValues": [
{
"value": {
"integerValue": 38
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
}
]
}
```
Ausgabe:
```
{
"errorEntries": []
}
```
Weitere Informationen finden Sie unter [Daten mithilfe der AWS SiteWise IoT-API](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/ingest-api.html) aufnehmen im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [BatchPutAssetPropertyValue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/batch-put-asset-property-value.html)in der *AWS CLI Befehlsreferenz.*
### `create-access-policy`
Das folgende Codebeispiel zeigt die Verwendung`create-access-policy`.
**AWS CLI**
**Beispiel 1: So gewähren Sie einem Benutzer Administratorzugriff auf ein Portal**
Im folgenden Beispiel für `create-access-policy` wird eine Zugriffsrichtlinie erstellt, die einem Benutzer Administratorzugriff auf ein Webportal für ein Windparkunternehmen gewährt.
```
aws iotsitewise create-access-policy \
--cli-input-json file://create-portal-administrator-access-policy.json
```
Inhalt von `create-portal-administrator-access-policy.json`:
```
{
"accessPolicyIdentity": {
"user": {
"id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE"
}
},
"accessPolicyPermission": "ADMINISTRATOR",
"accessPolicyResource": {
"portal": {
"id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE"
}
}
}
```
Ausgabe:
```
{
"accessPolicyId": "a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE",
"accessPolicyArn": "arn:aws:iotsitewise:us-west-2:123456789012:access-policy/a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE"
}
```
Weitere Informationen finden Sie unter [Hinzufügen oder Entfernen von Portaladministratoren](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins) im *AWS SiteWise IoT-Benutzerhandbuch*.
**Beispiel 2: So gewähren Sie einem Benutzer schreibgeschützten Zugriff auf ein Projekt**
Im folgenden Beispiel für `create-access-policy` wird eine Zugriffsrichtlinie erstellt, die einem Benutzer nur Lesezugriff auf ein Windparkprojekt gewährt.
```
aws iotsitewise create-access-policy \
--cli-input-json file://create-project-viewer-access-policy.json
```
Inhalt von `create-project-viewer-access-policy.json`:
```
{
"accessPolicyIdentity": {
"user": {
"id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE"
}
},
"accessPolicyPermission": "VIEWER",
"accessPolicyResource": {
"project": {
"id": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE"
}
}
}
```
Ausgabe:
```
{
"accessPolicyId": "a1b2c3d4-5678-90ab-cdef-dddddEXAMPLE",
"accessPolicyArn": "arn:aws:iotsitewise:us-west-2:123456789012:access-policy/a1b2c3d4-5678-90ab-cdef-dddddEXAMPLE"
}
```
Weitere Informationen finden Sie unter [Zuweisen von Projekt-Viewern](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/assign-project-viewers.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [CreateAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-access-policy.html)in der *AWS CLI Befehlsreferenz.*
### `create-asset-model`
Das folgende Codebeispiel zeigt die Verwendung`create-asset-model`.
**AWS CLI**
**So erstellen Sie ein Komponentenmodell**
Im folgenden Beispiel für `create-asset-model` wird ein Komponentenmodell erstellt, das eine Windturbine mit den folgenden Eigenschaften definiert:
Seriennummer — Die Seriennummer einer WindturbineErzeugter Strom — Der erzeugte Energiedatenstrom einer WindturbineTemperatur C — Der Temperaturdatenstrom einer Windturbine in CelsiusTemperature F — Die abgebildeten Temperaturdatenpunkte von Celsius bis Fahrenheit
```
aws iotsitewise create-asset-model \
--cli-input-json file://create-wind-turbine-model.json
```
Inhalt von `create-wind-turbine-model.json`:
```
{
"assetModelName": "Wind Turbine Model",
"assetModelDescription": "Represents a wind turbine",
"assetModelProperties": [
{
"name": "Serial Number",
"dataType": "STRING",
"type": {
"attribute": {}
}
},
{
"name": "Generated Power",
"dataType": "DOUBLE",
"unit": "kW",
"type": {
"measurement": {}
}
},
{
"name": "Temperature C",
"dataType": "DOUBLE",
"unit": "Celsius",
"type": {
"measurement": {}
}
},
{
"name": "Temperature F",
"dataType": "DOUBLE",
"unit": "Fahrenheit",
"type": {
"transform": {
"expression": "temp_c * 9 / 5 + 32",
"variables": [
{
"name": "temp_c",
"value": {
"propertyId": "Temperature C"
}
}
]
}
}
},
{
"name": "Total Generated Power",
"dataType": "DOUBLE",
"unit": "kW",
"type": {
"metric": {
"expression": "sum(power)",
"variables": [
{
"name": "power",
"value": {
"propertyId": "Generated Power"
}
}
],
"window": {
"tumbling": {
"interval": "1h"
}
}
}
}
}
]
}
```
Ausgabe:
```
{
"assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"assetModelArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"assetModelStatus": {
"state": "CREATING"
}
}
```
Weitere Informationen finden Sie unter [Definieren von Asset-Modellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/define-models.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [CreateAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-asset-model.html)in der *AWS CLI Befehlsreferenz*.
### `create-asset`
Das folgende Codebeispiel zeigt die Verwendung`create-asset`.
**AWS CLI**
**So erstellen Sie eine Komponente**
Im folgenden Beispiel für `create-asset` wird aus dem Komponentenmodell einer Windturbine eine Windturbinenkomponente erstellt.
```
aws iotsitewise create-asset \
--asset-model-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
--asset-name "Wind Turbine 1"
```
Ausgabe:
```
{
"assetId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"assetArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"assetStatus": {
"state": "CREATING"
}
}
```
Weitere Informationen finden Sie im *AWS SiteWise IoT-Benutzerhandbuch* unter [Assets erstellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-assets.html).
+ Einzelheiten zur API finden Sie [CreateAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-asset.html)in der *AWS CLI Befehlsreferenz*.
### `create-dashboard`
Das folgende Codebeispiel zeigt die Verwendung`create-dashboard`.
**AWS CLI**
**So erstellen Sie ein Dashboard**
Im folgenden Beispiel für `create-dashboard` wird ein Dashboard mit einem Liniendiagramm erstellt, das die gesamte erzeugte Leistung für einen Windpark anzeigt.
```
aws iotsitewise create-dashboard \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
--dashboard-name "Wind Farm" \
--dashboard-definition file://create-wind-farm-dashboard.json
```
Inhalt von `create-wind-farm-dashboard.json`:
```
{
"widgets": [
{
"type": "monitor-line-chart",
"title": "Generated Power",
"x": 0,
"y": 0,
"height": 3,
"width": 3,
"metrics": [
{
"label": "Power",
"type": "iotsitewise",
"assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE"
}
]
}
]
}
```
Ausgabe:
```
{
"dashboardId": "a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE",
"dashboardArn": "arn:aws:iotsitewise:us-west-2:123456789012:dashboard/a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE"
}
```
Weitere Informationen finden Sie unter [Erstellen von Dashboards (CLI)](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-dashboards-using-aws-cli.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [CreateDashboard AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-dashboard.html)*Befehlsreferenz.*
### `create-gateway`
Das folgende Codebeispiel zeigt die Verwendung`create-gateway`.
**AWS CLI**
**Um ein Gateway zu erstellen**
Das folgende `create-gateway` Beispiel erstellt ein Gateway, das auf AWS IoT Greengrass läuft.
```
aws iotsitewise create-gateway \
--gateway-name ExampleCorpGateway \
--gateway-platform greengrass={groupArn=arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-1b1b1EXAMPLE}
```
Ausgabe:
```
{
"gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"gatewayArn": "arn:aws:iotsitewise:us-west-2:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
}
```
Weitere Informationen finden Sie unter [Konfiguration eines Gateways](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [CreateGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-gateway.html)in der *AWS CLI Befehlsreferenz*.
### `create-portal`
Das folgende Codebeispiel zeigt die Verwendung`create-portal`.
**AWS CLI**
**Um ein Portal zu erstellen**
Im folgenden Beispiel für `create-portal` wird ein Webportal für ein Windparkunternehmen erstellt. Sie können Portale nur in derselben Region erstellen, in der Sie AWS Single Sign-On aktiviert haben.
```
aws iotsitewise create-portal \
--portal-name WindFarmPortal \
--portal-description "A portal that contains wind farm projects for Example Corp." \
--portal-contact-email support@example.com \
--role-arn arn:aws:iam::123456789012:role/service-role/MySiteWiseMonitorServiceRole
```
Ausgabe:
```
{
"portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"portalArn": "arn:aws:iotsitewise:us-west-2:123456789012:portal/a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"portalStartUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws",
"portalStatus": {
"state": "CREATING"
},
"ssoApplicationId": "ins-a1b2c3d4-EXAMPLE"
}
```
Weitere Informationen finden Sie unter [Erste Schritte mit AWS IoT SiteWise Monitor](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-getting-started.html) im *AWS SiteWise IoT-Benutzerhandbuch* und [AWS SSO aktivieren](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-getting-started.html#monitor-enable-sso) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [CreatePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-portal.html)in der *AWS CLI Befehlsreferenz*.
### `create-project`
Das folgende Codebeispiel zeigt die Verwendung`create-project`.
**AWS CLI**
**So erstellen Sie ein Projekt**
Im folgenden Beispiel für `create-project` wird ein Windparkprojekt erstellt.
```
aws iotsitewise create-project \
--portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE \
--project-name "Wind Farm 1" \
--project-description "Contains asset visualizations for Wind Farm #1 for Example Corp."
```
Ausgabe:
```
{
"projectId": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE",
"projectArn": "arn:aws:iotsitewise:us-west-2:123456789012:project/a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE"
}
```
Weitere Informationen finden Sie unter [Projekte erstellen](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/create-projects.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [CreateProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-project.html)in der *AWS CLI Befehlsreferenz*.
### `delete-access-policy`
Das folgende Codebeispiel zeigt die Verwendung`delete-access-policy`.
**AWS CLI**
**So widerrufen Sie den Zugriff eines Benutzers auf ein Projekt oder Portal**
Im folgenden Beispiel für `delete-access-policy` wird eine Zugriffsrichtlinie gelöscht, die einem Benutzer Administratorzugriff auf ein Portal gewährt.
```
aws iotsitewise delete-access-policy \
--access-policy-id a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Hinzufügen oder Entfernen von Portaladministratoren](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DeleteAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-access-policy.html)unter *AWS CLI Befehlsreferenz*.
### `delete-asset-model`
Das folgende Codebeispiel zeigt die Verwendung`delete-asset-model`.
**AWS CLI**
**So löschen Sie ein Komponentenmodell**
Im folgenden Beispiel für `delete-asset-model` wird ein Windturbinen-Komponentenmodell gelöscht.
```
aws iotsitewise delete-asset-model \
--asset-model-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
```
Ausgabe:
```
{
"assetModelStatus": {
"state": "DELETING"
}
}
```
Weitere Informationen finden Sie unter [Löschen von Asset-Modellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/delete-assets-and-models.html#delete-asset-models) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DeleteAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-asset-model.html)in der *AWS CLI Befehlsreferenz*.
### `delete-asset`
Das folgende Codebeispiel zeigt die Verwendung`delete-asset`.
**AWS CLI**
**So löschen Sie ein Asset**
Im folgenden Beispiel für `delete-asset` wird eine Windturbinen-Komponente gelöscht.
```
aws iotsitewise delete-asset \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
Ausgabe:
```
{
"assetStatus": {
"state": "DELETING"
}
}
```
Weitere Informationen finden Sie unter [Löschen von Assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/delete-assets-and-models.html#delete-assets) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DeleteAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-asset.html)in der *AWS CLI Befehlsreferenz*.
### `delete-dashboard`
Das folgende Codebeispiel zeigt die Verwendung`delete-dashboard`.
**AWS CLI**
**So löschen Sie ein Dashboard**
Im folgenden Beispiel für `delete-dashboard` wird ein Windturbinen-Dashboard gelöscht.
```
aws iotsitewise delete-dashboard \
--dashboard-id a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Löschen von Dashboards](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/delete-dashboards.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [DeleteDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-dashboard.html)in der *AWS CLI Befehlsreferenz.*
### `delete-gateway`
Das folgende Codebeispiel zeigt die Verwendung`delete-gateway`.
**AWS CLI**
**Um ein Gateway zu löschen**
Im folgenden Beispiel für `delete-gateway` wird ein Gateway gelöscht.
```
aws iotsitewise delete-gateway \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Daten mithilfe eines Gateways](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html) aufnehmen im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DeleteGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-gateway.html)in der *AWS CLI Befehlsreferenz.*
### `delete-portal`
Das folgende Codebeispiel zeigt die Verwendung`delete-portal`.
**AWS CLI**
**Um ein Portal zu löschen**
Im folgenden Beispiel für `delete-portal` wird ein Webportal für ein Windparkunternehmen gelöscht.
```
aws iotsitewise delete-portal \
--portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE
```
Ausgabe:
```
{
"portalStatus": {
"state": "DELETING"
}
}
```
Weitere Informationen finden Sie unter [Löschen eines Portals](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-delete-portal) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DeletePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-portal.html)in der *AWS CLI Befehlsreferenz*.
### `delete-project`
Das folgende Codebeispiel zeigt die Verwendung`delete-project`.
**AWS CLI**
**Um ein Projekt zu löschen**
Im folgenden Beispiel für `delete-project` wird ein Windparkprojekt gelöscht.
```
aws iotsitewise delete-project \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Löschen von Projekten](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/delete-projects.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [DeleteProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-project.html)in der *AWS CLI Befehlsreferenz*.
### `describe-access-policy`
Das folgende Codebeispiel zeigt die Verwendung`describe-access-policy`.
**AWS CLI**
**So beschreiben Sie eine Zugriffsrichtlinie**
Im folgenden Beispiel für `describe-access-policy` wird eine Zugriffsrichtlinie beschrieben, die einem Benutzer Administratorzugriff auf ein Webportal für ein Windparkunternehmen gewährt.
```
aws iotsitewise describe-access-policy \
--access-policy-id a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE
```
Ausgabe:
```
{
"accessPolicyId": "a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE",
"accessPolicyArn": "arn:aws:iotsitewise:us-west-2:123456789012:access-policy/a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE",
"accessPolicyIdentity": {
"user": {
"id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE"
}
},
"accessPolicyResource": {
"portal": {
"id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE"
}
},
"accessPolicyPermission": "ADMINISTRATOR",
"accessPolicyCreationDate": "2020-02-20T22:35:15.552880124Z",
"accessPolicyLastUpdateDate": "2020-02-20T22:35:15.552880124Z"
}
```
Weitere Informationen finden Sie unter [Hinzufügen oder Entfernen von Portaladministratoren](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-access-policy.html)unter *AWS CLI Befehlsreferenz*.
### `describe-asset-model`
Das folgende Codebeispiel zeigt die Verwendung`describe-asset-model`.
**AWS CLI**
**So beschreiben Sie ein Komponentenmodell**
Im folgenden Beispiel für `describe-asset-model` wird das Windpark-Komponentenmodell beschrieben.
```
aws iotsitewise describe-asset-model \
--asset-model-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE
```
Ausgabe:
```
{
"assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetModelArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetModelName": "Wind Farm Model",
"assetModelDescription": "Represents a wind farm that comprises many wind turbines",
"assetModelProperties": [
{
"id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE",
"name": "Total Generated Power",
"dataType": "DOUBLE",
"unit": "kW",
"type": {
"metric": {
"expression": "sum(power)",
"variables": [
{
"name": "power",
"value": {
"propertyId": "a1b2c3d4-5678-90ab-cdef-66666EXAMPLE",
"hierarchyId": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE"
}
}
],
"window": {
"tumbling": {
"interval": "1h"
}
}
}
}
},
{
"id": "a1b2c3d4-5678-90ab-cdef-88888EXAMPLE",
"name": "Region",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": " "
}
}
}
],
"assetModelHierarchies": [
{
"id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE",
"name": "Wind Turbines",
"childAssetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
],
"assetModelCreationDate": 1575671284.0,
"assetModelLastUpdateDate": 1575671988.0,
"assetModelStatus": {
"state": "ACTIVE"
}
}
```
Weitere Informationen finden Sie unter [Beschreibung eines bestimmten Asset-Modells](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#describe-asset-model) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-asset-model.html)in der *AWS CLI Befehlsreferenz*.
### `describe-asset-property`
Das folgende Codebeispiel zeigt die Verwendung`describe-asset-property`.
**AWS CLI**
**So beschreiben Sie eine Komponenteneigenschaft**
Im folgenden Beispiel für `describe-asset-property` wird die gesamte erzeugte Leistung einer Windparkkomponente beschrieben.
```
aws iotsitewise describe-asset-property \
--asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-99999EXAMPLE
```
Ausgabe:
```
{
"assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"assetName": "Wind Farm 1",
"assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetProperty": {
"id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE",
"name": "Total Generated Power",
"notification": {
"topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-99999EXAMPLE",
"state": "DISABLED"
},
"dataType": "DOUBLE",
"unit": "kW",
"type": {
"metric": {
"expression": "sum(power)",
"variables": [
{
"name": "power",
"value": {
"propertyId": "a1b2c3d4-5678-90ab-cdef-66666EXAMPLE",
"hierarchyId": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE"
}
}
],
"window": {
"tumbling": {
"interval": "1h"
}
}
}
}
}
}
```
Weitere Informationen finden Sie unter [Beschreibung einer bestimmten Anlageneigenschaft](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#describe-asset-property) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeAssetProperty](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-asset-property.html)in der *AWS CLI Befehlsreferenz*.
### `describe-asset`
Das folgende Codebeispiel zeigt die Verwendung`describe-asset`.
**AWS CLI**
**So beschreiben Sie eine Komponente**
Das folgende Beispiel für `describe-asset` beschreibt eine Windpark-Komponente.
```
aws iotsitewise describe-asset \
--asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE
```
Ausgabe:
```
{
"assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"assetArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"assetName": "Wind Farm 1",
"assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetProperties": [
{
"id": "a1b2c3d4-5678-90ab-cdef-88888EXAMPLE",
"name": "Region",
"dataType": "STRING"
},
{
"id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE",
"name": "Total Generated Power",
"dataType": "DOUBLE",
"unit": "kW"
}
],
"assetHierarchies": [
{
"id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE",
"name": "Wind Turbines"
}
],
"assetCreationDate": 1575672453.0,
"assetLastUpdateDate": 1575672453.0,
"assetStatus": {
"state": "ACTIVE"
}
}
```
Weitere Informationen finden Sie unter [Beschreibung eines bestimmten Assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#describe-asset) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-asset.html)in der *AWS CLI Befehlsreferenz*.
### `describe-dashboard`
Das folgende Codebeispiel zeigt die Verwendung`describe-dashboard`.
**AWS CLI**
**So beschreiben Sie ein Dashboard**
Im folgenden Beispiel für `describe-dashboard` wird das angegebene Windpark-Dashboard beschrieben.
```
aws iotsitewise describe-dashboard \
--dashboard-id a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE
```
Ausgabe:
```
{
"dashboardId": "a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE",
"dashboardArn": "arn:aws:iotsitewise:us-west-2:123456789012:dashboard/a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE",
"dashboardName": "Wind Farm",
"projectId": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE",
"dashboardDefinition": "{\"widgets\":[{\"type\":\"monitor-line-chart\",\"title\":\"Generated Power\",\"x\":0,\"y\":0,\"height\":3,\"width\":3,\"metrics\":[{\"label\":\"Power\",\"type\":\"iotsitewise\",\"assetId\":\"a1b2c3d4-5678-90ab-cdef-44444EXAMPLE\",\"propertyId\":\"a1b2c3d4-5678-90ab-cdef-99999EXAMPLE\"}]}]}",
"dashboardCreationDate": "2020-05-01T20:32:12.228476348Z",
"dashboardLastUpdateDate": "2020-05-01T20:32:12.228476348Z"
}
```
Weitere Informationen finden Sie unter [Anzeigen von Dashboards](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-dashboards.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [DescribeDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-dashboard.html)in der *AWS CLI Befehlsreferenz.*
### `describe-gateway-capability-configuration`
Das folgende Codebeispiel zeigt die Verwendung`describe-gateway-capability-configuration`.
**AWS CLI**
**So beschreiben Sie eine Gateway-Kapazität**
Im folgenden Beispiel für `describe-gateway-capability-configuration` wird eine OPC-UA-Quellfunktion beschrieben.
```
aws iotsitewise describe-gateway-capability-configuration \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
--capability-namespace "iotsitewise:opcuacollector:1"
```
Ausgabe:
```
{
"gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"capabilityNamespace": "iotsitewise:opcuacollector:1",
"capabilityConfiguration": "{\"sources\":[{\"name\":\"Wind Farm #1\",\"endpoint\":{\"certificateTrust\":{\"type\":\"TrustAny\"},\"endpointUri\":\"opc.tcp://203.0.113.0:49320\",\"securityPolicy\":\"BASIC256\",\"messageSecurityMode\":\"SIGN_AND_ENCRYPT\",\"identityProvider\":{\"type\":\"Username\",\"usernameSecretArn\":\"arn:aws:secretsmanager:us-east-1:123456789012:secret:greengrass-factory1-auth-3QNDmM\"},\"nodeFilterRules\":[]},\"measurementDataStreamPrefix\":\"\"}]}",
"capabilitySyncStatus": "IN_SYNC"
}
```
Weitere Informationen finden Sie unter [Konfiguration von Datenquellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-sources.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeGatewayCapabilityConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-gateway-capability-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `describe-gateway`
Das folgende Codebeispiel zeigt die Verwendung`describe-gateway`.
**AWS CLI**
**So beschreiben Sie ein Gateway**
Im folgenden Beispiel für `describe-gateway` wird ein Gateway beschrieben.
```
aws iotsitewise describe-gateway \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE
```
Ausgabe:
```
{
"gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"gatewayName": "ExampleCorpGateway",
"gatewayArn": "arn:aws:iotsitewise:us-west-2:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"gatewayPlatform": {
"greengrass": {
"groupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-1b1b1EXAMPLE"
}
},
"gatewayCapabilitySummaries": [
{
"capabilityNamespace": "iotsitewise:opcuacollector:1",
"capabilitySyncStatus": "IN_SYNC"
}
],
"creationDate": 1588369971.457,
"lastUpdateDate": 1588369971.457
}
```
Weitere Informationen finden Sie unter [Daten mithilfe eines Gateways](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html) aufnehmen im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-gateway.html)in der *AWS CLI Befehlsreferenz.*
### `describe-logging-options`
Das folgende Codebeispiel zeigt die Verwendung`describe-logging-options`.
**AWS CLI**
**Um die aktuellen AWS SiteWise IoT-Protokollierungsoptionen abzurufen**
Im folgenden `describe-logging-options` Beispiel werden die aktuellen AWS SiteWise IoT-Protokollierungsoptionen für Ihr AWS Konto in der aktuellen Region abgerufen.
```
aws iotsitewise describe-logging-options
```
Ausgabe:
```
{
"loggingOptions": {
"level": "INFO"
}
}
```
Weitere Informationen finden Sie unter [Monitoring AWS IoT SiteWise with Amazon CloudWatch Logs](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-cloudwatch-logs.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-logging-options.html)in der *AWS CLI Befehlsreferenz*.
### `describe-portal`
Das folgende Codebeispiel zeigt die Verwendung`describe-portal`.
**AWS CLI**
**So beschreiben Sie ein Portal**
Im folgenden Beispiel für `describe-portal` wird ein Webportal für ein Windparkunternehmen beschrieben.
```
aws iotsitewise describe-portal \
--portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE
```
Ausgabe:
```
{
"portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"portalArn": "arn:aws:iotsitewise:us-west-2:123456789012:portal/a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"portalName": "WindFarmPortal",
"portalDescription": "A portal that contains wind farm projects for Example Corp.",
"portalClientId": "E-a1b2c3d4e5f6_a1b2c3d4e5f6EXAMPLE",
"portalStartUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws",
"portalContactEmail": "support@example.com",
"portalStatus": {
"state": "ACTIVE"
},
"portalCreationDate": "2020-02-04T23:01:52.90248068Z",
"portalLastUpdateDate": "2020-02-04T23:01:52.90248078Z",
"roleArn": "arn:aws:iam::123456789012:role/MySiteWiseMonitorServiceRole"
}
```
Weitere Informationen finden Sie unter [Verwaltung Ihrer Portale](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DescribePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-portal.html)in der *AWS CLI Befehlsreferenz.*
### `describe-project`
Das folgende Codebeispiel zeigt die Verwendung`describe-project`.
**AWS CLI**
**So beschreiben Sie ein Projekt**
Im folgenden Beispiel für `describe-project` wird ein Windparkprojekt beschrieben.
```
aws iotsitewise describe-project \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE
```
Ausgabe:
```
{
"projectId": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE",
"projectArn": "arn:aws:iotsitewise:us-west-2:123456789012:project/a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE",
"projectName": "Wind Farm 1",
"portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"projectDescription": "Contains asset visualizations for Wind Farm #1 for Example Corp.",
"projectCreationDate": "2020-02-20T21:58:43.362246001Z",
"projectLastUpdateDate": "2020-02-20T21:58:43.362246095Z"
}
```
Weitere Informationen finden Sie unter [Projektdetails anzeigen](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-project-details.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [DescribeProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-project.html)in der *AWS CLI Befehlsreferenz*.
### `disassociate-assets`
Das folgende Codebeispiel zeigt die Verwendung`disassociate-assets`.
**AWS CLI**
**So heben Sie die Zuordnung einer untergeordneten Komponente zu einer übergeordneten Komponente auf**
Im folgenden Beispiel für `disassociate-assets` wird die Zuordnung einer Windturbinen-Komponente zu einer Windpark-Komponente aufgehoben.
```
aws iotsitewise disassociate-assets \
--asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \
--hierarchy-id a1b2c3d4-5678-90ab-cdef-77777EXAMPLE \
--child-asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Assets zuordnen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/add-associated-assets.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DisassociateAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/disassociate-assets.html)in der *AWS CLI Befehlsreferenz.*
### `get-asset-property-aggregates`
Das folgende Codebeispiel zeigt die Verwendung`get-asset-property-aggregates`.
**AWS CLI**
**So rufen Sie die aggregierten Werte für Durchschnitt und Anzahl einer Komponenteneigenschaft ab**
Im folgenden Beispiel für `get-asset-property-aggregates` werden die durchschnittliche Gesamtleistung und die Anzahl der Gesamtleistungs-Datenpunkte einer Windturbinen-Komponente für einen Zeitraum von 1 Stunde abgerufen.
```
aws iotsitewise get-asset-property-aggregates \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE \
--start-date 1580849400 \
--end-date 1580853000 \
--aggregate-types AVERAGE COUNT \
--resolution 1h
```
Ausgabe:
```
{
"aggregatedValues": [
{
"timestamp": 1580850000.0,
"quality": "GOOD",
"value": {
"average": 8723.46538886233,
"count": 12.0
}
}
]
}
```
Weitere Informationen finden Sie unter [Abfragen von Aggregaten für Asset-Eigenschaften](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#aggregates) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetAssetPropertyAggregates AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/get-asset-property-aggregates.html)*Befehlsreferenz*.
### `get-asset-property-value-history`
Das folgende Codebeispiel zeigt die Verwendung`get-asset-property-value-history`.
**AWS CLI**
**So rufen Sie die historischen Werte einer Komponenteneigenschaft ab**
Im folgenden Beispiel für `get-asset-property-value-history` werden die Gesamtleistungswerte einer Windturbinenkomponente für einen Zeitraum von 20 Minuten abgerufen.
```
aws iotsitewise get-asset-property-value-history \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE \
--start-date 1580851800 \
--end-date 1580853000
```
Ausgabe:
```
{
"assetPropertyValueHistory": [
{
"value": {
"doubleValue": 7217.787046814844
},
"timestamp": {
"timeInSeconds": 1580852100,
"offsetInNanos": 0
},
"quality": "GOOD"
},
{
"value": {
"doubleValue": 6941.242811875451
},
"timestamp": {
"timeInSeconds": 1580852400,
"offsetInNanos": 0
},
"quality": "GOOD"
},
{
"value": {
"doubleValue": 6976.797662266717
},
"timestamp": {
"timeInSeconds": 1580852700,
"offsetInNanos": 0
},
"quality": "GOOD"
},
{
"value": {
"doubleValue": 6890.8677520453875
},
"timestamp": {
"timeInSeconds": 1580853000,
"offsetInNanos": 0
},
"quality": "GOOD"
}
]
}
```
Weitere Informationen finden Sie unter [Abfragen historischer Immobilienwerte](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#historical-values) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetAssetPropertyValueHistory AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/get-asset-property-value-history.html)*Befehlsreferenz.*
### `get-asset-property-value`
Das folgende Codebeispiel zeigt die Verwendung`get-asset-property-value`.
**AWS CLI**
**So rufen Sie den aktuellen Wert einer Komponenteneigenschaft ab**
Im folgenden Beispiel für `get-asset-property-value` wird die aktuelle Gesamtleistung einer Windturbinenkomponente abgerufen.
```
aws iotsitewise get-asset-property-value \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE
```
Ausgabe:
```
{
"propertyValue": {
"value": {
"doubleValue": 6890.8677520453875
},
"timestamp": {
"timeInSeconds": 1580853000,
"offsetInNanos": 0
},
"quality": "GOOD"
}
}
```
Weitere Informationen finden Sie unter [Abfragen aktueller Objekteigenschaftswerte](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#current-values) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetAssetPropertyValue AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/get-asset-property-value.html)*Befehlsreferenz.*
### `list-access-policies`
Das folgende Codebeispiel zeigt die Verwendung`list-access-policies`.
**AWS CLI**
**So listen Sie alle Zugriffsrichtlinien auf**
Im folgenden Beispiel für `list-access-policies` werden alle Zugriffsrichtlinien für einen Benutzer aufgelistet, der Portaladministrator ist.
```
aws iotsitewise list-access-policies \
--identity-type USER \
--identity-id a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE
```
Ausgabe:
```
{
"accessPolicySummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE",
"identity": {
"user": {
"id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE"
}
},
"resource": {
"portal": {
"id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE"
}
},
"permission": "ADMINISTRATOR"
}
]
}
```
Weitere Informationen finden Sie unter [Verwaltung Ihrer Portale](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListAccessPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-access-policies.html)in der *AWS CLI Befehlsreferenz.*
### `list-asset-models`
Das folgende Codebeispiel zeigt die Verwendung`list-asset-models`.
**AWS CLI**
**So listen Sie alle Komponentenmodelle auf**
Das folgende `list-asset-models` Beispiel listet alle Vermögensmodelle auf, die in Ihrem AWS Konto in der aktuellen Region definiert sind.
```
aws iotsitewise list-asset-models
```
Ausgabe:
```
{
"assetModelSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"name": "Wind Farm Model",
"description": "Represents a wind farm that comprises many wind turbines",
"creationDate": 1575671284.0,
"lastUpdateDate": 1575671988.0,
"status": {
"state": "ACTIVE"
}
},
{
"id": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"name": "Wind Turbine Model",
"description": "Represents a wind turbine manufactured by Example Corp",
"creationDate": 1575671207.0,
"lastUpdateDate": 1575686273.0,
"status": {
"state": "ACTIVE"
}
}
]
}
```
Weitere Informationen finden Sie unter [Auflisten aller Asset-Modelle](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-asset-models) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListAssetModels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-asset-models.html)in der *AWS CLI Befehlsreferenz*.
### `list-assets`
Das folgende Codebeispiel zeigt die Verwendung`list-assets`.
**AWS CLI**
**Beispiel 1: So listen Sie alle Komponenten der obersten Ebene auf**
Das folgende `list-assets` Beispiel listet alle Anlagen auf, die sich in der Asset-Hierarchiestruktur auf oberster Ebene befinden und in Ihrem AWS Konto in der aktuellen Region definiert sind.
```
aws iotsitewise list-assets \
--filter TOP_LEVEL
```
Ausgabe:
```
{
"assetSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"name": "Wind Farm 1",
"assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"creationDate": 1575672453.0,
"lastUpdateDate": 1575672453.0,
"status": {
"state": "ACTIVE"
},
"hierarchies": [
{
"id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE",
"name": "Wind Turbines"
}
]
}
]
}
```
Weitere Informationen finden Sie unter [Auflisten von Assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-assets) im *AWS SiteWise IoT-Benutzerhandbuch*.
**Beispiel 2: So listen Sie alle Komponenten auf Basis eines Komponentenmodells auf**
Im folgenden `list-assets` Beispiel werden alle Vermögenswerte aufgeführt, die auf einem Vermögensmodell basieren und in Ihrem AWS Konto in der aktuellen Region definiert sind.
```
aws iotsitewise list-assets \
--asset-model-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
```
Ausgabe:
```
{
"assetSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"name": "Wind Turbine 1",
"assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"creationDate": 1575671550.0,
"lastUpdateDate": 1575686308.0,
"status": {
"state": "ACTIVE"
},
"hierarchies": []
}
]
}
```
Weitere Informationen finden Sie unter [Auflisten von Assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-assets) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-assets.html)in der *AWS CLI Befehlsreferenz*.
### `list-associated-assets`
Das folgende Codebeispiel zeigt die Verwendung`list-associated-assets`.
**AWS CLI**
**So listen Sie alle Komponenten auf, die einer Komponente in einer bestimmten Hierarchie zugeordnet sind**
Im folgenden Beispiel für `list-associated-assets` werden alle Windturbinen-Komponenten aufgeführt, die der angegebenen Windpark-Komponente zugeordnet sind.
```
aws iotsitewise list-associated-assets \
--asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \
--hierarchy-id a1b2c3d4-5678-90ab-cdef-77777EXAMPLE
```
Ausgabe:
```
{
"assetSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"name": "Wind Turbine 1",
"assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"creationDate": 1575671550.0,
"lastUpdateDate": 1575686308.0,
"status": {
"state": "ACTIVE"
},
"hierarchies": []
}
]
}
```
Weitere Informationen finden Sie im *AWS SiteWise IoT-Benutzerhandbuch* unter [Auflisten von Assets, die einem bestimmten Asset zugeordnet](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-associated-assets) sind.
+ Einzelheiten zur API finden Sie [ListAssociatedAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-associated-assets.html)in der *AWS CLI Befehlsreferenz*.
### `list-dashboards`
Das folgende Codebeispiel zeigt die Verwendung`list-dashboards`.
**AWS CLI**
**So listen Sie alle Dashboards in einem Projekt auf**
Im folgenden Beispiel für `list-dashboards` werden alle Dashboards aufgelistet, die in einem Projekt definiert sind.
```
aws iotsitewise list-dashboards \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE
```
Ausgabe:
```
{
"dashboardSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE",
"name": "Wind Farm",
"creationDate": "2020-05-01T20:32:12.228476348Z",
"lastUpdateDate": "2020-05-01T20:32:12.228476348Z"
}
]
}
```
Weitere Informationen finden Sie unter [Anzeigen von Dashboards](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-dashboards.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [ListDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-dashboards.html)in der *AWS CLI Befehlsreferenz.*
### `list-gateways`
Das folgende Codebeispiel zeigt die Verwendung`list-gateways`.
**AWS CLI**
**So listen Sie alle Gateways auf**
Das folgende `list-gateways` Beispiel listet alle Gateways auf, die in Ihrem AWS Konto in der aktuellen Region definiert sind.
```
aws iotsitewise list-gateways
```
Ausgabe:
```
{
"gatewaySummaries": [
{
"gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"gatewayName": "ExampleCorpGateway",
"gatewayCapabilitySummaries": [
{
"capabilityNamespace": "iotsitewise:opcuacollector:1",
"capabilitySyncStatus": "IN_SYNC"
}
],
"creationDate": 1588369971.457,
"lastUpdateDate": 1588369971.457
}
]
}
```
Weitere Informationen finden Sie unter [Daten mithilfe eines Gateways](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html) aufnehmen im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-gateways.html)in der *AWS CLI Befehlsreferenz.*
### `list-portals`
Das folgende Codebeispiel zeigt die Verwendung`list-portals`.
**AWS CLI**
**So listen Sie alle Portale auf**
Das folgende `list-portals` Beispiel listet alle Portale auf, die in Ihrem AWS Konto in der aktuellen Region definiert sind.
```
aws iotsitewise list-portals
```
Ausgabe:
```
{
"portalSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"name": "WindFarmPortal",
"description": "A portal that contains wind farm projects for Example Corp.",
"startUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws",
"creationDate": "2020-02-04T23:01:52.90248068Z",
"lastUpdateDate": "2020-02-04T23:01:52.90248078Z",
"roleArn": "arn:aws:iam::123456789012:role/service-role/MySiteWiseMonitorServiceRole"
}
]
}
```
Weitere Informationen finden Sie unter [Verwaltung Ihrer Portale](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListPortals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-portals.html)in der *AWS CLI Befehlsreferenz.*
### `list-project-assets`
Das folgende Codebeispiel zeigt die Verwendung`list-project-assets`.
**AWS CLI**
**So listen Sie alle Komponenten auf, die einem Projekt zugeordnet sind**
Im folgenden Beispiel für `list-project-assets` werden alle Komponenten aufgelistet, die einem Windparkprojekt zugeordnet sind.
```
aws iotsitewise list-projects \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE
```
Ausgabe:
```
{
"assetIds": [
"a1b2c3d4-5678-90ab-cdef-44444EXAMPLE"
]
}
```
Weitere Informationen finden Sie unter [Hinzufügen von Assets zu Projekten](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/add-assets-to-projects-sd.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [ListProjectAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-project-assets.html)in der *AWS CLI Befehlsreferenz*.
### `list-projects`
Das folgende Codebeispiel zeigt die Verwendung`list-projects`.
**AWS CLI**
**So listen Sie alle Projekte in einem Portal auf**
Im folgenden Beispiel für `list-projects` werden alle Projekte aufgelistet, die in einem Portal definiert sind.
```
aws iotsitewise list-projects \
--portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE
```
Ausgabe:
```
{
"projectSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE",
"name": "Wind Farm 1",
"description": "Contains asset visualizations for Wind Farm #1 for Example Corp.",
"creationDate": "2020-02-20T21:58:43.362246001Z",
"lastUpdateDate": "2020-02-20T21:58:43.362246095Z"
}
]
}
```
Weitere Informationen finden Sie unter [Projektdetails anzeigen](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-project-details.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [ListProjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-projects.html)in der *AWS CLI Befehlsreferenz*.
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`.
**AWS CLI**
**So listen Sie alle Tags für eine Ressource auf**
Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für eine Windturbinen-Komponente aufgelistet.
```
aws iotsitewise list-tags-for-resource \
--resource-arn arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
Ausgabe:
```
{
"tags": {
"Owner": "richard-roe"
}
}
```
Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.*
### `put-logging-options`
Das folgende Codebeispiel zeigt die Verwendung`put-logging-options`.
**AWS CLI**
**So legen Sie den Grad der Protokollierung fest**
Das folgende `put-logging-options` Beispiel aktiviert die `INFO` Level-Protokollierung in AWS IoT SiteWise. Andere Level umfassen `DEBUG` und `OFF`.
```
aws iotsitewise put-logging-options \
--logging-options level=INFO
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Monitoring AWS IoT SiteWise with Amazon CloudWatch Logs](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-cloudwatch-logs.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [PutLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/put-logging-options.html)in der *AWS CLI Befehlsreferenz*.
### `tag-resource`
Das folgende Codebeispiel zeigt die Verwendung`tag-resource`.
**AWS CLI**
**So fügen Sie einer Ressource ein Tag hinzu**
Im folgenden Beispiel für `tag-resource` wird einer Windturbinen-Komponente ein Eigentümer-Tag hinzugefügt. Auf diese Weise können Sie den Zugriff auf die Komponente auf Basis dessen steuern, wem sie gehört.
```
aws iotsitewise tag-resource \
--resource-arn arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--tags Owner=richard-roe
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/tag-resource.html)in der *AWS CLI Befehlsreferenz.*
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-resource`.
**AWS CLI**
**So entfernen Sie ein Tag von einer Ressource**
Im folgenden Beispiel für `untag-resource` wird ein Eigentümer-Tag von einer Windturbinen-Komponente entfernt.
```
aws iotsitewise untag-resource \
--resource-arn arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--tag-keys Owner
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/untag-resource.html)in der *AWS CLI Befehlsreferenz.*
### `update-access-policy`
Das folgende Codebeispiel zeigt die Verwendung`update-access-policy`.
**AWS CLI**
**So gewähren Sie einem Projekt-Viewer die Eigentümerschaft an einem Projekt**
Im folgenden Beispiel für `update-access-policy` wird eine Zugriffsrichtlinie aktualisiert, die einem Projekt-Viewer die Eigentümerschaft an einem Projekt gewährt.
```
aws iotsitewise update-access-policy \
--access-policy-id a1b2c3d4-5678-90ab-cdef-dddddEXAMPLE \
--cli-input-json file://update-project-viewer-access-policy.json
```
Inhalt von `update-project-viewer-access-policy.json`:
```
{
"accessPolicyIdentity": {
"user": {
"id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE"
}
},
"accessPolicyPermission": "ADMINISTRATOR",
"accessPolicyResource": {
"project": {
"id": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE"
}
}
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Zuweisen von Projekteigentümern](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/assign-project-owners.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [UpdateAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-access-policy.html)in der *AWS CLI Befehlsreferenz.*
### `update-asset-model`
Das folgende Codebeispiel zeigt die Verwendung`update-asset-model`.
**AWS CLI**
**So aktualisieren Sie ein Komponentenmodell**
Im folgenden Beispiel für `update-asset-model` wird die Beschreibung des Komponentenmodells eines Windparks aktualisiert. Dieses Beispiel beinhaltet die vorhandenen Definitionen IDs und Definitionen des Modells, da das bestehende Modell mit dem neuen Modell `update-asset-model` überschrieben wird.
```
aws iotsitewise update-asset-model \
--cli-input-json file://update-wind-farm-model.json
```
Inhalt von `update-wind-farm-model.json`:
```
{
"assetModelName": "Wind Farm Model",
"assetModelDescription": "Represents a wind farm that comprises many wind turbines",
"assetModelProperties": [
{
"id": "a1b2c3d4-5678-90ab-cdef-88888EXAMPLE",
"name": "Region",
"dataType": "STRING",
"type": {
"attribute": {}
}
},
{
"id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE",
"name": "Total Generated Power",
"dataType": "DOUBLE",
"unit": "kW",
"type": {
"metric": {
"expression": "sum(power)",
"variables": [
{
"name": "power",
"value": {
"hierarchyId": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-66666EXAMPLE"
}
}
],
"window": {
"tumbling": {
"interval": "1h"
}
}
}
}
}
],
"assetModelHierarchies": [
{
"id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE",
"name": "Wind Turbines",
"childAssetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
]
}
```
Ausgabe:
```
{
"assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetModelArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetModelStatus": {
"state": "CREATING"
}
}
```
Weitere Informationen finden Sie unter [Aktualisieren von Asset-Modellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-assets-and-models.html#update-asset-models) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UpdateAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-asset-model.html)in der *AWS CLI Befehlsreferenz*.
### `update-asset-property`
Das folgende Codebeispiel zeigt die Verwendung`update-asset-property`.
**AWS CLI**
**Beispiel 1: So aktualisieren Sie den Alias einer Komponenteneigenschaft**
Im folgenden Beispiel für `update-asset-property` wird der Leistungs-Alias einer Windturbinen-Komponente aktualisiert.
```
aws iotsitewise update-asset-property \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-55555EXAMPLE \
--property-alias "/examplecorp/windfarm/1/turbine/1/power" \
--property-notification-state DISABLED
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie im *AWS SiteWise IoT-Benutzerhandbuch* unter [Zuordnung von industriellen Datenströmen zu Anlageneigenschaften](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html).
**Beispiel 2: So aktivieren Sie Benachrichtigungen zu Komponenteneigenschaften**
Im folgenden Beispiel für `update-asset-property` werden Benachrichtigungen zur Aktualisierung von Komponenteneigenschaften für die Leistung einer Windturbinen-Komponente aktiviert. Aktualisierungen von Eigenschaftswerten werden im MQTT-Thema `$aws/sitewise/asset-models//assets//properties/` veröffentlicht, wobei jede ID durch die Eigenschafts-, Komponenten- und Modell-ID der Komponenteneigenschaft ersetzt wird.
```
aws iotsitewise update-asset-property \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE \
--property-notification-state ENABLED \
--property-alias "/examplecorp/windfarm/1/turbine/1/power"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Interaktion mit anderen Diensten](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/interact-with-other-services.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UpdateAssetProperty](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-asset-property.html)in der *AWS CLI Befehlsreferenz*.
### `update-asset`
Das folgende Codebeispiel zeigt die Verwendung`update-asset`.
**AWS CLI**
**So aktualisieren Sie den Namen einer Komponente**
Im folgenden Beispiel für `update-asset` wird der Name einer Windturbinen-Komponente aktualisiert.
```
aws iotsitewise update-asset \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--asset-name "Wind Turbine 2"
```
Ausgabe:
```
{
"assetStatus": {
"state": "UPDATING"
}
}
```
Weitere Informationen finden Sie unter [Aktualisieren von Ressourcen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-assets-and-models.html#update-assets) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UpdateAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-asset.html)in der *AWS CLI Befehlsreferenz*.
### `update-dashboard`
Das folgende Codebeispiel zeigt die Verwendung`update-dashboard`.
**AWS CLI**
**So aktualisieren Sie ein Dashboard**
Im folgenden Beispiel für `update-dashboard` wird der Titel des Liniendiagramms eines Dashboards geändert, in dem die gesamte erzeugte Leistung für einen Windpark angezeigt wird.
```
aws iotsitewise update-dashboard \
--project-id a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE \
--dashboard-name "Wind Farm" \
--dashboard-definition file://update-wind-farm-dashboard.json
```
Inhalt von `update-wind-farm-dashboard.json`:
```
{
"widgets": [
{
"type": "monitor-line-chart",
"title": "Total Generated Power",
"x": 0,
"y": 0,
"height": 3,
"width": 3,
"metrics": [
{
"label": "Power",
"type": "iotsitewise",
"assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE"
}
]
}
]
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Erstellen von Dashboards (CLI)](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-dashboards-using-aws-cli.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [UpdateDashboard AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-dashboard.html)*Befehlsreferenz.*
### `update-gateway-capability-configuration`
Das folgende Codebeispiel zeigt die Verwendung`update-gateway-capability-configuration`.
**AWS CLI**
**So aktualisieren Sie eine Gateway-Kapazität**
Im folgenden Beispiel für `update-gateway-capability-configuration` wird eine OPC-UA-Quelle mit den folgenden Eigenschaften konfiguriert:
Vertraut jedem Zertifikat. Verwendet den Basic256-Algorithmus, um Nachrichten zu sichern. Verwendet den SignAndEncrypt Modus, um Verbindungen zu sichern. Verwendet Authentifizierungsdaten, die in einem Secrets Manager-Geheimnis gespeichert sind. AWS
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
--capability-namespace "iotsitewise:opcuacollector:1" \
--capability-configuration file://opc-ua-capability-configuration.json
```
Inhalt von `opc-ua-capability-configuration.json`:
```
{
"sources": [
{
"name": "Wind Farm #1",
"endpoint": {
"certificateTrust": {
"type": "TrustAny"
},
"endpointUri": "opc.tcp://203.0.113.0:49320",
"securityPolicy": "BASIC256",
"messageSecurityMode": "SIGN_AND_ENCRYPT",
"identityProvider": {
"type": "Username",
"usernameSecretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-windfarm1-auth-1ABCDE"
},
"nodeFilterRules": []
},
"measurementDataStreamPrefix": ""
}
]
}
```
Ausgabe:
```
{
"capabilityNamespace": "iotsitewise:opcuacollector:1",
"capabilitySyncStatus": "OUT_OF_SYNC"
}
```
Weitere Informationen finden Sie unter [Konfiguration von Datenquellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-sources.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UpdateGatewayCapabilityConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-gateway-capability-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `update-gateway`
Das folgende Codebeispiel zeigt die Verwendung`update-gateway`.
**AWS CLI**
**So aktualisieren Sie den Namen eines Gateways**
Im folgenden Beispiel für `update-gateway` wird der Name eines Gateways aktualisiert.
```
aws iotsitewise update-gateway \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
--gateway-name ExampleCorpGateway1
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Daten mithilfe eines Gateways](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html) aufnehmen im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UpdateGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-gateway.html)in der *AWS CLI Befehlsreferenz.*
### `update-portal`
Das folgende Codebeispiel zeigt die Verwendung`update-portal`.
**AWS CLI**
**So aktualisieren Sie die Details eines Portals**
Im folgenden Beispiel für `update-portal` wird ein Webportal für ein Windparkunternehmen aktualisiert.
```
aws iotsitewise update-portal \
--portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE \
--portal-name WindFarmPortal \
--portal-description "A portal that contains wind farm projects for Example Corp." \
--portal-contact-email support@example.com \
--role-arn arn:aws:iam::123456789012:role/MySiteWiseMonitorServiceRole
```
Ausgabe:
```
{
"portalStatus": {
"state": "UPDATING"
}
}
```
Weitere Informationen finden Sie unter [Verwaltung Ihrer Portale](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html) im *AWS SiteWise IoT-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UpdatePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-portal.html)in der *AWS CLI Befehlsreferenz.*
### `update-project`
Das folgende Codebeispiel zeigt die Verwendung`update-project`.
**AWS CLI**
**So aktualisieren Sie die Details eines Projekts**
Im folgenden Beispiel für `update-project` wird ein Windparkprojekt aktualisiert.
```
aws iotsitewise update-project \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
--project-name "Wind Farm 1" \
--project-description "Contains asset visualizations for Wind Farm #1 for Example Corp."
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Projektdetails ändern](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/edit-project-details.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*.
+ Einzelheiten zur API finden Sie [UpdateProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-project.html)in der *AWS CLI Befehlsreferenz*.