Package software.amazon.awscdk.services.iam

Interface CustomizeRolesOptions

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CustomizeRolesOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.120.0 (build 192dc88)",
           date="2025-12-05T22:26:37.882Z")
@Stability(Stable)
public interface CustomizeRolesOptions
extends software.amazon.jsii.JsiiSerializable

Options for customizing IAM role creation.

Example:

 App app;
 Stack stack = new Stack(app, "MyStack");
 Role.customizeRoles(this, CustomizeRolesOptions.builder()
         .usePrecreatedRoles(Map.of(
                 "MyStack/MyLambda/ServiceRole", "my-role-name"))
         .build());
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static CustomizeRolesOptions.Builder	builder()
default Boolean	getPreventSynthesis()	Whether or not to synthesize the resource into the CFN template.
default Map<String,String>	getUsePrecreatedRoles()	A list of precreated IAM roles to substitute for roles that CDK is creating.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getPreventSynthesis

@Stability(Stable)
@Nullable
default Boolean getPreventSynthesis()

Whether or not to synthesize the resource into the CFN template.

Set this to false if you still want to create the resources and you also want to create the policy report.

Default: true

getUsePrecreatedRoles

@Stability(Stable)
@Nullable
default Map<String,String> getUsePrecreatedRoles()

A list of precreated IAM roles to substitute for roles that CDK is creating.

The constructPath can be either a relative or absolute path from the scope that customizeRoles is used on to the role being created.

Default: - there are no precreated roles. Synthesis will fail if `preventSynthesis=true`

Example:

 App app;
 Stack stack = new Stack(app, "MyStack");
 Role.Builder.create(stack, "MyRole")
         .assumedBy(new AccountPrincipal("1111111111"))
         .build();
 Role.customizeRoles(stack, CustomizeRolesOptions.builder()
         .usePrecreatedRoles(Map.of(
                 // absolute path
                 "MyStack/MyRole", "my-precreated-role-name",
                 // or relative path from `stack`
                 "MyRole", "my-precreated-role"))
         .build());
 

builder

@Stability(Stable)
static CustomizeRolesOptions.Builder builder()

Returns:

a CustomizeRolesOptions.Builder of CustomizeRolesOptions