AWS App Runner 自 2026 年 4 月 30 日起，不再開放給新客戶。如果您想要使用 App Runner，請在該日期之前註冊。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[AWS App Runner 可用性變更](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 App Runner 的服務連結角色
AWS App Runner 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)。服務連結角色是直接連結至 App Runner 的唯一 IAM 角色類型。服務連結角色由 App Runner 預先定義，並包含該服務代表您呼叫其他 AWS 服務所需的所有許可。
**Topics**
+ [使用 角色進行管理](using-service-linked-roles-management.md)
+ [使用角色進行聯網](using-service-linked-roles-networking.md)
# 使用 角色進行管理
AWS App Runner 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)。服務連結角色是直接連結至 App Runner 的唯一 IAM 角色類型。服務連結角色由 App Runner 預先定義，並包含該服務代表您呼叫其他 AWS 服務所需的所有許可。
服務連結角色可讓您更輕鬆地設定 App Runner，因為您不必手動新增必要的許可。App Runner 定義其服務連結角色的許可，除非另有定義，否則只有 App Runner 可以擔任其角色。定義的許可包括信任政策和許可政策，且該許可政策無法附加至其他 IAM 實體。
您必須先刪除服務連結角色的相關資源，才能將其刪除。這可保護您的 App Runner 資源，因為您不會不小心移除存取資源的許可。
如需關於支援服務連結角色的其他服務的資訊，請參閱[可搭配 IAM 運作的AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)，並尋找 **Service-Linked Role** (服務連結角色) 欄顯示為 **Yes** (是) 的服務。選擇具有連結的**是**，以檢視該服務的服務連結角色文件。
## App Runner 的服務連結角色許可
App Runner 使用名為 **AWSServiceRoleForAppRunner** 的服務連結角色。
此角色允許 App Runner 執行下列任務：
+ 將日誌推送至 Amazon CloudWatch Logs 日誌群組。
+ 建立 Amazon CloudWatch Events 規則以訂閱 Amazon Elastic Container Registry (Amazon ECR) 映像推送。
+ 將追蹤資訊傳送至 AWS X-Ray。
AWSServiceRoleForAppRunner 服務連結角色信任下列服務擔任該角色：
+ `apprunner.amazonaws.com`
AWSServiceRoleForAppRunner 服務連結角色的許可政策包含 App Runner 代表您完成動作所需的所有許可：
+ 受管政策 [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AppRunnerServiceRolePolicy.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AppRunnerServiceRolePolicy.html)
+ X-Ray 追蹤的政策 – 請參閱下列政策內容。
### X-Ray 追蹤的政策
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"xray:PutTraceSegments",
"xray:PutTelemetryRecords",
"xray:GetSamplingRules",
"xray:GetSamplingTargets",
"xray:GetSamplingStatisticSummaries"
],
"Resource": [
"*"
]
}
]
}
```
------
您必須設定許可，IAM 實體 (如使用者、群組或角色) 才可建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[服務連結角色許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。
## 為 App Runner 建立服務連結角色
您不需要手動建立服務連結角色，當您在 、 或 API 中建立 App Runner 服務時，App Runner 會為您建立服務連結角色。 AWS 管理主控台 AWS CLI AWS
若您刪除此服務連結角色，之後需要再次建立，您可以在帳戶中使用相同程序重新建立角色。當您建立 App Runner 服務時，App Runner 會再次為您建立服務連結角色。
## 編輯 App Runner 的服務連結角色
App Runner 不允許您編輯 AWSServiceRoleForAppRunner 服務連結角色。因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。然而，您可使用 IAM 來編輯角色描述。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[編輯服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。
## 刪除 App Runner 的服務連結角色
若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。然而，務必清除您的服務連結角色，之後才能以手動方式將其刪除。
### 清除服務連結角色
在您使用 IAM 刪除服務連結角色之前，您必須先刪除該角色所使用的任何資源。
在 App Runner 中，這表示刪除您帳戶中的所有 App Runner 服務。若要了解如何刪除 App Runner 服務，請參閱 [刪除 App Runner 服務](manage-delete.md)。
**注意**
如果 App Runner 服務在您嘗試刪除資源時使用角色，則刪除可能會失敗。若此情況發生，請等待數分鐘後並再次嘗試操作。
### 手動刪除 服務連結角色
使用 IAM 主控台 AWS CLI、 或 AWS API 來刪除 AWSServiceRoleForAppRunner 服務連結角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[刪除服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。
## App Runner 服務連結角色支援的區域
App Runner 支援在所有提供服務的區域中使用服務連結角色。如需詳細資訊，請參閱 *AWS 一般參考* 中的 [AWS App Runner 端點和配額](https://docs.aws.amazon.com/general/latest/gr/apprunner.html)。
# 使用角色進行聯網
AWS App Runner 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)。服務連結角色是直接連結至 App Runner 的唯一 IAM 角色類型。服務連結角色由 App Runner 預先定義，並包含該服務代表您呼叫其他 AWS 服務所需的所有許可。
服務連結角色可讓您更輕鬆地設定 App Runner，因為您不必手動新增必要的許可。App Runner 定義其服務連結角色的許可，除非另有定義，否則只有 App Runner 可以擔任其角色。定義的許可包括信任政策和許可政策，且該許可政策無法附加至其他 IAM 實體。
您必須先刪除服務連結角色的相關資源，才能將其刪除。這可保護您的 App Runner 資源，因為您不會不小心移除存取資源的許可。
如需關於支援服務連結角色的其他服務的資訊，請參閱[可搭配 IAM 運作的AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)，並尋找 **Service-Linked Role** (服務連結角色) 欄顯示為 **Yes** (是) 的服務。選擇具有連結的**是**，以檢視該服務的服務連結角色文件。
## App Runner 的服務連結角色許可
App Runner 使用名為 **AWSServiceRoleForAppRunnerNetworking** 的服務連結角色。
此角色允許 App Runner 執行下列任務：
+ 將 VPC 連接至 App Runner 服務並管理網路介面。
AWSServiceRoleForAppRunnerNetworking 服務連結角色信任下列服務擔任該角色：
+ `networking.apprunner.amazonaws.com`
名為 的角色許可政策[https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AppRunnerNetworkingServiceRolePolicy.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AppRunnerNetworkingServiceRolePolicy.html)包含 App Runner 代表您完成動作所需的所有許可。
您必須設定許可，IAM 實體 (如使用者、群組或角色) 才可建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[服務連結角色許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。
## 為 App Runner 建立服務連結角色
您不需要手動建立服務連結角色，當您在 AWS 管理主控台、 AWS CLI或 AWS API 中建立 VPC 連接器時，App Runner 會為您建立服務連結角色。
若您刪除此服務連結角色，之後需要再次建立，您可以在帳戶中使用相同程序重新建立角色。當您建立 VPC 連接器時，App Runner 會再次為您建立服務連結角色。
## 編輯 App Runner 的服務連結角色
App Runner 不允許您編輯 AWSServiceRoleForAppRunnerNetworking 服務連結角色。因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。然而，您可使用 IAM 來編輯角色描述。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[編輯服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。
## 刪除 App Runner 的服務連結角色
若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。然而，務必清除您的服務連結角色，之後才能以手動方式將其刪除。
### 清除服務連結角色
在您使用 IAM 刪除服務連結角色之前，您必須先刪除該角色所使用的任何資源。
在 App Runner 中，這表示取消 VPC 連接器與您帳戶中所有 App Runner 服務的關聯，並刪除 VPC 連接器。如需詳細資訊，請參閱[啟用傳出流量的 VPC 存取](network-vpc.md)。
**注意**
如果 App Runner 服務在您嘗試刪除資源時使用角色，則刪除可能會失敗。若此情況發生，請等待數分鐘後並再次嘗試操作。
### 手動刪除服務連結角色
使用 IAM 主控台 AWS CLI、 或 AWS API 來刪除 AWSServiceRoleForAppRunnerNetworking 服務連結角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[刪除服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。
## App Runner 服務連結角色支援的區域
App Runner 支援在所有提供服務的區域中使用服務連結角色。如需詳細資訊，請參閱 *AWS 一般參考* 中的 [AWS App Runner 端點和配額](https://docs.aws.amazon.com/general/latest/gr/apprunner.html)。