software.amazon.awscdk.services.iam

Interface CfnServiceLinkedRoleProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnServiceLinkedRoleProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:39.747Z")
 @Stability(value=Stable)
public interface CfnServiceLinkedRoleProps
extends software.amazon.jsii.JsiiSerializable

Properties for defining a `CfnServiceLinkedRole`.

Example:

 CfnServiceLinkedRole slr = CfnServiceLinkedRole.Builder.create(this, "ElasticSLR")
         .awsServiceName("es.amazonaws.com")
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CfnServiceLinkedRoleProps.Builder A builder for CfnServiceLinkedRoleProps
static class	CfnServiceLinkedRoleProps.Jsii$Proxy An implementation for CfnServiceLinkedRoleProps

Method Summary

Modifier and Type	Method and Description
static CfnServiceLinkedRoleProps.Builder	builder()
String	getAwsServiceName() The service principal for the AWS service to which this role is attached.
default String	getCustomSuffix() A string that you provide, which is combined with the service-provided prefix to form the complete role name.
default String	getDescription() The description of the role.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getAwsServiceName

@Stability(value=Stable)
 @NotNull
String getAwsServiceName()

The service principal for the AWS service to which this role is attached.

You use a string similar to a URL but without the http:// in front. For example: elasticbeanstalk.amazonaws.com .

Service principals are unique and case-sensitive. To find the exact service principal for your service-linked role, see AWS services that work with IAM in the IAM User Guide . Look for the services that have Yes in the Service-Linked Role column. Choose the Yes link to view the service-linked role documentation for that service.

getCustomSuffix

@Stability(value=Stable)
 @Nullable
default String getCustomSuffix()

A string that you provide, which is combined with the service-provided prefix to form the complete role name.

If you make multiple requests for the same service, then you must supply a different CustomSuffix for each request. Otherwise the request fails with a duplicate role name error. For example, you could add -1 or -debug to the suffix.

Some services do not support the CustomSuffix parameter. If you provide an optional suffix and the operation fails, try the operation again without the suffix.

getDescription

@Stability(value=Stable)
 @Nullable
default String getDescription()

The description of the role.

builder

@Stability(value=Stable)
static CfnServiceLinkedRoleProps.Builder builder()

Returns:

a CfnServiceLinkedRoleProps.Builder of CfnServiceLinkedRoleProps