AWS::IAM::ServiceLinkedRole - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::IAM::ServiceLinkedRole

创建链接到特定 AWS 服务的 IAM 角色。该服务控制附加的策略以及何时可以删除该角色。这有助于确保服务不会被意外更改或删除的角色破坏,这可能会使您的 AWS 资源处于未知状态。允许服务控制角色,这有助于提高服务稳定性,并在不再需要服务及其角色时正确清理。有关更多信息,请参阅 IAM 用户指南 中的使用服务相关角色

要将策略附加到此服务相关角色,您必须使用依赖于此角色的 AWS 服务提出请求。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::IAM::ServiceLinkedRole", "Properties" : { "AWSServiceName" : String, "CustomSuffix" : String, "Description" : String } }

YAML

Type: AWS::IAM::ServiceLinkedRole Properties: AWSServiceName: String CustomSuffix: String Description: String

属性

AWSServiceName

此角色要附加到的 AWS 服务的服务委托人。您可以使用一个类似于 URL 的字符串,但前面不能带 http://。例如:elasticbeanstalk.amazonaws.com

服务委托人是唯一的,并且区分大小写。要查找服务相关角色的确切服务委托人,请参阅 IAM 用户指南 中的 使用 IAM 的 AWS 服务。查找在服务相关角色列中具有值的服务。选择 Yes 链接以查看该服务的服务相关角色文档。

必需:是

类型:字符串

最低1

最高128

模式[\w+=,.@-]+

Update requires: Replacement

CustomSuffix

您提供的字符串,它与服务提供的前缀组合以形成完整的角色名称。如果您针对同一服务发出多个请求,则必须为每个请求提供不同的 CustomSuffix。否则,请求将失败,并显示角色名称重复错误。例如,您可以将 -1-debug 添加到后缀。

有些服务不支持 CustomSuffix 参数。如果您提供了可选的后缀但操作失败,则再次尝试该操作,但不带此后缀。

必需:否

类型:字符串

最低1

最高64

模式[\w+=,.@-]+

Update requires: Replacement

Description

角色的描述。

必需:否

类型:字符串

最高1000

模式[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}]*

Update requires: No interruption

返回值

Ref

When the logical ID of this resource is provided to the Ref intrinsic function, Ref returns the resource name.

例如:

{ "Ref": "BasicSLR" }

对于具有逻辑 ID BasicSLRAWS::IAM::ServiceLinkedRole 资源,Ref 将返回服务相关角色的名称。

For more information about using the Ref function, see Ref.

示例

为 Auto Scaling 创建 IAM 服务相关角色

以下示例创建一个可由 Auto Scaling 服务代入的服务相关角色。

JSON

{ "Description": "SLR resource create test - Auto Scaling", "Resources": { "BasicSLR": { "Type": "AWS::IAM::ServiceLinkedRole", "Properties": { "AWSServiceName": "autoscaling.amazonaws.com", "Description": "Test SLR description", "CustomSuffix": "TestSuffix" } } }, "Outputs": { "SLRId": { "Value": { "Ref": "BasicSLR" } } } }

YAML

Description: SLR resource create test - Auto Scaling Resources: BasicSLR: Type: 'AWS::IAM::ServiceLinkedRole' Properties: AWSServiceName: autoscaling.amazonaws.com Description: Test SLR description CustomSuffix: TestSuffix Outputs: SLRId: Value: !Ref BasicSLR