software.amazon.awscdk.core

Class Arn

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.core.Arn

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/0.22.0 (build 14afdde)",
           date="2020-03-18T10:30:11.844Z")
 @Stability(value=Stable)
public class Arn
extends software.amazon.jsii.JsiiObject

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Arn(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Arn(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
static String	format(ArnComponents components, Stack stack) Creates an ARN from components.
static ArnComponents	parse(String arn) Given an ARN, parses it and returns components.
static ArnComponents	parse(String arn, String sepIfToken) Given an ARN, parses it and returns components.
static ArnComponents	parse(String arn, String sepIfToken, Boolean hasName) Given an ARN, parses it and returns components.

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

Arn

protected Arn(software.amazon.jsii.JsiiObjectRef objRef)

Arn

protected Arn(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Method Detail

format

@Stability(value=Stable)
 @NotNull
public static String format(@NotNull
                                                               ArnComponents components,
                                                               @NotNull
                                                               Stack stack)

Creates an ARN from components.

If partition, region or account are not specified, the stack's partition, region and account will be used.

If any component is the empty string, an empty string will be inserted into the generated ARN at the location that component corresponds to.

The ARN will be formatted as follows:

arn:{partition}:{service}:{region}:{account}:{resource}{sep}{resource-name}

The required ARN pieces that are omitted will be taken from the stack that the 'scope' is attached to. If all ARN pieces are supplied, the supplied scope can be 'undefined'.

Parameters:

components - This parameter is required.

stack - This parameter is required.

parse

@Stability(value=Stable)
 @NotNull
public static ArnComponents parse(@NotNull
                                                                     String arn,
                                                                     @Nullable
                                                                     String sepIfToken,
                                                                     @Nullable
                                                                     Boolean hasName)

Given an ARN, parses it and returns components.

If the ARN is a concrete string, it will be parsed and validated. The separator (sep) will be set to '/' if the 6th component includes a '/', in which case, resource will be set to the value before the '/' and resourceName will be the rest. In case there is no '/', resource will be set to the 6th components and resourceName will be set to the rest of the string.

If the ARN includes tokens (or is a token), the ARN cannot be validated, since we don't have the actual value yet at the time of this function call. You will have to know the separator and the type of ARN. The resulting ArnComponents object will contain tokens for the subexpressions of the ARN, not string literals. In this case this function cannot properly parse the complete final resourceName (path) out of ARNs that use '/' to both separate the 'resource' from the 'resourceName' AND to subdivide the resourceName further. For example, in S3 ARNs:

 arn:aws:s3:::my_corporate_bucket/path/to/exampleobject.png
 

After parsing the resourceName will not contain 'path/to/exampleobject.png' but simply 'path'. This is a limitation because there is no slicing functionality in CloudFormation templates.

Parameters:

arn - The ARN to parse. This parameter is required.

sepIfToken - The separator used to separate resource from resourceName.

hasName - Whether there is a name component in the ARN at all.

Returns:

an ArnComponents object which allows access to the various components of the ARN.

parse

@Stability(value=Stable)
 @NotNull
public static ArnComponents parse(@NotNull
                                                                     String arn,
                                                                     @Nullable
                                                                     String sepIfToken)

Given an ARN, parses it and returns components.

If the ARN is a concrete string, it will be parsed and validated. The separator (sep) will be set to '/' if the 6th component includes a '/', in which case, resource will be set to the value before the '/' and resourceName will be the rest. In case there is no '/', resource will be set to the 6th components and resourceName will be set to the rest of the string.

If the ARN includes tokens (or is a token), the ARN cannot be validated, since we don't have the actual value yet at the time of this function call. You will have to know the separator and the type of ARN. The resulting ArnComponents object will contain tokens for the subexpressions of the ARN, not string literals. In this case this function cannot properly parse the complete final resourceName (path) out of ARNs that use '/' to both separate the 'resource' from the 'resourceName' AND to subdivide the resourceName further. For example, in S3 ARNs:

 arn:aws:s3:::my_corporate_bucket/path/to/exampleobject.png
 

After parsing the resourceName will not contain 'path/to/exampleobject.png' but simply 'path'. This is a limitation because there is no slicing functionality in CloudFormation templates.

Parameters:

arn - The ARN to parse. This parameter is required.

sepIfToken - The separator used to separate resource from resourceName.

Returns:

an ArnComponents object which allows access to the various components of the ARN.

parse

@Stability(value=Stable)
 @NotNull
public static ArnComponents parse(@NotNull
                                                                     String arn)

Given an ARN, parses it and returns components.

If the ARN is a concrete string, it will be parsed and validated. The separator (sep) will be set to '/' if the 6th component includes a '/', in which case, resource will be set to the value before the '/' and resourceName will be the rest. In case there is no '/', resource will be set to the 6th components and resourceName will be set to the rest of the string.

If the ARN includes tokens (or is a token), the ARN cannot be validated, since we don't have the actual value yet at the time of this function call. You will have to know the separator and the type of ARN. The resulting ArnComponents object will contain tokens for the subexpressions of the ARN, not string literals. In this case this function cannot properly parse the complete final resourceName (path) out of ARNs that use '/' to both separate the 'resource' from the 'resourceName' AND to subdivide the resourceName further. For example, in S3 ARNs:

 arn:aws:s3:::my_corporate_bucket/path/to/exampleobject.png
 

After parsing the resourceName will not contain 'path/to/exampleobject.png' but simply 'path'. This is a limitation because there is no slicing functionality in CloudFormation templates.

Parameters:

arn - The ARN to parse. This parameter is required.

Returns:

an ArnComponents object which allows access to the various components of the ARN.