Class CfnServiceLinkedRole
Creates an IAM role that is linked to a specific AWS service.
Implements
Inherited Members
Namespace: Amazon.CDK.AWS.IAM
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public class CfnServiceLinkedRole : CfnResource, IInspectable
Syntax (vb)
Public Class CfnServiceLinkedRole Inherits CfnResource Implements IInspectable
Remarks
The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed. For more information, see Using service-linked roles in the IAM User Guide .
To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.
CloudformationResource: AWS::IAM::ServiceLinkedRole
ExampleMetadata: infused
Examples
var slr = new CfnServiceLinkedRole(this, "ElasticSLR", new CfnServiceLinkedRoleProps {
AwsServiceName = "es.amazonaws.com"
});
Synopsis
Constructors
CfnServiceLinkedRole(Construct, string, ICfnServiceLinkedRoleProps?) | Creates an IAM role that is linked to a specific AWS service. |
Properties
AttrRoleName | Returns the friendly name that identifies the role. |
AwsServiceName | The service principal for the AWS service to which this role is attached. |
CFN_RESOURCE_TYPE_NAME | The CloudFormation resource type name for this resource class. |
CfnProperties | Creates an IAM role that is linked to a specific AWS service. |
CustomSuffix | A string that you provide, which is combined with the service-provided prefix to form the complete role name. |
Description | The description of the role. |
Methods
Inspect(TreeInspector) | Examines the CloudFormation resource and discloses attributes. |
RenderProperties(IDictionary<string, object>) | Creates an IAM role that is linked to a specific AWS service. |
Constructors
CfnServiceLinkedRole(Construct, string, ICfnServiceLinkedRoleProps?)
Creates an IAM role that is linked to a specific AWS service.
public CfnServiceLinkedRole(Construct scope, string id, ICfnServiceLinkedRoleProps? props = null)
Parameters
- scope Construct
Scope in which this resource is defined.
- id string
Construct identifier for this resource (unique in its scope).
- props ICfnServiceLinkedRoleProps
Resource properties.
Remarks
The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed. For more information, see Using service-linked roles in the IAM User Guide .
To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.
CloudformationResource: AWS::IAM::ServiceLinkedRole
ExampleMetadata: infused
Properties
AttrRoleName
Returns the friendly name that identifies the role.
public virtual string AttrRoleName { get; }
Property Value
Remarks
For example, AWSServiceRoleForAutoScaling
or AWSServiceRoleForAutoScaling_TestSuffix
if a CustomSuffix
is specified.
CloudformationAttribute: RoleName
AwsServiceName
The service principal for the AWS service to which this role is attached.
public virtual string? AwsServiceName { get; set; }
Property Value
Remarks
The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed. For more information, see Using service-linked roles in the IAM User Guide .
To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.
CloudformationResource: AWS::IAM::ServiceLinkedRole
ExampleMetadata: infused
CFN_RESOURCE_TYPE_NAME
The CloudFormation resource type name for this resource class.
public static string CFN_RESOURCE_TYPE_NAME { get; }
Property Value
Remarks
The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed. For more information, see Using service-linked roles in the IAM User Guide .
To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.
CloudformationResource: AWS::IAM::ServiceLinkedRole
ExampleMetadata: infused
CfnProperties
Creates an IAM role that is linked to a specific AWS service.
protected override IDictionary<string, object> CfnProperties { get; }
Property Value
Overrides
Remarks
The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed. For more information, see Using service-linked roles in the IAM User Guide .
To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.
CloudformationResource: AWS::IAM::ServiceLinkedRole
ExampleMetadata: infused
CustomSuffix
A string that you provide, which is combined with the service-provided prefix to form the complete role name.
public virtual string? CustomSuffix { get; set; }
Property Value
Remarks
The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed. For more information, see Using service-linked roles in the IAM User Guide .
To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.
CloudformationResource: AWS::IAM::ServiceLinkedRole
ExampleMetadata: infused
Description
The description of the role.
public virtual string? Description { get; set; }
Property Value
Remarks
The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed. For more information, see Using service-linked roles in the IAM User Guide .
To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.
CloudformationResource: AWS::IAM::ServiceLinkedRole
ExampleMetadata: infused
Methods
Inspect(TreeInspector)
Examines the CloudFormation resource and discloses attributes.
public virtual void Inspect(TreeInspector inspector)
Parameters
- inspector TreeInspector
tree inspector to collect and process attributes.
Remarks
The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed. For more information, see Using service-linked roles in the IAM User Guide .
To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.
CloudformationResource: AWS::IAM::ServiceLinkedRole
ExampleMetadata: infused
RenderProperties(IDictionary<string, object>)
Creates an IAM role that is linked to a specific AWS service.
protected override IDictionary<string, object> RenderProperties(IDictionary<string, object> props)
Parameters
- props IDictionary<string, object>
Returns
Overrides
Remarks
The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed. For more information, see Using service-linked roles in the IAM User Guide .
To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.
CloudformationResource: AWS::IAM::ServiceLinkedRole
ExampleMetadata: infused