@aws-cdk/aws-servicecatalogappregistry-alpha 2.50.0-alpha.0 → 2.51.0-alpha.0

package/.jsii

@@ -8,10 +8,88 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.50.0",
+    "aws-cdk-lib": "^2.51.0",
     "constructs": "^10.0.0"
   },
   "dependencyClosure": {
+    "@aws-cdk/asset-awscli-v1": {
+      "targets": {
+        "dotnet": {
+          "namespace": "Amazon.CDK.Asset.AwsCliV1",
+          "packageId": "Amazon.CDK.Asset.AwsCliV1"
+        },
+        "go": {
+          "moduleName": "github.com/cdklabs/awscdk-asset-awscli-go",
+          "packageName": "awscliv1"
+        },
+        "java": {
+          "maven": {
+            "artifactId": "cdk-asset-awscli-v1",
+            "groupId": "software.amazon.awscdk"
+          },
+          "package": "software.amazon.awscdk.cdk.asset.awscli.v1"
+        },
+        "js": {
+          "npm": "@aws-cdk/asset-awscli-v1"
+        },
+        "python": {
+          "distName": "aws-cdk.asset-awscli-v1",
+          "module": "aws_cdk.asset_awscli_v1"
+        }
+      }
+    },
+    "@aws-cdk/asset-kubectl-v20": {
+      "targets": {
+        "dotnet": {
+          "namespace": "Amazon.CDK.Asset.KubectlV20",
+          "packageId": "Amazon.CDK.Asset.KubectlV20"
+        },
+        "go": {
+          "moduleName": "github.com/cdklabs/awscdk-asset-kubectl-go",
+          "packageName": "kubectlv20"
+        },
+        "java": {
+          "maven": {
+            "artifactId": "cdk-asset-kubectl-v20",
+            "groupId": "software.amazon.awscdk"
+          },
+          "package": "software.amazon.awscdk.cdk.asset.kubectl.v20"
+        },
+        "js": {
+          "npm": "@aws-cdk/asset-kubectl-v20"
+        },
+        "python": {
+          "distName": "aws-cdk.asset-kubectl-v20",
+          "module": "aws_cdk.asset_kubectl_v20"
+        }
+      }
+    },
+    "@aws-cdk/asset-node-proxy-agent-v5": {
+      "targets": {
+        "dotnet": {
+          "namespace": "Amazon.CDK.Asset.NodeProxyAgentV5",
+          "packageId": "Amazon.CDK.Asset.NodeProxyAgentV5"
+        },
+        "go": {
+          "moduleName": "github.com/cdklabs/awscdk-asset-node-proxy-agent-go",
+          "packageName": "nodeproxyagentv5"
+        },
+        "java": {
+          "maven": {
+            "artifactId": "cdk-asset-node-proxy-agent-v5",
+            "groupId": "software.amazon.awscdk"
+          },
+          "package": "software.amazon.awscdk.cdk.asset.node.proxy.agent.v5"
+        },
+        "js": {
+          "npm": "@aws-cdk/asset-node-proxy-agent-v5"
+        },
+        "python": {
+          "distName": "aws-cdk.asset-node-proxy-agent-v5",
+          "module": "aws_cdk.asset_node_proxy_agent_v5"
+        }
+      }
+    },
     "aws-cdk-lib": {
       "submodules": {
         "aws-cdk-lib.alexa_ask": {
@@ -2147,6 +2225,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_organizations": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.Organizations"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.organizations"
+            },
+            "python": {
+              "module": "aws_cdk.aws_organizations"
+            }
+          }
+        },
         "aws-cdk-lib.aws_panorama": {
           "targets": {
             "dotnet": {
@@ -2316,6 +2407,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_resourceexplorer2": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.ResourceExplorer2"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.resourceexplorer2"
+            },
+            "python": {
+              "module": "aws_cdk.aws_resourceexplorer2"
+            }
+          }
+        },
         "aws-cdk-lib.aws_resourcegroups": {
           "targets": {
             "dotnet": {
@@ -2550,6 +2654,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_scheduler": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.Scheduler"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.scheduler"
+            },
+            "python": {
+              "module": "aws_cdk.aws_scheduler"
+            }
+          }
+        },
         "aws-cdk-lib.aws_sdb": {
           "targets": {
             "dotnet": {
@@ -3115,7 +3232,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/aws/aws-cdk",
-  "jsiiVersion": "1.69.0 (build f656c31)",
+  "jsiiVersion": "1.71.0 (build f1f58ae)",
   "keywords": [
     "aws",
     "cdk",
@@ -3137,7 +3254,7 @@
   },
   "name": "@aws-cdk/aws-servicecatalogappregistry-alpha",
   "readme": {
-    "markdown": "# AWS ServiceCatalogAppRegistry Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n[AWS Service Catalog App Registry](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/appregistry.html)\nenables organizations to create and manage repositores of applications and associated resources.\n\n## Table Of Contents\n\n- [Application](#application)\n- [Application-Associator](#application-associator)\n- [Attribute-Group](#attribute-group)\n- [Associations](#associations)\n  - [Associating application with an attribute group](#attribute-group-association)\n  - [Associating application with a stack](#resource-association)\n- [Sharing](#sharing)\n  - [Sharing an application](#sharing-an-application)\n  - [Sharing an attribute group](#sharing-an-attribute-group)\n\nThe `@aws-cdk/aws-servicecatalogappregistry` package contains resources that enable users to automate governance and management of their AWS resources at scale.\n\n```ts nofixture\nimport * as appreg from '@aws-cdk/aws-servicecatalogappregistry-alpha';\n```\n\n## Application\n\nAn AppRegistry application enables you to define your applications and associated resources.\nThe application name must be unique at the account level and it's immutable.\n\n```ts\nconst application = new appreg.Application(this, 'MyFirstApplication', {\n  applicationName: 'MyFirstApplicationName',\n  description: 'description for my application', // the description is optional\n});\n```\n\nAn application that has been created outside of the stack can be imported into your CDK app.\nApplications can be imported by their ARN via the `Application.fromApplicationArn()` API:\n\n```ts\nconst importedApplication = appreg.Application.fromApplicationArn(\n  this,\n  'MyImportedApplication',\n  'arn:aws:servicecatalog:us-east-1:012345678910:/applications/0aqmvxvgmry0ecc4mjhwypun6i',\n);\n```\n\n## Application-Associator\n\nIf you want to create an Application named `MyAssociatedApplication` in account `123456789012` and region `us-east-1`\nand want to associate all stacks in the `App` scope to `MyAssociatedApplication`, then use as shown in the example below:\n\n```ts\nconst app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n    applicationName: 'MyAssociatedApplication',\n    description: 'Testing associated application',\n    stackProps: {\n        stackName: 'MyAssociatedApplicationStack',\n        env: {account: '123456789012', region: 'us-east-1'},\n    },\n});\n```\n\nIf you want to re-use an existing Application with ARN: `arn:aws:servicecatalog:us-east-1:123456789012:/applications/applicationId`\nand want to associate all stacks in the `App` scope to your imported application, then use as shown in the example below:\n\n```ts\nconst app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n    applicationArnValue: 'arn:aws:servicecatalog:us-east-1:123456789012:/applications/applicationId',\n    stackProps: {\n        stackName: 'MyAssociatedApplicationStack',\n    },\n});\n```\n\nIf you are using CDK Pipelines to deploy your application, the application stacks will be inside Stages, and\nApplicationAssociator will not be able to find them. Call `associateStage` on each Stage object before adding it to the\nPipeline, as shown in the example below:\n\n```ts\nimport * as cdk from \"aws-cdk-lib\";\nimport * as codepipeline from \"aws-cdk-lib/pipelines\";\nimport * as codecommit from \"aws-cdk-lib/aws-codecommit\";\ndeclare const repo: codecommit.Repository;\ndeclare const pipeline: codepipeline.CodePipeline;\ndeclare const beta: cdk.Stage;\nclass ApplicationPipelineStack extends cdk.Stack {\n  constructor(scope: cdk.App, id: string, props: ApplicationPipelineStackProps) {\n    super(scope, id, props);\n\n   //associate the stage to application associator.\n   props.application.associateStage(beta);\n   pipeline.addStage(beta);\n  }\n};\n\ninterface ApplicationPipelineStackProps extends cdk.StackProps {\n  application: appreg.ApplicationAssociator;\n};\n\nconst app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n    applicationName: 'MyPipelineAssociatedApplication',\n    description: 'Testing pipeline associated app',\n    stackProps: {\n        stackName: 'MyPipelineAssociatedApplicationStack',\n        env: {account: '123456789012', region: 'us-east-1'},\n    },\n});\n\nconst cdkPipeline = new ApplicationPipelineStack(app, 'CDKApplicationPipelineStack', {\n    application: associatedApp,\n    env: {account: '123456789012', region: 'us-east-1'},\n});\n```\n\n## Attribute Group\n\nAn AppRegistry attribute group acts as a container for user-defined attributes for an application.\nMetadata is attached in a machine-readble format to integrate with automated workflows and tools.\n\n```ts\nconst attributeGroup = new appreg.AttributeGroup(this, 'MyFirstAttributeGroup', {\n  attributeGroupName: 'MyFirstAttributeGroupName',\n  description: 'description for my attribute group', // the description is optional,\n  attributes: {\n    project: 'foo',\n    team: ['member1', 'member2', 'member3'],\n    public: false,\n    stages: {\n      alpha: 'complete',\n      beta: 'incomplete',\n      release: 'not started'\n    }\n  }\n});\n```\n\nAn attribute group that has been created outside of the stack can be imported into your CDK app.\nAttribute groups can be imported by their ARN via the `AttributeGroup.fromAttributeGroupArn()` API:\n\n```ts\nconst importedAttributeGroup = appreg.AttributeGroup.fromAttributeGroupArn(\n  this,\n  'MyImportedAttrGroup',\n  'arn:aws:servicecatalog:us-east-1:012345678910:/attribute-groups/0aqmvxvgmry0ecc4mjhwypun6i',\n);\n```\n\n## Associations\n\nYou can associate your appregistry application with attribute groups and resources.\nResources are CloudFormation stacks that you can associate with an application to group relevant\nstacks together to enable metadata rich insights into your applications and resources.\nA Cloudformation stack can only be associated with one appregistry application.\nIf a stack is associated with multiple applications in your app or is already associated with one,\nCDK will fail at deploy time.\n\n### Associating application with an attribute group\n\nYou can associate an attribute group with an application with the `associateAttributeGroup()` API:\n\n```ts\ndeclare const application: appreg.Application;\ndeclare const attributeGroup: appreg.AttributeGroup;\napplication.associateAttributeGroup(attributeGroup);\n```\n\n### Associating application with a Stack\n\nYou can associate a stack with an application with the `associateStack()` API:\n\n```ts\nconst app = new App();\nconst myStack = new Stack(app, 'MyStack');\n\ndeclare const application: appreg.Application;\napplication.associateStack(myStack);\n```\n\n## Sharing\n\nYou can share your AppRegistry applications and attribute groups with AWS Organizations, Organizational Units (OUs), AWS accounts within an organization, as well as IAM roles and users. AppRegistry requires that AWS Organizations is enabled in an account before deploying a share of an application or attribute group.\n\n### Sharing an application\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const application: appreg.Application;\ndeclare const myRole: iam.IRole;\ndeclare const myUser: iam.IUser;\napplication.shareApplication({\n  accounts: ['123456789012'],\n  organizationArns: ['arn:aws:organizations::123456789012:organization/o-my-org-id'],\n  roles: [myRole],\n  users: [myUser],\n});\n```\n\nE.g., sharing an application with multiple accounts and allowing the accounts to associate resources to the application.\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const application: appreg.Application;\napplication.shareApplication({\n  accounts: ['123456789012', '234567890123'],\n  sharePermission: appreg.SharePermission.ALLOW_ACCESS,\n});\n```\n\n### Sharing an attribute group\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const attributeGroup: appreg.AttributeGroup;\ndeclare const myRole: iam.IRole;\ndeclare const myUser: iam.IUser;\nattributeGroup.shareAttributeGroup({\n  accounts: ['123456789012'],\n  organizationArns: ['arn:aws:organizations::123456789012:organization/o-my-org-id'],\n  roles: [myRole],\n  users: [myUser],\n});\n```\n\nE.g., sharing an application with multiple accounts and allowing the accounts to associate applications to the attribute group.\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const attributeGroup: appreg.AttributeGroup;\nattributeGroup.shareAttributeGroup({\n  accounts: ['123456789012', '234567890123'],\n  sharePermission: appreg.SharePermission.ALLOW_ACCESS,\n});\n```\n"
+    "markdown": "# AWS ServiceCatalogAppRegistry Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n[AWS Service Catalog App Registry](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/appregistry.html)\nenables organizations to create and manage repositores of applications and associated resources.\n\n## Table Of Contents\n\n- [Application](#application)\n- [Application-Associator](#application-associator)\n- [Attribute-Group](#attribute-group)\n- [Associations](#associations)\n  - [Associating application with an attribute group](#attribute-group-association)\n  - [Associating application with a stack](#resource-association)\n- [Sharing](#sharing)\n  - [Sharing an application](#sharing-an-application)\n  - [Sharing an attribute group](#sharing-an-attribute-group)\n\nThe `@aws-cdk/aws-servicecatalogappregistry` package contains resources that enable users to automate governance and management of their AWS resources at scale.\n\n```ts nofixture\nimport * as appreg from '@aws-cdk/aws-servicecatalogappregistry-alpha';\n```\n\n## Application\n\nAn AppRegistry application enables you to define your applications and associated resources.\nThe application name must be unique at the account level and it's immutable.\n\n```ts\nconst application = new appreg.Application(this, 'MyFirstApplication', {\n  applicationName: 'MyFirstApplicationName',\n  description: 'description for my application', // the description is optional\n});\n```\n\nAn application that has been created outside of the stack can be imported into your CDK app.\nApplications can be imported by their ARN via the `Application.fromApplicationArn()` API:\n\n```ts\nconst importedApplication = appreg.Application.fromApplicationArn(\n  this,\n  'MyImportedApplication',\n  'arn:aws:servicecatalog:us-east-1:012345678910:/applications/0aqmvxvgmry0ecc4mjhwypun6i',\n);\n```\n\n## Application-Associator\n\nIf you want to create an Application named `MyAssociatedApplication` in account `123456789012` and region `us-east-1`\nand want to associate all stacks in the `App` scope to `MyAssociatedApplication`, then use as shown in the example below:\n\n```ts\nconst app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n  applications: [appreg.TargetApplication.createApplicationStack({\n    applicationName: 'MyAssociatedApplication',\n    // 'Application containing stacks deployed via CDK.' is the default\n    applicationDescription: 'Associated Application description',\n    stackName: 'MyAssociatedApplicationStack',\n    // AWS Account and Region that are implied by the current CLI configuration is the default\n    env: { account: '123456789012', region: 'us-east-1' },\n  })],\n});\n```\n\nIf you want to re-use an existing Application with ARN: `arn:aws:servicecatalog:us-east-1:123456789012:/applications/applicationId`\nand want to associate all stacks in the `App` scope to your imported application, then use as shown in the example below:\n\n```ts\nconst app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n  applications: [appreg.TargetApplication.existingApplicationFromArn({\n    applicationArnValue: 'arn:aws:servicecatalog:us-east-1:123456789012:/applications/applicationId',\n    stackName: 'MyAssociatedApplicationStack',\n  })],\n});\n```\n\nIf you are using CDK Pipelines to deploy your application, the application stacks will be inside Stages, and\nApplicationAssociator will not be able to find them. Call `associateStage` on each Stage object before adding it to the\nPipeline, as shown in the example below:\n\n```ts\nimport * as cdk from \"aws-cdk-lib\";\nimport * as codepipeline from \"aws-cdk-lib/pipelines\";\nimport * as codecommit from \"aws-cdk-lib/aws-codecommit\";\ndeclare const repo: codecommit.Repository;\ndeclare const pipeline: codepipeline.CodePipeline;\ndeclare const beta: cdk.Stage;\nclass ApplicationPipelineStack extends cdk.Stack {\n  constructor(scope: cdk.App, id: string, props: ApplicationPipelineStackProps) {\n    super(scope, id, props);\n\n   //associate the stage to application associator.\n   props.application.associateStage(beta);\n   pipeline.addStage(beta);\n  }\n};\n\ninterface ApplicationPipelineStackProps extends cdk.StackProps {\n  application: appreg.ApplicationAssociator;\n};\n\nconst app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n  applications: [appreg.TargetApplication.createApplicationStack({\n    applicationName: 'MyPipelineAssociatedApplication',\n    stackName: 'MyPipelineAssociatedApplicationStack',\n    env: { account: '123456789012', region: 'us-east-1' },\n  })],\n});\n\nconst cdkPipeline = new ApplicationPipelineStack(app, 'CDKApplicationPipelineStack', {\n    application: associatedApp,\n    env: {account: '123456789012', region: 'us-east-1'},\n});\n```\n\n## Attribute Group\n\nAn AppRegistry attribute group acts as a container for user-defined attributes for an application.\nMetadata is attached in a machine-readble format to integrate with automated workflows and tools.\n\n```ts\nconst attributeGroup = new appreg.AttributeGroup(this, 'MyFirstAttributeGroup', {\n  attributeGroupName: 'MyFirstAttributeGroupName',\n  description: 'description for my attribute group', // the description is optional,\n  attributes: {\n    project: 'foo',\n    team: ['member1', 'member2', 'member3'],\n    public: false,\n    stages: {\n      alpha: 'complete',\n      beta: 'incomplete',\n      release: 'not started'\n    }\n  }\n});\n```\n\nAn attribute group that has been created outside of the stack can be imported into your CDK app.\nAttribute groups can be imported by their ARN via the `AttributeGroup.fromAttributeGroupArn()` API:\n\n```ts\nconst importedAttributeGroup = appreg.AttributeGroup.fromAttributeGroupArn(\n  this,\n  'MyImportedAttrGroup',\n  'arn:aws:servicecatalog:us-east-1:012345678910:/attribute-groups/0aqmvxvgmry0ecc4mjhwypun6i',\n);\n```\n\n## Associations\n\nYou can associate your appregistry application with attribute groups and resources.\nResources are CloudFormation stacks that you can associate with an application to group relevant\nstacks together to enable metadata rich insights into your applications and resources.\nA Cloudformation stack can only be associated with one appregistry application.\nIf a stack is associated with multiple applications in your app or is already associated with one,\nCDK will fail at deploy time.\n\n### Associating application with an attribute group\n\nYou can associate an attribute group with an application with the `associateAttributeGroup()` API:\n\n```ts\ndeclare const application: appreg.Application;\ndeclare const attributeGroup: appreg.AttributeGroup;\napplication.associateAttributeGroup(attributeGroup);\n```\n\n### Associating application with a Stack\n\nYou can associate a stack with an application with the `associateStack()` API:\n\n```ts\nconst app = new App();\nconst myStack = new Stack(app, 'MyStack');\n\ndeclare const application: appreg.Application;\napplication.associateStack(myStack);\n```\n\n## Sharing\n\nYou can share your AppRegistry applications and attribute groups with AWS Organizations, Organizational Units (OUs), AWS accounts within an organization, as well as IAM roles and users. AppRegistry requires that AWS Organizations is enabled in an account before deploying a share of an application or attribute group.\n\n### Sharing an application\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const application: appreg.Application;\ndeclare const myRole: iam.IRole;\ndeclare const myUser: iam.IUser;\napplication.shareApplication({\n  accounts: ['123456789012'],\n  organizationArns: ['arn:aws:organizations::123456789012:organization/o-my-org-id'],\n  roles: [myRole],\n  users: [myUser],\n});\n```\n\nE.g., sharing an application with multiple accounts and allowing the accounts to associate resources to the application.\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const application: appreg.Application;\napplication.shareApplication({\n  accounts: ['123456789012', '234567890123'],\n  sharePermission: appreg.SharePermission.ALLOW_ACCESS,\n});\n```\n\n### Sharing an attribute group\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const attributeGroup: appreg.AttributeGroup;\ndeclare const myRole: iam.IRole;\ndeclare const myUser: iam.IUser;\nattributeGroup.shareAttributeGroup({\n  accounts: ['123456789012'],\n  organizationArns: ['arn:aws:organizations::123456789012:organization/o-my-org-id'],\n  roles: [myRole],\n  users: [myUser],\n});\n```\n\nE.g., sharing an application with multiple accounts and allowing the accounts to associate applications to the attribute group.\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const attributeGroup: appreg.AttributeGroup;\nattributeGroup.shareAttributeGroup({\n  accounts: ['123456789012', '234567890123'],\n  sharePermission: appreg.SharePermission.ALLOW_ACCESS,\n});\n```\n"
   },
   "repository": {
     "directory": "packages/individual-packages/aws-servicecatalogappregistry",
@@ -3468,7 +3585,7 @@
         "remarks": "The application name must be unique at the account level and it's immutable.\nThis construct will automatically associate all stacks in the given scope, however\nin case of a `Pipeline` stack, stage underneath the pipeline will not automatically be associated and\nneeds to be associated separately.\n\nIf cross account stack is detected, then this construct will automatically share the application to consumer accounts.\nCross account feature will only work for non environment agnostic stacks.",
         "stability": "experimental",
         "summary": "An AppRegistry construct to automatically create an application with the given name and description.",
-        "example": "const app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n    applicationName: 'MyAssociatedApplication',\n    description: 'Testing associated application',\n    stackProps: {\n        stackName: 'MyAssociatedApplicationStack',\n        env: {account: '123456789012', region: 'us-east-1'},\n    },\n});",
+        "example": "const app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n  applications: [appreg.TargetApplication.createApplicationStack({\n    applicationName: 'MyAssociatedApplication',\n    // 'Application containing stacks deployed via CDK.' is the default\n    applicationDescription: 'Associated Application description',\n    stackName: 'MyAssociatedApplicationStack',\n    // AWS Account and Region that are implied by the current CLI configuration is the default\n    env: { account: '123456789012', region: 'us-east-1' },\n  })],\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
@@ -3480,7 +3597,7 @@
         },
         "locationInModule": {
           "filename": "lib/application-associator.ts",
-          "line": 56
+          "line": 37
         },
         "parameters": [
           {
@@ -3506,9 +3623,25 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/application-associator.ts",
-        "line": 49
+        "line": 30
       },
       "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Get the AppRegistry application."
+          },
+          "locationInModule": {
+            "filename": "lib/application-associator.ts",
+            "line": 71
+          },
+          "name": "appRegistryApplication",
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication"
+            }
+          }
+        },
         {
           "docs": {
             "stability": "experimental",
@@ -3516,7 +3649,7 @@
           },
           "locationInModule": {
             "filename": "lib/application-associator.ts",
-            "line": 79
+            "line": 53
           },
           "name": "associateStage",
           "parameters": [
@@ -3540,7 +3673,7 @@
           },
           "locationInModule": {
             "filename": "lib/application-associator.ts",
-            "line": 89
+            "line": 63
           },
           "name": "isStageAssociated",
           "parameters": [
@@ -3559,23 +3692,6 @@
         }
       ],
       "name": "ApplicationAssociator",
-      "properties": [
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Get the AppRegistry application."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/application-associator.ts",
-            "line": 97
-          },
-          "name": "appRegistryApplication",
-          "type": {
-            "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication"
-          }
-        }
-      ],
       "symbolId": "lib/application-associator:ApplicationAssociator"
     },
     "@aws-cdk/aws-servicecatalogappregistry-alpha.ApplicationAssociatorProps": {
@@ -3583,8 +3699,8 @@
       "datatype": true,
       "docs": {
         "stability": "experimental",
-        "summary": "Properties for a Service Catalog AppRegistry AutoApplication.",
-        "example": "const app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n    applicationName: 'MyAssociatedApplication',\n    description: 'Testing associated application',\n    stackProps: {\n        stackName: 'MyAssociatedApplicationStack',\n        env: {account: '123456789012', region: 'us-east-1'},\n    },\n});",
+        "summary": "Properties for Service Catalog AppRegistry Application Associator.",
+        "example": "const app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n  applications: [appreg.TargetApplication.createApplicationStack({\n    applicationName: 'MyAssociatedApplication',\n    // 'Application containing stacks deployed via CDK.' is the default\n    applicationDescription: 'Associated Application description',\n    stackName: 'MyAssociatedApplicationStack',\n    // AWS Account and Region that are implied by the current CLI configuration is the default\n    env: { account: '123456789012', region: 'us-east-1' },\n  })],\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
@@ -3593,78 +3709,30 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/application-associator.ts",
-        "line": 9
+        "line": 10
       },
       "name": "ApplicationAssociatorProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
+            "default": "- Empty array.",
             "stability": "experimental",
-            "summary": "Stack properties."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/application-associator.ts",
-            "line": 35
-          },
-          "name": "stackProps",
-          "type": {
-            "fqn": "aws-cdk-lib.StackProps"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "- No application arn.",
-            "stability": "experimental",
-            "summary": "Enforces a particular application arn."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/application-associator.ts",
-            "line": 22
-          },
-          "name": "applicationArnValue",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "- No name.",
-            "stability": "experimental",
-            "summary": "Enforces a particular physical application name."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/application-associator.ts",
-            "line": 15
-          },
-          "name": "applicationName",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "- No description.",
-            "stability": "experimental",
-            "summary": "Application description."
+            "summary": "Application associator properties."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application-associator.ts",
-            "line": 29
+            "line": 16
           },
-          "name": "description",
-          "optional": true,
+          "name": "applications",
           "type": {
-            "primitive": "string"
+            "collection": {
+              "elementtype": {
+                "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.TargetApplication"
+              },
+              "kind": "array"
+            }
           }
         }
       ],
@@ -3983,6 +4051,144 @@
       ],
       "symbolId": "lib/attribute-group:AttributeGroupProps"
     },
+    "@aws-cdk/aws-servicecatalogappregistry-alpha.BindTargetApplicationResult": {
+      "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Properties for Service Catalog AppRegistry Application Associator to work with.",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as servicecatalogappregistry_alpha from '@aws-cdk/aws-servicecatalogappregistry-alpha';\n\ndeclare const application: servicecatalogappregistry_alpha.Application;\nconst bindTargetApplicationResult: servicecatalogappregistry_alpha.BindTargetApplicationResult = {\n  application: application,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
+      },
+      "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.BindTargetApplicationResult",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/target-application.ts",
+        "line": 75
+      },
+      "name": "BindTargetApplicationResult",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Created or imported application."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/target-application.ts",
+            "line": 79
+          },
+          "name": "application",
+          "type": {
+            "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication"
+          }
+        }
+      ],
+      "symbolId": "lib/target-application:BindTargetApplicationResult"
+    },
+    "@aws-cdk/aws-servicecatalogappregistry-alpha.CreateTargetApplicationOptions": {
+      "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Properties used to define New TargetApplication.",
+        "example": "const app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n  applications: [appreg.TargetApplication.createApplicationStack({\n    applicationName: 'MyAssociatedApplication',\n    // 'Application containing stacks deployed via CDK.' is the default\n    applicationDescription: 'Associated Application description',\n    stackName: 'MyAssociatedApplicationStack',\n    // AWS Account and Region that are implied by the current CLI configuration is the default\n    env: { account: '123456789012', region: 'us-east-1' },\n  })],\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.CreateTargetApplicationOptions",
+      "interfaces": [
+        "@aws-cdk/aws-servicecatalogappregistry-alpha.TargetApplicationCommonOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/target-application.ts",
+        "line": 21
+      },
+      "name": "CreateTargetApplicationOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Enforces a particular physical application name."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/target-application.ts",
+            "line": 25
+          },
+          "name": "applicationName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- Application containing stacks deployed via CDK.",
+            "stability": "experimental",
+            "summary": "Application description."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/target-application.ts",
+            "line": 32
+          },
+          "name": "applicationDescription",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/target-application:CreateTargetApplicationOptions"
+    },
+    "@aws-cdk/aws-servicecatalogappregistry-alpha.ExistingTargetApplicationOptions": {
+      "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Properties used to define Existing TargetApplication.",
+        "example": "const app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n  applications: [appreg.TargetApplication.existingApplicationFromArn({\n    applicationArnValue: 'arn:aws:servicecatalog:us-east-1:123456789012:/applications/applicationId',\n    stackName: 'MyAssociatedApplicationStack',\n  })],\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ExistingTargetApplicationOptions",
+      "interfaces": [
+        "@aws-cdk/aws-servicecatalogappregistry-alpha.TargetApplicationCommonOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/target-application.ts",
+        "line": 38
+      },
+      "name": "ExistingTargetApplicationOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Enforces a particular application arn."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/target-application.ts",
+            "line": 42
+          },
+          "name": "applicationArnValue",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/target-application:ExistingTargetApplicationOptions"
+    },
     "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication": {
       "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
       "docs": {
@@ -4438,8 +4644,153 @@
       ],
       "name": "SharePermission",
       "symbolId": "lib/common:SharePermission"
+    },
+    "@aws-cdk/aws-servicecatalogappregistry-alpha.TargetApplication": {
+      "abstract": true,
+      "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Contains static factory methods with which you can build the input needed for application associator to work.",
+        "example": "const app = new App();\nconst associatedApp = new appreg.ApplicationAssociator(app, 'AssociatedApplication', {\n  applications: [appreg.TargetApplication.createApplicationStack({\n    applicationName: 'MyAssociatedApplication',\n    // 'Application containing stacks deployed via CDK.' is the default\n    applicationDescription: 'Associated Application description',\n    stackName: 'MyAssociatedApplicationStack',\n    // AWS Account and Region that are implied by the current CLI configuration is the default\n    env: { account: '123456789012', region: 'us-east-1' },\n  })],\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.TargetApplication",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "lib/target-application.ts",
+        "line": 49
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Factory method to build the input using the provided application name and stack props."
+          },
+          "locationInModule": {
+            "filename": "lib/target-application.ts",
+            "line": 62
+          },
+          "name": "createApplicationStack",
+          "parameters": [
+            {
+              "name": "options",
+              "type": {
+                "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.CreateTargetApplicationOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.TargetApplication"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Factory method to build the input using the provided application ARN."
+          },
+          "locationInModule": {
+            "filename": "lib/target-application.ts",
+            "line": 54
+          },
+          "name": "existingApplicationFromArn",
+          "parameters": [
+            {
+              "name": "options",
+              "type": {
+                "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ExistingTargetApplicationOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.TargetApplication"
+            }
+          },
+          "static": true
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Called when the ApplicationAssociator is initialized."
+          },
+          "locationInModule": {
+            "filename": "lib/target-application.ts",
+            "line": 69
+          },
+          "name": "bind",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.BindTargetApplicationResult"
+            }
+          }
+        }
+      ],
+      "name": "TargetApplication",
+      "symbolId": "lib/target-application:TargetApplication"
+    },
+    "@aws-cdk/aws-servicecatalogappregistry-alpha.TargetApplicationCommonOptions": {
+      "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Properties used to define targetapplication.",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as servicecatalogappregistry_alpha from '@aws-cdk/aws-servicecatalogappregistry-alpha';\nimport * as cdk from 'aws-cdk-lib';\n\ndeclare const stackSynthesizer: cdk.StackSynthesizer;\nconst targetApplicationCommonOptions: servicecatalogappregistry_alpha.TargetApplicationCommonOptions = {\n  analyticsReporting: false,\n  crossRegionReferences: false,\n  description: 'description',\n  env: {\n    account: 'account',\n    region: 'region',\n  },\n  stackId: 'stackId',\n  stackName: 'stackName',\n  synthesizer: stackSynthesizer,\n  tags: {\n    tagsKey: 'tags',\n  },\n  terminationProtection: false,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
+      },
+      "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.TargetApplicationCommonOptions",
+      "interfaces": [
+        "aws-cdk-lib.StackProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/target-application.ts",
+        "line": 8
+      },
+      "name": "TargetApplicationCommonOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- ApplicationAssociatorStack",
+            "stability": "experimental",
+            "summary": "Stack ID in which application will be created or imported."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/target-application.ts",
+            "line": 14
+          },
+          "name": "stackId",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/target-application:TargetApplicationCommonOptions"
     }
   },
-  "version": "2.50.0-alpha.0",
+  "version": "2.51.0-alpha.0",
   "fingerprint": "**********"
 }