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

# 使用 的服務連結角色 AWS Transform
<a name="using-service-linked-roles"></a>

AWS Transform use 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 Transform。服務連結角色由 預先定義， AWS Transform 並包含該服務代表您呼叫其他 AWS 服務所需的所有許可。

## 使用 的服務連結角色 AWS Transform
<a name="using-service-linked-roles-qdev"></a>

AWS Transform use 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 Transform。服務連結角色由 預先定義， AWS Transform 並包含該服務代表您呼叫其他 AWS 服務所需的所有許可。

服務連結角色可讓您更 AWS Transform 輕鬆地設定，因為您不必手動新增必要的許可。 AWS Transform 會定義其服務連結角色的許可，除非另有定義，否則只能 AWS Transform 擔任其角色。定義的許可包括信任政策和許可政策，且該許可政策無法附加至其他 IAM 實體。

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

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

### 的服務連結角色許可 AWS Transform
<a name="slr-permissions"></a>

AWS Transform 使用名為 [AWSServiceRoleForAWSTransform](security-iam-awsmanpol.md#security-iam-awsmanpol-AWSServiceRoleForAWSTransform) 的服務連結角色 – 此服務連結角色提供 AWS 轉換功能，可提供用量資訊。

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

名為 AWSServiceRoleForAWSTransform 的角色許可政策允許 對指定的資源 AWS Transform 完成下列動作：
+ cloudwatch:PutMetricData
  + 將自訂指標傳送至 CloudWatch 以進行 AWS Transform 操作
  + 追蹤轉型進度、成功率和效能指標
  + 啟用轉換工作流程的監控和提醒
+ sso：DescribeApplication
  + 在 Identity Center 中檢視特定應用程式的詳細資訊
  + 取得應用程式中繼資料，例如名稱、描述、狀態和組態
+ sso：GetApplicationAssignmentConfiguration
  + 擷取應用程式的指派組態設定
  + 了解使用者/群組如何設定為指派給應用程式
+ sso：ListApplicationAssignmentsForPrincipal
  + 列出指派給特定使用者或群組的所有應用程式 （委託人）
  + 檢視特定身分可存取的應用程式
+ 透過 IAM Identity Center 存取時，啟用 KMS 加密資料的解密。只有在加密內容包含有效的 IAM Identity Center 執行個體 ARN 且必須透過 IAM Identity Center 服務端點存取時，才能運作。
+ 允許透過 Identity Store 存取時解密 KMS 加密的資料。只有在加密內容包含有效的 Identity Store ARN 且必須透過 Identity Store 服務端點存取時，才能運作。
+ secretsmanager:GetSecretValue
  + 存取用於存放外部身分提供者用戶端秘密 AWS Transform 的服務連結秘密
  + 資源：arn：aws：secretsmanager：\*：\*：secret：transform-preprod！\*
  + 條件：必須由 transform-preprod 服務擁有，並從相同的帳戶存取
+ support：CreateCase， support：DescribeCases， support：DescribeCommunications， support：AddCommunicationToCase， support：ResolveCase
  + 從 AWS Transform Web 應用程式建立和管理進階支援案例
  + 檢視案例詳細資訊和通訊
  + 新增通訊並解決支援案例

您必須設定許可，以允許您的使用者、群組或角色建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱 *IAM 使用者指南*中的[服務連結角色許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

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

您不需要手動建立服務連結角色，當您在 AWS Transform 中建立 的設定檔時 AWS 管理主控台， 會為您 AWS Transform 建立服務連結角色。

若您刪除此服務連結角色，之後需要再次建立，您可以在帳戶中使用相同程序重新建立角色。當您更新設定時， AWS Transform 會再次為您建立服務連結角色。

您也可以使用 IAM 主控台或 AWS CLI 來建立具有服務名稱`transform.amazonaws.com`的服務連結角色。如需詳細資訊，請參閱《IAM 使用者指南》**中的「[建立服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role)」。如果您刪除此服務連結角色，您可以使用此相同的程序以再次建立該角色。

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

AWS Transform 不允許您編輯 AWSServiceRoleForAWSTransform 服務連結角色。因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。然而，您可使用 IAM 來編輯角色描述。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[編輯服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。

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

若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。然而，在手動刪除服務連結角色之前，您必須先清除資源。

**注意**  
如果 AWS Transform 服務在您嘗試刪除資源時使用 角色，則刪除可能會失敗。若此情況發生，請等待數分鐘後並再次嘗試操作。

**使用 IAM 手動刪除服務連結角色**

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

### AWS Transform 服務連結角色支援的區域
<a name="slr-regions"></a>

AWS Transform 不支援在提供服務的每個區域中使用服務連結角色。您可以在下列區域中使用 AWSServiceRoleForAWSTransform 角色。如需詳細資訊，請參閱 [AWS 區域與端點](https://docs.aws.amazon.com/general/latest/gr/rande.html)。



| 區域名稱 | 區域身分 | 中的支援 AWS Transform | 
| --- | --- | --- | 
| 美國東部 (維吉尼亞北部) | us-east-1 | 是 | 
| 歐洲 (法蘭克福) | eu-central-1 | 是 | 

## 使用適用於 AWS Transform Custom 的服務連結角色
<a name="using-service-linked-roles-custom"></a>

AWS Transform Custom 會使用名為 **AWSServiceRoleForAWSTransformCustom** 的服務連結角色，代表您將指標和日誌發佈至您的帳戶。這些指標可讓您直接在儀表板中監控轉換計數、延遲和狀態碼。日誌可讓您了解轉換期間遇到的問題。

[此服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)是由 AWS Transform Custom 預先定義，且僅包含服務所需的許可。您不需要手動新增任何許可，而且角色只能由 AWS Transform Custom 擔任。如需服務連結角色的一般資訊，請參閱《*IAM 使用者指南*》中的[使用服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html)。

### AWS Transform Custom 的服務連結角色許可
<a name="slr-permissions-custom"></a>

AWSServiceRoleForAWSTransformCustom 服務連結角色信任下列服務擔任該角色：
+ `transform-custom.amazonaws.com`

名為 AWSServiceRoleForAWSTransformCustom 的角色許可政策允許 AWS Transform Custom 對指定的資源完成下列動作：
+ `cloudwatch:PutMetricData` 在所有 AWS 資源上
  + 在`AWS/TransformCustom`命名空間下發佈操作指標至
  + 追蹤轉換計數、延遲和狀態碼
  + 透過`cloudwatch:namespace`條件索引鍵範圍限定於`AWS/TransformCustom`命名空間
+ `logs:CreateLogGroup` `/aws/TransformCustom`日誌群組`logs:PutRetentionPolicy`上的 和
  + 建立 CloudWatch Logs 日誌群組以發佈轉換日誌
  + 在日誌群組上設定日誌保留政策
  + 範圍為 `arn:aws:logs:*:*:log-group:/aws/TransformCustom`，其`aws:ResourceAccount`條件可確保僅在您的帳戶內存取
+ `logs:CreateLogStream` `logs:PutLogEvents`日誌群組內的 和 `/aws/TransformCustom`日誌串流
  + 建立日誌串流並發佈轉換操作的日誌事件
  + 範圍為 `arn:aws:logs:*:*:log-group:/aws/TransformCustom:log-stream:*`，其`aws:ResourceAccount`條件可確保僅在您的帳戶內存取

您必須設定許可，以允許您的使用者、群組或角色建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱 *IAM 使用者指南*中的[服務連結角色許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

### 為 AWS Transform Custom 建立服務連結角色
<a name="create-slr-custom"></a>

您不需要手動建立服務連結角色，當您使用 Transform Custom CLI 執行 AWS 轉換時， AWS Transform Custom 會為您建立服務連結角色。

若您刪除此服務連結角色，之後需要再次建立，您可以在帳戶中使用相同程序重新建立角色。當您使用 Transform Custom CLI 執行 AWS 轉換時， AWS Transform Custom 會再次為您建立服務連結角色。

您也可以使用 IAM 主控台建立具有 **AWSServiceRoleForAWSTransformCustom** 使用案例的服務連結角色。在 AWS CLI 或 AWS API 中，使用服務名稱建立`transform-custom.amazonaws.com`服務連結角色。如需詳細資訊，請參閱《IAM 使用者指南》**中的「[建立服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role)」。如果您刪除此服務連結角色，您可以使用此相同的程序以再次建立該角色。

### 編輯 AWS Transform Custom 的服務連結角色
<a name="edit-slr-custom"></a>

AWS Transform Custom 不允許您編輯 AWSServiceRoleForAWSTransformCustom 服務連結角色。因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。然而，您可使用 IAM 來編輯角色描述。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[編輯服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。

### 刪除 AWS Transform Custom 的服務連結角色
<a name="delete-slr-custom"></a>

若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。

AWSServiceRoleForAWSTransformCustom 服務連結角色不會在您的帳戶中建立持久性資源。您可以直接刪除它，無需任何資源清理。

如果您刪除此角色，稍後使用轉換自訂 CLI 執行 AWS 轉換，則會自動重新建立服務連結角色。

**使用 IAM 手動刪除服務連結角色**

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

### AWS Transform Custom 服務連結角色支援的 區域
<a name="slr-regions-custom"></a>

AWS 在可使用 Transform Custom 的所有區域中， AWS Transform Custom 支援使用服務連結角色。如需支援的區域清單，請參閱[支援的區域](https://docs.aws.amazon.com/transform/latest/userguide/custom-get-started.html#custom-region-configuration)。