Application

class aws_cdk.aws_servicecatalogappregistry_alpha.Application(scope, id, *, application_name, description=None)

Bases: Resource

(experimental) A Service Catalog AppRegistry Application.

Stability:: experimental
ExampleMetadata:: infused

Example:

application = appreg.Application(self, "MyFirstApplication",
    application_name="MyFirstApplicationName",
    description="description for my application"
)

Parameters:

scope (Construct) –
id (str) –
application_name (str) – (experimental) Enforces a particular physical application name.
description (Optional[str]) – (experimental) Description for application. Default: - No description provided

Stability:

experimental

Methods

add_attribute_group(id, *, attribute_group_name, attributes, description=None)

(experimental) Create an attribute group and associate this application with the created attribute group.

Parameters:

id (str) –
attribute_group_name (str) – (experimental) Name for attribute group.
attributes (Mapping[str, Any]) – (experimental) A JSON of nested key-value pairs that represent the attributes in the group. Attributes maybe an empty JSON ‘{}’, but must be explicitly stated.
description (Optional[str]) – (experimental) Description for attribute group. Default: - No description provided

Stability:

experimental

Return type:

IAttributeGroup

apply_removal_policy(policy)

Apply the given removal policy to this resource.

The Removal Policy controls what happens to this resource when it stops being managed by CloudFormation, either because you’ve removed it from the CDK application or because you’ve made a change that requires the resource to be replaced.

The resource can be deleted (RemovalPolicy.DESTROY), or left in your AWS account for data recovery and cleanup later (RemovalPolicy.RETAIN).

Parameters:

policy (RemovalPolicy) –

Return type:

None

associate_all_stacks_in_scope(scope)

(experimental) Associate all stacks present in construct’s aspect with application, including cross-account stacks.

NOTE: This method won’t automatically register stacks under pipeline stages, and requires association of each pipeline stage by calling this method with stage Construct.

Parameters:

scope (Construct) –

Stability:

experimental

Return type:

None

associate_application_with_stack(stack)

(experimental) Associate stack with the application in the stack passed as parameter.

A stack can only be associated with one application.

Parameters:

stack (Stack) –

Stability:

experimental

Return type:

None

associate_attribute_group(attribute_group)

(deprecated) Associate an attribute group with application If the attribute group is already associated, it will ignore duplicate request.

Parameters:

attribute_group (IAttributeGroup) –

Deprecated:

Use AttributeGroup.associateWith instead.

Stability:

deprecated

Return type:

None

associate_stack(stack)

(deprecated) Associate a stack with the application If the resource is already associated, it will ignore duplicate request.

A stack can only be associated with one application.

Parameters:

stack (Stack) –

Deprecated:

Use associateApplicationWithStack instead.

Stability:

deprecated

Return type:

None

share_application(id, *, name, accounts=None, organization_arns=None, roles=None, share_permission=None, users=None)

(experimental) Share an application with accounts, organizations and OUs, and IAM roles and users.

The application will become available to end users within those principals.

Parameters:

id (str) – The construct name for the share.
name (str) – (experimental) Name of the share.
accounts (Optional[Sequence[str]]) – (experimental) A list of AWS accounts that the application will be shared with. Default: - No accounts specified for share
organization_arns (Optional[Sequence[str]]) – (experimental) A list of AWS Organization or Organizational Units (OUs) ARNs that the application will be shared with. Default: - No AWS Organizations or OUs specified for share
roles (Optional[Sequence[IRole]]) – (experimental) A list of AWS IAM roles that the application will be shared with. Default: - No IAM roles specified for share
share_permission (Union[str, SharePermission, None]) – (experimental) An option to manage access to the application or attribute group. Default: - Principals will be assigned read only permissions on the application or attribute group.
users (Optional[Sequence[IUser]]) – (experimental) A list of AWS IAM users that the application will be shared with. Default: - No IAM Users specified for share

Stability:

experimental

Return type:

None

to_string()

Returns a string representation of this construct.

Return type:: str

Attributes

application_arn

(experimental) The ARN of the application.

Stability:: experimental

application_id

(experimental) The ID of the application.

Stability:: experimental

application_manager_url

(experimental) Application manager URL for the Application.

Stability:: experimental
Attribute:: true

application_name

(experimental) The name of the application.

Stability:: experimental

env

The environment this resource belongs to.

For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.

node: The tree node.

stack: The stack in which this resource is defined.

Static Methods

classmethod from_application_arn(scope, id, application_arn)

(experimental) Imports an Application construct that represents an external application.

Parameters:

scope (Construct) – The parent creating construct (usually this).
id (str) – The construct’s name.
application_arn (str) – the Amazon Resource Name of the existing AppRegistry Application.

Stability:

experimental

Return type:

IApplication

classmethod is_construct(x)

Checks if x is a construct.

Use this method instead of instanceof to properly detect Construct instances, even when the construct library is symlinked.

Explanation: in JavaScript, multiple copies of the constructs library on disk are seen as independent, completely different libraries. As a consequence, the class Construct in each copy of the constructs library is seen as a different class, and an instance of one class will not test as instanceof the other class. npm install will not create installations like this, but users may manually symlink construct libraries together or use a monorepo tool: in those cases, multiple copies of the constructs library can be accidentally installed, and instanceof will behave unpredictably. It is safest to avoid using instanceof, and using this type-testing method instead.

Parameters:: x (Any) – Any object.
Return type:: bool
Returns:: true if x is an object created from a class which extends Construct.

classmethod is_owned_resource(construct)

Returns true if the construct was created by CDK, and false otherwise.

Parameters:

construct (IConstruct) –

Return type:

bool

classmethod is_resource(construct)

Check whether the given construct is a Resource.

Parameters:

construct (IConstruct) –

Return type:

bool