将服务相关角色用于 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 服务，并查找服务相关角色列中为是的服务。选择是，可转到查看该服务的服务相关角色文档的链接。

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

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

AWSServiceRoleForIoTSiteWise服务相关角色使用具有以下权限的AWSServiceRoleForIoTSiteWise策略：

  • 此策略 Amazon IoT SiteWise 允许部署 SiteWise Edge 网关（在上运行Amazon IoT Greengrass）。

  • 此策略还 Amazon IoT SiteWise 允许执行日志记录。

  • 该策略还 Amazon IoT SiteWise 允许对 Amazon IoT TwinMaker 数据库运行元数据搜索查询。

有关中允许的操作的更多信息AWSServiceRoleForIoTSiteWise，请参阅中的Amazon 托管策略 Amazon IoT SiteWise。


{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Sid": "AllowSiteWiseReadGreenGrass",
			"Effect": "Allow",
			"Action": [
				"greengrass:GetAssociatedRole",
				"greengrass:GetCoreDefinition",
				"greengrass:GetCoreDefinitionVersion",
				"greengrass:GetGroup",
				"greengrass:GetGroupVersion"
			],
			"Resource": "*"
		},
		{
			"Sid": "AllowSiteWiseAccessLogGroup",
			"Effect": "Allow",
			"Action": [
				"logs:CreateLogGroup",
				"logs:DescribeLogGroups"
			],
			"Resource": "arn:aws-cn:logs:*:*:log-group:/aws/iotsitewise*"
		},
		{
			"Sid": "AllowSiteWiseAccessLog",
			"Effect": "Allow",
			"Action": [
				"logs:CreateLogStream",
				"logs:DescribeLogStreams",
				"logs:PutLogEvents"
			],
			"Resource": "arn:aws-cn:logs:*:*:log-group:/aws/iotsitewise*:log-stream:*"
		},
		{
			"Sid": "AllowSiteWiseAccessSiteWiseManagedWorkspaceInTwinMaker",
			"Effect": "Allow",
			"Action": [
				"iottwinmaker:GetWorkspace",
				"iottwinmaker:ExecuteQuery"
			],
			"Resource": "arn:aws-cn:iottwinmaker:*:*:workspace/*",
			"Condition": {
				"ForAnyValue:StringEquals": {
					"iottwinmaker:linkedServices": [
						"IOTSITEWISE"
					]
				}
			}
		}
	]
}

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

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

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

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

  • 创建 Greengrass V1 网关。

  • 配置日志选项。

  • 在查询横幅中选择 “选择加入” 按钮。

如果您删除该服务相关角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。当您在 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. 删除所有活动的 SiteWise Edge 网关。

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

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

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

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