将服务相关角色用于 Amazon IoT SiteWise - Amazon IoT SiteWise
Amazon IoT SiteWise 的服务相关角色权限为 Amazon IoT SiteWise 创建服务相关角色为 Amazon IoT SiteWise 编辑服务相关角色删除 Amazon IoT SiteWise 的服务相关角色Amazon IoT SiteWise 服务相关角色的受支持区域
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

将服务相关角色用于 Amazon IoT SiteWise

Amazon IoT SiteWise 使用 Amazon Identity and Access Management (IAM) 服务相关角色。服务相关角色是一种独特类型的 IAM 角色，它与 Amazon IoT SiteWise 直接相关。服务相关角色由 Amazon IoT SiteWise 预定义，并包含该服务代表您调用其他 Amazon 服务所需的一切权限。

服务相关角色使 Amazon IoT SiteWise 的设置更轻松，因为您不必手动添加必要的权限。Amazon IoT SiteWise 定义其服务相关角色的权限，除非另行定义，否则仅 Amazon IoT SiteWise 可以代入其角色。定义的权限包括信任策略和权限策略，以及不能附加到任何其他 IAM 实体的权限策略。

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

有关支持服务相关角色的其他服务的信息，请参阅与 IAM 配合使用的 Amazon 服务，并查找 Service-Linked Role（服务相关角色）列中显示为 Yes（是）的服务。请选择 Yes 与查看该服务的服务相关角色文档的链接。

Amazon IoT SiteWise 的服务相关角色权限

Amazon IoT SiteWise使用名为的服务相关角色AWSServiceRoleForIoTSiteWise。Amazon IoT SiteWise使用此服务相关角色部署网关（运行在Amazon IoT Greengrass) 并执行日志记录。

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

  • iotsitewise.amazonaws.com

的AWSServiceRoleForIoTSiteWise角色使用AWSServiceRoleForIoTSiteWise具有以下权限的策略。此政策允许Amazon IoT Greengrass将日志写入iotsitewise亚马逊群组 CloudWatch 日志。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "greengrass:GetAssociatedRole",
                "greengrass:GetCoreDefinition",
                "greengrass:GetCoreDefinitionVersion",
                "greengrass:GetGroup",
                "greengrass:GetGroupVersion"
            ],
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "logs:CreateLogGroup",
                "logs:DescribeLogGroups"
            ],
            "Resource": "arn:aws-cn:logs:*:*:log-group:/aws/iotsitewise*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "logs:CreateLogStream",
                "logs:DescribeLogStreams",
                "logs:PutLogEvents"
            ],
            "Resource": "arn:aws-cn:logs:*:*:log-group:/aws/iotsitewise*:log-stream:*",
            "Effect": "Allow"
        }
    ]
}

您可以使用日志来监控网关并对其进行故障排除。有关更多信息，请参阅监控网关日志：

要允许 IAM 实体（例如用户、群组或角色）创建、编辑或删除服务相关角色，请先配置权限。有关更多信息，请参阅 IAM 用户指南中的服务相关角色权限。

为 Amazon IoT SiteWise 创建服务相关角色

无需手动创建服务相关角色。当您在中执行任何操作时Amazon IoT SiteWise控制台，Amazon IoT SiteWise为您创建服务相关角色。

如果删除此服务相关角色，然后需要再次创建，可以使用相同流程在账户中重新创建此角色。当您在中执行任何操作时Amazon IoT SiteWise控制台，Amazon IoT SiteWise再次为您创建服务相关角色。

您也可以使用 IAM 控制台或 API 为创建服务相关角色Amazon IoT SiteWise。

  • 要在 IAM 控制台中执行此操作，请使用创建角色AWSServiceRoleForIoTSiteWise政策以及与之建立信任关系iotsitewise.amazonaws.com。

  • 要做到这一点，请使用Amazon CLI或 IAM API，使用创建角色arn:aws:iam::aws:policy/aws-service-role/AWSServiceRoleForIoTSiteWise政策以及与之建立信任关系iotsitewise.amazonaws.com。

有关更多信息，请参阅《IAM 用户指南》 中的创建服务相关角色。

如果您删除了此服务相关角色，则可以使用此相同过程再次创建角色。

为 Amazon IoT SiteWise 编辑服务相关角色

Amazon IoT SiteWise不允许你编辑 AWSServiceRoleForIoTSiteWise 服务相关角色。在创建服务相关角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。不过，您可以使用 IAM 编辑角色的说明。有关更多信息，请参阅 IAM 用户指南中的编辑服务相关角色。

删除 Amazon IoT SiteWise 的服务相关角色

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

注意

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

要删除Amazon IoT SiteWise使用的资源 AWSServiceRoleForIoTSiteWise

  1. 为 Amazon IoT SiteWise 禁用日志记录。有关更多信息，请参阅 更改日志记录级别（控制台） 或 更改日志记录级别 (CLI)。

  2. 删除任何活动网关。

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

使用 IAM 控制台，Amazon CLI，或者Amazon用于删除的 API AWSServiceRoleForIoTSiteWise 服务相关角色。有关更多信息，请参见 IAM 用户指南中的删除服务相关角色。

Amazon IoT SiteWise 服务相关角色的受支持区域

Amazon IoT SiteWise 支持在服务可用的所有区域中使用服务相关角色。有关更多信息，请参阅 Amazon IoT SiteWise 终端节点和配额。