Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
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 Greengrass V2 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 Greengrass V2.
*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-service-role-to-account`
Das folgende Codebeispiel zeigt, wie Sie`associate-service-role-to-account`.
**AWS CLI**
**Um die Greengrass-Servicerolle mit Ihrem AWS Konto zu verknüpfen**
Das folgende `associate-service-role-to-account` Beispiel ordnet AWS IoT Greengrass eine Servicerolle für Ihr AWS Konto zu.
```
aws greengrassv2 associate-service-role-to-account \
--role-arn arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole
```
Ausgabe:
```
{
"associatedAt": "2022-01-19T19:21:53Z"
}
```
Weitere Informationen finden Sie unter [Greengrass-Servicerolle](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) im *Entwicklerhandbuch für AWS IoT Greengrass*.
+ Einzelheiten zur API finden Sie [AssociateServiceRoleToAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/associate-service-role-to-account.html)in der *AWS CLI Befehlsreferenz.*
### `batch-associate-client-device-with-core-device`
Das folgende Codebeispiel zeigt die Verwendung`batch-associate-client-device-with-core-device`.
**AWS CLI**
**So verknüpfen Sie Client-Geräte mit einem Kerngerät**
Im folgenden Beispiel für `batch-associate-client-device-with-core-device` werden zwei Client-Geräte mit einem Kerngerät verknüpft.
```
aws greengrassv2 batch-associate-client-device-with-core-device \
--core-device-thing-name MyGreengrassCore \
--entries thingName=MyClientDevice1 thingName=MyClientDevice2
```
Ausgabe:
```
{
"errorEntries": []
}
```
Weitere Informationen finden Sie unter [Mit lokalen IoT-Geräten interagieren](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [BatchAssociateClientDeviceWithCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/batch-associate-client-device-with-core-device.html)in der *AWS CLI Befehlsreferenz*.
### `batch-disassociate-client-device-from-core-device`
Das folgende Codebeispiel zeigt die Verwendung`batch-disassociate-client-device-from-core-device`.
**AWS CLI**
**So trennen Sie Client-Geräte von einem Kerngerät**
Im folgenden Beispiel für `batch-disassociate-client-device-from-core-device` werden zwei Client-Geräte von einem Kerngerät getrennt.
```
aws greengrassv2 batch-disassociate-client-device-from-core-device \
--core-device-thing-name MyGreengrassCore \
--entries thingName=MyClientDevice1 thingName=MyClientDevice2
```
Ausgabe:
```
{
"errorEntries": []
}
```
Weitere Informationen finden Sie unter [Mit lokalen IoT-Geräten interagieren](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [BatchDisassociateClientDeviceFromCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/batch-disassociate-client-device-from-core-device.html)in der *AWS CLI Befehlsreferenz*.
### `cancel-deployment`
Das folgende Codebeispiel zeigt die Verwendung`cancel-deployment`.
**AWS CLI**
**So brechen Sie einen Bereitstellung ab**
Im folgenden Beispiel für `cancel-deployment` wird eine kontinuierliche Bereitstellung auf einer Objektgruppe abgebrochen.
```
aws greengrassv2 cancel-deployment \
--deployment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"message": "SUCCESS"
}
```
Weitere Informationen finden Sie unter [Abbrechen von Bereitstellungen](https://docs.aws.amazon.com/greengrass/v2/developerguide/cancel-deployments.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [CancelDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/cancel-deployment.html)in der *AWS CLI Befehlsreferenz*.
### `create-component-version`
Das folgende Codebeispiel zeigt die Verwendung`create-component-version`.
**AWS CLI**
**Beispiel 1: So erstellen Sie eine Komponentenversion anhand eines Rezepts**
Im folgenden Beispiel für `create-component-version` wird eine Version einer Hello-World-Komponente anhand einer Rezeptdatei erstellt.
```
aws greengrassv2 create-component-version \
--inline-recipe fileb://com.example.HelloWorld-1.0.0.json
```
Inhalt von `com.example.HelloWorld-1.0.0.json`:
```
{
"RecipeFormatVersion": "2020-01-25",
"ComponentName": "com.example.HelloWorld",
"ComponentVersion": "1.0.0",
"ComponentDescription": "My first AWS IoT Greengrass component.",
"ComponentPublisher": "Amazon",
"ComponentConfiguration": {
"DefaultConfiguration": {
"Message": "world"
}
},
"Manifests": [
{
"Platform": {
"os": "linux"
},
"Lifecycle": {
"Run": "echo 'Hello {configuration:/Message}'"
}
}
]
}
```
Ausgabe:
```
{
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.0",
"creationTimestamp": "2021-01-07T16:24:33.650000-08:00",
"status": {
"componentState": "REQUESTED",
"message": "NONE",
"errors": {}
}
}
```
Weitere Informationen finden Sie unter [Erstellen von benutzerdefinierten Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-components.html) und [Hochladen von Komponenten zur Bereitstellung](https://docs.aws.amazon.com/greengrass/v2/developerguide/upload-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
**Beispiel 2: So erstellen Sie eine Komponentenversion aus einer AWS Lambda-Funktion**
Im folgenden `create-component-version` Beispiel wird eine Version einer Hello World-Komponente aus einer AWS Lambda-Funktion erstellt.
```
aws greengrassv2 create-component-version \
--cli-input-json file://lambda-function-component.json
```
Inhalt von `lambda-function-component.json`:
```
{
"lambdaFunction": {
"lambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:HelloWorldPythonLambda:1",
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.0",
"componentLambdaParameters": {
"eventSources": [
{
"topic": "hello/world/+",
"type": "IOT_CORE"
}
]
}
}
}
```
Ausgabe:
```
{
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.0",
"creationTimestamp": "2021-01-07T17:05:27.347000-08:00",
"status": {
"componentState": "REQUESTED",
"message": "NONE",
"errors": {}
}
}
```
Weitere Informationen finden Sie unter [Ausführen von AWS Lambda-Funktionen](https://docs.aws.amazon.com/greengrass/v2/developerguide/run-lambda-functions.html) im *AWS IoT Greengrass V2 Developer Guide*.
+ Einzelheiten zur API finden Sie unter [CreateComponentVersion AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/create-component-version.html)*Befehlsreferenz*.
### `create-deployment`
Das folgende Codebeispiel zeigt die Verwendung`create-deployment`.
**AWS CLI**
**Beispiel 1: So erstellen Sie eine Bereitstellung**
Im folgenden `create-deployment` Beispiel wird die AWS IoT Greengrass-Befehlszeilenschnittstelle auf einem Kerngerät bereitgestellt.
```
aws greengrassv2 create-deployment \
--cli-input-json file://cli-deployment.json
```
Inhalt von `cli-deployment.json`:
```
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
"deploymentName": "Deployment for MyGreengrassCore",
"components": {
"aws.greengrass.Cli": {
"componentVersion": "2.0.3"
}
},
"deploymentPolicies": {
"failureHandlingPolicy": "DO_NOTHING",
"componentUpdatePolicy": {
"timeoutInSeconds": 60,
"action": "NOTIFY_COMPONENTS"
},
"configurationValidationPolicy": {
"timeoutInSeconds": 60
}
},
"iotJobConfiguration": {}
}
```
Ausgabe:
```
{
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-deployments.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
**Beispiel 2: So erstellen Sie eine Bereitstellung, die Komponentenkonfigurationen aktualisiert**
Im folgenden `create-deployment` Beispiel wird die Nucleus-Komponente AWS IoT Greengrass für eine Gruppe von Kerngeräten bereitgestellt. Bei dieser Bereitstellung werden für die Nucleus-Komponente die folgenden Konfigurationsupdates angewendet:
Setzt die Proxy-Einstellungen der Zielgeräte auf die Standardeinstellungen ohne Proxy zurück. Setzt die MQTT-Einstellungen der Zielgeräte auf ihre Standardwerte zurück. Legt die JVM-Optionen für die JVM des Nucleus fest. Legt die Protokollierungsebene für den Nucleus fest.
```
aws greengrassv2 create-deployment \
--cli-input-json file://nucleus-deployment.json
```
Inhalt von `nucleus-deployment.json`:
```
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
"deploymentName": "Deployment for MyGreengrassCoreGroup",
"components": {
"aws.greengrass.Nucleus": {
"componentVersion": "2.0.3",
"configurationUpdate": {
"reset": [
"/networkProxy",
"/mqtt"
],
"merge": "{\"jvmOptions\":\"-Xmx64m\",\"logging\":{\"level\":\"WARN\"}}"
}
}
},
"deploymentPolicies": {
"failureHandlingPolicy": "ROLLBACK",
"componentUpdatePolicy": {
"timeoutInSeconds": 60,
"action": "NOTIFY_COMPONENTS"
},
"configurationValidationPolicy": {
"timeoutInSeconds": 60
}
},
"iotJobConfiguration": {}
}
```
Ausgabe:
```
{
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}
```
Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-deployments.html) und [Aktualisieren von Komponentenkonfigurationen](https://docs.aws.amazon.com/greengrass/v2/developerguide/update-component-configurations.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/create-deployment.html)in der *AWS CLI Befehlsreferenz*.
### `delete-component`
Das folgende Codebeispiel zeigt die Verwendung`delete-component`.
**AWS CLI**
**So löschen Sie eine Komponentenversion**
Im folgenden Beispiel für `delete-component` wird eine Hello-World-Komponente gelöscht.
```
aws greengrassv2 delete-component \
--arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [DeleteComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/delete-component.html)in der *AWS CLI Befehlsreferenz*.
### `delete-core-device`
Das folgende Codebeispiel zeigt die Verwendung`delete-core-device`.
**AWS CLI**
**So löschen Sie ein Kerngerät**
Im folgenden `delete-core-device` Beispiel wird ein AWS IoT-Greengrass-Core-Gerät gelöscht.
```
aws greengrassv2 delete-core-device \
--core-device-thing-name MyGreengrassCore
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden [Sie unter Deinstallieren der AWS IoT Greengrass Core-Software](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#uninstall-greengrass-core-v2) im *AWS IoT Greengrass V2 Developer Guide*.
+ Einzelheiten zur API finden Sie unter [DeleteCoreDevice AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/delete-core-device.html)*Befehlsreferenz*.
### `describe-component`
Das folgende Codebeispiel zeigt die Verwendung`describe-component`.
**AWS CLI**
**So beschreiben Sie eine Komponentenversion**
Im folgenden Beispiel für `describe-component` wird eine Hello-World-Komponente beschrieben.
```
aws greengrassv2 describe-component \
--arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0
```
Ausgabe:
```
{
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.0",
"creationTimestamp": "2021-01-07T17:12:11.133000-08:00",
"publisher": "Amazon",
"description": "My first AWS IoT Greengrass component.",
"status": {
"componentState": "DEPLOYABLE",
"message": "NONE",
"errors": {}
},
"platforms": [
{
"attributes": {
"os": "linux"
}
}
]
}
```
Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [DescribeComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/describe-component.html)in der *AWS CLI Befehlsreferenz*.
### `disassociate-service-role-from-account`
Das folgende Codebeispiel zeigt die Verwendung`disassociate-service-role-from-account`.
**AWS CLI**
**Um die Greengrass-Servicerolle von Ihrem Konto zu trennen AWS **
Im folgenden `disassociate-service-role-from-account` Beispiel wird die Greengrass-Servicerolle für Ihr Konto von AWS IoT Greengrass getrennt. AWS
```
aws greengrassv2 disassociate-service-role-from-account
```
Ausgabe:
```
{
"disassociatedAt": "2022-01-19T19:26:09Z"
}
```
Weitere Informationen finden Sie unter [Greengrass-Servicerolle](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) im *Entwicklerhandbuch für AWS IoT Greengrass*.
+ *Einzelheiten zur API finden Sie unter Befehlsreferenz [DisassociateServiceRoleFromAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/disassociate-service-role-from-account.html).AWS CLI *
### `get-component-version-artifact`
Das folgende Codebeispiel zeigt die Verwendung`get-component-version-artifact`.
**AWS CLI**
**So rufen Sie eine URL zum Herunterladen eines Komponentenartefakts ab**
Im folgenden Beispiel für `get-component-version-artifact` wird eine URL zum Herunterladen der JAR-Datei der lokalen Debug-Konsolenkomponente abgerufen.
```
aws greengrassv2 get-component-version-artifact \
--arn arn:aws:greengrass:us-west-2:aws:components:aws.greengrass.LocalDebugConsole:versions:2.0.3 \
--artifact-name "Uvt6ZEzQ9TKiAuLbfXBX_APdY0TWks3uc46tHFHTzBM=/aws.greengrass.LocalDebugConsole.jar"
```
Ausgabe:
```
{
"preSignedUrl": "https://evergreencomponentmanageme-artifactbucket7410c9ef-g18n1iya8kwr.s3.us-west-2.amazonaws.com/public/aws.greengrass.LocalDebugConsole/2.0.3/s3/ggv2-component-releases-prod-pdx/EvergreenHttpDebugView/2ffc496ba41b39568968b22c582b4714a937193ee7687a45527238e696672521/aws.greengrass.LocalDebugConsole/aws.greengrass.LocalDebugConsole.jar?X-Amz-Security-Token=KwfLKSdEXAMPLE..."
}
```
Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [GetComponentVersionArtifact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-component-version-artifact.html)in der *AWS CLI Befehlsreferenz*.
### `get-component`
Das folgende Codebeispiel zeigt die Verwendung`get-component`.
**AWS CLI**
**Beispiel 1: So laden Sie das Rezept einer Komponente im YAML-Format (Linux, macOS oder Unix) herunter)**
Im folgenden Beispiel für `get-component` wird das Rezept einer Hello-World-Komponente im YAML-Format in eine Datei heruntergeladen. Der Befehl hat folgende Auswirkungen:
Verwendet die Parameter `--output` und `--query`, um die Ausgabe des Befehls zu steuern. Diese Parameter extrahieren den Rezept-Blob aus der Ausgabe des Befehls. Weitere Informationen zum Steuern der Ausgabe finden Sie unter [Steuern der Befehlsausgabe](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) im *Benutzerhandbuch für die AWS -Befehlszeilenschnittstelle*. Verwendet das Dienstprogramm `base64`. Dieses Tool dekodiert den extrahierten Blob in den Originaltext. Bei dem Blob, der von einem erfolgreichen `get-component`-Befehl zurückgegeben wird, handelt es sich um base64-kodierten Text. Sie müssen dieses Blob dekodieren, um den Originaltext zu erhalten.Speichert den dekodierten Text in einer Datei. Der letzte Abschnitt des Befehls (`> com.example.HelloWorld-1.0.0.json`) speichert den dekodierten Text in einer Datei.
```
aws greengrassv2 get-component \
--arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0 \
--recipe-output-format YAML \
--query recipe \
--output text | base64 --decode > com.example.HelloWorld-1.0.0.json
```
Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
**Beispiel 2: So laden Sie das Rezept einer Komponente im YAML-Format (Windows CMD) herunter**
Im folgenden Beispiel für `get-component` wird das Rezept einer Hello-World-Komponente im YAML-Format in eine Datei heruntergeladen. Dieser Befehl verwendet das Dienstprogramm `certutil`.
```
aws greengrassv2 get-component ^
--arn arn:aws:greengrass:us-west-2:675946970638:components:com.example.HelloWorld:versions:1.0.0 ^
--recipe-output-format YAML ^
--query recipe ^
--output text > com.example.HelloWorld-1.0.0.yaml.b64
certutil -decode com.example.HelloWorld-1.0.0.yaml.b64 com.example.HelloWorld-1.0.0.yaml
```
Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
**Beispiel 3: Um das Rezept einer Komponente im YAML-Format herunterzuladen (Windows PowerShell)**
Im folgenden Beispiel für `get-component` wird das Rezept einer Hello-World-Komponente im YAML-Format in eine Datei heruntergeladen. Dieser Befehl verwendet das Dienstprogramm `certutil`.
```
aws greengrassv2 get-component `
--arn arn:aws:greengrass:us-west-2:675946970638:components:com.example.HelloWorld:versions:1.0.0 `
--recipe-output-format YAML `
--query recipe `
--output text > com.example.HelloWorld-1.0.0.yaml.b64
certutil -decode com.example.HelloWorld-1.0.0.yaml.b64 com.example.HelloWorld-1.0.0.yaml
```
Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [GetComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-component.html)in der *AWS CLI Befehlsreferenz.*
### `get-connectivity-info`
Das folgende Codebeispiel zeigt die Verwendung`get-connectivity-info`.
**AWS CLI**
**So rufen Sie die Verbindungsinformationen für ein Greengrass-Kerngerät ab**
Im folgenden Beispiel für `get-connectivity-info` werden Verbindungsinformationen für ein Greengrass-Kerngerät abgerufen. Client-Geräte verwenden diese Informationen, um eine Verbindung mit dem MQTT-Broker herzustellen, der auf diesem Kerngerät ausgeführt wird.
```
aws greengrassv2 get-connectivity-info \
--thing-name MyGreengrassCore
```
Ausgabe:
```
{
"connectivityInfo": [
{
"id": "localIP_192.0.2.0",
"hostAddress": "192.0.2.0",
"portNumber": 8883
}
]
}
```
Weitere Informationen finden Sie unter [Verwalten von Endpunkten für Kerngeräte](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [GetConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-connectivity-info.html)in der *AWS CLI Befehlsreferenz*.
### `get-core-device`
Das folgende Codebeispiel zeigt die Verwendung`get-core-device`.
**AWS CLI**
**So rufen Sie ein Kerngerät ab**
Das folgende `get-core-device` Beispiel ruft Informationen über ein AWS IoT-Greengrass-Core-Gerät ab.
```
aws greengrassv2 get-core-device \
--core-device-thing-name MyGreengrassCore
```
Ausgabe:
```
{
"coreDeviceThingName": "MyGreengrassCore",
"coreVersion": "2.0.3",
"platform": "linux",
"architecture": "amd64",
"status": "HEALTHY",
"lastStatusUpdateTimestamp": "2021-01-08T04:57:58.838000-08:00",
"tags": {}
}
```
Weitere Informationen finden Sie unter [Überprüfen des Status eines Kerngeräts](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [GetCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-core-device.html)in der *AWS CLI Befehlsreferenz.*
### `get-deployment`
Das folgende Codebeispiel zeigt die Verwendung`get-deployment`.
**AWS CLI**
**So rufen Sie eine Bereitstellung ab**
Das folgende `get-deployment` Beispiel enthält Informationen zur Bereitstellung der AWS IoT Greengrass Nucleus-Komponente auf einer Gruppe von Kerngeräten.
```
aws greengrassv2 get-deployment \
--deployment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
"revisionId": "14",
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"deploymentName": "Deployment for MyGreengrassCoreGroup",
"deploymentStatus": "ACTIVE",
"iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"components": {
"aws.greengrass.Nucleus": {
"componentVersion": "2.0.3",
"configurationUpdate": {
"merge": "{\"jvmOptions\":\"-Xmx64m\",\"logging\":{\"level\":\"WARN\"}}",
"reset": [
"/networkProxy",
"/mqtt"
]
}
}
},
"deploymentPolicies": {
"failureHandlingPolicy": "ROLLBACK",
"componentUpdatePolicy": {
"timeoutInSeconds": 60,
"action": "NOTIFY_COMPONENTS"
},
"configurationValidationPolicy": {
"timeoutInSeconds": 60
}
},
"iotJobConfiguration": {},
"creationTimestamp": "2021-01-07T17:21:20.691000-08:00",
"isLatestForTarget": false,
"tags": {}
}
```
Weitere Informationen finden Sie unter [Bereitstellen von Komponenten auf Geräten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-deployment.html)in der *AWS CLI Befehlsreferenz.*
### `get-service-role-for-account`
Das folgende Codebeispiel zeigt die Verwendung`get-service-role-for-account`.
**AWS CLI**
**Um die Greengrass-Servicerolle für Ihr Konto zu AWS erhalten**
Im folgenden `get-service-role-for-account` Beispiel wird die Servicerolle abgerufen, die AWS IoT Greengrass für Ihr AWS Konto zugeordnet ist.
```
aws greengrassv2 get-service-role-for-account
```
Ausgabe:
```
{
"associatedAt": "2022-01-19T19:21:53Z",
"roleArn": "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole"
}
```
Weitere Informationen finden Sie unter [Greengrass-Servicerolle](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) im *Entwicklerhandbuch für AWS IoT Greengrass*.
+ Einzelheiten zur API finden Sie unter [GetServiceRoleForAccount AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-service-role-for-account.html)*Befehlsreferenz.*
### `list-client-devices-associated-with-core-device`
Das folgende Codebeispiel zeigt die Verwendung`list-client-devices-associated-with-core-device`.
**AWS CLI**
**So listen Sie die Client-Geräte auf, die mit einem Kerngerät verknüpft sind**
Im folgenden Beispiel für `list-client-devices-associated-with-core-device` werden alle Client-Geräte aufgelistet, die mit einem Kerngerät verknüpft sind.
```
aws greengrassv2 list-client-devices-associated-with-core-device \
--core-device-thing-name MyTestGreengrassCore
```
Ausgabe:
```
{
"associatedClientDevices": [
{
"thingName": "MyClientDevice2",
"associationTimestamp": "2021-07-12T16:33:55.843000-07:00"
},
{
"thingName": "MyClientDevice1",
"associationTimestamp": "2021-07-12T16:33:55.843000-07:00"
}
]
}
```
Weitere Informationen finden Sie unter [Mit lokalen IoT-Geräten interagieren](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [ListClientDevicesAssociatedWithCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-client-devices-associated-with-core-device.html)in der *AWS CLI Befehlsreferenz*.
### `list-component-versions`
Das folgende Codebeispiel zeigt die Verwendung`list-component-versions`.
**AWS CLI**
**So listen Sie die Versionen einer Komponente auf**
Im folgenden Beispiel für `list-component-versions` werden alle Versionen einer Hello-World-Komponente aufgelistet.
```
aws greengrassv2 list-component-versions \
--arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld
```
Ausgabe:
```
{
"componentVersions": [
{
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.1",
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.1"
},
{
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.0",
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0"
}
]
}
```
Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [ListComponentVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-component-versions.html)in der *AWS CLI Befehlsreferenz*.
### `list-components`
Das folgende Codebeispiel zeigt die Verwendung`list-components`.
**AWS CLI**
**So listen Sie Komponenten auf**
Das folgende `list-components` Beispiel listet jede Komponente und ihre neueste Version auf, die in Ihrem AWS Konto in der aktuellen Region definiert ist.
```
aws greengrassv2 list-components
```
Ausgabe:
```
{
"components": [
{
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld",
"componentName": "com.example.HelloWorld",
"latestVersion": {
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.1",
"componentVersion": "1.0.1",
"creationTimestamp": "2021-01-08T16:51:07.352000-08:00",
"description": "My first AWS IoT Greengrass component.",
"publisher": "Amazon",
"platforms": [
{
"attributes": {
"os": "linux"
}
}
]
}
}
]
}
```
Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [ListComponents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-components.html)unter *AWS CLI Befehlsreferenz*.
### `list-core-devices`
Das folgende Codebeispiel zeigt die Verwendung`list-core-devices`.
**AWS CLI**
**So listen Sie Kerngeräte auf**
Das folgende `list-core-devices` Beispiel listet die AWS IoT-Greengrass-Kerngeräte in Ihrem AWS Konto in der aktuellen Region auf.
```
aws greengrassv2 list-core-devices
```
Ausgabe:
```
{
"coreDevices": [
{
"coreDeviceThingName": "MyGreengrassCore",
"status": "HEALTHY",
"lastStatusUpdateTimestamp": "2021-01-08T04:57:58.838000-08:00"
}
]
}
```
Weitere Informationen finden Sie unter [Überprüfen des Status eines Kerngeräts](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [ListCoreDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-core-devices.html)in der *AWS CLI Befehlsreferenz.*
### `list-deployments`
Das folgende Codebeispiel zeigt die Verwendung`list-deployments`.
**AWS CLI**
**So listen Sie Bereitstellungen auf**
Das folgende `list-deployments` Beispiel listet die neueste Version jeder Bereitstellung auf, die in Ihrem AWS Konto in der aktuellen Region definiert ist.
```
aws greengrassv2 list-deployments
```
Ausgabe:
```
{
"deployments": [
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
"revisionId": "14",
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"deploymentName": "Deployment for MyGreengrassCoreGroup",
"creationTimestamp": "2021-01-07T17:21:20.691000-08:00",
"deploymentStatus": "ACTIVE",
"isLatestForTarget": false
},
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
"revisionId": "1",
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"deploymentName": "Deployment for MyGreengrassCore",
"creationTimestamp": "2021-01-06T16:10:42.407000-08:00",
"deploymentStatus": "COMPLETED",
"isLatestForTarget": false
}
]
}
```
Weitere Informationen finden Sie unter [Bereitstellen von Komponenten auf Geräten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-deployments.html)unter *AWS CLI Befehlsreferenz*.
### `list-effective-deployments`
Das folgende Codebeispiel zeigt die Verwendung`list-effective-deployments`.
**AWS CLI**
**So listen Sie Bereitstellungsaufträge auf**
Das folgende `list-effective-deployments` Beispiel listet die Bereitstellungen auf, die für ein AWS IoT-Greengrass-Core-Gerät gelten.
```
aws greengrassv2 list-effective-deployments \
--core-device-thing-name MyGreengrassCore
```
Ausgabe:
```
{
"effectiveDeployments": [
{
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"deploymentName": "Deployment for MyGreengrassCore",
"iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
"coreDeviceExecutionStatus": "COMPLETED",
"reason": "SUCCESSFUL",
"creationTimestamp": "2021-01-06T16:10:42.442000-08:00",
"modifiedTimestamp": "2021-01-08T17:21:27.830000-08:00"
},
{
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"deploymentName": "Deployment for MyGreengrassCoreGroup",
"iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444",
"iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE44444",
"targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
"coreDeviceExecutionStatus": "SUCCEEDED",
"reason": "SUCCESSFUL",
"creationTimestamp": "2021-01-07T17:19:20.394000-08:00",
"modifiedTimestamp": "2021-01-07T17:21:20.721000-08:00"
}
]
}
```
Weitere Informationen finden Sie unter [Überprüfen des Status eines Kerngeräts](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [ListEffectiveDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-effective-deployments.html)unter *AWS CLI Befehlsreferenz*.
### `list-installed-components`
Das folgende Codebeispiel zeigt die Verwendung`list-installed-components`.
**AWS CLI**
**So listen Sie Komponenten auf, die auf einem Kerngerät installiert sind**
Das folgende `list-installed-components` Beispiel listet die Komponenten auf, die auf einem AWS IoT Greengrass-Core-Gerät installiert sind.
```
aws greengrassv2 list-installed-components \
--core-device-thing-name MyGreengrassCore
```
Ausgabe:
```
{
"installedComponents": [
{
"componentName": "aws.greengrass.Cli",
"componentVersion": "2.0.3",
"lifecycleState": "RUNNING",
"isRoot": true
},
{
"componentName": "aws.greengrass.Nucleus",
"componentVersion": "2.0.3",
"lifecycleState": "FINISHED",
"isRoot": true
}
]
}
```
Weitere Informationen finden Sie unter [Überprüfen des Status eines Kerngeräts](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie unter [ListInstalledComponents AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-installed-components.html)*Befehlsreferenz.*
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`.
**AWS CLI**
**So listen Sie Tags für eine Ressource auf**
Das folgende `list-tags-for-resource` Beispiel listet alle Tags für ein AWS IoT Greengrass-Core-Gerät auf.
```
aws greengrassv2 list-tags-for-resource \
--resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore
```
Ausgabe:
```
{
"tags": {
"Owner": "richard-roe"
}
}
```
Weitere Informationen finden Sie unter [Eigene Ressourcen taggen](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-tags-for-resource.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**
Das folgende `tag-resource` Beispiel fügt einem AWS IoT-Greengrass-Core-Gerät ein Eigentümertag hinzu. Sie können dieses Tag verwenden, um den Zugriff auf das Kerngerät auf Basis dessen zu steuern, wem es gehört.
```
aws greengrassv2 tag-resource \
--resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore \
--tags Owner=richard-roe
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Eigene Ressourcen taggen](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie unter [TagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/tag-resource.html)*Befehlsreferenz.*
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-resource`.
**AWS CLI**
**So entfernen Sie ein Tag von einer Ressource**
Im folgenden `untag-resource` Beispiel wird ein Besitzer-Tag von einem AWS IoT-Greengrass-Core-Gerät entfernt.
```
aws iotsitewise untag-resource \
--resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore \
--tag-keys Owner
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Eigene Ressourcen taggen](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/untag-resource.html)in der *AWS CLI Befehlsreferenz.*
### `update-connectivity-info`
Das folgende Codebeispiel zeigt die Verwendung`update-connectivity-info`.
**AWS CLI**
**So aktualisieren Sie die Verbindungsinformationen für ein Greengrass-Kerngerät**
Im folgenden Beispiel für `update-connectivity-info` werden Verbindungsinformationen für ein Greengrass-Kerngerät abgerufen. Client-Geräte verwenden diese Informationen, um eine Verbindung mit dem MQTT-Broker herzustellen, der auf diesem Kerngerät ausgeführt wird.
```
aws greengrassv2 update-connectivity-info \
--thing-name MyGreengrassCore \
--cli-input-json file://core-device-connectivity-info.json
```
Inhalt von `core-device-connectivity-info.json`:
```
{
"connectivityInfo": [
{
"hostAddress": "192.0.2.0",
"portNumber": 8883,
"id": "localIP_192.0.2.0"
}
]
}
```
Ausgabe:
```
{
"version": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Weitere Informationen finden Sie unter [Verwalten von Endpunkten für Kerngeräte](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*.
+ Einzelheiten zur API finden Sie [UpdateConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/update-connectivity-info.html)in der *AWS CLI Befehlsreferenz*.