@aws-cdk/aws-servicecatalogappregistry-alpha 2.38.1-alpha.0 → 2.40.0-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.38.1",
+    "aws-cdk-lib": "^2.40.0",
     "constructs": "^10.0.0"
   },
   "dependencyClosure": {
@@ -3024,7 +3024,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/aws/aws-cdk",
-  "jsiiVersion": "1.63.2 (build a8a8833)",
+  "jsiiVersion": "1.66.0 (build 3c9512b)",
   "keywords": [
     "aws",
     "cdk",
@@ -3046,7 +3046,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- [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\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, but is mutable.\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## 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"
+    "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- [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, but is mutable.\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## 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",
@@ -3090,12 +3090,12 @@
       "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
       "base": "aws-cdk-lib.Resource",
       "docs": {
+        "stability": "experimental",
+        "summary": "A Service Catalog AppRegistry Application.",
+        "example": "const application = new appreg.Application(this, 'MyFirstApplication', {\n  applicationName: 'MyFirstApplicationName',\n  description: 'description for my application', // the description is optional\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "const application = new appreg.Application(this, 'MyFirstApplication', {\n  applicationName: 'MyFirstApplicationName',\n  description: 'description for my application', // the description is optional\n});",
-        "stability": "experimental",
-        "summary": "A Service Catalog AppRegistry Application."
+        }
       },
       "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.Application",
       "initializer": {
@@ -3104,7 +3104,7 @@
         },
         "locationInModule": {
           "filename": "lib/application.ts",
-          "line": 134
+          "line": 181
         },
         "parameters": [
           {
@@ -3133,7 +3133,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/application.ts",
-        "line": 100
+        "line": 147
       },
       "methods": [
         {
@@ -3143,7 +3143,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 108
+            "line": 155
           },
           "name": "fromApplicationArn",
           "parameters": [
@@ -3189,7 +3189,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 63
+            "line": 77
           },
           "name": "associateAttributeGroup",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
@@ -3210,7 +3210,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 79
+            "line": 93
           },
           "name": "associateStack",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
@@ -3230,7 +3230,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 149
+            "line": 196
           },
           "name": "generateUniqueHash",
           "parameters": [
@@ -3247,6 +3247,30 @@
               "primitive": "string"
             }
           }
+        },
+        {
+          "docs": {
+            "remarks": "The application will become available to end users within those principals.",
+            "stability": "experimental",
+            "summary": "Share an application with accounts, organizations and OUs, and IAM roles and users."
+          },
+          "locationInModule": {
+            "filename": "lib/application.ts",
+            "line": 111
+          },
+          "name": "shareApplication",
+          "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "The options for the share."
+              },
+              "name": "shareOptions",
+              "type": {
+                "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ShareOptions"
+              }
+            }
+          ]
         }
       ],
       "name": "Application",
@@ -3259,7 +3283,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 130
+            "line": 177
           },
           "name": "applicationArn",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
@@ -3275,7 +3299,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 131
+            "line": 178
           },
           "name": "applicationId",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IApplication",
@@ -3290,18 +3314,18 @@
       "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Properties for a Service Catalog AppRegistry Application.",
+        "example": "const application = new appreg.Application(this, 'MyFirstApplication', {\n  applicationName: 'MyFirstApplicationName',\n  description: 'description for my application', // the description is optional\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "const application = new appreg.Application(this, 'MyFirstApplication', {\n  applicationName: 'MyFirstApplicationName',\n  description: 'description for my application', // the description is optional\n});",
-        "stability": "experimental",
-        "summary": "Properties for a Service Catalog AppRegistry Application."
+        }
       },
       "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ApplicationProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/application.ts",
-        "line": 40
+        "line": 54
       },
       "name": "ApplicationProps",
       "properties": [
@@ -3314,7 +3338,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 44
+            "line": 58
           },
           "name": "applicationName",
           "type": {
@@ -3331,7 +3355,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 50
+            "line": 64
           },
           "name": "description",
           "optional": true,
@@ -3346,12 +3370,12 @@
       "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
       "base": "aws-cdk-lib.Resource",
       "docs": {
+        "stability": "experimental",
+        "summary": "A Service Catalog AppRegistry Attribute Group.",
+        "example": "const 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});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "const 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});",
-        "stability": "experimental",
-        "summary": "A Service Catalog AppRegistry Attribute Group."
+        }
       },
       "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.AttributeGroup",
       "initializer": {
@@ -3360,7 +3384,7 @@
         },
         "locationInModule": {
           "filename": "lib/attribute-group.ts",
-          "line": 82
+          "line": 122
         },
         "parameters": [
           {
@@ -3389,7 +3413,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/attribute-group.ts",
-        "line": 53
+        "line": 93
       },
       "methods": [
         {
@@ -3399,7 +3423,7 @@
           },
           "locationInModule": {
             "filename": "lib/attribute-group.ts",
-            "line": 61
+            "line": 101
           },
           "name": "fromAttributeGroupArn",
           "parameters": [
@@ -3437,6 +3461,51 @@
             }
           },
           "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Get the correct permission ARN based on the SharePermission."
+          },
+          "locationInModule": {
+            "filename": "lib/attribute-group.ts",
+            "line": 77
+          },
+          "name": "getAttributeGroupSharePermissionARN",
+          "parameters": [
+            {
+              "name": "shareOptions",
+              "type": {
+                "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ShareOptions"
+              }
+            }
+          ],
+          "protected": true,
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Share the attribute group resource with other IAM entities, accounts, or OUs."
+          },
+          "locationInModule": {
+            "filename": "lib/attribute-group.ts",
+            "line": 62
+          },
+          "name": "shareAttributeGroup",
+          "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IAttributeGroup",
+          "parameters": [
+            {
+              "name": "shareOptions",
+              "type": {
+                "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ShareOptions"
+              }
+            }
+          ]
         }
       ],
       "name": "AttributeGroup",
@@ -3449,7 +3518,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/attribute-group.ts",
-            "line": 79
+            "line": 119
           },
           "name": "attributeGroupArn",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IAttributeGroup",
@@ -3465,7 +3534,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/attribute-group.ts",
-            "line": 80
+            "line": 120
           },
           "name": "attributeGroupId",
           "overrides": "@aws-cdk/aws-servicecatalogappregistry-alpha.IAttributeGroup",
@@ -3480,18 +3549,18 @@
       "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Properties for a Service Catalog AppRegistry Attribute Group.",
+        "example": "const 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});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "const 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});",
-        "stability": "experimental",
-        "summary": "Properties for a Service Catalog AppRegistry Attribute Group."
+        }
       },
       "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.AttributeGroupProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/attribute-group.ts",
-        "line": 26
+        "line": 39
       },
       "name": "AttributeGroupProps",
       "properties": [
@@ -3504,7 +3573,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/attribute-group.ts",
-            "line": 30
+            "line": 43
           },
           "name": "attributeGroupName",
           "type": {
@@ -3521,7 +3590,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/attribute-group.ts",
-            "line": 42
+            "line": 55
           },
           "name": "attributes",
           "type": {
@@ -3543,7 +3612,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/attribute-group.ts",
-            "line": 36
+            "line": 49
           },
           "name": "description",
           "optional": true,
@@ -3567,7 +3636,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/application.ts",
-        "line": 11
+        "line": 16
       },
       "methods": [
         {
@@ -3578,7 +3647,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 28
+            "line": 34
           },
           "name": "associateAttributeGroup",
           "parameters": [
@@ -3601,7 +3670,7 @@
           },
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 34
+            "line": 41
           },
           "name": "associateStack",
           "parameters": [
@@ -3615,6 +3684,29 @@
               }
             }
           ]
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Share this application with other IAM entities, accounts, or OUs."
+          },
+          "locationInModule": {
+            "filename": "lib/application.ts",
+            "line": 48
+          },
+          "name": "shareApplication",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "The options for the share."
+              },
+              "name": "shareOptions",
+              "type": {
+                "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ShareOptions"
+              }
+            }
+          ]
         }
       ],
       "name": "IApplication",
@@ -3631,7 +3723,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 16
+            "line": 21
           },
           "name": "applicationArn",
           "type": {
@@ -3650,7 +3742,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/application.ts",
-            "line": 22
+            "line": 27
           },
           "name": "applicationId",
           "type": {
@@ -3673,8 +3765,33 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/attribute-group.ts",
-        "line": 9
+        "line": 15
       },
+      "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Share the attribute group resource with other IAM entities, accounts, or OUs."
+          },
+          "locationInModule": {
+            "filename": "lib/attribute-group.ts",
+            "line": 33
+          },
+          "name": "shareAttributeGroup",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "The options for the share."
+              },
+              "name": "shareOptions",
+              "type": {
+                "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ShareOptions"
+              }
+            }
+          ]
+        }
+      ],
       "name": "IAttributeGroup",
       "properties": [
         {
@@ -3689,7 +3806,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/attribute-group.ts",
-            "line": 14
+            "line": 20
           },
           "name": "attributeGroupArn",
           "type": {
@@ -3708,7 +3825,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/attribute-group.ts",
-            "line": 20
+            "line": 26
           },
           "name": "attributeGroupId",
           "type": {
@@ -3717,8 +3834,184 @@
         }
       ],
       "symbolId": "lib/attribute-group:IAttributeGroup"
+    },
+    "@aws-cdk/aws-servicecatalogappregistry-alpha.ShareOptions": {
+      "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "The options that are passed into a share of an Application or Attribute Group.",
+        "example": "import * 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});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.ShareOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/common.ts",
+        "line": 22
+      },
+      "name": "ShareOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No accounts specified for share",
+            "stability": "experimental",
+            "summary": "A list of AWS accounts that the application will be shared with."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/common.ts",
+            "line": 28
+          },
+          "name": "accounts",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No AWS Organizations or OUs specified for share",
+            "stability": "experimental",
+            "summary": "A list of AWS Organization or Organizational Units (OUs) ARNs that the application will be shared with."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/common.ts",
+            "line": 35
+          },
+          "name": "organizationArns",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No IAM roles specified for share",
+            "stability": "experimental",
+            "summary": "A list of AWS IAM roles that the application will be shared with."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/common.ts",
+            "line": 42
+          },
+          "name": "roles",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_iam.IRole"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- Principals will be assigned read only permissions on the application or attribute group.",
+            "stability": "experimental",
+            "summary": "An option to manage access to the application or attribute group."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/common.ts",
+            "line": 49
+          },
+          "name": "sharePermission",
+          "optional": true,
+          "type": {
+            "union": {
+              "types": [
+                {
+                  "primitive": "string"
+                },
+                {
+                  "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.SharePermission"
+                }
+              ]
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No IAM Users specified for share",
+            "stability": "experimental",
+            "summary": "A list of AWS IAM users that the application will be shared with."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/common.ts",
+            "line": 56
+          },
+          "name": "users",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_iam.IUser"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "lib/common:ShareOptions"
+    },
+    "@aws-cdk/aws-servicecatalogappregistry-alpha.SharePermission": {
+      "assembly": "@aws-cdk/aws-servicecatalogappregistry-alpha",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Supported permissions for sharing applications or attribute groups with principals using AWS RAM.",
+        "example": "import * 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});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-servicecatalogappregistry-alpha.SharePermission",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "lib/common.ts",
+        "line": 7
+      },
+      "members": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Allows principals in the share to only view the application or attribute group."
+          },
+          "name": "READ_ONLY"
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Allows principals in the share to associate resources and attribute groups with applications."
+          },
+          "name": "ALLOW_ACCESS"
+        }
+      ],
+      "name": "SharePermission",
+      "symbolId": "lib/common:SharePermission"
     }
   },
-  "version": "2.38.1-alpha.0",
+  "version": "2.40.0-alpha.0",
   "fingerprint": "**********"
 }