将服务相关角色用于 AWS IoT TwinMaker

AWS IoT TwinMaker 使用 AWS Identity and Access Management (IAM) 服务相关角色。服务相关角色是一种与之直接关联的独特IAM角色类型。 AWS IoT TwinMaker服务相关角色由服务预定义 AWS IoT TwinMaker ，包括该服务代表您调用其他 AWS 服务所需的所有权限。

服务相关角色使设置变得 AWS IoT TwinMaker 更加容易，因为您不必手动添加必要的权限。 AWS IoT TwinMaker 定义其服务相关角色的权限，除非另有定义，否则 AWS IoT TwinMaker 只能担任其角色。定义的权限包括信任策略和权限策略，并且该权限策略不能附加到任何其他IAM实体。

只有在首先删除相关资源后，您才能删除服务相关角色。这样可以保护您的 AWS IoT TwinMaker 资源，因为您不会无意中删除访问资源的权限。

有关支持服务相关角色的其他服务的信息，请参阅与服务关联角色配合使用的AWS 服务，IAM并在服务相关角色列中查找带有 “是” 的服务。选择是和链接，查看该服务的服务相关角色文档。

的服务相关角色权限 AWS IoT TwinMaker

AWS IoT TwinMaker 使用名为的服务相关角色 AWSServiceRoleForIoTTwinMaker— AWS IoT TwinMaker 允许代表您调用其他 AWS 服务并同步其资源。

AWSServiceRoleForIoTTwinMaker 服务相关角色信任以下服务来代入该角色：

• iottwinmaker.amazonaws.com

名为的角色权限策略 AWSIoTTwinMakerServiceRolePolicy AWS IoT TwinMaker 允许对指定资源完成以下操作：

• 操作：all your iotsitewise asset and asset-model resources 上的 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

您必须配置允许用户、组或角色创建、编辑或删除服务相关角色的权限。有关更多信息，请参阅《IAM用户指南》中的服务相关角色权限。

为创建服务相关角色 AWS IoT TwinMaker

您无需手动创建服务相关角色。当您在中同步 AWS IoT SiteWise 资产和资产模型（资产同步）时 AWS CLI，会 AWS API为您 AWS IoT TwinMaker 创建服务相关角色。 AWS Management Console

如果您删除该服务相关角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。当您同步 AWS IoT SiteWise 资产和资产模型（资产同步）时， AWS IoT TwinMaker 会再次为您创建服务相关角色。

您还可以使用IAM控制台通过 “IoT TwinMaker -托管角色” 用例创建服务相关角色。在 AWS CLI 或中 AWS API，使用服务名称创建服务相关角色。iottwinmaker.amazonaws.com有关更多信息，请参阅《IAM用户指南》中的创建服务相关角色。如果您删除了此服务相关角色，可以使用同样的过程再次创建角色。

编辑的服务相关角色 AWS IoT TwinMaker

AWS IoT TwinMaker 不允许您编辑 AWSServiceRoleForIoTTwinMaker 服务相关角色。创建服务相关角色后，将无法更改角色名称，因为可能有多个实体引用该角色。但是，您可以使用编辑角色的描述IAM。有关更多信息，请参阅《IAM用户指南》中的编辑服务相关角色。

删除的服务相关角色 AWS IoT TwinMaker

如果不再需要使用某个需要服务相关角色的功能或服务，我们建议您删除该角色。这样就没有未被主动监控或维护的未使用实体。但是，您必须先清理仍在使用您的服务相关角色的所有 serviceLinked-workspaces，然后才能手动删除该角色。

注意

如果您尝试删除资源时 AWS IoT TwinMaker 服务正在使用该角色，则删除可能会失败。如果发生这种情况，请等待几分钟后重试。

使用手动删除服务相关角色 IAM

使用IAM控制台 AWS CLI、或删除 AWSServiceRoleForIoTTwinMaker 服务相关角色。 AWS API有关更多信息，请参阅《IAM用户指南》中的删除服务相关角色。

AWS IoT TwinMaker 服务相关角色支持的区域

AWS IoT TwinMaker 支持在提供服务的所有区域中使用服务相关角色。有关更多信息，请参阅AWS 区域和端点。