本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 将服务相关角色用于 AWS IoT TwinMaker
<a name="using-service-linked-roles"></a>

AWS IoT TwinMaker 使用 AWS Identity and Access Management (IAM) [服务相关角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)。服务相关角色是一种与之直接关联的 IAM 角色的独特类型。 AWS IoT TwinMaker Service-linked 角色由预定义 AWS IoT TwinMaker ，包括该服务代表您调用其他 AWS 服务所需的所有权限。

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

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

有关支持服务相关角色的其他服务的信息，请参阅与 [IAM 配合使用的AWS 服务，](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)并在**Service-linked 角色**列中查找带有 “**是**” 的服务。请选择**是**与查看该服务的服务关联角色文档的链接。

## Service-linked 的角色权限 AWS IoT TwinMaker
<a name="slr-permissions"></a>

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 用户指南*中的[Service-linked 角色权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

## 为 创建服务相关角色 AWS IoT TwinMaker
<a name="create-slr"></a>

您无需手动创建服务关联角色。当您在 AWS 管理控制台、或 AWS API 中同步 AWS IoT SiteWise 资产和资产模型（资产同步）时， AWS IoT TwinMaker 会为您创建服务相关角色。 AWS CLI

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

您还可以使用 IAM 控制台通过 **“IoT TwinMaker -托管角色” 用例创建服务相关角色**。在 AWS CLI 或 AWS API 中，使用服务名称创建服务相关角色。`iottwinmaker.amazonaws.com`有关更多信息，请参阅 *IAM 用户指南* 中的[创建服务相关角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role)。如果您删除了此服务相关角色，可以使用同样的过程再次创建角色。

## 为 编辑服务相关角色 AWS IoT TwinMaker
<a name="edit-slr"></a>

AWS IoT TwinMaker 不允许您编辑 AWSServiceRoleForIoTTwinMaker 服务相关角色。创建服务关联角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。有关更多信息，请参阅《IAM 用户指南》**中的[编辑服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。

## 删除 的服务相关角色 AWS IoT TwinMaker
<a name="delete-slr"></a>

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

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

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

使用 IAM 控制台 AWS CLI、或 AWS API 删除 AWSServiceRoleForIoTTwinMaker 服务相关角色。有关更多信息，请参阅《IAM 用户指南》**中的[删除服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。

## 支持的区域 AWS IoT TwinMaker 服务关联角色
<a name="slr-regions"></a>

AWS IoT TwinMaker 支持在提供服务的所有地区使用服务相关角色。有关更多信息，请参阅[AWS 区域和端点](https://docs.aws.amazon.com/general/latest/gr/iot-twinmaker.html)。