本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用服務連結角色進行受管整合
<a name="using-service-linked-roles"></a>

 AWS IoT Device Management 的受管整合使用 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 Device Management 的受管整合會定義其服務連結角色的許可，除非另有定義，否則只有受管整合才能擔任其角色。定義的許可包括信任政策和許可政策，且該許可政策無法附加至其他 IAM 實體。

您必須先刪除服務連結角色的相關資源，才能將其刪除。這可保護您的受管整合資源，因為您不會不小心移除存取資源的許可。

如需有關支援服務連結角色的其他 服務的資訊，請參閱[AWS 使用 IAM 的服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)，並在**服務連結角色**欄中尋找具有**是**的服務。選擇具有連結的**是**，以檢視該服務的服務連結角色文件。

## 受管整合的服務連結角色許可
<a name="slr-permissions"></a>

 AWS IoT Device Management 的受管整合使用名為 ** AWSServiceRoleForIoTManagedIntegrations** 的服務連結角色 – 為 AWS IoT Device Management 提供受管整合，以代表您發佈日誌和指標。

AWSServiceRoleForIoTManagedIntegrations 服務連結角色信任下列服務擔任該角色：
+ `iotmanagedintegrations.amazonaws.com`

名為 AWSIoTManagedIntegrationsServiceRolePolicy 的角色許可政策允許受管整合對指定的資源完成下列動作：
+ 動作：`logs:CreateLogGroup, logs:DescribeLogGroups, logs:CreateLogStream, logs:PutLogEvents, logs:DescribeLogStreams, cloudwatch:PutMetricData` `on all of your managed integrations resources.`

------
#### [ 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>

您不需要手動建立服務連結角色，當您在 `CreateEventLogConfiguration`、 或 `RegisterCustomEndpoint` API 中呼叫 `PutRuntimeLogConfiguration`、 AWS 管理主控台 AWS CLI或 AWS API 命令等事件類型時， 受管整合會為您建立服務連結角色。如需 `PutRuntimeLogConfiguration`、 `CreateEventLogConfiguration`或 的詳細資訊`RegisterCustomEndpoint`，請參閱 [PutRuntimeLogConfiguration](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_PutRuntimeLogConfiguration.html)、[CreateEventLogConfiguration](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_CreateEventLogConfiguration.html) 或 [RegisterCustomEndpoint](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_RegisterCustomEndpoint.html)。

若您刪除此服務連結角色，之後需要再次建立，您可以在帳戶中使用相同程序重新建立角色。當您呼叫 `PutRuntimeLogConfiguration`、 `CreateEventLogConfiguration`或 `RegisterCustomEndpoint` API 命令等事件類型時，受管整合會再次為您建立服務連結角色。或者，您也可以透過 聯絡 AWS 客戶支援 AWS Support Center Console。如需 AWS Support Plans 的詳細資訊，請參閱[比較 AWS Support Plans](https://aws.amazon.com/premiumsupport/plans/)。

您也可以使用 IAM 主控台，透過 **IoT ManagedIntegrations - Managed Role 使用案例來建立服務連結角色**。在 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>

受管整合不允許您編輯 AWSServiceRoleForIoTManagedIntegrations 服務連結角色。因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。然而，您可使用 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 來刪除 AWSServiceRoleForIoTManagedIntegrations 服務連結角色。如需詳細資訊，請參閱《*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 Device Management 的受管整合支援在提供服務的所有區域中使用服務連結角色。如需詳細資訊，請參閱 [AWS Regions and endpoints](https://docs.aws.amazon.com/general/latest/gr/iot-managedintegrations.html)。