Verwenden von serviceverknüpften Rollen für AWS IoT TwinMaker

AWS IoT TwinMaker verwendet AWS Identity and Access Management (IAM) serviceverknüpfte Rollen. Eine serviceverknüpfte Rolle ist ein einzigartiger Typ von IAM-Rolle, mit der direkt verknüpft ist. AWS IoT TwinMaker Mit Diensten verknüpfte Rollen sind vordefiniert AWS IoT TwinMaker und enthalten alle Berechtigungen, die der Dienst benötigt, um andere AWS Dienste in Ihrem Namen aufzurufen.

Eine dienstbezogene Rolle AWS IoT TwinMaker erleichtert die Einrichtung, da Sie die erforderlichen Berechtigungen nicht manuell hinzufügen müssen. AWS IoT TwinMaker definiert die Berechtigungen ihrer dienstbezogenen Rollen und AWS IoT TwinMaker kann, sofern nicht anders definiert, nur ihre Rollen übernehmen. Die definierten Berechtigungen umfassen die Vertrauens- und Berechtigungsrichtlinie. Diese Berechtigungsrichtlinie kann keinen anderen IAM-Entitäten zugewiesen werden.

Sie können eine serviceverknüpfte Rolle erst löschen, nachdem ihre verwandten Ressourcen gelöscht wurden. Dadurch werden Ihre AWS IoT TwinMaker Ressourcen geschützt, da Sie nicht versehentlich die Zugriffsberechtigung für die Ressourcen entziehen können.

Informationen zu anderen Services, die serviceorientierte Rollen unterstützen, finden Sie unter AWS services that work with IAM (-Services, die mit IAM funktionieren). Suchen Sie nach den Services, für die Yes (Ja) in der Spalte Service-linked roles (Serviceorientierte Rollen) angegeben ist. Wählen Sie über einen Link Ja aus, um die Dokumentation zu einer serviceverknüpften Rolle für diesen Service anzuzeigen.

Mit dem Dienst verknüpfte Rollenberechtigungen für AWS IoT TwinMaker

AWS IoT TwinMaker verwendet die dienstbezogene Rolle mit dem Namen AWSServiceRoleForIoTTwinMaker— Ermöglicht AWS IoT TwinMaker das Aufrufen anderer AWS Dienste und das Synchronisieren ihrer Ressourcen in Ihrem Namen.

Die AWSServiceRoleForIoTTwinMaker dienstgebundene Rolle vertraut darauf, dass die folgenden Dienste die Rolle übernehmen:

• iottwinmaker.amazonaws.com

Die genannte Rollenberechtigungsrichtlinie AWSIoTTwinMakerServiceRolePolicy ermöglicht es AWS IoT TwinMaker , die folgenden Aktionen für die angegebenen Ressourcen durchzuführen:

• Aktion: iotsitewise:DescribeAsset, iotsitewise:ListAssets, iotsitewise:DescribeAssetModel, and iotsitewise:ListAssetModels, iottwinmaker:GetEntity, iottwinmaker:CreateEntity, iottwinmaker:UpdateEntity, iottwinmaker:DeleteEntity, iottwinmaker:ListEntities, iottwinmaker:GetComponentType, iottwinmaker:CreateComponentType, iottwinmaker:UpdateComponentType, iottwinmaker:DeleteComponentType, iottwinmaker:ListComponentTypes für all your iotsitewise asset and asset-model resources

Sie müssen Berechtigungen konfigurieren, damit eine Benutzer, Gruppen oder Rollen eine serviceverknüpfte Rolle erstellen, bearbeiten oder löschen können. Weitere Informationen finden Sie unter serviceverknüpfte Rollenberechtigung im IAM-Benutzerhandbuch.

Erstellen einer dienstbezogenen Rolle für AWS IoT TwinMaker

Sie müssen eine serviceverknüpfte Rolle nicht manuell erstellen. Wenn Sie Ihre AWS IoT SiteWise Assets und Asset-Modelle (Asset-Synchronisierung) in der AWS Management Console, der oder der AWS API synchronisieren AWS CLI, AWS IoT TwinMaker wird die serviceverknüpfte Rolle für Sie erstellt.

Wenn Sie diese serviceverknüpfte Rolle löschen und sie dann erneut erstellen müssen, können Sie dasselbe Verfahren anwenden, um die Rolle in Ihrem Konto neu anzulegen. Wenn Sie Ihre AWS IoT SiteWise Assets und Asset-Modelle synchronisieren (Asset-Synchronisierung), AWS IoT TwinMaker wird die dienstbezogene Rolle erneut für Sie erstellt.

Sie können die IAM-Konsole auch verwenden, um eine serviceverknüpfte Rolle mit dem Anwendungsfall „IoT TwinMaker — Managed Role“ zu erstellen. Erstellen Sie in der AWS CLI oder der AWS API eine serviceverknüpfte Rolle mit dem iottwinmaker.amazonaws.com Dienstnamen. Weitere Informationen finden Sie unter Erstellen einer serviceverknüpften Rolle im IAM-Benutzerhandbuch. Wenn Sie diese serviceverknüpfte Rolle löschen, können Sie mit demselben Verfahren die Rolle erneut erstellen.

Bearbeiten einer dienstbezogenen Rolle für AWS IoT TwinMaker

AWS IoT TwinMaker erlaubt es Ihnen nicht, die AWSServiceRoleForIoTTwinMaker dienstbezogene Rolle zu bearbeiten. Da möglicherweise verschiedene Entitäten auf die Rolle verweisen, kann der Rollenname nach dem Erstellen einer serviceverknüpften Rolle nicht mehr geändert werden. Sie können jedoch die Beschreibung der Rolle mit IAM bearbeiten. Weitere Informationen finden Sie unter Bearbeiten einer serviceverknüpften Rolle im IAM-Benutzerhandbuch.

Löschen einer dienstbezogenen Rolle für AWS IoT TwinMaker

Wenn Sie ein Feature oder einen Dienst, die bzw. der eine serviceverknüpften Rolle erfordert, nicht mehr benötigen, sollten Sie diese Rolle löschen. Auf diese Weise haben Sie keine ungenutzte juristische Stelle, die nicht aktiv überwacht oder verwaltet wird. Sie müssen jedoch alle ServiceLinked-Workspaces bereinigen, die Ihre serviceverknüpfte Rolle noch verwenden, bevor Sie die Rolle manuell löschen können.

Anmerkung

Wenn der AWS IoT TwinMaker Dienst die Rolle verwendet, wenn Sie versuchen, die Ressourcen zu löschen, schlägt das Löschen möglicherweise fehl. Wenn dies passiert, warten Sie einige Minuten und versuchen Sie es erneut.

So löschen Sie die serviceverknüpfte Rolle mit IAM

Verwenden Sie die IAM-Konsole, die oder die AWS API AWS CLI, um die AWSServiceRoleForIoTTwinMaker dienstverknüpfte Rolle zu löschen. Weitere Informationen finden Sie unter Löschen einer serviceverknüpften Rolle im IAM-Benutzerhandbuch.

Unterstützte Regionen für serviceverknüpfte Rollen AWS IoT TwinMaker

AWS IoT TwinMaker unterstützt die Verwendung von dienstbezogenen Rollen in allen Regionen, in denen der Dienst verfügbar ist. Weitere Informationen finden Sie unter AWS Regionen und Endpunkte.