Skip to content
v2.276.0

IApplication Interface ​

Properties ​

applicationArnstringapplication_arnstrapplicationArnStringApplicationArnstringApplicationArn*string#
The Amazon Resource Name (ARN) of the application.
applicationIdstringapplication_idstrapplicationIdStringApplicationIdstringApplicationId*string#
The ID of the application.
applicationRefApplicationReferenceapplication_refApplicationReferenceapplicationRefApplicationReferenceApplicationRefApplicationReferenceApplicationRefApplicationReference#
A reference to a Application resource.
descriptionmay be undefinedstringdescriptionmay be undefinedstrdescriptionmay be undefinedStringDescriptionmay be undefinedstringDescriptionmay be undefined*string#
The description of the application.
The environment this resource belongs to.
notes

For resources that are created and managed in a Stack (those created by creating new class instances like new Role(), new Bucket(), etc.), this is always the same as the environment of the stack they belong to.

For referenced resources (those obtained from referencing methods like Role.fromRoleArn(), Bucket.fromBucketName(), etc.), they might be different than the stack they were imported into.

namemay be undefinedstringnamemay be undefinedstrnamemay be undefinedStringNamemay be undefinedstringNamemay be undefined*string#
The name of the application.
nodeNodenodeNodenodeNodeNodeNodeNodeNode#
The tree node.
stackStackstackStackstackStackStackStackStackStack#
The stack in which this resource is defined.

Methods ​

addEnvironment(id: string, options?: EnvironmentOptions): IEnvironmentdef add_environment(self, id: str, options: typing.Optional[EnvironmentOptions] = None) -> IEnvironmentpublic IEnvironment addEnvironment(String id, EnvironmentOptions options)public IEnvironment AddEnvironment(string id, EnvironmentOptions? options = null)func AddEnvironment(Id *string, Options EnvironmentOptions) IEnvironment#
Adds an environment.
2 parameters

Parameters

  • ididididId — The name of the environment construct.
  • optionsoptionsoptionsoptionsOptions — The options for the environment construct.
addExistingEnvironment(environment: IEnvironmentRef): voiddef add_existing_environment(self, environment: IEnvironmentRef) -> Nonepublic void addExistingEnvironment(IEnvironmentRef environment)public void AddExistingEnvironment(IEnvironmentRef environment)func AddExistingEnvironment(Environment IEnvironmentRef)#
Adds an existing environment.
1 parameter

Parameters

  • environmentenvironmentenvironmentenvironmentEnvironment — The environment.
addExtension(extension: IExtension): voiddef add_extension(self, extension: IExtension) -> Nonepublic void addExtension(IExtension extension)public void AddExtension(IExtension extension)func AddExtension(Extension IExtension)#
Adds an extension association to the application.
1 parameter

Parameters

  • extensionextensionextensionextensionExtension — The extension to create an association for.
addHostedConfiguration(id: string, options: HostedConfigurationOptions): HostedConfigurationdef add_hosted_configuration(self, id: str, options: HostedConfigurationOptions) -> HostedConfigurationpublic HostedConfiguration addHostedConfiguration(String id, HostedConfigurationOptions options)public HostedConfiguration AddHostedConfiguration(string id, HostedConfigurationOptions options)func AddHostedConfiguration(Id *string, Options HostedConfigurationOptions) HostedConfiguration#
Adds a hosted configuration.
2 parameters

Parameters

  • ididididId — The name of the hosted configuration construct.
  • optionsoptionsoptionsoptionsOptions — The options for the hosted configuration construct.
addSourcedConfiguration(id: string, options: SourcedConfigurationOptions): SourcedConfigurationdef add_sourced_configuration(self, id: str, options: SourcedConfigurationOptions) -> SourcedConfigurationpublic SourcedConfiguration addSourcedConfiguration(String id, SourcedConfigurationOptions options)public SourcedConfiguration AddSourcedConfiguration(string id, SourcedConfigurationOptions options)func AddSourcedConfiguration(Id *string, Options SourcedConfigurationOptions) SourcedConfiguration#
Adds a sourced configuration.
2 parameters

Parameters

  • ididididId — The name of the sourced configuration construct.
  • optionsoptionsoptionsoptionsOptions — The options for the sourced configuration construct.
applyRemovalPolicy(policy: RemovalPolicy): voiddef apply_removal_policy(self, policy: RemovalPolicy) -> Nonepublic void applyRemovalPolicy(RemovalPolicy policy)public void ApplyRemovalPolicy(RemovalPolicy policy)func ApplyRemovalPolicy(Policy RemovalPolicy)#
Apply the given removal policy to this resource.
notes

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).

atDeploymentTick(eventDestination: IEventDestination, options?: ExtensionOptions): voiddef at_deployment_tick(self, event_destination: IEventDestination, options: typing.Optional[ExtensionOptions] = None) -> Nonepublic void atDeploymentTick(IEventDestination eventDestination, ExtensionOptions options)public void AtDeploymentTick(IEventDestination eventDestination, ExtensionOptions? options = null)func AtDeploymentTick(EventDestination IEventDestination, Options ExtensionOptions)#
Adds an AT_DEPLOYMENT_TICK extension with the provided event destination and also creates an extension association to an application.
2 parameters

Parameters

  • eventDestinationevent_destinationeventDestinationeventDestinationEventDestination — The event that occurs during the extension.
  • optionsoptionsoptionsoptionsOptions — Options for the extension.
environments(): IEnvironment[]def environments(self, ) -> typing.List[IEnvironment]public List<IEnvironment> environments()public IEnvironment[] Environments()func Environments() *[]IEnvironment#
Returns the list of associated environments.
on(actionPoint: ActionPoint, eventDestination: IEventDestination, options?: ExtensionOptions): voiddef on(self, action_point: ActionPoint, event_destination: IEventDestination, options: typing.Optional[ExtensionOptions] = None) -> Nonepublic void on(ActionPoint actionPoint, IEventDestination eventDestination, ExtensionOptions options)public void On(ActionPoint actionPoint, IEventDestination eventDestination, ExtensionOptions? options = null)func On(ActionPoint ActionPoint, EventDestination IEventDestination, Options ExtensionOptions)#
Adds an extension defined by the action point and event destination and also creates an extension association to an application.
3 parameters

Parameters

  • actionPointaction_pointactionPointactionPointActionPoint — The action point which triggers the event.
  • eventDestinationevent_destinationeventDestinationeventDestinationEventDestination — The event that occurs during the extension.
  • optionsoptionsoptionsoptionsOptions — Options for the extension.
onDeploymentBaking(eventDestination: IEventDestination, options?: ExtensionOptions): voiddef on_deployment_baking(self, event_destination: IEventDestination, options: typing.Optional[ExtensionOptions] = None) -> Nonepublic void onDeploymentBaking(IEventDestination eventDestination, ExtensionOptions options)public void OnDeploymentBaking(IEventDestination eventDestination, ExtensionOptions? options = null)func OnDeploymentBaking(EventDestination IEventDestination, Options ExtensionOptions)#
Adds an ON_DEPLOYMENT_BAKING extension with the provided event destination and also creates an extension association to an application.
2 parameters

Parameters

  • eventDestinationevent_destinationeventDestinationeventDestinationEventDestination — The event that occurs during the extension.
  • optionsoptionsoptionsoptionsOptions — Options for the extension.
onDeploymentComplete(eventDestination: IEventDestination, options?: ExtensionOptions): voiddef on_deployment_complete(self, event_destination: IEventDestination, options: typing.Optional[ExtensionOptions] = None) -> Nonepublic void onDeploymentComplete(IEventDestination eventDestination, ExtensionOptions options)public void OnDeploymentComplete(IEventDestination eventDestination, ExtensionOptions? options = null)func OnDeploymentComplete(EventDestination IEventDestination, Options ExtensionOptions)#
Adds an ON_DEPLOYMENT_COMPLETE extension with the provided event destination and also creates an extension association to an application.
2 parameters

Parameters

  • eventDestinationevent_destinationeventDestinationeventDestinationEventDestination — The event that occurs during the extension.
  • optionsoptionsoptionsoptionsOptions — Options for the extension.
onDeploymentRolledBack(eventDestination: IEventDestination, options?: ExtensionOptions): voiddef on_deployment_rolled_back(self, event_destination: IEventDestination, options: typing.Optional[ExtensionOptions] = None) -> Nonepublic void onDeploymentRolledBack(IEventDestination eventDestination, ExtensionOptions options)public void OnDeploymentRolledBack(IEventDestination eventDestination, ExtensionOptions? options = null)func OnDeploymentRolledBack(EventDestination IEventDestination, Options ExtensionOptions)#
Adds an ON_DEPLOYMENT_ROLLED_BACK extension with the provided event destination and also creates an extension association to an application.
2 parameters

Parameters

  • eventDestinationevent_destinationeventDestinationeventDestinationEventDestination — The event that occurs during the extension.
  • optionsoptionsoptionsoptionsOptions — Options for the extension.
onDeploymentStart(eventDestination: IEventDestination, options?: ExtensionOptions): voiddef on_deployment_start(self, event_destination: IEventDestination, options: typing.Optional[ExtensionOptions] = None) -> Nonepublic void onDeploymentStart(IEventDestination eventDestination, ExtensionOptions options)public void OnDeploymentStart(IEventDestination eventDestination, ExtensionOptions? options = null)func OnDeploymentStart(EventDestination IEventDestination, Options ExtensionOptions)#
Adds an ON_DEPLOYMENT_START extension with the provided event destination and also creates an extension association to an application.
2 parameters

Parameters

  • eventDestinationevent_destinationeventDestinationeventDestinationEventDestination — The event that occurs during the extension.
  • optionsoptionsoptionsoptionsOptions — Options for the extension.
onDeploymentStep(eventDestination: IEventDestination, options?: ExtensionOptions): voiddef on_deployment_step(self, event_destination: IEventDestination, options: typing.Optional[ExtensionOptions] = None) -> Nonepublic void onDeploymentStep(IEventDestination eventDestination, ExtensionOptions options)public void OnDeploymentStep(IEventDestination eventDestination, ExtensionOptions? options = null)func OnDeploymentStep(EventDestination IEventDestination, Options ExtensionOptions)#
Adds an ON_DEPLOYMENT_STEP extension with the provided event destination and also creates an extension association to an application.
2 parameters

Parameters

  • eventDestinationevent_destinationeventDestinationeventDestinationEventDestination — The event that occurs during the extension.
  • optionsoptionsoptionsoptionsOptions — Options for the extension.
preCreateHostedConfigurationVersion(eventDestination: IEventDestination, options?: ExtensionOptions): voiddef pre_create_hosted_configuration_version(self, event_destination: IEventDestination, options: typing.Optional[ExtensionOptions] = None) -> Nonepublic void preCreateHostedConfigurationVersion(IEventDestination eventDestination, ExtensionOptions options)public void PreCreateHostedConfigurationVersion(IEventDestination eventDestination, ExtensionOptions? options = null)func PreCreateHostedConfigurationVersion(EventDestination IEventDestination, Options ExtensionOptions)#
Adds a PRE_CREATE_HOSTED_CONFIGURATION_VERSION extension with the provided event destination and also creates an extension association to an application.
2 parameters

Parameters

  • eventDestinationevent_destinationeventDestinationeventDestinationEventDestination — The event that occurs during the extension.
  • optionsoptionsoptionsoptionsOptions — Options for the extension.
preStartDeployment(eventDestination: IEventDestination, options?: ExtensionOptions): voiddef pre_start_deployment(self, event_destination: IEventDestination, options: typing.Optional[ExtensionOptions] = None) -> Nonepublic void preStartDeployment(IEventDestination eventDestination, ExtensionOptions options)public void PreStartDeployment(IEventDestination eventDestination, ExtensionOptions? options = null)func PreStartDeployment(EventDestination IEventDestination, Options ExtensionOptions)#
Adds a PRE_START_DEPLOYMENT extension with the provided event destination and also creates an extension association to an application.
2 parameters

Parameters

  • eventDestinationevent_destinationeventDestinationeventDestinationEventDestination — The event that occurs during the extension.
  • optionsoptionsoptionsoptionsOptions — Options for the extension.
with(...mixins: IMixin[]): IConstructdef with(self, mixins: IMixin) -> IConstructpublic IConstruct with(IMixin mixins)public IConstruct With(IMixin mixins)func With(Mixins IMixin) IConstruct#
Applies one or more mixins to this construct.

Mixins are applied in order. The list of constructs is captured at the start of the call, so constructs added by a mixin will not be visited.

1 parameter · returns

Parameters

  • mixinsmixinsmixinsmixinsMixins — The mixins to apply.

Returns: This construct for chaining