Package software.amazon.awssdk.policybuilder.iam

Interface IamPolicyReader

All Known Implementing Classes:

DefaultIamPolicyReader

@SdkPublicApi
@ThreadSafe
public interface IamPolicyReader

The IamPolicyReader converts a JSON policy into an IamPolicy.

Usage Examples

Log the number of statements in a policy downloaded from IAM.

See Also:

• IamPolicy.fromJson(String)

Method Summary

Modifier and Type	Method	Description
static IamPolicyReader	create()	Create a new IamPolicyReader.
IamPolicy	read(byte[] policy)	Read a policy from a byte array.
IamPolicy	read(InputStream policy)	Read a policy from an InputStream.
IamPolicy	read(String policy)	Read a policy from a String.

Method Details

create

static IamPolicyReader create()

Create a new IamPolicyReader.

This method is inexpensive, allowing the creation of readers wherever they are needed.

read

IamPolicy read(String policy)

Read a policy from a String.

This only performs minimal validation on the provided policy.

Throws:

RuntimeException - If the provided policy is not valid JSON or is missing a minimal set of required fields.

read

IamPolicy read(InputStream policy)

Read a policy from an InputStream.

The stream must provide a UTF-8 encoded string representing the policy. This only performs minimal validation on the provided policy.

Throws:

RuntimeException - If the provided policy is not valid JSON or is missing a minimal set of required fields.

read

IamPolicy read(byte[] policy)

Read a policy from a byte array.

The stream must provide a UTF-8 encoded string representing the policy. This only performs minimal validation on the provided policy.

Throws:

RuntimeException - If the provided policy is not valid JSON or is missing a minimal set of required fields.