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

# 使用服务相关角色进行托管集成
<a name="using-service-linked-roles"></a>

 AWS IoT 设备管理用户 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 服务所需的所有权限。

服务相关角色可以更轻松地设置托管集成，因为您不必手动添加必要的权限。 AWS IoT 设备管理的托管集成定义了其服务相关角色的权限，除非另有定义，否则只有托管集成才能扮演其角色。定义的权限包括信任策略和权限策略，以及不能附加到任何其他 IAM 实体的权限策略。

只有在首先删除相关资源后，您才能删除服务关联角色。这可以保护您的托管集成资源，因为您不会无意中移除对资源的访问权限。

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

## 托管集成的服务相关角色权限
<a name="slr-permissions"></a>

 AWS IoT 设备管理托管集成使用名为 Inte ** AWSServiceRoleForIoTManagedgrat** ions 的服务相关角色——为 AWS IoT 设备管理提供托管集成，允许您发布日志和指标。

 AWSServiceRoleForIoTManaged集成服务相关角色信任以下服务来代替该角色：
+ `iotmanagedintegrations.amazonaws.com`

名为的角色权限策略 AWSIoTManagedIntegrationsServiceRolePolicy 允许托管集成对指定资源完成以下操作：
+ 操作：`on all of your managed integrations resources.` 上的 `logs:CreateLogGroup, logs:DescribeLogGroups, logs:CreateLogStream, logs:PutLogEvents, logs:DescribeLogStreams, cloudwatch:PutMetricData`

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement" : [
    { 
      "Sid" : "CloudWatchLogs",
      "Effect" : "Allow",
      "Action" : [
        "logs:CreateLogGroup",
        "logs:DescribeLogGroups"
      ],
      "Resource" : [
        "arn:aws:logs:*:*:log-group:/aws/iotmanagedintegrations/*"
      ]
    },
    {
      "Sid" : "CloudWatchStreams",
      "Effect" : "Allow",
      "Action" : [
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams"
      ],
      "Resource" : [
        "arn:aws:logs:*:*:log-group:/aws/iotmanagedintegrations/*:log-stream:*"
      ]
    },
    {
      "Sid" : "CloudWatchMetrics",
      "Effect" : "Allow",
      "Action" : [
        "cloudwatch:PutMetricData"
      ],
      "Resource" : "*",
      "Condition" : {
        "StringEquals" : {
          "cloudwatch:namespace" : [
            "AWS/IoTManagedIntegrations",
            "AWS/Usage"
          ]
        }
      }
    }
  ]
}
```

------

您必须配置使用户、组或角色能够创建、编辑或删除服务相关角色的权限。有关更多信息，请参阅*《IAM 用户指南》*中的[服务相关角色权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

## 为托管集成创建服务相关角色
<a name="create-slr"></a>

您无需手动创建服务关联角色。当您创建事件类型（例如在`PutRuntimeLogConfiguration`、或 API 中调用`CreateEventLogConfiguration` AWS 管理控制台、或 `RegisterCustomEndpoint` AP AWS I 命令）时，托管集成会为您创建服务相关角色。 AWS CLI有关`PutRuntimeLogConfiguration`、`CreateEventLogConfiguration`或的更多信息`RegisterCustomEndpoint`，请参阅[PutRuntimeLogConfiguration[CreateEventLogConfiguration](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_CreateEventLogConfiguration.html)](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_PutRuntimeLogConfiguration.html)、或[RegisterCustomEndpoint](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_RegisterCustomEndpoint.html)。

如果您删除该服务关联角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。当您创建事件类型（例如调用`PutRuntimeLogConfiguration``CreateEventLogConfiguration`、或 `RegisterCustomEndpoint` API 命令）时，托管集成会再次为您创建服务相关角色。或者，您可以通过以下方式联系 AWS 客户支持 AWS Support Center Console。有关 AWS 支持计划的更多信息，请参阅[比较 AWS Support 计划](https://aws.amazon.com/premiumsupport/plans/)。

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

## 编辑托管集成的服务相关角色
<a name="edit-slr"></a>

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

## 删除托管集成的服务相关角色
<a name="delete-slr"></a>

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

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

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

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

## 托管集成服务相关角色支持的区域
<a name="slr-regions"></a>

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