Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS wird der Support für eingestellt. AWS IoT Greengrass Version 1 Nach dem 7. Oktober 2026 können Sie nicht mehr auf die Ressourcen zugreifen. AWS IoT Greengrass V1 Weitere Informationen finden Sie unter [Migrieren von AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). 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. # CloudFormation Unterstützung für AWS IoT Greengrass CloudFormation ist ein Service, der Sie bei der Erstellung, Verwaltung und Replikation Ihrer AWS Ressourcen unterstützen kann. Sie können CloudFormation Vorlagen verwenden, um AWS IoT Greengrass Gruppen und die Client-Geräte, Abonnements und andere Komponenten zu definieren, die Sie bereitstellen möchten. Ein Beispiel finden Sie unter [-Beispielvorlage](#cloudformation-support-example). Die Ressourcen und Infrastruktur, die Sie aus einer Vorlage generieren, wird als *Stack* bezeichnet. Sie können alle Ihre Ressourcen in einer Vorlage definieren oder auf Ressourcen von anderen Stacks verweisen. Weitere Informationen zu CloudFormation Vorlagen und Funktionen finden Sie unter [Was ist CloudFormation?](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) im *AWS CloudFormation Benutzerhandbuch*. ## Erstellen von -Ressourcen. CloudFormation Vorlagen sind JSON- oder YAML-Dokumente, die die Eigenschaften und Beziehungen von AWS Ressourcen beschreiben. Die folgenden AWS IoT Greengrass Ressourcen werden unterstützt: + Gruppen + Kerne + Client-Geräte (Geräte) + Lambda-Funktionen + Konnektoren + Ressourcen (lokal, Machine Learning und geheime Schlüssel) + Subscriptions (Abonnements) + Logger (Protokollierungskonfigurationen) In CloudFormation Vorlagen basieren Struktur und Syntax der Greengrass-Ressourcen auf der AWS IoT Greengrass API. Die [Beispielvorlage verknüpft beispielsweise](#cloudformation-support-example) eine oberste Ebene `DeviceDefinition` mit einer`DeviceDefinitionVersion`, die ein einzelnes Client-Gerät enthält. Weitere Informationen finden Sie unter [Überblick über das AWS IoT Greengrass Gruppenobjektmodell](deployments.md#api-overview). Die [Referenz zu den AWS IoT Greengrass Ressourcentypen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Greengrass.html) im *AWS CloudFormation Benutzerhandbuch* beschreibt die Greengrass-Ressourcen, mit CloudFormation denen Sie umgehen können. Wenn Sie CloudFormation Vorlagen verwenden, um Greengrass-Ressourcen zu erstellen, empfehlen wir, dass Sie diese nur von aus CloudFormation verwalten. Beispielsweise sollten Sie Ihre Vorlage aktualisieren, wenn Sie ein Gerät hinzufügen, ändern oder entfernen möchten (anstatt die AWS IoT Greengrass API oder AWS IoT Konsole zu verwenden). Auf diese Weise können Sie Rollback und andere Funktionen der CloudFormation -Änderungsverwaltung verwenden. Weitere Informationen CloudFormation zur Erstellung und Verwaltung Ihrer Ressourcen und Stacks finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [Arbeiten mit Stacks](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html). Eine exemplarische Vorgehensweise, die zeigt, wie Sie AWS IoT Greengrass Ressourcen in einer CloudFormation Vorlage erstellen und bereitstellen, finden Sie im offiziellen [Blog unter Automatisieren der AWS IoT Greengrass Einrichtung mit](https://aws.amazon.com/blogs/iot/automating-aws-iot-greengrass-setup-with-aws-cloudformation/) im CloudFormation Internet der Dinge. AWS ## Bereitstellen von Ressourcen Nachdem Sie einen CloudFormation Stack erstellt haben, der Ihre Gruppenversion enthält, können Sie ihn mit der AWS CLI AWS IoT OR-Konsole bereitstellen. **Anmerkung** Um eine Gruppe bereitzustellen, muss Ihnen eine Greengrass-Servicerolle zugeordnet sein. AWS-Konto Die Servicerolle ermöglicht AWS IoT Greengrass den Zugriff auf Ihre Ressourcen in AWS Lambda und anderen AWS Diensten. Diese Rolle sollte existieren, wenn Sie in der aktuellen AWS-Region Version bereits eine Greengrass-Gruppe bereitgestellt haben. Weitere Informationen finden Sie unter [Greengrass-Servicerolle](service-role.md). **So stellen Sie die Gruppe bereit (AWS CLI)** + Führen Sie den Befehl [https://docs.aws.amazon.com/greengrass/v1/apireference/createdeployment-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/createdeployment-post.html) aus. ``` aws greengrass create-deployment --group-id GroupId --group-version-id GroupVersionId --deployment-type NewDeployment ``` **Anmerkung** Die `CommandToDeployGroup` Anweisung in der [Beispielvorlage](#cloudformation-support-example) zeigt, wie Sie den Befehl mit Ihrer Gruppen- und Gruppenversion ausgeben, IDs wenn Sie einen Stack erstellen. **So stellen Sie die Gruppe bereit (Konsole)** 1. Erweitern Sie im Navigationsbereich der AWS IoT Konsole unter **Verwalten** die Option **Greengrass-Geräte** und wählen Sie dann **Gruppen (V1)** aus. 1. Wählen Sie Ihre Gruppe aus. 1. Wählen Sie auf der Seite mit der Gruppenkonfiguration die Option **Bereitstellen** aus. ## -Beispielvorlage Die folgende Beispielvorlage erstellt eine Greengrass-Gruppe, die einen Kern, ein Client-Gerät, eine Funktion, einen Logger, ein Abonnement und zwei Ressourcen enthält. Zu diesem Zweck folgt die Vorlage dem Objektmodell der AWS IoT Greengrass API. Beispielsweise sind die Client-Geräte, die Sie der Gruppe hinzufügen möchten, in einer `DeviceDefinitionVersion` Ressource enthalten, die einer `DeviceDefinition` Ressource zugeordnet ist. Wenn Sie der Gruppe die Geräte hinzufügen möchten, verweist die Gruppenversion auf den ARN von `DeviceDefinitionVersion`. Die Vorlage enthält Parameter, mit denen Sie das Zertifikat ARNs für den Kern und das Gerät sowie den Versions-ARN der Quell-Lambda-Funktion (bei der es sich um eine AWS Lambda Ressource handelt) angeben können. Es verwendet die `GetAtt` systemeigenen Funktionen, um auf, `Ref` und andere Attribute zu verweisen IDs ARNs, die für die Erstellung von Greengrass-Ressourcen erforderlich sind. Die Vorlage definiert auch zwei AWS IoT Geräte (Dinge), die das Core- und das Client-Gerät darstellen, die der Greengrass-Gruppe hinzugefügt werden. Nachdem Sie den Stack mit Ihren Greengrass-Ressourcen erstellt haben, können Sie die [Gruppe mithilfe der AWS IoT Konsole AWS CLI oder der Konsole bereitstellen](#cloudformation-support-deploy). **Anmerkung** Die `CommandToDeployGroup`-Anweisung im Beispiel zeigt, wie Sie einen kompletten **create-deployment**-CLI-Befehl ausgeben, mit dem Sie Ihre Gruppe bereitstellen können. ------ #### [ JSON ] ``` { "AWSTemplateFormatVersion": "2010-09-09", "Description": "AWS IoT Greengrass example template that creates a group version with a core, device, function, logger, subscription, and resources.", "Parameters": { "CoreCertificateArn": { "Type": "String" }, "DeviceCertificateArn": { "Type": "String" }, "LambdaVersionArn": { "Type": "String" } }, "Resources": { "TestCore1": { "Type": "AWS::IoT::Thing", "Properties": { "ThingName": "TestCore1" } }, "TestCoreDefinition": { "Type": "AWS::Greengrass::CoreDefinition", "Properties": { "Name": "DemoTestCoreDefinition" } }, "TestCoreDefinitionVersion": { "Type": "AWS::Greengrass::CoreDefinitionVersion", "Properties": { "CoreDefinitionId": { "Ref": "TestCoreDefinition" }, "Cores": [ { "Id": "TestCore1", "CertificateArn": { "Ref": "CoreCertificateArn" }, "SyncShadow": "false", "ThingArn": { "Fn::Join": [ ":", [ "arn:aws:iot", { "Ref": "AWS::Region" }, { "Ref": "AWS::AccountId" }, "thing/TestCore1" ] ] } } ] } }, "TestClientDevice1": { "Type": "AWS::IoT::Thing", "Properties": { "ThingName": "TestClientDevice1" } }, "TestDeviceDefinition": { "Type": "AWS::Greengrass::DeviceDefinition", "Properties": { "Name": "DemoTestDeviceDefinition" } }, "TestDeviceDefinitionVersion": { "Type": "AWS::Greengrass::DeviceDefinitionVersion", "Properties": { "DeviceDefinitionId": { "Fn::GetAtt": [ "TestDeviceDefinition", "Id" ] }, "Devices": [ { "Id": "TestClientDevice1", "CertificateArn": { "Ref": "DeviceCertificateArn" }, "SyncShadow": "true", "ThingArn": { "Fn::Join": [ ":", [ "arn:aws:iot", { "Ref": "AWS::Region" }, { "Ref": "AWS::AccountId" }, "thing/TestClientDevice1" ] ] } } ] } }, "TestFunctionDefinition": { "Type": "AWS::Greengrass::FunctionDefinition", "Properties": { "Name": "DemoTestFunctionDefinition" } }, "TestFunctionDefinitionVersion": { "Type": "AWS::Greengrass::FunctionDefinitionVersion", "Properties": { "FunctionDefinitionId": { "Fn::GetAtt": [ "TestFunctionDefinition", "Id" ] }, "DefaultConfig": { "Execution": { "IsolationMode": "GreengrassContainer" } }, "Functions": [ { "Id": "TestLambda1", "FunctionArn": { "Ref": "LambdaVersionArn" }, "FunctionConfiguration": { "Pinned": "true", "Executable": "run.exe", "ExecArgs": "argument1", "MemorySize": "512", "Timeout": "2000", "EncodingType": "binary", "Environment": { "Variables": { "variable1": "value1" }, "ResourceAccessPolicies": [ { "ResourceId": "ResourceId1", "Permission": "ro" }, { "ResourceId": "ResourceId2", "Permission": "rw" } ], "AccessSysfs": "false", "Execution": { "IsolationMode": "GreengrassContainer", "RunAs": { "Uid": "1", "Gid": "10" } } } } } ] } }, "TestLoggerDefinition": { "Type": "AWS::Greengrass::LoggerDefinition", "Properties": { "Name": "DemoTestLoggerDefinition" } }, "TestLoggerDefinitionVersion": { "Type": "AWS::Greengrass::LoggerDefinitionVersion", "Properties": { "LoggerDefinitionId": { "Ref": "TestLoggerDefinition" }, "Loggers": [ { "Id": "TestLogger1", "Type": "AWSCloudWatch", "Component": "GreengrassSystem", "Level": "INFO" } ] } }, "TestResourceDefinition": { "Type": "AWS::Greengrass::ResourceDefinition", "Properties": { "Name": "DemoTestResourceDefinition" } }, "TestResourceDefinitionVersion": { "Type": "AWS::Greengrass::ResourceDefinitionVersion", "Properties": { "ResourceDefinitionId": { "Ref": "TestResourceDefinition" }, "Resources": [ { "Id": "ResourceId1", "Name": "LocalDeviceResource", "ResourceDataContainer": { "LocalDeviceResourceData": { "SourcePath": "/dev/TestSourcePath1", "GroupOwnerSetting": { "AutoAddGroupOwner": "false", "GroupOwner": "TestOwner" } } } }, { "Id": "ResourceId2", "Name": "LocalVolumeResourceData", "ResourceDataContainer": { "LocalVolumeResourceData": { "SourcePath": "/dev/TestSourcePath2", "DestinationPath": "/volumes/TestDestinationPath2", "GroupOwnerSetting": { "AutoAddGroupOwner": "false", "GroupOwner": "TestOwner" } } } } ] } }, "TestSubscriptionDefinition": { "Type": "AWS::Greengrass::SubscriptionDefinition", "Properties": { "Name": "DemoTestSubscriptionDefinition" } }, "TestSubscriptionDefinitionVersion": { "Type": "AWS::Greengrass::SubscriptionDefinitionVersion", "Properties": { "SubscriptionDefinitionId": { "Ref": "TestSubscriptionDefinition" }, "Subscriptions": [ { "Id": "TestSubscription1", "Source": { "Fn::Join": [ ":", [ "arn:aws:iot", { "Ref": "AWS::Region" }, { "Ref": "AWS::AccountId" }, "thing/TestClientDevice1" ] ] }, "Subject": "TestSubjectUpdated", "Target": { "Ref": "LambdaVersionArn" } } ] } }, "TestGroup": { "Type": "AWS::Greengrass::Group", "Properties": { "Name": "DemoTestGroupNewName", "RoleArn": { "Fn::Join": [ ":", [ "arn:aws:iam:", { "Ref": "AWS::AccountId" }, "role/TestUser" ] ] }, "InitialVersion": { "CoreDefinitionVersionArn": { "Ref": "TestCoreDefinitionVersion" }, "DeviceDefinitionVersionArn": { "Ref": "TestDeviceDefinitionVersion" }, "FunctionDefinitionVersionArn": { "Ref": "TestFunctionDefinitionVersion" }, "SubscriptionDefinitionVersionArn": { "Ref": "TestSubscriptionDefinitionVersion" }, "LoggerDefinitionVersionArn": { "Ref": "TestLoggerDefinitionVersion" }, "ResourceDefinitionVersionArn": { "Ref": "TestResourceDefinitionVersion" } }, "Tags": { "KeyName0": "value", "KeyName1": "value", "KeyName2": "value" } } } }, "Outputs": { "CommandToDeployGroup": { "Value": { "Fn::Join": [ " ", [ "groupVersion=$(cut -d'/' -f6 <<<", { "Fn::GetAtt": [ "TestGroup", "LatestVersionArn" ] }, ");", "aws --region", { "Ref": "AWS::Region" }, "greengrass create-deployment --group-id", { "Ref": "TestGroup" }, "--deployment-type NewDeployment --group-version-id", "$groupVersion" ] ] } } } } ``` ------ #### [ YAML ] ``` AWSTemplateFormatVersion: 2010-09-09 Description: >- AWS IoT Greengrass example template that creates a group version with a core, device, function, logger, subscription, and resources. Parameters: CoreCertificateArn: Type: String DeviceCertificateArn: Type: String LambdaVersionArn: Type: String Resources: TestCore1: Type: 'AWS::IoT::Thing' Properties: ThingName: TestCore1 TestCoreDefinition: Type: 'AWS::Greengrass::CoreDefinition' Properties: Name: DemoTestCoreDefinition TestCoreDefinitionVersion: Type: 'AWS::Greengrass::CoreDefinitionVersion' Properties: CoreDefinitionId: !Ref TestCoreDefinition Cores: - Id: TestCore1 CertificateArn: !Ref CoreCertificateArn SyncShadow: 'false' ThingArn: !Join - ':' - - 'arn:aws:iot' - !Ref 'AWS::Region' - !Ref 'AWS::AccountId' - thing/TestCore1 TestClientDevice1: Type: 'AWS::IoT::Thing' Properties: ThingName: TestClientDevice1 TestDeviceDefinition: Type: 'AWS::Greengrass::DeviceDefinition' Properties: Name: DemoTestDeviceDefinition TestDeviceDefinitionVersion: Type: 'AWS::Greengrass::DeviceDefinitionVersion' Properties: DeviceDefinitionId: !GetAtt - TestDeviceDefinition - Id Devices: - Id: TestClientDevice1 CertificateArn: !Ref DeviceCertificateArn SyncShadow: 'true' ThingArn: !Join - ':' - - 'arn:aws:iot' - !Ref 'AWS::Region' - !Ref 'AWS::AccountId' - thing/TestClientDevice1 TestFunctionDefinition: Type: 'AWS::Greengrass::FunctionDefinition' Properties: Name: DemoTestFunctionDefinition TestFunctionDefinitionVersion: Type: 'AWS::Greengrass::FunctionDefinitionVersion' Properties: FunctionDefinitionId: !GetAtt - TestFunctionDefinition - Id DefaultConfig: Execution: IsolationMode: GreengrassContainer Functions: - Id: TestLambda1 FunctionArn: !Ref LambdaVersionArn FunctionConfiguration: Pinned: 'true' Executable: run.exe ExecArgs: argument1 MemorySize: '512' Timeout: '2000' EncodingType: binary Environment: Variables: variable1: value1 ResourceAccessPolicies: - ResourceId: ResourceId1 Permission: ro - ResourceId: ResourceId2 Permission: rw AccessSysfs: 'false' Execution: IsolationMode: GreengrassContainer RunAs: Uid: '1' Gid: '10' TestLoggerDefinition: Type: 'AWS::Greengrass::LoggerDefinition' Properties: Name: DemoTestLoggerDefinition TestLoggerDefinitionVersion: Type: 'AWS::Greengrass::LoggerDefinitionVersion' Properties: LoggerDefinitionId: !Ref TestLoggerDefinition Loggers: - Id: TestLogger1 Type: AWSCloudWatch Component: GreengrassSystem Level: INFO TestResourceDefinition: Type: 'AWS::Greengrass::ResourceDefinition' Properties: Name: DemoTestResourceDefinition TestResourceDefinitionVersion: Type: 'AWS::Greengrass::ResourceDefinitionVersion' Properties: ResourceDefinitionId: !Ref TestResourceDefinition Resources: - Id: ResourceId1 Name: LocalDeviceResource ResourceDataContainer: LocalDeviceResourceData: SourcePath: /dev/TestSourcePath1 GroupOwnerSetting: AutoAddGroupOwner: 'false' GroupOwner: TestOwner - Id: ResourceId2 Name: LocalVolumeResourceData ResourceDataContainer: LocalVolumeResourceData: SourcePath: /dev/TestSourcePath2 DestinationPath: /volumes/TestDestinationPath2 GroupOwnerSetting: AutoAddGroupOwner: 'false' GroupOwner: TestOwner TestSubscriptionDefinition: Type: 'AWS::Greengrass::SubscriptionDefinition' Properties: Name: DemoTestSubscriptionDefinition TestSubscriptionDefinitionVersion: Type: 'AWS::Greengrass::SubscriptionDefinitionVersion' Properties: SubscriptionDefinitionId: !Ref TestSubscriptionDefinition Subscriptions: - Id: TestSubscription1 Source: !Join - ':' - - 'arn:aws:iot' - !Ref 'AWS::Region' - !Ref 'AWS::AccountId' - thing/TestClientDevice1 Subject: TestSubjectUpdated Target: !Ref LambdaVersionArn TestGroup: Type: 'AWS::Greengrass::Group' Properties: Name: DemoTestGroupNewName RoleArn: !Join - ':' - - 'arn:aws:iam:' - !Ref 'AWS::AccountId' - role/TestUser InitialVersion: CoreDefinitionVersionArn: !Ref TestCoreDefinitionVersion DeviceDefinitionVersionArn: !Ref TestDeviceDefinitionVersion FunctionDefinitionVersionArn: !Ref TestFunctionDefinitionVersion SubscriptionDefinitionVersionArn: !Ref TestSubscriptionDefinitionVersion LoggerDefinitionVersionArn: !Ref TestLoggerDefinitionVersion ResourceDefinitionVersionArn: !Ref TestResourceDefinitionVersion Tags: KeyName0: value KeyName1: value KeyName2: value Outputs: CommandToDeployGroup: Value: !Join - ' ' - - groupVersion=$(cut -d'/' -f6 <<< - !GetAtt - TestGroup - LatestVersionArn - ); - aws --region - !Ref 'AWS::Region' - greengrass create-deployment --group-id - !Ref TestGroup - '--deployment-type NewDeployment --group-version-id' - $groupVersion ``` ------ ## Unterstützt s AWS-Region Derzeit können Sie AWS IoT Greengrass Ressourcen nur in den folgenden [AWS-Region s](https://docs.aws.amazon.com/general/latest/gr/greengrass.html) erstellen und verwalten: + US East (Ohio) + USA Ost (Nord-Virginia) + USA West (Oregon) + Asia Pacific (Mumbai) + Asia Pacific (Seoul) + Asien-Pazifik (Singapur) + Asien-Pazifik (Sydney) + Asien-Pazifik (Tokio) + China (Peking) + Europe (Frankfurt) + Europa (Irland) + Europa (London) + AWS GovCloud (US-West)