software.amazon.awscdk.services.iam

Class PolicyDocument.Builder

java.lang.Object

software.amazon.awscdk.services.iam.PolicyDocument.Builder

Enclosing class:

PolicyDocument

public static final class PolicyDocument.Builder
extends java.lang.Object

A fluent builder for PolicyDocument.

Method Summary

Modifier and Type	Method and Description
PolicyDocument.Builder	assignSids(java.lang.Boolean assignSids) Automatically assign Statement Ids to all statements.
PolicyDocument	build()
static PolicyDocument.Builder	create()
PolicyDocument.Builder	minimize(java.lang.Boolean minimize) Try to minimize the policy by merging statements.
PolicyDocument.Builder	statements(java.util.List<? extends PolicyStatement> statements) Initial statements to add to the policy document.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static PolicyDocument.Builder create()

Returns:

a new instance of PolicyDocument.Builder.

assignSids

public PolicyDocument.Builder assignSids(java.lang.Boolean assignSids)

Automatically assign Statement Ids to all statements.

Default: false

Parameters:

assignSids - Automatically assign Statement Ids to all statements. This parameter is required.

Returns:

this

minimize

public PolicyDocument.Builder minimize(java.lang.Boolean minimize)

Try to minimize the policy by merging statements.

To avoid overrunning the maximum policy size, combine statements if they produce the same result. Merging happens according to the following rules:

• The Effect of both statements is the same
• Neither of the statements have a 'Sid'
• Combine Principals if the rest of the statement is exactly the same.
• Combine Resources if the rest of the statement is exactly the same.
• Combine Actions if the rest of the statement is exactly the same.
• We will never combine NotPrincipals, NotResources or NotActions, because doing so would change the meaning of the policy document.

Default: - false, unless the feature flag `@aws-cdk/aws-iam:minimizePolicies` is set

Parameters:

minimize - Try to minimize the policy by merging statements. This parameter is required.

Returns:

this

statements

public PolicyDocument.Builder statements(java.util.List<? extends PolicyStatement> statements)

Initial statements to add to the policy document.

Default: - No statements

Parameters:

statements - Initial statements to add to the policy document. This parameter is required.

Returns:

this

build

public PolicyDocument build()