feat(client-ram): Resource owners can now specify ResourceShareConfiguration request parameter for CreateResourceShare API including RetainSharingOnAccountLeaveOrganization boolean parameter

Author: awstools

clients/client-ram/src/commands/CreateResourceShareCommand.ts

@@ -65,6 +65,9 @@ export interface CreateResourceShareCommandOutput extends CreateResourceShareRes
  *   sources: [ // SourceArnOrAccountList
  *     "STRING_VALUE",
  *   ],
+ *   resourceShareConfiguration: { // ResourceShareConfiguration
+ *     retainSharingOnAccountLeaveOrganization: true || false,
+ *   },
  * };
  * const command = new CreateResourceShareCommand(input);
  * const response = await client.send(command);
@@ -85,6 +88,9 @@ export interface CreateResourceShareCommandOutput extends CreateResourceShareRes
  * //     creationTime: new Date("TIMESTAMP"),
  * //     lastUpdatedTime: new Date("TIMESTAMP"),
  * //     featureSet: "CREATED_FROM_POLICY" || "PROMOTING_TO_STANDARD" || "STANDARD",
+ * //     resourceShareConfiguration: { // ResourceShareConfiguration
+ * //       retainSharingOnAccountLeaveOrganization: true || false,
+ * //     },
  * //   },
  * //   clientToken: "STRING_VALUE",
  * // };

clients/client-ram/src/commands/GetResourceSharesCommand.ts

@@ -83,6 +83,9 @@ export interface GetResourceSharesCommandOutput extends GetResourceSharesRespons
  * //       creationTime: new Date("TIMESTAMP"),
  * //       lastUpdatedTime: new Date("TIMESTAMP"),
  * //       featureSet: "CREATED_FROM_POLICY" || "PROMOTING_TO_STANDARD" || "STANDARD",
+ * //       resourceShareConfiguration: { // ResourceShareConfiguration
+ * //         retainSharingOnAccountLeaveOrganization: true || false,
+ * //       },
  * //     },
  * //   ],
  * //   nextToken: "STRING_VALUE",

clients/client-ram/src/commands/UpdateResourceShareCommand.ts

@@ -61,6 +61,9 @@ export interface UpdateResourceShareCommandOutput extends UpdateResourceShareRes
  * //     creationTime: new Date("TIMESTAMP"),
  * //     lastUpdatedTime: new Date("TIMESTAMP"),
  * //     featureSet: "CREATED_FROM_POLICY" || "PROMOTING_TO_STANDARD" || "STANDARD",
+ * //     resourceShareConfiguration: { // ResourceShareConfiguration
+ * //       retainSharingOnAccountLeaveOrganization: true || false,
+ * //     },
  * //   },
  * //   clientToken: "STRING_VALUE",
  * // };

clients/client-ram/src/models/models_0.ts

@@ -894,6 +894,18 @@ export interface CreatePermissionVersionResponse {
   clientToken?: string | undefined;
 }
 
+/**
+ * <p>The configuration of the resource share</p>
+ * @public
+ */
+export interface ResourceShareConfiguration {
+  /**
+   * <p>Specifies whether the consumer account retains access to the resource share after leaving the organization.</p>
+   * @public
+   */
+  retainSharingOnAccountLeaveOrganization?: boolean | undefined;
+}
+
 /**
  * @public
  */
@@ -1000,6 +1012,12 @@ export interface CreateResourceShareRequest {
    * @public
    */
   sources?: string[] | undefined;
+
+  /**
+   * <p>Specifies the configuration of this resource share.</p>
+   * @public
+   */
+  resourceShareConfiguration?: ResourceShareConfiguration | undefined;
 }
 
 /**
@@ -1108,6 +1126,12 @@ export interface ResourceShare {
    * @public
    */
   featureSet?: ResourceShareFeatureSet | undefined;
+
+  /**
+   * <p>The configuration of the resource share</p>
+   * @public
+   */
+  resourceShareConfiguration?: ResourceShareConfiguration | undefined;
 }
 
 /**

clients/client-ram/src/schemas/schemas_0.ts

@@ -126,6 +126,7 @@ const _RS = "ResourceShare";
 const _RSA = "ResourceShareAssociation";
 const _RSAL = "ResourceShareArnList";
 const _RSALe = "ResourceShareAssociationList";
+const _RSC = "ResourceShareConfiguration";
 const _RSI = "ResourceShareInvitation";
 const _RSIAAE = "ResourceShareInvitationAlreadyAcceptedException";
 const _RSIAL = "ResourceShareInvitationArnList";
@@ -218,11 +219,13 @@ const _rS = "resourceShare";
 const _rSA = "resourceShareArn";
 const _rSAe = "resourceShareAssociations";
 const _rSAes = "resourceShareArns";
+const _rSC = "resourceShareConfiguration";
 const _rSI = "resourceShareInvitation";
 const _rSIA = "resourceShareInvitationArn";
 const _rSIAe = "resourceShareInvitationArns";
 const _rSIe = "resourceShareInvitations";
 const _rSN = "resourceShareName";
+const _rSOALO = "retainSharingOnAccountLeaveOrganization";
 const _rSS = "resourceShareStatus";
 const _rSe = "resourceShares";
 const _rT = "resourceType";
@@ -534,8 +537,8 @@ export var CreatePermissionVersionResponse$: StaticStructureSchema = [3, n0, _CP
 ];
 export var CreateResourceShareRequest$: StaticStructureSchema = [3, n0, _CRSR,
   0,
-  [_n, _rA, _p, _t, _aEP, _cT, _pAe, _so],
-  [0, [() => ResourceArnList, 0], [() => PrincipalArnOrIdList, 0], () => TagList, 2, 0, [() => PermissionArnList, 0], [() => SourceArnOrAccountList, 0]], 1
+  [_n, _rA, _p, _t, _aEP, _cT, _pAe, _so, _rSC],
+  [0, [() => ResourceArnList, 0], [() => PrincipalArnOrIdList, 0], () => TagList, 2, 0, [() => PermissionArnList, 0], [() => SourceArnOrAccountList, 0], () => ResourceShareConfiguration$], 1
 ];
 export var CreateResourceShareResponse$: StaticStructureSchema = [3, n0, _CRSRr,
   0,
@@ -809,14 +812,19 @@ export var Resource$: StaticStructureSchema = [3, n0, _R,
 ];
 export var ResourceShare$: StaticStructureSchema = [3, n0, _RS,
   0,
-  [_rSA, _n, _oAI, _aEP, _st, _sM, _t, _cTr, _lUT, _fS],
-  [0, 0, 0, 2, 0, 0, () => TagList, 4, 4, 0]
+  [_rSA, _n, _oAI, _aEP, _st, _sM, _t, _cTr, _lUT, _fS, _rSC],
+  [0, 0, 0, 2, 0, 0, () => TagList, 4, 4, 0, () => ResourceShareConfiguration$]
 ];
 export var ResourceShareAssociation$: StaticStructureSchema = [3, n0, _RSA,
   0,
   [_rSA, _rSN, _aE, _aT, _st, _sM, _cTr, _lUT, _ex],
   [0, 0, 0, 0, 0, 0, 4, 4, 2]
 ];
+export var ResourceShareConfiguration$: StaticStructureSchema = [3, n0, _RSC,
+  0,
+  [_rSOALO],
+  [2]
+];
 export var ResourceShareInvitation$: StaticStructureSchema = [3, n0, _RSI,
   0,
   [_rSIA, _rSN, _rSA, _sAI, _rAI, _iT, _st, _rSAe, _rAec],

clients/client-ram/test/index-objects.spec.mjs

@@ -189,6 +189,7 @@ import {
   ResourceShareAssociation$,
   ResourceShareAssociationStatus,
   ResourceShareAssociationType,
+  ResourceShareConfiguration$,
   ResourceShareFeatureSet,
   ResourceShareInvitation$,
   ResourceShareInvitationAlreadyAcceptedException,
@@ -385,6 +386,7 @@ assert(typeof ReplacePermissionAssociationsWork$ === "object");
 assert(typeof Resource$ === "object");
 assert(typeof ResourceShare$ === "object");
 assert(typeof ResourceShareAssociation$ === "object");
+assert(typeof ResourceShareConfiguration$ === "object");
 assert(typeof ResourceShareInvitation$ === "object");
 assert(typeof ResourceSharePermissionDetail$ === "object");
 assert(typeof ResourceSharePermissionSummary$ === "object");

clients/client-ram/test/index-types.ts

@@ -190,6 +190,7 @@ export type {
   Resource,
   ResourceShare,
   ResourceShareAssociation,
+  ResourceShareConfiguration,
   ResourceShareInvitation,
   ResourceSharePermissionDetail,
   ResourceSharePermissionSummary,

codegen/sdk-codegen/aws-models/ram.json

@@ -1869,6 +1869,12 @@
           "traits": {
             "smithy.api#documentation": "<p>Specifies source constraints (accounts, ARNs, organization IDs, or organization paths) that limit when service principals can access resources in this resource share. When a service principal attempts to access a shared resource, validation is performed to ensure the request originates from one of the specified sources. This helps prevent confused deputy attacks by applying constraints on where service principals can access resources from.</p>"
           }
+        },
+        "resourceShareConfiguration": {
+          "target": "com.amazonaws.ram#ResourceShareConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the configuration of this resource share.</p>"
+          }
         }
       },
       "traits": {
@@ -5116,6 +5122,12 @@
           "traits": {
             "smithy.api#documentation": "<p>Indicates what features are available for this resource share. This parameter can have one of\n            the following values:</p>\n         <ul>\n            <li>\n               <p>\n                  <b>STANDARD</b> – A resource share that supports all\n                    functionality. These resource shares are visible to all principals you share the resource share with. \n                    You can modify these resource shares in RAM using the console or APIs. This resource share might \n                    have been created by RAM, or it might have been <b>CREATED_FROM_POLICY</b> and then promoted.</p>\n            </li>\n            <li>\n               <p>\n                  <b>CREATED_FROM_POLICY</b> – The customer\n                    manually shared a resource by attaching a resource-based policy. That policy did\n                    not match any existing managed permissions, so RAM created this customer managed permission automatically on the\n                    customer's behalf based on the attached policy document. This type of resource share \n                    is visible only to the Amazon Web Services account that created it. You can't modify it in \n                    RAM unless you promote it. For more information, \n                    see <a>PromoteResourceShareCreatedFromPolicy</a>.</p>\n            </li>\n            <li>\n               <p>\n                  <b>PROMOTING_TO_STANDARD</b> – This\n                    resource share was originally <code>CREATED_FROM_POLICY</code>, but the customer ran\n                    the <a>PromoteResourceShareCreatedFromPolicy</a> and that operation\n                    is still in progress. This value changes to <code>STANDARD</code> when\n                    complete.</p>\n            </li>\n         </ul>"
           }
+        },
+        "resourceShareConfiguration": {
+          "target": "com.amazonaws.ram#ResourceShareConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>The configuration of the resource share</p>"
+          }
         }
       },
       "traits": {
@@ -5278,6 +5290,20 @@
         }
       }
     },
+    "com.amazonaws.ram#ResourceShareConfiguration": {
+      "type": "structure",
+      "members": {
+        "retainSharingOnAccountLeaveOrganization": {
+          "target": "com.amazonaws.ram#Boolean",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies whether the consumer account retains access to the resource share after leaving the organization.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#documentation": "<p>The configuration of the resource share</p>"
+      }
+    },
     "com.amazonaws.ram#ResourceShareFeatureSet": {
       "type": "enum",
       "members": {