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

# 使用 AmazonChimeSDKEvents 服務連結角色
<a name="analytics-service-role"></a>

Amazon Chime SDK 使用名為 的服務連結角色`AmazonChimeSDKEvents`。此角色會授予 Amazon Chime SDK 使用或管理之 AWS 服務的存取權，例如用於資料串流的 Kinesis Firehose。

`AmazonChimeSDKEvents` 服務連結角色允許 Amazon Chime SDK 使用此格式完成串流`kinesis:PutRecordBatch`上的 `kinesis:PutRecord`和 。 `arn:aws:firehose:::deliverystream/AmazonChimeSDKEvents-*`

您必須設定許可，以允許 IAM 實體，例如使用者、群組或角色，來建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱 *IAM 使用者指南*中的[服務連結角色許可](https://docs.aws.amazon.com/)。

## 建立 服務連結角色
<a name="slr-create"></a>

服務連結角色是快速建立連結中 Chime SDK Events CloudFormation 範本的一部分。

您也可以使用 IAM 主控台，透過 Amazon Chime SDK Events 使用案例來建立服務連結角色。在 AWS CLI 或 AWS API 中，使用服務名稱建立`events.chime.amazonaws.com`服務連結角色。如需詳細資訊，請參閱《 IAM 使用者指南》**中的[使用服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html)。如果您刪除此角色，您可以重複此程序以再次建立該角色。

## 編輯 服務連結角色
<a name="slr-edit"></a>

建立服務連結角色之後，您只能編輯其描述，並使用 IAM 執行此操作。如需詳細資訊，請參閱《 IAM 使用者指南》**中的[使用服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html)。

## 刪除 服務連結角色
<a name="slr-delete-resources"></a>

最佳實務是，當您不再需要需要的 功能或服務時，請刪除`Amazon Chime SDKEvents`角色。否則，您有一個未使用的實體未主動監控或維護。

若要手動刪除角色，您首先會刪除角色使用的資源。以下一組步驟說明如何執行這兩個任務。

**刪除角色資源**  
您可以透過刪除用於串流資料的 Kinesis Firehose 來刪除資源。

**注意**  
如果您在角色使用資源時嘗試刪除資源，刪除可能會失敗。如果刪除失敗，請等待幾分鐘，然後重試操作。

**刪除角色資源**
+ 透過叫用下列 API 關閉 Kinesis Firehose。

  ```
  aws firehose delete-delivery-stream --delivery-stream-name {{delivery_stream_name}}
  ```

**刪除服務連結角色**
+ 使用 IAM 主控台、 AWS CLI 或 AWS API 來刪除 AmazonChimeSDKEvents 服務連結角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[使用服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html)和[刪除服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/example_iam_DeleteServiceLinkedRole_section.html)。