From c6a225f7949ac4e2b2a8bac5ed7e196749aeaef0 Mon Sep 17 00:00:00 2001
From: awstools <awstools@amazon.com>
Date: Wed, 19 Apr 2023 18:15:51 +0000
Subject: [PATCH] feat(client-ram): This release adds support for customer
 managed permissions. Customer managed permissions enable customers to author
 and manage tailored permissions for resources shared using RAM.

---
 clients/client-ram/README.md                  |   81 +-
 clients/client-ram/src/RAM.ts                 |  216 +-
 clients/client-ram/src/RAMClient.ts           |   57 +-
 .../AcceptResourceShareInvitationCommand.ts   |   28 +-
 .../commands/AssociateResourceShareCommand.ts |   33 +-
 ...AssociateResourceSharePermissionCommand.ts |   16 +-
 .../src/commands/CreatePermissionCommand.ts   |  178 +
 .../CreatePermissionVersionCommand.ts         |  175 +
 .../commands/CreateResourceShareCommand.ts    |   32 +-
 .../src/commands/DeletePermissionCommand.ts   |  160 +
 .../DeletePermissionVersionCommand.ts         |  165 +
 .../commands/DeleteResourceShareCommand.ts    |   33 +-
 .../DisassociateResourceShareCommand.ts       |   32 +-
 ...associateResourceSharePermissionCommand.ts |   25 +-
 ...EnableSharingWithAwsOrganizationCommand.ts |   25 +-
 .../src/commands/GetPermissionCommand.ts      |   16 +-
 .../commands/GetResourcePoliciesCommand.ts    |   16 +-
 .../GetResourceShareAssociationsCommand.ts    |   21 +-
 .../GetResourceShareInvitationsCommand.ts     |   22 +-
 .../src/commands/GetResourceSharesCommand.ts  |   17 +-
 .../ListPendingInvitationResourcesCommand.ts  |   24 +-
 .../ListPermissionAssociationsCommand.ts      |  163 +
 .../commands/ListPermissionVersionsCommand.ts |   18 +-
 .../src/commands/ListPermissionsCommand.ts    |   14 +-
 .../src/commands/ListPrincipalsCommand.ts     |   16 +-
 ...eplacePermissionAssociationsWorkCommand.ts |  168 +
 .../ListResourceSharePermissionsCommand.ts    |   18 +-
 .../src/commands/ListResourceTypesCommand.ts  |   11 +-
 .../src/commands/ListResourcesCommand.ts      |   18 +-
 ...omotePermissionCreatedFromPolicyCommand.ts |  202 ++
 ...teResourceShareCreatedFromPolicyCommand.ts |   48 +-
 .../RejectResourceShareInvitationCommand.ts   |   28 +-
 .../ReplacePermissionAssociationsCommand.ts   |  185 +
 .../SetDefaultPermissionVersionCommand.ts     |  169 +
 .../src/commands/TagResourceCommand.ts        |   28 +-
 .../src/commands/UntagResourceCommand.ts      |   19 +-
 .../commands/UpdateResourceShareCommand.ts    |   24 +-
 clients/client-ram/src/commands/index.ts      |    9 +
 .../src/endpoint/EndpointParameters.ts        |    2 +-
 clients/client-ram/src/endpoint/ruleset.ts    |   47 +-
 clients/client-ram/src/models/models_0.ts     | 1761 ++++++++--
 .../ListPermissionAssociationsPaginator.ts    |   50 +
 ...lacePermissionAssociationsWorkPaginator.ts |   50 +
 clients/client-ram/src/pagination/index.ts    |    2 +
 .../client-ram/src/protocols/Aws_restJson1.ts | 1282 ++++++-
 codegen/sdk-codegen/aws-models/ram.json       | 3069 +++++++++++++----
 46 files changed, 7418 insertions(+), 1355 deletions(-)
 create mode 100644 clients/client-ram/src/commands/CreatePermissionCommand.ts
 create mode 100644 clients/client-ram/src/commands/CreatePermissionVersionCommand.ts
 create mode 100644 clients/client-ram/src/commands/DeletePermissionCommand.ts
 create mode 100644 clients/client-ram/src/commands/DeletePermissionVersionCommand.ts
 create mode 100644 clients/client-ram/src/commands/ListPermissionAssociationsCommand.ts
 create mode 100644 clients/client-ram/src/commands/ListReplacePermissionAssociationsWorkCommand.ts
 create mode 100644 clients/client-ram/src/commands/PromotePermissionCreatedFromPolicyCommand.ts
 create mode 100644 clients/client-ram/src/commands/ReplacePermissionAssociationsCommand.ts
 create mode 100644 clients/client-ram/src/commands/SetDefaultPermissionVersionCommand.ts
 create mode 100644 clients/client-ram/src/pagination/ListPermissionAssociationsPaginator.ts
 create mode 100644 clients/client-ram/src/pagination/ListReplacePermissionAssociationsWorkPaginator.ts

diff --git a/clients/client-ram/README.md b/clients/client-ram/README.md
index 2429e3901166..7988d128cd8c 100644
--- a/clients/client-ram/README.md
+++ b/clients/client-ram/README.md
@@ -11,11 +11,10 @@ AWS SDK for JavaScript RAM Client for Node.js, Browser and React Native.
 
 <p>This is the <i>Resource Access Manager API Reference</i>. This documentation provides
 descriptions and syntax for each of the actions and data types in RAM. RAM is a
-service that helps you securely share your Amazon Web Services resources across Amazon Web Services accounts. If you
-have multiple Amazon Web Services accounts, you can use RAM to share those resources with other
-accounts. If you use Organizations to manage your accounts, then you share your resources
-with your organization or organizational units (OUs). For supported resource types, you
-can also share resources with individual Identity and Access Management (IAM) roles an users. </p>
+service that helps you securely share your Amazon Web Services resources to other Amazon Web Services accounts. If
+you use Organizations to manage your accounts, then you can share your resources with your
+entire organization or to organizational units (OUs). For supported resource types, you
+can also share resources with individual Identity and Access Management (IAM) roles and users. </p>
 <p>To learn more about RAM, see the following resources:</p>
 <ul>
 <li>
@@ -249,6 +248,22 @@ AssociateResourceSharePermission
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/associateresourcesharepermissioncommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/associateresourcesharepermissioncommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/associateresourcesharepermissioncommandoutput.html)
 
+</details>
+<details>
+<summary>
+CreatePermission
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/createpermissioncommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/createpermissioncommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/createpermissioncommandoutput.html)
+
+</details>
+<details>
+<summary>
+CreatePermissionVersion
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/createpermissionversioncommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/createpermissionversioncommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/createpermissionversioncommandoutput.html)
+
 </details>
 <details>
 <summary>
@@ -257,6 +272,22 @@ CreateResourceShare
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/createresourcesharecommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/createresourcesharecommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/createresourcesharecommandoutput.html)
 
+</details>
+<details>
+<summary>
+DeletePermission
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/deletepermissioncommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/deletepermissioncommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/deletepermissioncommandoutput.html)
+
+</details>
+<details>
+<summary>
+DeletePermissionVersion
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/deletepermissionversioncommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/deletepermissionversioncommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/deletepermissionversioncommandoutput.html)
+
 </details>
 <details>
 <summary>
@@ -337,6 +368,14 @@ ListPendingInvitationResources
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/listpendinginvitationresourcescommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/listpendinginvitationresourcescommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/listpendinginvitationresourcescommandoutput.html)
 
+</details>
+<details>
+<summary>
+ListPermissionAssociations
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/listpermissionassociationscommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/listpermissionassociationscommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/listpermissionassociationscommandoutput.html)
+
 </details>
 <details>
 <summary>
@@ -361,6 +400,14 @@ ListPrincipals
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/listprincipalscommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/listprincipalscommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/listprincipalscommandoutput.html)
 
+</details>
+<details>
+<summary>
+ListReplacePermissionAssociationsWork
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/listreplacepermissionassociationsworkcommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/listreplacepermissionassociationsworkcommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/listreplacepermissionassociationsworkcommandoutput.html)
+
 </details>
 <details>
 <summary>
@@ -385,6 +432,14 @@ ListResourceTypes
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/listresourcetypescommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/listresourcetypescommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/listresourcetypescommandoutput.html)
 
+</details>
+<details>
+<summary>
+PromotePermissionCreatedFromPolicy
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/promotepermissioncreatedfrompolicycommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/promotepermissioncreatedfrompolicycommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/promotepermissioncreatedfrompolicycommandoutput.html)
+
 </details>
 <details>
 <summary>
@@ -401,6 +456,22 @@ RejectResourceShareInvitation
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/rejectresourceshareinvitationcommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/rejectresourceshareinvitationcommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/rejectresourceshareinvitationcommandoutput.html)
 
+</details>
+<details>
+<summary>
+ReplacePermissionAssociations
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/replacepermissionassociationscommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/replacepermissionassociationscommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/replacepermissionassociationscommandoutput.html)
+
+</details>
+<details>
+<summary>
+SetDefaultPermissionVersion
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/classes/setdefaultpermissionversioncommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/setdefaultpermissionversioncommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ram/interfaces/setdefaultpermissionversioncommandoutput.html)
+
 </details>
 <details>
 <summary>
diff --git a/clients/client-ram/src/RAM.ts b/clients/client-ram/src/RAM.ts
index b9a852255b20..0eb9c83d77c8 100644
--- a/clients/client-ram/src/RAM.ts
+++ b/clients/client-ram/src/RAM.ts
@@ -17,11 +17,31 @@ import {
   AssociateResourceSharePermissionCommandInput,
   AssociateResourceSharePermissionCommandOutput,
 } from "./commands/AssociateResourceSharePermissionCommand";
+import {
+  CreatePermissionCommand,
+  CreatePermissionCommandInput,
+  CreatePermissionCommandOutput,
+} from "./commands/CreatePermissionCommand";
+import {
+  CreatePermissionVersionCommand,
+  CreatePermissionVersionCommandInput,
+  CreatePermissionVersionCommandOutput,
+} from "./commands/CreatePermissionVersionCommand";
 import {
   CreateResourceShareCommand,
   CreateResourceShareCommandInput,
   CreateResourceShareCommandOutput,
 } from "./commands/CreateResourceShareCommand";
+import {
+  DeletePermissionCommand,
+  DeletePermissionCommandInput,
+  DeletePermissionCommandOutput,
+} from "./commands/DeletePermissionCommand";
+import {
+  DeletePermissionVersionCommand,
+  DeletePermissionVersionCommandInput,
+  DeletePermissionVersionCommandOutput,
+} from "./commands/DeletePermissionVersionCommand";
 import {
   DeleteResourceShareCommand,
   DeleteResourceShareCommandInput,
@@ -72,6 +92,11 @@ import {
   ListPendingInvitationResourcesCommandInput,
   ListPendingInvitationResourcesCommandOutput,
 } from "./commands/ListPendingInvitationResourcesCommand";
+import {
+  ListPermissionAssociationsCommand,
+  ListPermissionAssociationsCommandInput,
+  ListPermissionAssociationsCommandOutput,
+} from "./commands/ListPermissionAssociationsCommand";
 import {
   ListPermissionsCommand,
   ListPermissionsCommandInput,
@@ -87,6 +112,11 @@ import {
   ListPrincipalsCommandInput,
   ListPrincipalsCommandOutput,
 } from "./commands/ListPrincipalsCommand";
+import {
+  ListReplacePermissionAssociationsWorkCommand,
+  ListReplacePermissionAssociationsWorkCommandInput,
+  ListReplacePermissionAssociationsWorkCommandOutput,
+} from "./commands/ListReplacePermissionAssociationsWorkCommand";
 import {
   ListResourcesCommand,
   ListResourcesCommandInput,
@@ -102,6 +132,11 @@ import {
   ListResourceTypesCommandInput,
   ListResourceTypesCommandOutput,
 } from "./commands/ListResourceTypesCommand";
+import {
+  PromotePermissionCreatedFromPolicyCommand,
+  PromotePermissionCreatedFromPolicyCommandInput,
+  PromotePermissionCreatedFromPolicyCommandOutput,
+} from "./commands/PromotePermissionCreatedFromPolicyCommand";
 import {
   PromoteResourceShareCreatedFromPolicyCommand,
   PromoteResourceShareCreatedFromPolicyCommandInput,
@@ -112,6 +147,16 @@ import {
   RejectResourceShareInvitationCommandInput,
   RejectResourceShareInvitationCommandOutput,
 } from "./commands/RejectResourceShareInvitationCommand";
+import {
+  ReplacePermissionAssociationsCommand,
+  ReplacePermissionAssociationsCommandInput,
+  ReplacePermissionAssociationsCommandOutput,
+} from "./commands/ReplacePermissionAssociationsCommand";
+import {
+  SetDefaultPermissionVersionCommand,
+  SetDefaultPermissionVersionCommandInput,
+  SetDefaultPermissionVersionCommandOutput,
+} from "./commands/SetDefaultPermissionVersionCommand";
 import { TagResourceCommand, TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import {
   UntagResourceCommand,
@@ -129,7 +174,11 @@ const commands = {
   AcceptResourceShareInvitationCommand,
   AssociateResourceShareCommand,
   AssociateResourceSharePermissionCommand,
+  CreatePermissionCommand,
+  CreatePermissionVersionCommand,
   CreateResourceShareCommand,
+  DeletePermissionCommand,
+  DeletePermissionVersionCommand,
   DeleteResourceShareCommand,
   DisassociateResourceShareCommand,
   DisassociateResourceSharePermissionCommand,
@@ -140,14 +189,19 @@ const commands = {
   GetResourceShareInvitationsCommand,
   GetResourceSharesCommand,
   ListPendingInvitationResourcesCommand,
+  ListPermissionAssociationsCommand,
   ListPermissionsCommand,
   ListPermissionVersionsCommand,
   ListPrincipalsCommand,
+  ListReplacePermissionAssociationsWorkCommand,
   ListResourcesCommand,
   ListResourceSharePermissionsCommand,
   ListResourceTypesCommand,
+  PromotePermissionCreatedFromPolicyCommand,
   PromoteResourceShareCreatedFromPolicyCommand,
   RejectResourceShareInvitationCommand,
+  ReplacePermissionAssociationsCommand,
+  SetDefaultPermissionVersionCommand,
   TagResourceCommand,
   UntagResourceCommand,
   UpdateResourceShareCommand,
@@ -205,6 +259,40 @@ export interface RAM {
     cb: (err: any, data?: AssociateResourceSharePermissionCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link CreatePermissionCommand}
+   */
+  createPermission(
+    args: CreatePermissionCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<CreatePermissionCommandOutput>;
+  createPermission(
+    args: CreatePermissionCommandInput,
+    cb: (err: any, data?: CreatePermissionCommandOutput) => void
+  ): void;
+  createPermission(
+    args: CreatePermissionCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: CreatePermissionCommandOutput) => void
+  ): void;
+
+  /**
+   * @see {@link CreatePermissionVersionCommand}
+   */
+  createPermissionVersion(
+    args: CreatePermissionVersionCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<CreatePermissionVersionCommandOutput>;
+  createPermissionVersion(
+    args: CreatePermissionVersionCommandInput,
+    cb: (err: any, data?: CreatePermissionVersionCommandOutput) => void
+  ): void;
+  createPermissionVersion(
+    args: CreatePermissionVersionCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: CreatePermissionVersionCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link CreateResourceShareCommand}
    */
@@ -222,6 +310,40 @@ export interface RAM {
     cb: (err: any, data?: CreateResourceShareCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link DeletePermissionCommand}
+   */
+  deletePermission(
+    args: DeletePermissionCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<DeletePermissionCommandOutput>;
+  deletePermission(
+    args: DeletePermissionCommandInput,
+    cb: (err: any, data?: DeletePermissionCommandOutput) => void
+  ): void;
+  deletePermission(
+    args: DeletePermissionCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: DeletePermissionCommandOutput) => void
+  ): void;
+
+  /**
+   * @see {@link DeletePermissionVersionCommand}
+   */
+  deletePermissionVersion(
+    args: DeletePermissionVersionCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<DeletePermissionVersionCommandOutput>;
+  deletePermissionVersion(
+    args: DeletePermissionVersionCommandInput,
+    cb: (err: any, data?: DeletePermissionVersionCommandOutput) => void
+  ): void;
+  deletePermissionVersion(
+    args: DeletePermissionVersionCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: DeletePermissionVersionCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link DeleteResourceShareCommand}
    */
@@ -386,6 +508,23 @@ export interface RAM {
     cb: (err: any, data?: ListPendingInvitationResourcesCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListPermissionAssociationsCommand}
+   */
+  listPermissionAssociations(
+    args: ListPermissionAssociationsCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ListPermissionAssociationsCommandOutput>;
+  listPermissionAssociations(
+    args: ListPermissionAssociationsCommandInput,
+    cb: (err: any, data?: ListPermissionAssociationsCommandOutput) => void
+  ): void;
+  listPermissionAssociations(
+    args: ListPermissionAssociationsCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListPermissionAssociationsCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ListPermissionsCommand}
    */
@@ -431,6 +570,23 @@ export interface RAM {
     cb: (err: any, data?: ListPrincipalsCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListReplacePermissionAssociationsWorkCommand}
+   */
+  listReplacePermissionAssociationsWork(
+    args: ListReplacePermissionAssociationsWorkCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ListReplacePermissionAssociationsWorkCommandOutput>;
+  listReplacePermissionAssociationsWork(
+    args: ListReplacePermissionAssociationsWorkCommandInput,
+    cb: (err: any, data?: ListReplacePermissionAssociationsWorkCommandOutput) => void
+  ): void;
+  listReplacePermissionAssociationsWork(
+    args: ListReplacePermissionAssociationsWorkCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListReplacePermissionAssociationsWorkCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ListResourcesCommand}
    */
@@ -476,6 +632,23 @@ export interface RAM {
     cb: (err: any, data?: ListResourceTypesCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link PromotePermissionCreatedFromPolicyCommand}
+   */
+  promotePermissionCreatedFromPolicy(
+    args: PromotePermissionCreatedFromPolicyCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<PromotePermissionCreatedFromPolicyCommandOutput>;
+  promotePermissionCreatedFromPolicy(
+    args: PromotePermissionCreatedFromPolicyCommandInput,
+    cb: (err: any, data?: PromotePermissionCreatedFromPolicyCommandOutput) => void
+  ): void;
+  promotePermissionCreatedFromPolicy(
+    args: PromotePermissionCreatedFromPolicyCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: PromotePermissionCreatedFromPolicyCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link PromoteResourceShareCreatedFromPolicyCommand}
    */
@@ -510,6 +683,40 @@ export interface RAM {
     cb: (err: any, data?: RejectResourceShareInvitationCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ReplacePermissionAssociationsCommand}
+   */
+  replacePermissionAssociations(
+    args: ReplacePermissionAssociationsCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ReplacePermissionAssociationsCommandOutput>;
+  replacePermissionAssociations(
+    args: ReplacePermissionAssociationsCommandInput,
+    cb: (err: any, data?: ReplacePermissionAssociationsCommandOutput) => void
+  ): void;
+  replacePermissionAssociations(
+    args: ReplacePermissionAssociationsCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ReplacePermissionAssociationsCommandOutput) => void
+  ): void;
+
+  /**
+   * @see {@link SetDefaultPermissionVersionCommand}
+   */
+  setDefaultPermissionVersion(
+    args: SetDefaultPermissionVersionCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<SetDefaultPermissionVersionCommandOutput>;
+  setDefaultPermissionVersion(
+    args: SetDefaultPermissionVersionCommandInput,
+    cb: (err: any, data?: SetDefaultPermissionVersionCommandOutput) => void
+  ): void;
+  setDefaultPermissionVersion(
+    args: SetDefaultPermissionVersionCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: SetDefaultPermissionVersionCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link TagResourceCommand}
    */
@@ -554,11 +761,10 @@ export interface RAM {
  * @public
  * <p>This is the <i>Resource Access Manager API Reference</i>. This documentation provides
  *             descriptions and syntax for each of the actions and data types in RAM. RAM is a
- *             service that helps you securely share your Amazon Web Services resources across Amazon Web Services accounts. If you
- *             have multiple Amazon Web Services accounts, you can use RAM to share those resources with other
- *             accounts. If you use Organizations to manage your accounts, then you share your resources
- *             with your organization or organizational units (OUs). For supported resource types, you
- *             can also share resources with individual Identity and Access Management (IAM) roles an users. </p>
+ *             service that helps you securely share your Amazon Web Services resources to other Amazon Web Services accounts. If
+ *             you use Organizations to manage your accounts, then you can share your resources with your
+ *             entire organization or to organizational units (OUs). For supported resource types, you
+ *             can also share resources with individual Identity and Access Management (IAM) roles and users. </p>
  *          <p>To learn more about RAM, see the following resources:</p>
  *          <ul>
  *             <li>
diff --git a/clients/client-ram/src/RAMClient.ts b/clients/client-ram/src/RAMClient.ts
index aac71995640a..66cc11c34465 100644
--- a/clients/client-ram/src/RAMClient.ts
+++ b/clients/client-ram/src/RAMClient.ts
@@ -61,10 +61,20 @@ import {
   AssociateResourceSharePermissionCommandInput,
   AssociateResourceSharePermissionCommandOutput,
 } from "./commands/AssociateResourceSharePermissionCommand";
+import { CreatePermissionCommandInput, CreatePermissionCommandOutput } from "./commands/CreatePermissionCommand";
+import {
+  CreatePermissionVersionCommandInput,
+  CreatePermissionVersionCommandOutput,
+} from "./commands/CreatePermissionVersionCommand";
 import {
   CreateResourceShareCommandInput,
   CreateResourceShareCommandOutput,
 } from "./commands/CreateResourceShareCommand";
+import { DeletePermissionCommandInput, DeletePermissionCommandOutput } from "./commands/DeletePermissionCommand";
+import {
+  DeletePermissionVersionCommandInput,
+  DeletePermissionVersionCommandOutput,
+} from "./commands/DeletePermissionVersionCommand";
 import {
   DeleteResourceShareCommandInput,
   DeleteResourceShareCommandOutput,
@@ -99,18 +109,30 @@ import {
   ListPendingInvitationResourcesCommandInput,
   ListPendingInvitationResourcesCommandOutput,
 } from "./commands/ListPendingInvitationResourcesCommand";
+import {
+  ListPermissionAssociationsCommandInput,
+  ListPermissionAssociationsCommandOutput,
+} from "./commands/ListPermissionAssociationsCommand";
 import { ListPermissionsCommandInput, ListPermissionsCommandOutput } from "./commands/ListPermissionsCommand";
 import {
   ListPermissionVersionsCommandInput,
   ListPermissionVersionsCommandOutput,
 } from "./commands/ListPermissionVersionsCommand";
 import { ListPrincipalsCommandInput, ListPrincipalsCommandOutput } from "./commands/ListPrincipalsCommand";
+import {
+  ListReplacePermissionAssociationsWorkCommandInput,
+  ListReplacePermissionAssociationsWorkCommandOutput,
+} from "./commands/ListReplacePermissionAssociationsWorkCommand";
 import { ListResourcesCommandInput, ListResourcesCommandOutput } from "./commands/ListResourcesCommand";
 import {
   ListResourceSharePermissionsCommandInput,
   ListResourceSharePermissionsCommandOutput,
 } from "./commands/ListResourceSharePermissionsCommand";
 import { ListResourceTypesCommandInput, ListResourceTypesCommandOutput } from "./commands/ListResourceTypesCommand";
+import {
+  PromotePermissionCreatedFromPolicyCommandInput,
+  PromotePermissionCreatedFromPolicyCommandOutput,
+} from "./commands/PromotePermissionCreatedFromPolicyCommand";
 import {
   PromoteResourceShareCreatedFromPolicyCommandInput,
   PromoteResourceShareCreatedFromPolicyCommandOutput,
@@ -119,6 +141,14 @@ import {
   RejectResourceShareInvitationCommandInput,
   RejectResourceShareInvitationCommandOutput,
 } from "./commands/RejectResourceShareInvitationCommand";
+import {
+  ReplacePermissionAssociationsCommandInput,
+  ReplacePermissionAssociationsCommandOutput,
+} from "./commands/ReplacePermissionAssociationsCommand";
+import {
+  SetDefaultPermissionVersionCommandInput,
+  SetDefaultPermissionVersionCommandOutput,
+} from "./commands/SetDefaultPermissionVersionCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
 import {
@@ -140,7 +170,11 @@ export type ServiceInputTypes =
   | AcceptResourceShareInvitationCommandInput
   | AssociateResourceShareCommandInput
   | AssociateResourceSharePermissionCommandInput
+  | CreatePermissionCommandInput
+  | CreatePermissionVersionCommandInput
   | CreateResourceShareCommandInput
+  | DeletePermissionCommandInput
+  | DeletePermissionVersionCommandInput
   | DeleteResourceShareCommandInput
   | DisassociateResourceShareCommandInput
   | DisassociateResourceSharePermissionCommandInput
@@ -151,14 +185,19 @@ export type ServiceInputTypes =
   | GetResourceShareInvitationsCommandInput
   | GetResourceSharesCommandInput
   | ListPendingInvitationResourcesCommandInput
+  | ListPermissionAssociationsCommandInput
   | ListPermissionVersionsCommandInput
   | ListPermissionsCommandInput
   | ListPrincipalsCommandInput
+  | ListReplacePermissionAssociationsWorkCommandInput
   | ListResourceSharePermissionsCommandInput
   | ListResourceTypesCommandInput
   | ListResourcesCommandInput
+  | PromotePermissionCreatedFromPolicyCommandInput
   | PromoteResourceShareCreatedFromPolicyCommandInput
   | RejectResourceShareInvitationCommandInput
+  | ReplacePermissionAssociationsCommandInput
+  | SetDefaultPermissionVersionCommandInput
   | TagResourceCommandInput
   | UntagResourceCommandInput
   | UpdateResourceShareCommandInput;
@@ -170,7 +209,11 @@ export type ServiceOutputTypes =
   | AcceptResourceShareInvitationCommandOutput
   | AssociateResourceShareCommandOutput
   | AssociateResourceSharePermissionCommandOutput
+  | CreatePermissionCommandOutput
+  | CreatePermissionVersionCommandOutput
   | CreateResourceShareCommandOutput
+  | DeletePermissionCommandOutput
+  | DeletePermissionVersionCommandOutput
   | DeleteResourceShareCommandOutput
   | DisassociateResourceShareCommandOutput
   | DisassociateResourceSharePermissionCommandOutput
@@ -181,14 +224,19 @@ export type ServiceOutputTypes =
   | GetResourceShareInvitationsCommandOutput
   | GetResourceSharesCommandOutput
   | ListPendingInvitationResourcesCommandOutput
+  | ListPermissionAssociationsCommandOutput
   | ListPermissionVersionsCommandOutput
   | ListPermissionsCommandOutput
   | ListPrincipalsCommandOutput
+  | ListReplacePermissionAssociationsWorkCommandOutput
   | ListResourceSharePermissionsCommandOutput
   | ListResourceTypesCommandOutput
   | ListResourcesCommandOutput
+  | PromotePermissionCreatedFromPolicyCommandOutput
   | PromoteResourceShareCreatedFromPolicyCommandOutput
   | RejectResourceShareInvitationCommandOutput
+  | ReplacePermissionAssociationsCommandOutput
+  | SetDefaultPermissionVersionCommandOutput
   | TagResourceCommandOutput
   | UntagResourceCommandOutput
   | UpdateResourceShareCommandOutput;
@@ -359,11 +407,10 @@ export interface RAMClientResolvedConfig extends RAMClientResolvedConfigType {}
  * @public
  * <p>This is the <i>Resource Access Manager API Reference</i>. This documentation provides
  *             descriptions and syntax for each of the actions and data types in RAM. RAM is a
- *             service that helps you securely share your Amazon Web Services resources across Amazon Web Services accounts. If you
- *             have multiple Amazon Web Services accounts, you can use RAM to share those resources with other
- *             accounts. If you use Organizations to manage your accounts, then you share your resources
- *             with your organization or organizational units (OUs). For supported resource types, you
- *             can also share resources with individual Identity and Access Management (IAM) roles an users. </p>
+ *             service that helps you securely share your Amazon Web Services resources to other Amazon Web Services accounts. If
+ *             you use Organizations to manage your accounts, then you can share your resources with your
+ *             entire organization or to organizational units (OUs). For supported resource types, you
+ *             can also share resources with individual Identity and Access Management (IAM) roles and users. </p>
  *          <p>To learn more about RAM, see the following resources:</p>
  *          <ul>
  *             <li>
diff --git a/clients/client-ram/src/commands/AcceptResourceShareInvitationCommand.ts b/clients/client-ram/src/commands/AcceptResourceShareInvitationCommand.ts
index 1da90155e1bd..0c4f89ae3fdf 100644
--- a/clients/client-ram/src/commands/AcceptResourceShareInvitationCommand.ts
+++ b/clients/client-ram/src/commands/AcceptResourceShareInvitationCommand.ts
@@ -61,36 +61,40 @@ export interface AcceptResourceShareInvitationCommandOutput
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link IdempotentParameterMismatchException} (client fault)
- *  <p>The client token input parameter was matched one used with a previous call to the
- *             operation, but at least one of the other input parameters is different from the previous
- *             call.</p>
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
  *
  * @throws {@link InvalidClientTokenException} (client fault)
- *  <p>The client token is not valid.</p>
+ *  <p>The operation failed because the specified client token isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ResourceShareInvitationAlreadyAcceptedException} (client fault)
- *  <p>The specified invitation was already accepted.</p>
+ *  <p>The operation failed because the specified invitation was already accepted.</p>
  *
  * @throws {@link ResourceShareInvitationAlreadyRejectedException} (client fault)
- *  <p>The specified invitation was already rejected.</p>
+ *  <p>The operation failed because the specified invitation was already rejected.</p>
  *
  * @throws {@link ResourceShareInvitationArnNotFoundException} (client fault)
- *  <p>The specified Amazon Resource Name (ARN) for an invitation was not found.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> for an invitation was not
+ *             found.</p>
  *
  * @throws {@link ResourceShareInvitationExpiredException} (client fault)
- *  <p>The specified invitation is expired.</p>
+ *  <p>The operation failed because the specified invitation is past its expiration date and
+ *             time.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/AssociateResourceShareCommand.ts b/clients/client-ram/src/commands/AssociateResourceShareCommand.ts
index b6bcb872b42c..92082cd6f6f0 100644
--- a/clients/client-ram/src/commands/AssociateResourceShareCommand.ts
+++ b/clients/client-ram/src/commands/AssociateResourceShareCommand.ts
@@ -62,40 +62,45 @@ export interface AssociateResourceShareCommandOutput extends AssociateResourceSh
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link IdempotentParameterMismatchException} (client fault)
- *  <p>The client token input parameter was matched one used with a previous call to the
- *             operation, but at least one of the other input parameters is different from the previous
- *             call.</p>
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
  *
  * @throws {@link InvalidClientTokenException} (client fault)
- *  <p>The client token is not valid.</p>
+ *  <p>The operation failed because the specified client token isn't valid.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link InvalidStateTransitionException} (client fault)
- *  <p>The requested state transition is not valid.</p>
+ *  <p>The operation failed because the requested operation isn't valid for the resource
+ *             share in its current state.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ResourceShareLimitExceededException} (client fault)
- *  <p>This request would exceed the limit for resource shares for your account.</p>
+ *  <p>The operation failed because it would exceed the limit for resource shares for your account. To
+ *             view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the Service Quotas
+ *                 console</a>.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  <p>You exceeded the rate at which you are allowed to perform this operation. Please try
- *             again later.</p>
+ *  <p>The operation failed because it exceeded the rate at which you are allowed to perform
+ *             this operation. Please try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/AssociateResourceSharePermissionCommand.ts b/clients/client-ram/src/commands/AssociateResourceSharePermissionCommand.ts
index 96497e2de567..ea65adb2d5f8 100644
--- a/clients/client-ram/src/commands/AssociateResourceSharePermissionCommand.ts
+++ b/clients/client-ram/src/commands/AssociateResourceSharePermissionCommand.ts
@@ -65,25 +65,27 @@ export interface AssociateResourceSharePermissionCommandOutput
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidClientTokenException} (client fault)
- *  <p>The client token is not valid.</p>
+ *  <p>The operation failed because the specified client token isn't valid.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/CreatePermissionCommand.ts b/clients/client-ram/src/commands/CreatePermissionCommand.ts
new file mode 100644
index 000000000000..4afede087139
--- /dev/null
+++ b/clients/client-ram/src/commands/CreatePermissionCommand.ts
@@ -0,0 +1,178 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import { CreatePermissionRequest, CreatePermissionResponse } from "../models/models_0";
+import { de_CreatePermissionCommand, se_CreatePermissionCommand } from "../protocols/Aws_restJson1";
+import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
+
+/**
+ * @public
+ *
+ * The input for {@link CreatePermissionCommand}.
+ */
+export interface CreatePermissionCommandInput extends CreatePermissionRequest {}
+/**
+ * @public
+ *
+ * The output of {@link CreatePermissionCommand}.
+ */
+export interface CreatePermissionCommandOutput extends CreatePermissionResponse, __MetadataBearer {}
+
+/**
+ * @public
+ * <p>Creates a customer managed permission for a specified resource type that you can attach to resource shares.
+ *             It is created in the Amazon Web Services Region in which you call the operation.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { RAMClient, CreatePermissionCommand } from "@aws-sdk/client-ram"; // ES Modules import
+ * // const { RAMClient, CreatePermissionCommand } = require("@aws-sdk/client-ram"); // CommonJS import
+ * const client = new RAMClient(config);
+ * const input = { // CreatePermissionRequest
+ *   name: "STRING_VALUE", // required
+ *   resourceType: "STRING_VALUE", // required
+ *   policyTemplate: "STRING_VALUE", // required
+ *   clientToken: "STRING_VALUE",
+ *   tags: [ // TagList
+ *     { // Tag
+ *       key: "STRING_VALUE",
+ *       value: "STRING_VALUE",
+ *     },
+ *   ],
+ * };
+ * const command = new CreatePermissionCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @param CreatePermissionCommandInput - {@link CreatePermissionCommandInput}
+ * @returns {@link CreatePermissionCommandOutput}
+ * @see {@link CreatePermissionCommandInput} for command's `input` shape.
+ * @see {@link CreatePermissionCommandOutput} for command's `response` shape.
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
+ *
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
+ *
+ * @throws {@link InvalidClientTokenException} (client fault)
+ *  <p>The operation failed because the specified client token isn't valid.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
+ *
+ * @throws {@link InvalidPolicyException} (client fault)
+ *  <p>The operation failed because a policy you specified isn't valid.</p>
+ *
+ * @throws {@link MalformedPolicyTemplateException} (client fault)
+ *  <p>The operation failed because the policy template that you provided isn't valid.</p>
+ *
+ * @throws {@link OperationNotPermittedException} (client fault)
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
+ *
+ * @throws {@link PermissionAlreadyExistsException} (client fault)
+ *  <p>The operation failed because a permission with the specified name already exists in
+ *             the requested Amazon Web Services Region. Choose a different name.</p>
+ *
+ * @throws {@link PermissionLimitExceededException} (client fault)
+ *  <p>The operation failed because it would exceed the maximum number of permissions you can
+ *             create in each Amazon Web Services Region. To view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the
+ *                 Service Quotas console</a>.</p>
+ *
+ * @throws {@link ServerInternalException} (server fault)
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
+ *
+ *
+ */
+export class CreatePermissionCommand extends $Command<
+  CreatePermissionCommandInput,
+  CreatePermissionCommandOutput,
+  RAMClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  /**
+   * @public
+   */
+  constructor(readonly input: CreatePermissionCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: RAMClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<CreatePermissionCommandInput, CreatePermissionCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, CreatePermissionCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "RAMClient";
+    const commandName = "CreatePermissionCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: (_: any) => _,
+      outputFilterSensitiveLog: (_: any) => _,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  /**
+   * @internal
+   */
+  private serialize(input: CreatePermissionCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return se_CreatePermissionCommand(input, context);
+  }
+
+  /**
+   * @internal
+   */
+  private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<CreatePermissionCommandOutput> {
+    return de_CreatePermissionCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}
diff --git a/clients/client-ram/src/commands/CreatePermissionVersionCommand.ts b/clients/client-ram/src/commands/CreatePermissionVersionCommand.ts
new file mode 100644
index 000000000000..f746a26678db
--- /dev/null
+++ b/clients/client-ram/src/commands/CreatePermissionVersionCommand.ts
@@ -0,0 +1,175 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import { CreatePermissionVersionRequest, CreatePermissionVersionResponse } from "../models/models_0";
+import { de_CreatePermissionVersionCommand, se_CreatePermissionVersionCommand } from "../protocols/Aws_restJson1";
+import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
+
+/**
+ * @public
+ *
+ * The input for {@link CreatePermissionVersionCommand}.
+ */
+export interface CreatePermissionVersionCommandInput extends CreatePermissionVersionRequest {}
+/**
+ * @public
+ *
+ * The output of {@link CreatePermissionVersionCommand}.
+ */
+export interface CreatePermissionVersionCommandOutput extends CreatePermissionVersionResponse, __MetadataBearer {}
+
+/**
+ * @public
+ * <p>Creates a new version of the specified customer managed permission. The new version is automatically set as
+ *             the default version of the customer managed permission. New resource shares automatically use the default
+ *             permission. Existing resource shares continue to use their original permission versions,
+ *             but you can use <a>ReplacePermissionAssociations</a> to update them.</p>
+ *          <p>If the specified customer managed permission already has the maximum of 5 versions, then
+ *             you must delete one of the existing versions before you can create a new one.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { RAMClient, CreatePermissionVersionCommand } from "@aws-sdk/client-ram"; // ES Modules import
+ * // const { RAMClient, CreatePermissionVersionCommand } = require("@aws-sdk/client-ram"); // CommonJS import
+ * const client = new RAMClient(config);
+ * const input = { // CreatePermissionVersionRequest
+ *   permissionArn: "STRING_VALUE", // required
+ *   policyTemplate: "STRING_VALUE", // required
+ *   clientToken: "STRING_VALUE",
+ * };
+ * const command = new CreatePermissionVersionCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @param CreatePermissionVersionCommandInput - {@link CreatePermissionVersionCommandInput}
+ * @returns {@link CreatePermissionVersionCommandOutput}
+ * @see {@link CreatePermissionVersionCommandInput} for command's `input` shape.
+ * @see {@link CreatePermissionVersionCommandOutput} for command's `response` shape.
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
+ *
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
+ *
+ * @throws {@link InvalidClientTokenException} (client fault)
+ *  <p>The operation failed because the specified client token isn't valid.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
+ *
+ * @throws {@link InvalidPolicyException} (client fault)
+ *  <p>The operation failed because a policy you specified isn't valid.</p>
+ *
+ * @throws {@link MalformedArnException} (client fault)
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
+ *
+ * @throws {@link MalformedPolicyTemplateException} (client fault)
+ *  <p>The operation failed because the policy template that you provided isn't valid.</p>
+ *
+ * @throws {@link PermissionVersionsLimitExceededException} (client fault)
+ *  <p>The operation failed because it would exceed the limit for the number of versions you
+ *             can have for a permission. To view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the
+ *                 Service Quotas console</a>.</p>
+ *
+ * @throws {@link ServerInternalException} (server fault)
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
+ *
+ * @throws {@link UnknownResourceException} (client fault)
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
+ *
+ *
+ */
+export class CreatePermissionVersionCommand extends $Command<
+  CreatePermissionVersionCommandInput,
+  CreatePermissionVersionCommandOutput,
+  RAMClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  /**
+   * @public
+   */
+  constructor(readonly input: CreatePermissionVersionCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: RAMClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<CreatePermissionVersionCommandInput, CreatePermissionVersionCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, CreatePermissionVersionCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "RAMClient";
+    const commandName = "CreatePermissionVersionCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: (_: any) => _,
+      outputFilterSensitiveLog: (_: any) => _,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  /**
+   * @internal
+   */
+  private serialize(input: CreatePermissionVersionCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return se_CreatePermissionVersionCommand(input, context);
+  }
+
+  /**
+   * @internal
+   */
+  private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<CreatePermissionVersionCommandOutput> {
+    return de_CreatePermissionVersionCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}
diff --git a/clients/client-ram/src/commands/CreateResourceShareCommand.ts b/clients/client-ram/src/commands/CreateResourceShareCommand.ts
index e46aa5660fb5..2dbc7270e895 100644
--- a/clients/client-ram/src/commands/CreateResourceShareCommand.ts
+++ b/clients/client-ram/src/commands/CreateResourceShareCommand.ts
@@ -77,39 +77,45 @@ export interface CreateResourceShareCommandOutput extends CreateResourceShareRes
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link IdempotentParameterMismatchException} (client fault)
- *  <p>The client token input parameter was matched one used with a previous call to the
- *             operation, but at least one of the other input parameters is different from the previous
- *             call.</p>
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
  *
  * @throws {@link InvalidClientTokenException} (client fault)
- *  <p>The client token is not valid.</p>
+ *  <p>The operation failed because the specified client token isn't valid.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link InvalidStateTransitionException} (client fault)
- *  <p>The requested state transition is not valid.</p>
+ *  <p>The operation failed because the requested operation isn't valid for the resource
+ *             share in its current state.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ResourceShareLimitExceededException} (client fault)
- *  <p>This request would exceed the limit for resource shares for your account.</p>
+ *  <p>The operation failed because it would exceed the limit for resource shares for your account. To
+ *             view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the Service Quotas
+ *                 console</a>.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link TagPolicyViolationException} (client fault)
- *  <p>The specified tag key is a reserved word and can't be used.</p>
+ *  <p>The operation failed because the specified tag key is a reserved word and can't be
+ *             used.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/DeletePermissionCommand.ts b/clients/client-ram/src/commands/DeletePermissionCommand.ts
new file mode 100644
index 000000000000..e8835153c3cf
--- /dev/null
+++ b/clients/client-ram/src/commands/DeletePermissionCommand.ts
@@ -0,0 +1,160 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import { DeletePermissionRequest, DeletePermissionResponse } from "../models/models_0";
+import { de_DeletePermissionCommand, se_DeletePermissionCommand } from "../protocols/Aws_restJson1";
+import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
+
+/**
+ * @public
+ *
+ * The input for {@link DeletePermissionCommand}.
+ */
+export interface DeletePermissionCommandInput extends DeletePermissionRequest {}
+/**
+ * @public
+ *
+ * The output of {@link DeletePermissionCommand}.
+ */
+export interface DeletePermissionCommandOutput extends DeletePermissionResponse, __MetadataBearer {}
+
+/**
+ * @public
+ * <p>Deletes the specified customer managed permission in the Amazon Web Services Region in which you call this operation. You
+ *             can delete a customer managed permission only if it isn't attached to any resource share. The operation deletes all
+ *             versions associated with the customer managed permission.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { RAMClient, DeletePermissionCommand } from "@aws-sdk/client-ram"; // ES Modules import
+ * // const { RAMClient, DeletePermissionCommand } = require("@aws-sdk/client-ram"); // CommonJS import
+ * const client = new RAMClient(config);
+ * const input = { // DeletePermissionRequest
+ *   permissionArn: "STRING_VALUE", // required
+ *   clientToken: "STRING_VALUE",
+ * };
+ * const command = new DeletePermissionCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @param DeletePermissionCommandInput - {@link DeletePermissionCommandInput}
+ * @returns {@link DeletePermissionCommandOutput}
+ * @see {@link DeletePermissionCommandInput} for command's `input` shape.
+ * @see {@link DeletePermissionCommandOutput} for command's `response` shape.
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
+ *
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
+ *
+ * @throws {@link InvalidClientTokenException} (client fault)
+ *  <p>The operation failed because the specified client token isn't valid.</p>
+ *
+ * @throws {@link MalformedArnException} (client fault)
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
+ *
+ * @throws {@link OperationNotPermittedException} (client fault)
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
+ *
+ * @throws {@link ServerInternalException} (server fault)
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
+ *
+ * @throws {@link UnknownResourceException} (client fault)
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
+ *
+ *
+ */
+export class DeletePermissionCommand extends $Command<
+  DeletePermissionCommandInput,
+  DeletePermissionCommandOutput,
+  RAMClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  /**
+   * @public
+   */
+  constructor(readonly input: DeletePermissionCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: RAMClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<DeletePermissionCommandInput, DeletePermissionCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, DeletePermissionCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "RAMClient";
+    const commandName = "DeletePermissionCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: (_: any) => _,
+      outputFilterSensitiveLog: (_: any) => _,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  /**
+   * @internal
+   */
+  private serialize(input: DeletePermissionCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return se_DeletePermissionCommand(input, context);
+  }
+
+  /**
+   * @internal
+   */
+  private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<DeletePermissionCommandOutput> {
+    return de_DeletePermissionCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}
diff --git a/clients/client-ram/src/commands/DeletePermissionVersionCommand.ts b/clients/client-ram/src/commands/DeletePermissionVersionCommand.ts
new file mode 100644
index 000000000000..48fa257dab61
--- /dev/null
+++ b/clients/client-ram/src/commands/DeletePermissionVersionCommand.ts
@@ -0,0 +1,165 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import { DeletePermissionVersionRequest, DeletePermissionVersionResponse } from "../models/models_0";
+import { de_DeletePermissionVersionCommand, se_DeletePermissionVersionCommand } from "../protocols/Aws_restJson1";
+import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
+
+/**
+ * @public
+ *
+ * The input for {@link DeletePermissionVersionCommand}.
+ */
+export interface DeletePermissionVersionCommandInput extends DeletePermissionVersionRequest {}
+/**
+ * @public
+ *
+ * The output of {@link DeletePermissionVersionCommand}.
+ */
+export interface DeletePermissionVersionCommandOutput extends DeletePermissionVersionResponse, __MetadataBearer {}
+
+/**
+ * @public
+ * <p>Deletes one version of a customer managed permission. The version you specify must not be attached to any
+ *             resource share and must not be the default version for the permission.</p>
+ *          <p>If a customer managed permission has the maximum of 5 versions, then you must delete at
+ *             least one version before you can create another.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { RAMClient, DeletePermissionVersionCommand } from "@aws-sdk/client-ram"; // ES Modules import
+ * // const { RAMClient, DeletePermissionVersionCommand } = require("@aws-sdk/client-ram"); // CommonJS import
+ * const client = new RAMClient(config);
+ * const input = { // DeletePermissionVersionRequest
+ *   permissionArn: "STRING_VALUE", // required
+ *   permissionVersion: Number("int"), // required
+ *   clientToken: "STRING_VALUE",
+ * };
+ * const command = new DeletePermissionVersionCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @param DeletePermissionVersionCommandInput - {@link DeletePermissionVersionCommandInput}
+ * @returns {@link DeletePermissionVersionCommandOutput}
+ * @see {@link DeletePermissionVersionCommandInput} for command's `input` shape.
+ * @see {@link DeletePermissionVersionCommandOutput} for command's `response` shape.
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
+ *
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
+ *
+ * @throws {@link InvalidClientTokenException} (client fault)
+ *  <p>The operation failed because the specified client token isn't valid.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
+ *
+ * @throws {@link MalformedArnException} (client fault)
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
+ *
+ * @throws {@link OperationNotPermittedException} (client fault)
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
+ *
+ * @throws {@link ServerInternalException} (server fault)
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
+ *
+ * @throws {@link UnknownResourceException} (client fault)
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
+ *
+ *
+ */
+export class DeletePermissionVersionCommand extends $Command<
+  DeletePermissionVersionCommandInput,
+  DeletePermissionVersionCommandOutput,
+  RAMClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  /**
+   * @public
+   */
+  constructor(readonly input: DeletePermissionVersionCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: RAMClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<DeletePermissionVersionCommandInput, DeletePermissionVersionCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, DeletePermissionVersionCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "RAMClient";
+    const commandName = "DeletePermissionVersionCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: (_: any) => _,
+      outputFilterSensitiveLog: (_: any) => _,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  /**
+   * @internal
+   */
+  private serialize(input: DeletePermissionVersionCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return se_DeletePermissionVersionCommand(input, context);
+  }
+
+  /**
+   * @internal
+   */
+  private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<DeletePermissionVersionCommandOutput> {
+    return de_DeletePermissionVersionCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}
diff --git a/clients/client-ram/src/commands/DeleteResourceShareCommand.ts b/clients/client-ram/src/commands/DeleteResourceShareCommand.ts
index 9a5be47de39b..75c24f234de3 100644
--- a/clients/client-ram/src/commands/DeleteResourceShareCommand.ts
+++ b/clients/client-ram/src/commands/DeleteResourceShareCommand.ts
@@ -32,9 +32,11 @@ export interface DeleteResourceShareCommandOutput extends DeleteResourceShareRes
 
 /**
  * @public
- * <p>Deletes the specified resource share. This doesn't delete any of the resources that were
- *             associated with the resource share; it only stops the sharing of those resources outside of the
- *             Amazon Web Services account that created them.</p>
+ * <p>Deletes the specified resource share.</p>
+ *          <important>
+ *             <p>This doesn't delete any of the resources that were associated with the resource share; it
+ *                 only stops the sharing of those resources through this resource share.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -56,33 +58,36 @@ export interface DeleteResourceShareCommandOutput extends DeleteResourceShareRes
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link IdempotentParameterMismatchException} (client fault)
- *  <p>The client token input parameter was matched one used with a previous call to the
- *             operation, but at least one of the other input parameters is different from the previous
- *             call.</p>
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
  *
  * @throws {@link InvalidClientTokenException} (client fault)
- *  <p>The client token is not valid.</p>
+ *  <p>The operation failed because the specified client token isn't valid.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link InvalidStateTransitionException} (client fault)
- *  <p>The requested state transition is not valid.</p>
+ *  <p>The operation failed because the requested operation isn't valid for the resource
+ *             share in its current state.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/DisassociateResourceShareCommand.ts b/clients/client-ram/src/commands/DisassociateResourceShareCommand.ts
index a32e927e2701..bb1257ae03f1 100644
--- a/clients/client-ram/src/commands/DisassociateResourceShareCommand.ts
+++ b/clients/client-ram/src/commands/DisassociateResourceShareCommand.ts
@@ -32,7 +32,8 @@ export interface DisassociateResourceShareCommandOutput extends DisassociateReso
 
 /**
  * @public
- * <p>Disassociates the specified principals or resources from the specified resource share.</p>
+ * <p>Removes the specified principals or resources from participating in the specified
+ *             resource share.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -60,36 +61,41 @@ export interface DisassociateResourceShareCommandOutput extends DisassociateReso
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link IdempotentParameterMismatchException} (client fault)
- *  <p>The client token input parameter was matched one used with a previous call to the
- *             operation, but at least one of the other input parameters is different from the previous
- *             call.</p>
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
  *
  * @throws {@link InvalidClientTokenException} (client fault)
- *  <p>The client token is not valid.</p>
+ *  <p>The operation failed because the specified client token isn't valid.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link InvalidStateTransitionException} (client fault)
- *  <p>The requested state transition is not valid.</p>
+ *  <p>The operation failed because the requested operation isn't valid for the resource
+ *             share in its current state.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ResourceShareLimitExceededException} (client fault)
- *  <p>This request would exceed the limit for resource shares for your account.</p>
+ *  <p>The operation failed because it would exceed the limit for resource shares for your account. To
+ *             view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the Service Quotas
+ *                 console</a>.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/DisassociateResourceSharePermissionCommand.ts b/clients/client-ram/src/commands/DisassociateResourceSharePermissionCommand.ts
index e018722743d2..d691263d4363 100644
--- a/clients/client-ram/src/commands/DisassociateResourceSharePermissionCommand.ts
+++ b/clients/client-ram/src/commands/DisassociateResourceSharePermissionCommand.ts
@@ -40,9 +40,9 @@ export interface DisassociateResourceSharePermissionCommandOutput
 
 /**
  * @public
- * <p>Disassociates an RAM permission from a resource share. Permission changes take effect
- *             immediately. You can remove a RAM permission from a resource share only if there are currently
- *             no resources of the relevant resource type currently attached to the resource share.</p>
+ * <p>Removes a managed permission from a resource share. Permission changes take effect immediately. You can
+ *             remove a managed permission from a resource share only if there are currently no resources of the relevant
+ *             resource type currently attached to the resource share.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -65,28 +65,31 @@ export interface DisassociateResourceSharePermissionCommandOutput
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidClientTokenException} (client fault)
- *  <p>The client token is not valid.</p>
+ *  <p>The operation failed because the specified client token isn't valid.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link InvalidStateTransitionException} (client fault)
- *  <p>The requested state transition is not valid.</p>
+ *  <p>The operation failed because the requested operation isn't valid for the resource
+ *             share in its current state.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/EnableSharingWithAwsOrganizationCommand.ts b/clients/client-ram/src/commands/EnableSharingWithAwsOrganizationCommand.ts
index 74cd9c5bfd8e..e385fd3b2166 100644
--- a/clients/client-ram/src/commands/EnableSharingWithAwsOrganizationCommand.ts
+++ b/clients/client-ram/src/commands/EnableSharingWithAwsOrganizationCommand.ts
@@ -37,15 +37,17 @@ export interface EnableSharingWithAwsOrganizationCommandOutput
 
 /**
  * @public
- * <p>Enables resource sharing within your organization in Organizations. Calling this operation
- *             enables RAM to retrieve information about the organization and its structure. This
- *             lets you share resources with all of the accounts in an organization by specifying the
- *             organization's ID, or all of the accounts in an organizational unit (OU) by specifying
- *             the OU's ID. Until you enable sharing within the organization, you can specify only
- *             individual Amazon Web Services accounts, or for supported resource types, IAM users and
- *             roles.</p>
- *          <p>You must call this operation from an IAM user or role in the organization's
+ * <p>Enables resource sharing within your organization in Organizations. This operation creates
+ *             a service-linked role called <code>AWSServiceRoleForResourceAccessManager</code> that has the IAM managed policy
+ *             named AWSResourceAccessManagerServiceRolePolicy attached. This role permits RAM to retrieve information about
+ *             the organization and its structure. This lets you share resources with all of the
+ *             accounts in the calling account's organization by specifying the organization ID, or all
+ *             of the accounts in an organizational unit (OU) by specifying the OU ID. Until you enable
+ *             sharing within the organization, you can specify only individual Amazon Web Services accounts, or for
+ *             supported resource types, IAM roles and users.</p>
+ *          <p>You must call this operation from an IAM role or user in the organization's
  *             management account.</p>
+ *          <p></p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -64,13 +66,14 @@ export interface EnableSharingWithAwsOrganizationCommandOutput
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/GetPermissionCommand.ts b/clients/client-ram/src/commands/GetPermissionCommand.ts
index ff5ef4c751fb..565c20c37c3a 100644
--- a/clients/client-ram/src/commands/GetPermissionCommand.ts
+++ b/clients/client-ram/src/commands/GetPermissionCommand.ts
@@ -32,7 +32,7 @@ export interface GetPermissionCommandOutput extends GetPermissionResponse, __Met
 
 /**
  * @public
- * <p>Gets the contents of an RAM permission in JSON format.</p>
+ * <p>Retrieves the contents of a managed permission in JSON format.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -54,22 +54,24 @@ export interface GetPermissionCommandOutput extends GetPermissionResponse, __Met
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/GetResourcePoliciesCommand.ts b/clients/client-ram/src/commands/GetResourcePoliciesCommand.ts
index 9df72028d1d5..178dfb774ce6 100644
--- a/clients/client-ram/src/commands/GetResourcePoliciesCommand.ts
+++ b/clients/client-ram/src/commands/GetResourcePoliciesCommand.ts
@@ -59,22 +59,26 @@ export interface GetResourcePoliciesCommandOutput extends GetResourcePoliciesRes
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link ResourceArnNotFoundException} (client fault)
- *  <p>The specified Amazon Resource Name (ARN) was not found.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> was not found.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/GetResourceShareAssociationsCommand.ts b/clients/client-ram/src/commands/GetResourceShareAssociationsCommand.ts
index 4bfe0686a3bc..b3786203e719 100644
--- a/clients/client-ram/src/commands/GetResourceShareAssociationsCommand.ts
+++ b/clients/client-ram/src/commands/GetResourceShareAssociationsCommand.ts
@@ -37,7 +37,8 @@ export interface GetResourceShareAssociationsCommandOutput
 
 /**
  * @public
- * <p>Retrieves the resource and principal associations for resource shares that you own.</p>
+ * <p>Retrieves the lists of resources and principals that associated for resource shares that you
+ *             own.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -66,25 +67,29 @@ export interface GetResourceShareAssociationsCommandOutput
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/GetResourceShareInvitationsCommand.ts b/clients/client-ram/src/commands/GetResourceShareInvitationsCommand.ts
index 6ae0e0725889..068b45ea0815 100644
--- a/clients/client-ram/src/commands/GetResourceShareInvitationsCommand.ts
+++ b/clients/client-ram/src/commands/GetResourceShareInvitationsCommand.ts
@@ -65,28 +65,34 @@ export interface GetResourceShareInvitationsCommandOutput
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidMaxResultsException} (client fault)
- *  <p>The specified value for <code>MaxResults</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>MaxResults</code> isn't
+ *             valid.</p>
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link ResourceShareInvitationArnNotFoundException} (client fault)
- *  <p>The specified Amazon Resource Name (ARN) for an invitation was not found.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> for an invitation was not
+ *             found.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/GetResourceSharesCommand.ts b/clients/client-ram/src/commands/GetResourceSharesCommand.ts
index 9c01a577cf3d..b0361bbc6712 100644
--- a/clients/client-ram/src/commands/GetResourceSharesCommand.ts
+++ b/clients/client-ram/src/commands/GetResourceSharesCommand.ts
@@ -57,6 +57,7 @@ export interface GetResourceSharesCommandOutput extends GetResourceSharesRespons
  *   nextToken: "STRING_VALUE",
  *   maxResults: Number("int"),
  *   permissionArn: "STRING_VALUE",
+ *   permissionVersion: Number("int"),
  * };
  * const command = new GetResourceSharesCommand(input);
  * const response = await client.send(command);
@@ -69,22 +70,26 @@ export interface GetResourceSharesCommandOutput extends GetResourceSharesRespons
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/ListPendingInvitationResourcesCommand.ts b/clients/client-ram/src/commands/ListPendingInvitationResourcesCommand.ts
index 7908d72b10bd..d2b463d01802 100644
--- a/clients/client-ram/src/commands/ListPendingInvitationResourcesCommand.ts
+++ b/clients/client-ram/src/commands/ListPendingInvitationResourcesCommand.ts
@@ -63,31 +63,37 @@ export interface ListPendingInvitationResourcesCommandOutput
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link MissingRequiredParameterException} (client fault)
- *  <p>A required input parameter is missing.</p>
+ *  <p>The operation failed because a required input parameter is missing.</p>
  *
  * @throws {@link ResourceShareInvitationAlreadyRejectedException} (client fault)
- *  <p>The specified invitation was already rejected.</p>
+ *  <p>The operation failed because the specified invitation was already rejected.</p>
  *
  * @throws {@link ResourceShareInvitationArnNotFoundException} (client fault)
- *  <p>The specified Amazon Resource Name (ARN) for an invitation was not found.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> for an invitation was not
+ *             found.</p>
  *
  * @throws {@link ResourceShareInvitationExpiredException} (client fault)
- *  <p>The specified invitation is expired.</p>
+ *  <p>The operation failed because the specified invitation is past its expiration date and
+ *             time.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/ListPermissionAssociationsCommand.ts b/clients/client-ram/src/commands/ListPermissionAssociationsCommand.ts
new file mode 100644
index 000000000000..66e77c74eb7c
--- /dev/null
+++ b/clients/client-ram/src/commands/ListPermissionAssociationsCommand.ts
@@ -0,0 +1,163 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import { ListPermissionAssociationsRequest, ListPermissionAssociationsResponse } from "../models/models_0";
+import { de_ListPermissionAssociationsCommand, se_ListPermissionAssociationsCommand } from "../protocols/Aws_restJson1";
+import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
+
+/**
+ * @public
+ *
+ * The input for {@link ListPermissionAssociationsCommand}.
+ */
+export interface ListPermissionAssociationsCommandInput extends ListPermissionAssociationsRequest {}
+/**
+ * @public
+ *
+ * The output of {@link ListPermissionAssociationsCommand}.
+ */
+export interface ListPermissionAssociationsCommandOutput extends ListPermissionAssociationsResponse, __MetadataBearer {}
+
+/**
+ * @public
+ * <p>Lists information about the managed permission and its associations to any resource shares that use
+ *             this managed permission. This lets you see which resource shares use which versions of the specified
+ *             managed permission.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { RAMClient, ListPermissionAssociationsCommand } from "@aws-sdk/client-ram"; // ES Modules import
+ * // const { RAMClient, ListPermissionAssociationsCommand } = require("@aws-sdk/client-ram"); // CommonJS import
+ * const client = new RAMClient(config);
+ * const input = { // ListPermissionAssociationsRequest
+ *   permissionArn: "STRING_VALUE",
+ *   permissionVersion: Number("int"),
+ *   associationStatus: "ASSOCIATING" || "ASSOCIATED" || "FAILED" || "DISASSOCIATING" || "DISASSOCIATED",
+ *   resourceType: "STRING_VALUE",
+ *   featureSet: "CREATED_FROM_POLICY" || "PROMOTING_TO_STANDARD" || "STANDARD",
+ *   defaultVersion: true || false,
+ *   nextToken: "STRING_VALUE",
+ *   maxResults: Number("int"),
+ * };
+ * const command = new ListPermissionAssociationsCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @param ListPermissionAssociationsCommandInput - {@link ListPermissionAssociationsCommandInput}
+ * @returns {@link ListPermissionAssociationsCommandOutput}
+ * @see {@link ListPermissionAssociationsCommandInput} for command's `input` shape.
+ * @see {@link ListPermissionAssociationsCommandOutput} for command's `response` shape.
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
+ *
+ * @throws {@link InvalidNextTokenException} (client fault)
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
+ *
+ * @throws {@link MalformedArnException} (client fault)
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
+ *
+ * @throws {@link ServerInternalException} (server fault)
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
+ *
+ *
+ */
+export class ListPermissionAssociationsCommand extends $Command<
+  ListPermissionAssociationsCommandInput,
+  ListPermissionAssociationsCommandOutput,
+  RAMClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  /**
+   * @public
+   */
+  constructor(readonly input: ListPermissionAssociationsCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: RAMClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<ListPermissionAssociationsCommandInput, ListPermissionAssociationsCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, ListPermissionAssociationsCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "RAMClient";
+    const commandName = "ListPermissionAssociationsCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: (_: any) => _,
+      outputFilterSensitiveLog: (_: any) => _,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  /**
+   * @internal
+   */
+  private serialize(input: ListPermissionAssociationsCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return se_ListPermissionAssociationsCommand(input, context);
+  }
+
+  /**
+   * @internal
+   */
+  private deserialize(
+    output: __HttpResponse,
+    context: __SerdeContext
+  ): Promise<ListPermissionAssociationsCommandOutput> {
+    return de_ListPermissionAssociationsCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}
diff --git a/clients/client-ram/src/commands/ListPermissionVersionsCommand.ts b/clients/client-ram/src/commands/ListPermissionVersionsCommand.ts
index 0f1616601821..2511feeceb97 100644
--- a/clients/client-ram/src/commands/ListPermissionVersionsCommand.ts
+++ b/clients/client-ram/src/commands/ListPermissionVersionsCommand.ts
@@ -55,25 +55,29 @@ export interface ListPermissionVersionsCommandOutput extends ListPermissionVersi
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/ListPermissionsCommand.ts b/clients/client-ram/src/commands/ListPermissionsCommand.ts
index 14ad03e42417..2a9a8bf25d96 100644
--- a/clients/client-ram/src/commands/ListPermissionsCommand.ts
+++ b/clients/client-ram/src/commands/ListPermissionsCommand.ts
@@ -44,6 +44,7 @@ export interface ListPermissionsCommandOutput extends ListPermissionsResponse, _
  *   resourceType: "STRING_VALUE",
  *   nextToken: "STRING_VALUE",
  *   maxResults: Number("int"),
+ *   permissionType: "ALL" || "AWS_MANAGED" || "CUSTOMER_MANAGED",
  * };
  * const command = new ListPermissionsCommand(input);
  * const response = await client.send(command);
@@ -56,19 +57,22 @@ export interface ListPermissionsCommandOutput extends ListPermissionsResponse, _
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/ListPrincipalsCommand.ts b/clients/client-ram/src/commands/ListPrincipalsCommand.ts
index 0eb606ef28cc..96eb57c5fa3a 100644
--- a/clients/client-ram/src/commands/ListPrincipalsCommand.ts
+++ b/clients/client-ram/src/commands/ListPrincipalsCommand.ts
@@ -64,22 +64,26 @@ export interface ListPrincipalsCommandOutput extends ListPrincipalsResponse, __M
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/ListReplacePermissionAssociationsWorkCommand.ts b/clients/client-ram/src/commands/ListReplacePermissionAssociationsWorkCommand.ts
new file mode 100644
index 000000000000..d8765e100940
--- /dev/null
+++ b/clients/client-ram/src/commands/ListReplacePermissionAssociationsWorkCommand.ts
@@ -0,0 +1,168 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import {
+  ListReplacePermissionAssociationsWorkRequest,
+  ListReplacePermissionAssociationsWorkResponse,
+} from "../models/models_0";
+import {
+  de_ListReplacePermissionAssociationsWorkCommand,
+  se_ListReplacePermissionAssociationsWorkCommand,
+} from "../protocols/Aws_restJson1";
+import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
+
+/**
+ * @public
+ *
+ * The input for {@link ListReplacePermissionAssociationsWorkCommand}.
+ */
+export interface ListReplacePermissionAssociationsWorkCommandInput
+  extends ListReplacePermissionAssociationsWorkRequest {}
+/**
+ * @public
+ *
+ * The output of {@link ListReplacePermissionAssociationsWorkCommand}.
+ */
+export interface ListReplacePermissionAssociationsWorkCommandOutput
+  extends ListReplacePermissionAssociationsWorkResponse,
+    __MetadataBearer {}
+
+/**
+ * @public
+ * <p>Retrieves the current status of the asynchronous tasks performed by RAM when you
+ *             perform the <a>ReplacePermissionAssociationsWork</a> operation.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { RAMClient, ListReplacePermissionAssociationsWorkCommand } from "@aws-sdk/client-ram"; // ES Modules import
+ * // const { RAMClient, ListReplacePermissionAssociationsWorkCommand } = require("@aws-sdk/client-ram"); // CommonJS import
+ * const client = new RAMClient(config);
+ * const input = { // ListReplacePermissionAssociationsWorkRequest
+ *   workIds: [ // ReplacePermissionAssociationsWorkIdList
+ *     "STRING_VALUE",
+ *   ],
+ *   status: "IN_PROGRESS" || "COMPLETED" || "FAILED",
+ *   nextToken: "STRING_VALUE",
+ *   maxResults: Number("int"),
+ * };
+ * const command = new ListReplacePermissionAssociationsWorkCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @param ListReplacePermissionAssociationsWorkCommandInput - {@link ListReplacePermissionAssociationsWorkCommandInput}
+ * @returns {@link ListReplacePermissionAssociationsWorkCommandOutput}
+ * @see {@link ListReplacePermissionAssociationsWorkCommandInput} for command's `input` shape.
+ * @see {@link ListReplacePermissionAssociationsWorkCommandOutput} for command's `response` shape.
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
+ *
+ * @throws {@link InvalidNextTokenException} (client fault)
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
+ *
+ * @throws {@link ServerInternalException} (server fault)
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
+ *
+ *
+ */
+export class ListReplacePermissionAssociationsWorkCommand extends $Command<
+  ListReplacePermissionAssociationsWorkCommandInput,
+  ListReplacePermissionAssociationsWorkCommandOutput,
+  RAMClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  /**
+   * @public
+   */
+  constructor(readonly input: ListReplacePermissionAssociationsWorkCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: RAMClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<ListReplacePermissionAssociationsWorkCommandInput, ListReplacePermissionAssociationsWorkCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, ListReplacePermissionAssociationsWorkCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "RAMClient";
+    const commandName = "ListReplacePermissionAssociationsWorkCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: (_: any) => _,
+      outputFilterSensitiveLog: (_: any) => _,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  /**
+   * @internal
+   */
+  private serialize(
+    input: ListReplacePermissionAssociationsWorkCommandInput,
+    context: __SerdeContext
+  ): Promise<__HttpRequest> {
+    return se_ListReplacePermissionAssociationsWorkCommand(input, context);
+  }
+
+  /**
+   * @internal
+   */
+  private deserialize(
+    output: __HttpResponse,
+    context: __SerdeContext
+  ): Promise<ListReplacePermissionAssociationsWorkCommandOutput> {
+    return de_ListReplacePermissionAssociationsWorkCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}
diff --git a/clients/client-ram/src/commands/ListResourceSharePermissionsCommand.ts b/clients/client-ram/src/commands/ListResourceSharePermissionsCommand.ts
index 8ea474f70d11..9c2abadd016f 100644
--- a/clients/client-ram/src/commands/ListResourceSharePermissionsCommand.ts
+++ b/clients/client-ram/src/commands/ListResourceSharePermissionsCommand.ts
@@ -60,25 +60,29 @@ export interface ListResourceSharePermissionsCommandOutput
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/ListResourceTypesCommand.ts b/clients/client-ram/src/commands/ListResourceTypesCommand.ts
index 801d66a68149..335d3a17d92c 100644
--- a/clients/client-ram/src/commands/ListResourceTypesCommand.ts
+++ b/clients/client-ram/src/commands/ListResourceTypesCommand.ts
@@ -55,16 +55,19 @@ export interface ListResourceTypesCommandOutput extends ListResourceTypesRespons
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/ListResourcesCommand.ts b/clients/client-ram/src/commands/ListResourcesCommand.ts
index d1f9456b11f6..f3ae5a38884c 100644
--- a/clients/client-ram/src/commands/ListResourcesCommand.ts
+++ b/clients/client-ram/src/commands/ListResourcesCommand.ts
@@ -65,25 +65,29 @@ export interface ListResourcesCommandOutput extends ListResourcesResponse, __Met
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidNextTokenException} (client fault)
- *  <p>The specified value for <code>NextToken</code> is not valid.</p>
+ *  <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link InvalidResourceTypeException} (client fault)
- *  <p>The specified resource type is not valid.</p>
+ *  <p>The operation failed because the specified resource type isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/PromotePermissionCreatedFromPolicyCommand.ts b/clients/client-ram/src/commands/PromotePermissionCreatedFromPolicyCommand.ts
new file mode 100644
index 000000000000..45621350fda0
--- /dev/null
+++ b/clients/client-ram/src/commands/PromotePermissionCreatedFromPolicyCommand.ts
@@ -0,0 +1,202 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import {
+  PromotePermissionCreatedFromPolicyRequest,
+  PromotePermissionCreatedFromPolicyResponse,
+} from "../models/models_0";
+import {
+  de_PromotePermissionCreatedFromPolicyCommand,
+  se_PromotePermissionCreatedFromPolicyCommand,
+} from "../protocols/Aws_restJson1";
+import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
+
+/**
+ * @public
+ *
+ * The input for {@link PromotePermissionCreatedFromPolicyCommand}.
+ */
+export interface PromotePermissionCreatedFromPolicyCommandInput extends PromotePermissionCreatedFromPolicyRequest {}
+/**
+ * @public
+ *
+ * The output of {@link PromotePermissionCreatedFromPolicyCommand}.
+ */
+export interface PromotePermissionCreatedFromPolicyCommandOutput
+  extends PromotePermissionCreatedFromPolicyResponse,
+    __MetadataBearer {}
+
+/**
+ * @public
+ * <p>When you attach a resource-based policy to a resource, RAM automatically creates
+ *             a resource share of <code>featureSet</code>=<code>CREATED_FROM_POLICY</code> with a managed permission that
+ *             has the same IAM permissions as the original resource-based policy. However, this type
+ *             of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by
+ *             using RAM.</p>
+ *          <p>This operation creates a separate, fully manageable customer managed permission that has the same IAM
+ *             permissions as the original resource-based policy. You can associate this customer managed permission to any
+ *             resource shares.</p>
+ *          <p>Before you use <a>PromoteResourceShareCreatedFromPolicy</a>, you should
+ *             first run this operation to ensure that you have an appropriate customer managed permission that can be
+ *             associated with the promoted resource share.</p>
+ *          <note>
+ *             <ul>
+ *                <li>
+ *                   <p>The original <code>CREATED_FROM_POLICY</code> policy isn't deleted, and
+ *                         resource shares using that original policy aren't automatically
+ *                         updated.</p>
+ *                </li>
+ *                <li>
+ *                   <p>You can't modify a <code>CREATED_FROM_POLICY</code> resource share so you can't
+ *                         associate the new customer managed permission by using
+ *                         <code>ReplacePermsissionAssociations</code>. However, if you use <a>PromoteResourceShareCreatedFromPolicy</a>, that operation
+ *                         automatically associates the fully manageable customer managed permission to the newly promoted
+ *                             <code>STANDARD</code> resource share.</p>
+ *                </li>
+ *                <li>
+ *                   <p>After you promote a resource share, if the original <code>CREATED_FROM_POLICY</code>
+ *                         managed permission has no other associations to A resource share, then RAM automatically deletes
+ *                         it.</p>
+ *                </li>
+ *             </ul>
+ *          </note>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { RAMClient, PromotePermissionCreatedFromPolicyCommand } from "@aws-sdk/client-ram"; // ES Modules import
+ * // const { RAMClient, PromotePermissionCreatedFromPolicyCommand } = require("@aws-sdk/client-ram"); // CommonJS import
+ * const client = new RAMClient(config);
+ * const input = { // PromotePermissionCreatedFromPolicyRequest
+ *   permissionArn: "STRING_VALUE", // required
+ *   name: "STRING_VALUE", // required
+ *   clientToken: "STRING_VALUE",
+ * };
+ * const command = new PromotePermissionCreatedFromPolicyCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @param PromotePermissionCreatedFromPolicyCommandInput - {@link PromotePermissionCreatedFromPolicyCommandInput}
+ * @returns {@link PromotePermissionCreatedFromPolicyCommandOutput}
+ * @see {@link PromotePermissionCreatedFromPolicyCommandInput} for command's `input` shape.
+ * @see {@link PromotePermissionCreatedFromPolicyCommandOutput} for command's `response` shape.
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
+ *
+ * @throws {@link MalformedArnException} (client fault)
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
+ *
+ * @throws {@link MissingRequiredParameterException} (client fault)
+ *  <p>The operation failed because a required input parameter is missing.</p>
+ *
+ * @throws {@link OperationNotPermittedException} (client fault)
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
+ *
+ * @throws {@link ServerInternalException} (server fault)
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
+ *
+ * @throws {@link UnknownResourceException} (client fault)
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
+ *
+ *
+ */
+export class PromotePermissionCreatedFromPolicyCommand extends $Command<
+  PromotePermissionCreatedFromPolicyCommandInput,
+  PromotePermissionCreatedFromPolicyCommandOutput,
+  RAMClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  /**
+   * @public
+   */
+  constructor(readonly input: PromotePermissionCreatedFromPolicyCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: RAMClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<PromotePermissionCreatedFromPolicyCommandInput, PromotePermissionCreatedFromPolicyCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, PromotePermissionCreatedFromPolicyCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "RAMClient";
+    const commandName = "PromotePermissionCreatedFromPolicyCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: (_: any) => _,
+      outputFilterSensitiveLog: (_: any) => _,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  /**
+   * @internal
+   */
+  private serialize(
+    input: PromotePermissionCreatedFromPolicyCommandInput,
+    context: __SerdeContext
+  ): Promise<__HttpRequest> {
+    return se_PromotePermissionCreatedFromPolicyCommand(input, context);
+  }
+
+  /**
+   * @internal
+   */
+  private deserialize(
+    output: __HttpResponse,
+    context: __SerdeContext
+  ): Promise<PromotePermissionCreatedFromPolicyCommandOutput> {
+    return de_PromotePermissionCreatedFromPolicyCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}
diff --git a/clients/client-ram/src/commands/PromoteResourceShareCreatedFromPolicyCommand.ts b/clients/client-ram/src/commands/PromoteResourceShareCreatedFromPolicyCommand.ts
index cf8eec064070..5cf488944d2a 100644
--- a/clients/client-ram/src/commands/PromoteResourceShareCreatedFromPolicyCommand.ts
+++ b/clients/client-ram/src/commands/PromoteResourceShareCreatedFromPolicyCommand.ts
@@ -41,12 +41,20 @@ export interface PromoteResourceShareCreatedFromPolicyCommandOutput
 
 /**
  * @public
- * <p>When you attach a resource-based permission policy to a resource, it automatically
- *             creates a resource share. However, resource shares created this way are visible only to the resource share owner, and
- *             the resource share can't be modified in RAM.</p>
- *          <p>You can use this operation to promote the resource share to a full RAM resource share. When you promote
- *             a resource share, you can then manage the resource share in RAM and it becomes visible to all of the
- *             principals you shared it with.</p>
+ * <p>When you attach a resource-based policy to a resource, RAM automatically creates
+ *             a resource share of <code>featureSet</code>=<code>CREATED_FROM_POLICY</code> with a managed permission that
+ *             has the same IAM permissions as the original resource-based policy. However, this type
+ *             of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by
+ *             using RAM.</p>
+ *          <p>This operation promotes the resource share to a <code>STANDARD</code> resource share that is fully
+ *             manageable in RAM. When you promote a resource share, you can then manage the resource share in RAM and
+ *             it becomes visible to all of the principals you shared it with.</p>
+ *          <important>
+ *             <p>Before you perform this operation, you should first run <a>PromotePermissionCreatedFromPolicy</a>to ensure that you have an
+ *                 appropriate customer managed permission that can be associated with this resource share after its is promoted. If
+ *                 this operation can't find a managed permission that exactly matches the existing
+ *                     <code>CREATED_FROM_POLICY</code> permission, then this operation fails.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -67,28 +75,40 @@ export interface PromoteResourceShareCreatedFromPolicyCommandOutput
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
+ *
+ * @throws {@link InvalidStateTransitionException} (client fault)
+ *  <p>The operation failed because the requested operation isn't valid for the resource
+ *             share in its current state.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link MissingRequiredParameterException} (client fault)
- *  <p>A required input parameter is missing.</p>
+ *  <p>The operation failed because a required input parameter is missing.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ResourceShareLimitExceededException} (client fault)
- *  <p>This request would exceed the limit for resource shares for your account.</p>
+ *  <p>The operation failed because it would exceed the limit for resource shares for your account. To
+ *             view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the Service Quotas
+ *                 console</a>.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
+ *
+ * @throws {@link UnmatchedPolicyPermissionException} (client fault)
+ *  <p>There isn't an existing managed permission defined in RAM that has the same IAM permissions as
+ *             the resource-based policy attached to the resource. You should first run <a>PromotePermissionCreatedFromPolicy</a> to create that managed permission.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/RejectResourceShareInvitationCommand.ts b/clients/client-ram/src/commands/RejectResourceShareInvitationCommand.ts
index 72f466dbcae0..bd7e36d2a4d8 100644
--- a/clients/client-ram/src/commands/RejectResourceShareInvitationCommand.ts
+++ b/clients/client-ram/src/commands/RejectResourceShareInvitationCommand.ts
@@ -59,36 +59,40 @@ export interface RejectResourceShareInvitationCommandOutput
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link IdempotentParameterMismatchException} (client fault)
- *  <p>The client token input parameter was matched one used with a previous call to the
- *             operation, but at least one of the other input parameters is different from the previous
- *             call.</p>
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
  *
  * @throws {@link InvalidClientTokenException} (client fault)
- *  <p>The client token is not valid.</p>
+ *  <p>The operation failed because the specified client token isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ResourceShareInvitationAlreadyAcceptedException} (client fault)
- *  <p>The specified invitation was already accepted.</p>
+ *  <p>The operation failed because the specified invitation was already accepted.</p>
  *
  * @throws {@link ResourceShareInvitationAlreadyRejectedException} (client fault)
- *  <p>The specified invitation was already rejected.</p>
+ *  <p>The operation failed because the specified invitation was already rejected.</p>
  *
  * @throws {@link ResourceShareInvitationArnNotFoundException} (client fault)
- *  <p>The specified Amazon Resource Name (ARN) for an invitation was not found.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> for an invitation was not
+ *             found.</p>
  *
  * @throws {@link ResourceShareInvitationExpiredException} (client fault)
- *  <p>The specified invitation is expired.</p>
+ *  <p>The operation failed because the specified invitation is past its expiration date and
+ *             time.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/ReplacePermissionAssociationsCommand.ts b/clients/client-ram/src/commands/ReplacePermissionAssociationsCommand.ts
new file mode 100644
index 000000000000..2f1dc60365ff
--- /dev/null
+++ b/clients/client-ram/src/commands/ReplacePermissionAssociationsCommand.ts
@@ -0,0 +1,185 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import { ReplacePermissionAssociationsRequest, ReplacePermissionAssociationsResponse } from "../models/models_0";
+import {
+  de_ReplacePermissionAssociationsCommand,
+  se_ReplacePermissionAssociationsCommand,
+} from "../protocols/Aws_restJson1";
+import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
+
+/**
+ * @public
+ *
+ * The input for {@link ReplacePermissionAssociationsCommand}.
+ */
+export interface ReplacePermissionAssociationsCommandInput extends ReplacePermissionAssociationsRequest {}
+/**
+ * @public
+ *
+ * The output of {@link ReplacePermissionAssociationsCommand}.
+ */
+export interface ReplacePermissionAssociationsCommandOutput
+  extends ReplacePermissionAssociationsResponse,
+    __MetadataBearer {}
+
+/**
+ * @public
+ * <p>Updates all resource shares that use a managed permission to a different managed
+ *             permission. This operation always applies the default version of the target managed
+ *             permission. You can optionally specify that the update applies to only resource shares that
+ *             currently use a specified version. This enables you to update to the latest version,
+ *             without changing the which managed permission is used.</p>
+ *          <p>You can use this operation to update all of your resource shares to use the current
+ *             default version of the permission by specifying the same value for the
+ *                 <code>fromPermissionArn</code> and <code>toPermissionArn</code> parameters.</p>
+ *          <p>You can use the optional <code>fromPermissionVersion</code> parameter to update only
+ *             those resources that use a specified version of the managed permission to the new managed
+ *             permission.</p>
+ *          <important>
+ *             <p>To successfully perform this operation, you must have permission to update the
+ *                 resource-based policy on all affected resource types.</p>
+ *          </important>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { RAMClient, ReplacePermissionAssociationsCommand } from "@aws-sdk/client-ram"; // ES Modules import
+ * // const { RAMClient, ReplacePermissionAssociationsCommand } = require("@aws-sdk/client-ram"); // CommonJS import
+ * const client = new RAMClient(config);
+ * const input = { // ReplacePermissionAssociationsRequest
+ *   fromPermissionArn: "STRING_VALUE", // required
+ *   fromPermissionVersion: Number("int"),
+ *   toPermissionArn: "STRING_VALUE", // required
+ *   clientToken: "STRING_VALUE",
+ * };
+ * const command = new ReplacePermissionAssociationsCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @param ReplacePermissionAssociationsCommandInput - {@link ReplacePermissionAssociationsCommandInput}
+ * @returns {@link ReplacePermissionAssociationsCommandOutput}
+ * @see {@link ReplacePermissionAssociationsCommandInput} for command's `input` shape.
+ * @see {@link ReplacePermissionAssociationsCommandOutput} for command's `response` shape.
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
+ *
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
+ *
+ * @throws {@link InvalidClientTokenException} (client fault)
+ *  <p>The operation failed because the specified client token isn't valid.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
+ *
+ * @throws {@link MalformedArnException} (client fault)
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
+ *
+ * @throws {@link OperationNotPermittedException} (client fault)
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
+ *
+ * @throws {@link ServerInternalException} (server fault)
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
+ *
+ * @throws {@link UnknownResourceException} (client fault)
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
+ *
+ *
+ */
+export class ReplacePermissionAssociationsCommand extends $Command<
+  ReplacePermissionAssociationsCommandInput,
+  ReplacePermissionAssociationsCommandOutput,
+  RAMClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  /**
+   * @public
+   */
+  constructor(readonly input: ReplacePermissionAssociationsCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: RAMClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<ReplacePermissionAssociationsCommandInput, ReplacePermissionAssociationsCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, ReplacePermissionAssociationsCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "RAMClient";
+    const commandName = "ReplacePermissionAssociationsCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: (_: any) => _,
+      outputFilterSensitiveLog: (_: any) => _,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  /**
+   * @internal
+   */
+  private serialize(input: ReplacePermissionAssociationsCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return se_ReplacePermissionAssociationsCommand(input, context);
+  }
+
+  /**
+   * @internal
+   */
+  private deserialize(
+    output: __HttpResponse,
+    context: __SerdeContext
+  ): Promise<ReplacePermissionAssociationsCommandOutput> {
+    return de_ReplacePermissionAssociationsCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}
diff --git a/clients/client-ram/src/commands/SetDefaultPermissionVersionCommand.ts b/clients/client-ram/src/commands/SetDefaultPermissionVersionCommand.ts
new file mode 100644
index 000000000000..7c2cec870796
--- /dev/null
+++ b/clients/client-ram/src/commands/SetDefaultPermissionVersionCommand.ts
@@ -0,0 +1,169 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import { SetDefaultPermissionVersionRequest, SetDefaultPermissionVersionResponse } from "../models/models_0";
+import {
+  de_SetDefaultPermissionVersionCommand,
+  se_SetDefaultPermissionVersionCommand,
+} from "../protocols/Aws_restJson1";
+import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
+
+/**
+ * @public
+ *
+ * The input for {@link SetDefaultPermissionVersionCommand}.
+ */
+export interface SetDefaultPermissionVersionCommandInput extends SetDefaultPermissionVersionRequest {}
+/**
+ * @public
+ *
+ * The output of {@link SetDefaultPermissionVersionCommand}.
+ */
+export interface SetDefaultPermissionVersionCommandOutput
+  extends SetDefaultPermissionVersionResponse,
+    __MetadataBearer {}
+
+/**
+ * @public
+ * <p>Designates the specified version number as the default version for the specified
+ *             customer managed permission. New resource shares automatically use this new default permission. Existing
+ *             resource shares continue to use their original permission version, but you can use <a>ReplacePermissionAssociations</a> to update them.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { RAMClient, SetDefaultPermissionVersionCommand } from "@aws-sdk/client-ram"; // ES Modules import
+ * // const { RAMClient, SetDefaultPermissionVersionCommand } = require("@aws-sdk/client-ram"); // CommonJS import
+ * const client = new RAMClient(config);
+ * const input = { // SetDefaultPermissionVersionRequest
+ *   permissionArn: "STRING_VALUE", // required
+ *   permissionVersion: Number("int"), // required
+ *   clientToken: "STRING_VALUE",
+ * };
+ * const command = new SetDefaultPermissionVersionCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @param SetDefaultPermissionVersionCommandInput - {@link SetDefaultPermissionVersionCommandInput}
+ * @returns {@link SetDefaultPermissionVersionCommandOutput}
+ * @see {@link SetDefaultPermissionVersionCommandInput} for command's `input` shape.
+ * @see {@link SetDefaultPermissionVersionCommandOutput} for command's `response` shape.
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
+ *
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
+ *
+ * @throws {@link InvalidClientTokenException} (client fault)
+ *  <p>The operation failed because the specified client token isn't valid.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
+ *
+ * @throws {@link MalformedArnException} (client fault)
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
+ *
+ * @throws {@link ServerInternalException} (server fault)
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
+ *
+ * @throws {@link UnknownResourceException} (client fault)
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
+ *
+ *
+ */
+export class SetDefaultPermissionVersionCommand extends $Command<
+  SetDefaultPermissionVersionCommandInput,
+  SetDefaultPermissionVersionCommandOutput,
+  RAMClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  /**
+   * @public
+   */
+  constructor(readonly input: SetDefaultPermissionVersionCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: RAMClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<SetDefaultPermissionVersionCommandInput, SetDefaultPermissionVersionCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, SetDefaultPermissionVersionCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "RAMClient";
+    const commandName = "SetDefaultPermissionVersionCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: (_: any) => _,
+      outputFilterSensitiveLog: (_: any) => _,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  /**
+   * @internal
+   */
+  private serialize(input: SetDefaultPermissionVersionCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return se_SetDefaultPermissionVersionCommand(input, context);
+  }
+
+  /**
+   * @internal
+   */
+  private deserialize(
+    output: __HttpResponse,
+    context: __SerdeContext
+  ): Promise<SetDefaultPermissionVersionCommandOutput> {
+    return de_SetDefaultPermissionVersionCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}
diff --git a/clients/client-ram/src/commands/TagResourceCommand.ts b/clients/client-ram/src/commands/TagResourceCommand.ts
index 191f417d0649..be94f23ec593 100644
--- a/clients/client-ram/src/commands/TagResourceCommand.ts
+++ b/clients/client-ram/src/commands/TagResourceCommand.ts
@@ -32,8 +32,9 @@ export interface TagResourceCommandOutput extends TagResourceResponse, __Metadat
 
 /**
  * @public
- * <p>Adds the specified tag keys and values to the specified resource share. The tags are attached
- *             only to the resource share, not to the resources that are in the resource share.</p>
+ * <p>Adds the specified tag keys and values to a resource share or managed permission. If you choose a resource share, the
+ *             tags are attached to only the resource share, not to the resources that are in the resource share.</p>
+ *          <p>The tags on a managed permission are the same for all versions of the managed permission.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -41,13 +42,14 @@ export interface TagResourceCommandOutput extends TagResourceResponse, __Metadat
  * // const { RAMClient, TagResourceCommand } = require("@aws-sdk/client-ram"); // CommonJS import
  * const client = new RAMClient(config);
  * const input = { // TagResourceRequest
- *   resourceShareArn: "STRING_VALUE", // required
+ *   resourceShareArn: "STRING_VALUE",
  *   tags: [ // TagList // required
  *     { // Tag
  *       key: "STRING_VALUE",
  *       value: "STRING_VALUE",
  *     },
  *   ],
+ *   resourceArn: "STRING_VALUE",
  * };
  * const command = new TagResourceCommand(input);
  * const response = await client.send(command);
@@ -60,28 +62,32 @@ export interface TagResourceCommandOutput extends TagResourceResponse, __Metadat
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link ResourceArnNotFoundException} (client fault)
- *  <p>The specified Amazon Resource Name (ARN) was not found.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> was not found.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link TagLimitExceededException} (client fault)
- *  <p>This request would exceed the limit for tags for your account.</p>
+ *  <p>The operation failed because it would exceed the limit for tags for your
+ *             Amazon Web Services account.</p>
  *
  * @throws {@link TagPolicyViolationException} (client fault)
- *  <p>The specified tag key is a reserved word and can't be used.</p>
+ *  <p>The operation failed because the specified tag key is a reserved word and can't be
+ *             used.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/UntagResourceCommand.ts b/clients/client-ram/src/commands/UntagResourceCommand.ts
index 075b6e3a0aee..6243c1e35cd7 100644
--- a/clients/client-ram/src/commands/UntagResourceCommand.ts
+++ b/clients/client-ram/src/commands/UntagResourceCommand.ts
@@ -32,7 +32,7 @@ export interface UntagResourceCommandOutput extends UntagResourceResponse, __Met
 
 /**
  * @public
- * <p>Removes the specified tag key and value pairs from the specified resource share.</p>
+ * <p>Removes the specified tag key and value pairs from the specified resource share or managed permission.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -40,10 +40,11 @@ export interface UntagResourceCommandOutput extends UntagResourceResponse, __Met
  * // const { RAMClient, UntagResourceCommand } = require("@aws-sdk/client-ram"); // CommonJS import
  * const client = new RAMClient(config);
  * const input = { // UntagResourceRequest
- *   resourceShareArn: "STRING_VALUE", // required
+ *   resourceShareArn: "STRING_VALUE",
  *   tagKeys: [ // TagKeyList // required
  *     "STRING_VALUE",
  *   ],
+ *   resourceArn: "STRING_VALUE",
  * };
  * const command = new UntagResourceCommand(input);
  * const response = await client.send(command);
@@ -56,13 +57,21 @@ export interface UntagResourceCommandOutput extends UntagResourceResponse, __Met
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
+ *
+ * @throws {@link MalformedArnException} (client fault)
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
+ *
+ * @throws {@link UnknownResourceException} (client fault)
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/UpdateResourceShareCommand.ts b/clients/client-ram/src/commands/UpdateResourceShareCommand.ts
index 836e9dda16c3..0940f6bd3f3d 100644
--- a/clients/client-ram/src/commands/UpdateResourceShareCommand.ts
+++ b/clients/client-ram/src/commands/UpdateResourceShareCommand.ts
@@ -56,33 +56,35 @@ export interface UpdateResourceShareCommandOutput extends UpdateResourceShareRes
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
  *
  * @throws {@link IdempotentParameterMismatchException} (client fault)
- *  <p>The client token input parameter was matched one used with a previous call to the
- *             operation, but at least one of the other input parameters is different from the previous
- *             call.</p>
+ *  <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
  *
  * @throws {@link InvalidClientTokenException} (client fault)
- *  <p>The client token is not valid.</p>
+ *  <p>The operation failed because the specified client token isn't valid.</p>
  *
  * @throws {@link InvalidParameterException} (client fault)
- *  <p>A parameter is not valid.</p>
+ *  <p>The operation failed because a parameter you specified isn't valid.</p>
  *
  * @throws {@link MalformedArnException} (client fault)
- *  <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ *  <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  *
  * @throws {@link MissingRequiredParameterException} (client fault)
- *  <p>A required input parameter is missing.</p>
+ *  <p>The operation failed because a required input parameter is missing.</p>
  *
  * @throws {@link OperationNotPermittedException} (client fault)
- *  <p>The requested operation is not permitted.</p>
+ *  <p>The operation failed because the requested operation isn't permitted.</p>
  *
  * @throws {@link ServerInternalException} (server fault)
- *  <p>The service could not respond to the request due to an internal problem.</p>
+ *  <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  *
  * @throws {@link ServiceUnavailableException} (server fault)
- *  <p>The service is not available.</p>
+ *  <p>The operation failed because the service isn't available. Try again later.</p>
  *
  * @throws {@link UnknownResourceException} (client fault)
- *  <p>A specified resource was not found.</p>
+ *  <p>The operation failed because a specified resource couldn't be found.</p>
  *
  *
  */
diff --git a/clients/client-ram/src/commands/index.ts b/clients/client-ram/src/commands/index.ts
index 208149a4929b..d7c42b43b9ad 100644
--- a/clients/client-ram/src/commands/index.ts
+++ b/clients/client-ram/src/commands/index.ts
@@ -2,7 +2,11 @@
 export * from "./AcceptResourceShareInvitationCommand";
 export * from "./AssociateResourceShareCommand";
 export * from "./AssociateResourceSharePermissionCommand";
+export * from "./CreatePermissionCommand";
+export * from "./CreatePermissionVersionCommand";
 export * from "./CreateResourceShareCommand";
+export * from "./DeletePermissionCommand";
+export * from "./DeletePermissionVersionCommand";
 export * from "./DeleteResourceShareCommand";
 export * from "./DisassociateResourceShareCommand";
 export * from "./DisassociateResourceSharePermissionCommand";
@@ -13,14 +17,19 @@ export * from "./GetResourceShareAssociationsCommand";
 export * from "./GetResourceShareInvitationsCommand";
 export * from "./GetResourceSharesCommand";
 export * from "./ListPendingInvitationResourcesCommand";
+export * from "./ListPermissionAssociationsCommand";
 export * from "./ListPermissionVersionsCommand";
 export * from "./ListPermissionsCommand";
 export * from "./ListPrincipalsCommand";
+export * from "./ListReplacePermissionAssociationsWorkCommand";
 export * from "./ListResourceSharePermissionsCommand";
 export * from "./ListResourceTypesCommand";
 export * from "./ListResourcesCommand";
+export * from "./PromotePermissionCreatedFromPolicyCommand";
 export * from "./PromoteResourceShareCreatedFromPolicyCommand";
 export * from "./RejectResourceShareInvitationCommand";
+export * from "./ReplacePermissionAssociationsCommand";
+export * from "./SetDefaultPermissionVersionCommand";
 export * from "./TagResourceCommand";
 export * from "./UntagResourceCommand";
 export * from "./UpdateResourceShareCommand";
diff --git a/clients/client-ram/src/endpoint/EndpointParameters.ts b/clients/client-ram/src/endpoint/EndpointParameters.ts
index 54cbf14009c2..f77db1fc7d5d 100644
--- a/clients/client-ram/src/endpoint/EndpointParameters.ts
+++ b/clients/client-ram/src/endpoint/EndpointParameters.ts
@@ -24,7 +24,7 @@ export const resolveClientEndpointParameters = <T>(
 };
 
 export interface EndpointParameters extends __EndpointParameters {
-  Region: string;
+  Region?: string;
   UseDualStack?: boolean;
   UseFIPS?: boolean;
   Endpoint?: string;
diff --git a/clients/client-ram/src/endpoint/ruleset.ts b/clients/client-ram/src/endpoint/ruleset.ts
index 0bc74e8aff68..719edf79f56c 100644
--- a/clients/client-ram/src/endpoint/ruleset.ts
+++ b/clients/client-ram/src/endpoint/ruleset.ts
@@ -6,28 +6,27 @@ import { RuleSetObject } from "@aws-sdk/util-endpoints";
    or see "smithy.rules#endpointRuleSet"
    in codegen/sdk-codegen/aws-models/ram.json */
 
-const u="fn",
-v="argv",
-w="ref";
-const a=true,
-b=false,
-c="String",
-d="PartitionResult",
-e="tree",
-f="error",
-g="endpoint",
-h="getAttr",
-i="stringEquals",
-j={"required":true,"default":false,"type":"Boolean"},
-k={[w]:"Region"},
-l={[w]:"Endpoint"},
-m={[u]:"booleanEquals",[v]:[{[w]:"UseFIPS"},true]},
-n={[u]:"booleanEquals",[v]:[{[w]:"UseDualStack"},true]},
-o={},
-p={[u]:"booleanEquals",[v]:[true,{[u]:h,[v]:[{[w]:d},"supportsFIPS"]}]},
-q={[w]:d},
-r={[u]:"booleanEquals",[v]:[true,{[u]:h,[v]:[q,"supportsDualStack"]}]},
-s=[m],
-t=[n];
-const _data={version:"1.0",parameters:{Region:{required:a,type:c},UseDualStack:j,UseFIPS:j,Endpoint:{required:b,type:c}},rules:[{conditions:[{[u]:"aws.partition",[v]:[k],assign:d}],type:e,rules:[{conditions:[{[u]:"isSet",[v]:[l]}],type:e,rules:[{conditions:s,error:"Invalid Configuration: FIPS and custom endpoint are not supported",type:f},{type:e,rules:[{conditions:t,error:"Invalid Configuration: Dualstack and custom endpoint are not supported",type:f},{endpoint:{url:l,properties:o,headers:o},type:g}]}]},{conditions:[m,n],type:e,rules:[{conditions:[p,r],type:e,rules:[{type:e,rules:[{endpoint:{url:"https://ram-fips.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:o,headers:o},type:g}]}]},{error:"FIPS and DualStack are enabled, but this partition does not support one or both",type:f}]},{conditions:s,type:e,rules:[{conditions:[p],type:e,rules:[{type:e,rules:[{conditions:[{[u]:i,[v]:["aws-us-gov",{[u]:h,[v]:[q,"name"]}]}],endpoint:{url:"https://ram.{Region}.amazonaws.com",properties:o,headers:o},type:g},{endpoint:{url:"https://ram-fips.{Region}.{PartitionResult#dnsSuffix}",properties:o,headers:o},type:g}]}]},{error:"FIPS is enabled but this partition does not support FIPS",type:f}]},{conditions:t,type:e,rules:[{conditions:[r],type:e,rules:[{type:e,rules:[{endpoint:{url:"https://ram.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:o,headers:o},type:g}]}]},{error:"DualStack is enabled but this partition does not support DualStack",type:f}]},{type:e,rules:[{conditions:[{[u]:i,[v]:[k,"us-gov-east-1"]}],endpoint:{url:"https://ram.us-gov-east-1.amazonaws.com",properties:o,headers:o},type:g},{conditions:[{[u]:i,[v]:[k,"us-gov-west-1"]}],endpoint:{url:"https://ram.us-gov-west-1.amazonaws.com",properties:o,headers:o},type:g},{endpoint:{url:"https://ram.{Region}.{PartitionResult#dnsSuffix}",properties:o,headers:o},type:g}]}]}]};
+const s="required",
+t="fn",
+u="argv",
+v="ref";
+const a="isSet",
+b="tree",
+c="error",
+d="endpoint",
+e="PartitionResult",
+f="getAttr",
+g={[s]:false,"type":"String"},
+h={[s]:true,"default":false,"type":"Boolean"},
+i={[v]:"Endpoint"},
+j={[t]:"booleanEquals",[u]:[{[v]:"UseFIPS"},true]},
+k={[t]:"booleanEquals",[u]:[{[v]:"UseDualStack"},true]},
+l={},
+m={[t]:"booleanEquals",[u]:[true,{[t]:f,[u]:[{[v]:e},"supportsFIPS"]}]},
+n={[v]:e},
+o={[t]:"booleanEquals",[u]:[true,{[t]:f,[u]:[n,"supportsDualStack"]}]},
+p=[j],
+q=[k],
+r=[{[v]:"Region"}];
+const _data={version:"1.0",parameters:{Region:g,UseDualStack:h,UseFIPS:h,Endpoint:g},rules:[{conditions:[{[t]:a,[u]:[i]}],type:b,rules:[{conditions:p,error:"Invalid Configuration: FIPS and custom endpoint are not supported",type:c},{type:b,rules:[{conditions:q,error:"Invalid Configuration: Dualstack and custom endpoint are not supported",type:c},{endpoint:{url:i,properties:l,headers:l},type:d}]}]},{type:b,rules:[{conditions:[{[t]:a,[u]:r}],type:b,rules:[{conditions:[{[t]:"aws.partition",[u]:r,assign:e}],type:b,rules:[{conditions:[j,k],type:b,rules:[{conditions:[m,o],type:b,rules:[{type:b,rules:[{endpoint:{url:"https://ram-fips.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:l,headers:l},type:d}]}]},{error:"FIPS and DualStack are enabled, but this partition does not support one or both",type:c}]},{conditions:p,type:b,rules:[{conditions:[m],type:b,rules:[{type:b,rules:[{conditions:[{[t]:"stringEquals",[u]:["aws-us-gov",{[t]:f,[u]:[n,"name"]}]}],endpoint:{url:"https://ram.{Region}.amazonaws.com",properties:l,headers:l},type:d},{endpoint:{url:"https://ram-fips.{Region}.{PartitionResult#dnsSuffix}",properties:l,headers:l},type:d}]}]},{error:"FIPS is enabled but this partition does not support FIPS",type:c}]},{conditions:q,type:b,rules:[{conditions:[o],type:b,rules:[{type:b,rules:[{endpoint:{url:"https://ram.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:l,headers:l},type:d}]}]},{error:"DualStack is enabled but this partition does not support DualStack",type:c}]},{type:b,rules:[{endpoint:{url:"https://ram.{Region}.{PartitionResult#dnsSuffix}",properties:l,headers:l},type:d}]}]}]},{error:"Invalid Configuration: Missing Region",type:c}]}]};
 export const ruleSet: RuleSetObject = _data;
diff --git a/clients/client-ram/src/models/models_0.ts b/clients/client-ram/src/models/models_0.ts
index cce7eea1e9bd..43ab8069ab78 100644
--- a/clients/client-ram/src/models/models_0.ts
+++ b/clients/client-ram/src/models/models_0.ts
@@ -8,7 +8,7 @@ import { RAMServiceException as __BaseException } from "./RAMServiceException";
  */
 export interface AcceptResourceShareInvitationRequest {
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the invitation that you want to accept.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the invitation that you want to accept.</p>
    */
   resourceShareInvitationArn: string | undefined;
 
@@ -21,6 +21,9 @@ export interface AcceptResourceShareInvitationRequest {
    *              value.</a>.</p>
    *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
    *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
    */
   clientToken?: string;
 }
@@ -60,11 +63,11 @@ export type ResourceShareAssociationStatus =
 
 /**
  * @public
- * <p>Describes an association with a resource share and either a principal or a resource.</p>
+ * <p>Describes an association between a resource share and either a principal or a resource.</p>
  */
 export interface ResourceShareAssociation {
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share.</p>
    */
   resourceShareArn?: string;
 
@@ -77,7 +80,7 @@ export interface ResourceShareAssociation {
    * <p>The associated entity. This can be either of the following:</p>
    *          <ul>
    *             <li>
-   *                <p>For a resource association, this is the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource.</p>
+   *                <p>For a resource association, this is the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource.</p>
    *             </li>
    *             <li>
    *                <p>For principal associations, this is one of the following:</p>
@@ -86,7 +89,7 @@ export interface ResourceShareAssociation {
    *                      <p>The ID of an Amazon Web Services account</p>
    *                   </li>
    *                   <li>
-   *                      <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of an organization in Organizations</p>
+   *                      <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of an organization in Organizations</p>
    *                   </li>
    *                   <li>
    *                      <p>The ARN of an organizational unit (OU) in Organizations</p>
@@ -158,7 +161,7 @@ export type ResourceShareInvitationStatus =
  */
 export interface ResourceShareInvitation {
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the invitation.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the invitation.</p>
    */
   resourceShareInvitationArn?: string;
 
@@ -168,7 +171,7 @@ export interface ResourceShareInvitation {
   resourceShareName?: string;
 
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share</p>
    */
   resourceShareArn?: string;
 
@@ -200,7 +203,7 @@ export interface ResourceShareInvitation {
   resourceShareAssociations?: ResourceShareAssociation[];
 
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the IAM user or role that received the invitation.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the IAM user or role that received the invitation.</p>
    */
   receiverArn?: string;
 }
@@ -225,9 +228,9 @@ export interface AcceptResourceShareInvitationResponse {
 
 /**
  * @public
- * <p>The client token input parameter was matched one used with a previous call to the
- *             operation, but at least one of the other input parameters is different from the previous
- *             call.</p>
+ * <p>The operation failed because the client token input parameter matched one that was
+ *             used with a previous call to the operation, but at least one of the other input
+ *             parameters is different from the previous call.</p>
  */
 export class IdempotentParameterMismatchException extends __BaseException {
   readonly name: "IdempotentParameterMismatchException" = "IdempotentParameterMismatchException";
@@ -247,7 +250,7 @@ export class IdempotentParameterMismatchException extends __BaseException {
 
 /**
  * @public
- * <p>The client token is not valid.</p>
+ * <p>The operation failed because the specified client token isn't valid.</p>
  */
 export class InvalidClientTokenException extends __BaseException {
   readonly name: "InvalidClientTokenException" = "InvalidClientTokenException";
@@ -267,7 +270,8 @@ export class InvalidClientTokenException extends __BaseException {
 
 /**
  * @public
- * <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
+ * <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
+ *             valid.</p>
  */
 export class MalformedArnException extends __BaseException {
   readonly name: "MalformedArnException" = "MalformedArnException";
@@ -287,7 +291,7 @@ export class MalformedArnException extends __BaseException {
 
 /**
  * @public
- * <p>The requested operation is not permitted.</p>
+ * <p>The operation failed because the requested operation isn't permitted.</p>
  */
 export class OperationNotPermittedException extends __BaseException {
   readonly name: "OperationNotPermittedException" = "OperationNotPermittedException";
@@ -307,7 +311,7 @@ export class OperationNotPermittedException extends __BaseException {
 
 /**
  * @public
- * <p>The specified invitation was already accepted.</p>
+ * <p>The operation failed because the specified invitation was already accepted.</p>
  */
 export class ResourceShareInvitationAlreadyAcceptedException extends __BaseException {
   readonly name: "ResourceShareInvitationAlreadyAcceptedException" = "ResourceShareInvitationAlreadyAcceptedException";
@@ -327,7 +331,7 @@ export class ResourceShareInvitationAlreadyAcceptedException extends __BaseExcep
 
 /**
  * @public
- * <p>The specified invitation was already rejected.</p>
+ * <p>The operation failed because the specified invitation was already rejected.</p>
  */
 export class ResourceShareInvitationAlreadyRejectedException extends __BaseException {
   readonly name: "ResourceShareInvitationAlreadyRejectedException" = "ResourceShareInvitationAlreadyRejectedException";
@@ -347,7 +351,8 @@ export class ResourceShareInvitationAlreadyRejectedException extends __BaseExcep
 
 /**
  * @public
- * <p>The specified Amazon Resource Name (ARN) for an invitation was not found.</p>
+ * <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> for an invitation was not
+ *             found.</p>
  */
 export class ResourceShareInvitationArnNotFoundException extends __BaseException {
   readonly name: "ResourceShareInvitationArnNotFoundException" = "ResourceShareInvitationArnNotFoundException";
@@ -367,7 +372,8 @@ export class ResourceShareInvitationArnNotFoundException extends __BaseException
 
 /**
  * @public
- * <p>The specified invitation is expired.</p>
+ * <p>The operation failed because the specified invitation is past its expiration date and
+ *             time.</p>
  */
 export class ResourceShareInvitationExpiredException extends __BaseException {
   readonly name: "ResourceShareInvitationExpiredException" = "ResourceShareInvitationExpiredException";
@@ -387,7 +393,8 @@ export class ResourceShareInvitationExpiredException extends __BaseException {
 
 /**
  * @public
- * <p>The service could not respond to the request due to an internal problem.</p>
+ * <p>The operation failed because the service could not respond to the request due to an
+ *             internal problem. Try again later.</p>
  */
 export class ServerInternalException extends __BaseException {
   readonly name: "ServerInternalException" = "ServerInternalException";
@@ -407,7 +414,7 @@ export class ServerInternalException extends __BaseException {
 
 /**
  * @public
- * <p>The service is not available.</p>
+ * <p>The operation failed because the service isn't available. Try again later.</p>
  */
 export class ServiceUnavailableException extends __BaseException {
   readonly name: "ServiceUnavailableException" = "ServiceUnavailableException";
@@ -430,7 +437,7 @@ export class ServiceUnavailableException extends __BaseException {
  */
 export interface AssociateResourceShareRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share that you want to add principals or resources
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share that you want to add principals or resources
    *             to.</p>
    */
   resourceShareArn: string | undefined;
@@ -453,7 +460,7 @@ export interface AssociateResourceShareRequest {
    *                </p>
    *             </li>
    *             <li>
-   *                <p>An <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of an organization in Organizations, for example:
+   *                <p>An <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of an organization in Organizations, for example:
    *                         <code>organizations::123456789012:organization/o-exampleorgid</code>
    *                </p>
    *             </li>
@@ -490,6 +497,9 @@ export interface AssociateResourceShareRequest {
    *              value.</a>.</p>
    *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
    *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
    */
   clientToken?: string;
 }
@@ -514,7 +524,7 @@ export interface AssociateResourceShareResponse {
 
 /**
  * @public
- * <p>A parameter is not valid.</p>
+ * <p>The operation failed because a parameter you specified isn't valid.</p>
  */
 export class InvalidParameterException extends __BaseException {
   readonly name: "InvalidParameterException" = "InvalidParameterException";
@@ -534,7 +544,8 @@ export class InvalidParameterException extends __BaseException {
 
 /**
  * @public
- * <p>The requested state transition is not valid.</p>
+ * <p>The operation failed because the requested operation isn't valid for the resource
+ *             share in its current state.</p>
  */
 export class InvalidStateTransitionException extends __BaseException {
   readonly name: "InvalidStateTransitionException" = "InvalidStateTransitionException";
@@ -554,7 +565,9 @@ export class InvalidStateTransitionException extends __BaseException {
 
 /**
  * @public
- * <p>This request would exceed the limit for resource shares for your account.</p>
+ * <p>The operation failed because it would exceed the limit for resource shares for your account. To
+ *             view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the Service Quotas
+ *                 console</a>.</p>
  */
 export class ResourceShareLimitExceededException extends __BaseException {
   readonly name: "ResourceShareLimitExceededException" = "ResourceShareLimitExceededException";
@@ -574,8 +587,8 @@ export class ResourceShareLimitExceededException extends __BaseException {
 
 /**
  * @public
- * <p>You exceeded the rate at which you are allowed to perform this operation. Please try
- *             again later.</p>
+ * <p>The operation failed because it exceeded the rate at which you are allowed to perform
+ *             this operation. Please try again later.</p>
  */
 export class ThrottlingException extends __BaseException {
   readonly name: "ThrottlingException" = "ThrottlingException";
@@ -595,7 +608,7 @@ export class ThrottlingException extends __BaseException {
 
 /**
  * @public
- * <p>A specified resource was not found.</p>
+ * <p>The operation failed because a specified resource couldn't be found.</p>
  */
 export class UnknownResourceException extends __BaseException {
   readonly name: "UnknownResourceException" = "UnknownResourceException";
@@ -618,23 +631,23 @@ export class UnknownResourceException extends __BaseException {
  */
 export interface AssociateResourceSharePermissionRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share to which you want to add or replace
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share to which you want to add or replace
    *             permissions.</p>
    */
   resourceShareArn: string | undefined;
 
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the RAM permission to associate with the resource share.
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the RAM permission to associate with the resource share.
    *             To find the ARN for a permission, use either the <a>ListPermissions</a> operation or go to the <a href="https://console.aws.amazon.com/ram/home#Permissions:">Permissions library</a> page in the RAM console and
    *              then choose the name of the permission. The ARN is displayed on the detail page.</p>
    */
   permissionArn: string | undefined;
 
   /**
-   * <p>Specifies whether the specified permission should replace or add to the existing
-   *             permission associated with the resource share. Use <code>true</code> to replace the current
-   *             permissions. Use <code>false</code> to add the permission to the current permission. The
-   *             default value is <code>false</code>.</p>
+   * <p>Specifies whether the specified permission should replace the existing permission
+   *             associated with the resource share. Use <code>true</code> to replace the current permissions. Use
+   *                 <code>false</code> to add the permission to a resource share that currently doesn't
+   *             have a permission. The default value is <code>false</code>.</p>
    *          <note>
    *             <p>A resource share can have only one permission per resource type. If a resource share already has a
    *                 permission for the specified resource type and you don't set <code>replace</code> to
@@ -653,27 +666,614 @@ export interface AssociateResourceSharePermissionRequest {
    *              value.</a>.</p>
    *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
    *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
    */
   clientToken?: string;
 
   /**
-   * <p>Specifies the version of the RAM permission to associate with the resource share. If you don't
-   *             specify this parameter, the operation uses the version designated as the default. You
-   *             can use the <a>ListPermissionVersions</a> operation to discover the available
-   *             versions of a permission.</p>
+   * <p>Specifies the version of the RAM permission to associate with the resource share. You can
+   *             specify <i>only</i> the version that is currently set as the default
+   *             version for the permission. If you also set the <code>replace</code> pararameter to
+   *                 <code>true</code>, then this operation updates an outdated version of the permission
+   *             to the current default version.</p>
+   *          <note>
+   *             <p>You don't need to specify this parameter because the default behavior is to use
+   *                 the version that is currently set as the default version for the permission. This
+   *                 parameter is supported for backwards compatibility.</p>
+   *          </note>
+   */
+  permissionVersion?: number;
+}
+
+/**
+ * @public
+ */
+export interface AssociateResourceSharePermissionResponse {
+  /**
+   * <p>A return value of <code>true</code> indicates that the request succeeded.
+   *              A value of <code>false</code> indicates that the request failed.</p>
+   */
+  returnValue?: boolean;
+
+  /**
+   * <p>The idempotency identifier associated with this request. If you
+   *              want to repeat the same operation in an idempotent manner then you must include this
+   *              value in the <code>clientToken</code> request parameter of that later call. All other
+   *              parameters must also have the same values that you used in the first call.</p>
+   */
+  clientToken?: string;
+}
+
+/**
+ * @public
+ * <p>A structure containing a tag. A tag is metadata that you can attach to your resources
+ *             to help organize and categorize them. You can also use them to help you secure your
+ *             resources. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">Controlling access to Amazon Web Services resources
+ *                 using tags</a>.</p>
+ *          <p>For more information about tags, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services resources</a> in the
+ *                 <i>Amazon Web Services General Reference Guide</i>.</p>
+ */
+export interface Tag {
+  /**
+   * <p>The key, or name, attached to the tag. Every tag must have a key. Key names are case
+   *             sensitive.</p>
+   */
+  key?: string;
+
+  /**
+   * <p>The string value attached to the tag. The value can be an empty string. Key values are
+   *             case sensitive.</p>
+   */
+  value?: string;
+}
+
+/**
+ * @public
+ */
+export interface CreatePermissionRequest {
+  /**
+   * <p>Specifies the name of the customer managed permission. The name must be unique within the
+   *             Amazon Web Services Region.</p>
+   */
+  name: string | undefined;
+
+  /**
+   * <p>Specifies the name of the resource type that this customer managed permission applies to.</p>
+   *          <p>The format is
+   *                     <code>
+   *                <i><service-code></i>:<i><resource-type></i>
+   *             </code>
+   *             and is not case sensitive. For example, to specify an Amazon EC2 Subnet, you can use the
+   *             string <code>ec2:subnet</code>. To see the list of valid values for this parameter,
+   *             query the <a>ListResourceTypes</a> operation.</p>
+   */
+  resourceType: string | undefined;
+
+  /**
+   * <p>A string in JSON format string that contains the following elements of a
+   *             resource-based policy:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <b>Effect</b>: must be set to
+   *                     <code>ALLOW</code>.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>Action</b>: specifies the actions that are
+   *                     allowed by this customer managed permission. The list must contain only actions that are supported by
+   *                     the specified resource type. For a list of all actions supported by each
+   *                     resource type, see <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html">Actions, resources, and condition keys for Amazon Web Services services</a> in the
+   *                         <i>Identity and Access Management User Guide</i>.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>Condition</b>: (optional) specifies conditional
+   *                     parameters that must evaluate to true when a user attempts an action for that
+   *                     action to be allowed. For more information about the Condition element, see
+   *                     <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html">IAM
+   *                         policies: Condition element</a> in the <i>Identity and Access Management User
+   *                     Guide</i>.</p>
+   *             </li>
+   *          </ul>
+   *          <p>This template can't include either the <code>Resource</code> or
+   *             <code>Principal</code> elements. Those are both filled in by RAM when it instantiates
+   *             the resource-based policy on each resource shared using this managed permission. The
+   *             <code>Resource</code> comes from the ARN of the specific resource that you are sharing.
+   *             The <code>Principal</code> comes from the list of identities added to the resource
+   *             share.</p>
+   */
+  policyTemplate: string | undefined;
+
+  /**
+   * <p>Specifies a unique, case-sensitive identifier that you provide to
+   *              ensure the idempotency of the request. This lets you safely retry the request without
+   *              accidentally performing the same operation a second time. Passing the same value to a
+   *              later call to an operation requires that you also pass the same value for all other
+   *              parameters. We recommend that you use a <a href="https://wikipedia.org/wiki/Universally_unique_identifier">UUID type of
+   *              value.</a>.</p>
+   *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
+   *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
+   */
+  clientToken?: string;
+
+  /**
+   * <p>Specifies a list of one or more tag key and value pairs to attach to the
+   *             permission.</p>
+   */
+  tags?: Tag[];
+}
+
+/**
+ * @public
+ * @enum
+ */
+export const PermissionFeatureSet = {
+  CREATED_FROM_POLICY: "CREATED_FROM_POLICY",
+  PROMOTING_TO_STANDARD: "PROMOTING_TO_STANDARD",
+  STANDARD: "STANDARD",
+} as const;
+
+/**
+ * @public
+ */
+export type PermissionFeatureSet = (typeof PermissionFeatureSet)[keyof typeof PermissionFeatureSet];
+
+/**
+ * @public
+ * @enum
+ */
+export const PermissionType = {
+  AWS_MANAGED: "AWS_MANAGED",
+  CUSTOMER_MANAGED: "CUSTOMER_MANAGED",
+} as const;
+
+/**
+ * @public
+ */
+export type PermissionType = (typeof PermissionType)[keyof typeof PermissionType];
+
+/**
+ * @public
+ * <p>Information about an RAM permission.</p>
+ */
+export interface ResourceSharePermissionSummary {
+  /**
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the permission you want information about.</p>
+   */
+  arn?: string;
+
+  /**
+   * <p>The version of the permission associated with this resource share.</p>
+   */
+  version?: string;
+
+  /**
+   * <p>Specifies whether the version of the managed permission used by this resource share is the default version for
+   *             this managed permission.</p>
+   */
+  defaultVersion?: boolean;
+
+  /**
+   * <p>The name of this managed permission.</p>
+   */
+  name?: string;
+
+  /**
+   * <p>The type of resource to which this permission applies. This takes the form of:
+   *                 <code>service-code</code>:<code>resource-code</code>, and is case-insensitive. For
+   *             example, an Amazon EC2 Subnet would be represented by the string
+   *             <code>ec2:subnet</code>.</p>
+   */
+  resourceType?: string;
+
+  /**
+   * <p>The current status of the permission.</p>
+   */
+  status?: string;
+
+  /**
+   * <p>The date and time when the permission was created.</p>
+   */
+  creationTime?: Date;
+
+  /**
+   * <p>The date and time when the permission was last updated.</p>
+   */
+  lastUpdatedTime?: Date;
+
+  /**
+   * <p>Specifies whether the managed permission associated with this resource share is the default managed permission for all
+   *             resources of this resource type.</p>
+   */
+  isResourceTypeDefault?: boolean;
+
+  /**
+   * <p>The type of managed permission. This can be one of the following values:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>AWS_MANAGED</code> – Amazon Web Services created and manages this
+   *                     managed permission. You can associate it with your resource shares, but you can't modify it.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>CUSTOMER_MANAGED</code> – You, or another principal in
+   *                     your account created this managed permission. You can associate it with your resource shares and create
+   *                     new versions that have different permissions.</p>
+   *             </li>
+   *          </ul>
+   */
+  permissionType?: PermissionType | string;
+
+  /**
+   * <p>Indicates what features are available for this resource share. This parameter can have one of
+   *             the following values:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <b>STANDARD</b> – A resource share that supports all
+   *                     functionality. These resource shares are visible to all principals you share the resource share with.
+   *                     You can modify these resource shares in RAM using the console or APIs. This resource share might
+   *                     have been created by RAM, or it might have been <b>CREATED_FROM_POLICY</b> and then promoted.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>CREATED_FROM_POLICY</b> – The customer
+   *                     manually shared a resource by attaching a resource-based policy. That policy did
+   *                     not match any existing managed permissions, so RAM created this customer managed permission automatically on the
+   *                     customer's behalf based on the attached policy document. This type of resource share
+   *                     is visible only to the Amazon Web Services account that created it. You can't modify it in
+   *                     RAM unless you promote it. For more information,
+   *                     see <a>PromoteResourceShareCreatedFromPolicy</a>.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>PROMOTING_TO_STANDARD</b> – This
+   *                     resource share was originally <code>CREATED_FROM_POLICY</code>, but the customer ran
+   *                     the <a>PromoteResourceShareCreatedFromPolicy</a> and that operation
+   *                     is still in progress. This value changes to <code>STANDARD</code> when
+   *                     complete.</p>
+   *             </li>
+   *          </ul>
+   */
+  featureSet?: PermissionFeatureSet | string;
+
+  /**
+   * <p>A list of the tag key value pairs currently attached to the permission.</p>
+   */
+  tags?: Tag[];
+}
+
+/**
+ * @public
+ */
+export interface CreatePermissionResponse {
+  /**
+   * <p>A structure with information about this customer managed permission.</p>
+   */
+  permission?: ResourceSharePermissionSummary;
+
+  /**
+   * <p>The idempotency identifier associated with this request. If you
+   *              want to repeat the same operation in an idempotent manner then you must include this
+   *              value in the <code>clientToken</code> request parameter of that later call. All other
+   *              parameters must also have the same values that you used in the first call.</p>
+   */
+  clientToken?: string;
+}
+
+/**
+ * @public
+ * <p>The operation failed because a policy you specified isn't valid.</p>
+ */
+export class InvalidPolicyException extends __BaseException {
+  readonly name: "InvalidPolicyException" = "InvalidPolicyException";
+  readonly $fault: "client" = "client";
+  /**
+   * @internal
+   */
+  constructor(opts: __ExceptionOptionType<InvalidPolicyException, __BaseException>) {
+    super({
+      name: "InvalidPolicyException",
+      $fault: "client",
+      ...opts,
+    });
+    Object.setPrototypeOf(this, InvalidPolicyException.prototype);
+  }
+}
+
+/**
+ * @public
+ * <p>The operation failed because the policy template that you provided isn't valid.</p>
+ */
+export class MalformedPolicyTemplateException extends __BaseException {
+  readonly name: "MalformedPolicyTemplateException" = "MalformedPolicyTemplateException";
+  readonly $fault: "client" = "client";
+  /**
+   * @internal
+   */
+  constructor(opts: __ExceptionOptionType<MalformedPolicyTemplateException, __BaseException>) {
+    super({
+      name: "MalformedPolicyTemplateException",
+      $fault: "client",
+      ...opts,
+    });
+    Object.setPrototypeOf(this, MalformedPolicyTemplateException.prototype);
+  }
+}
+
+/**
+ * @public
+ * <p>The operation failed because a permission with the specified name already exists in
+ *             the requested Amazon Web Services Region. Choose a different name.</p>
+ */
+export class PermissionAlreadyExistsException extends __BaseException {
+  readonly name: "PermissionAlreadyExistsException" = "PermissionAlreadyExistsException";
+  readonly $fault: "client" = "client";
+  /**
+   * @internal
+   */
+  constructor(opts: __ExceptionOptionType<PermissionAlreadyExistsException, __BaseException>) {
+    super({
+      name: "PermissionAlreadyExistsException",
+      $fault: "client",
+      ...opts,
+    });
+    Object.setPrototypeOf(this, PermissionAlreadyExistsException.prototype);
+  }
+}
+
+/**
+ * @public
+ * <p>The operation failed because it would exceed the maximum number of permissions you can
+ *             create in each Amazon Web Services Region. To view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the
+ *                 Service Quotas console</a>.</p>
+ */
+export class PermissionLimitExceededException extends __BaseException {
+  readonly name: "PermissionLimitExceededException" = "PermissionLimitExceededException";
+  readonly $fault: "client" = "client";
+  /**
+   * @internal
+   */
+  constructor(opts: __ExceptionOptionType<PermissionLimitExceededException, __BaseException>) {
+    super({
+      name: "PermissionLimitExceededException",
+      $fault: "client",
+      ...opts,
+    });
+    Object.setPrototypeOf(this, PermissionLimitExceededException.prototype);
+  }
+}
+
+/**
+ * @public
+ */
+export interface CreatePermissionVersionRequest {
+  /**
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the customer managed permission you're creating a new version for.</p>
+   */
+  permissionArn: string | undefined;
+
+  /**
+   * <p>A string in JSON format string that contains the following elements of a
+   *             resource-based policy:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <b>Effect</b>: must be set to
+   *                     <code>ALLOW</code>.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>Action</b>: specifies the actions that are
+   *                     allowed by this customer managed permission. The list must contain only actions that are supported by
+   *                     the specified resource type. For a list of all actions supported by each
+   *                     resource type, see <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html">Actions, resources, and condition keys for Amazon Web Services services</a> in the
+   *                         <i>Identity and Access Management User Guide</i>.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>Condition</b>: (optional) specifies conditional
+   *                     parameters that must evaluate to true when a user attempts an action for that
+   *                     action to be allowed. For more information about the Condition element, see
+   *                     <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html">IAM
+   *                         policies: Condition element</a> in the <i>Identity and Access Management User
+   *                     Guide</i>.</p>
+   *             </li>
+   *          </ul>
+   *          <p>This template can't include either the <code>Resource</code> or
+   *             <code>Principal</code> elements. Those are both filled in by RAM when it instantiates
+   *             the resource-based policy on each resource shared using this managed permission. The
+   *             <code>Resource</code> comes from the ARN of the specific resource that you are sharing.
+   *             The <code>Principal</code> comes from the list of identities added to the resource
+   *             share.</p>
+   */
+  policyTemplate: string | undefined;
+
+  /**
+   * <p>Specifies a unique, case-sensitive identifier that you provide to
+   *              ensure the idempotency of the request. This lets you safely retry the request without
+   *              accidentally performing the same operation a second time. Passing the same value to a
+   *              later call to an operation requires that you also pass the same value for all other
+   *              parameters. We recommend that you use a <a href="https://wikipedia.org/wiki/Universally_unique_identifier">UUID type of
+   *              value.</a>.</p>
+   *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
+   *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
+   */
+  clientToken?: string;
+}
+
+/**
+ * @public
+ * @enum
+ */
+export const PermissionStatus = {
+  ATTACHABLE: "ATTACHABLE",
+  DELETED: "DELETED",
+  DELETING: "DELETING",
+  UNATTACHABLE: "UNATTACHABLE",
+} as const;
+
+/**
+ * @public
+ */
+export type PermissionStatus = (typeof PermissionStatus)[keyof typeof PermissionStatus];
+
+/**
+ * @public
+ * <p>Information about a RAM managed permission.</p>
+ */
+export interface ResourceSharePermissionDetail {
+  /**
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of this RAM managed permission.</p>
+   */
+  arn?: string;
+
+  /**
+   * <p>The version of the permission described in this response.</p>
+   */
+  version?: string;
+
+  /**
+   * <p>Specifies whether the version of the permission represented in this response is the
+   *             default version for this permission.</p>
+   */
+  defaultVersion?: boolean;
+
+  /**
+   * <p>The name of this permission.</p>
    */
-  permissionVersion?: number;
+  name?: string;
+
+  /**
+   * <p>The resource type to which this permission applies.</p>
+   */
+  resourceType?: string;
+
+  /**
+   * <p>The permission's effect and actions in JSON format. The <code>effect</code> indicates
+   *             whether the specified actions are allowed or denied. The <code>actions</code> list the
+   *             operations to which the principal is granted or denied access.</p>
+   */
+  permission?: string;
+
+  /**
+   * <p>The date and time when the permission was created.</p>
+   */
+  creationTime?: Date;
+
+  /**
+   * <p>The date and time when the permission was last updated.</p>
+   */
+  lastUpdatedTime?: Date;
+
+  /**
+   * <p>Specifies whether the version of the permission represented in this response is the
+   *             default version for all resources of this resource type.</p>
+   */
+  isResourceTypeDefault?: boolean;
+
+  /**
+   * <p>The type of managed permission. This can be one of the following values:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>AWS_MANAGED</code> – Amazon Web Services created and manages this
+   *                     managed permission. You can associate it with your resource shares, but you can't modify it.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>CUSTOMER_MANAGED</code> – You, or another principal in
+   *                     your account created this managed permission. You can associate it with your resource shares and create
+   *                     new versions that have different permissions.</p>
+   *             </li>
+   *          </ul>
+   */
+  permissionType?: PermissionType | string;
+
+  /**
+   * <p>Indicates what features are available for this resource share. This parameter can have one of
+   *             the following values:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <b>STANDARD</b> – A resource share that supports all
+   *                     functionality. These resource shares are visible to all principals you share the resource share with.
+   *                     You can modify these resource shares in RAM using the console or APIs. This resource share might
+   *                     have been created by RAM, or it might have been <b>CREATED_FROM_POLICY</b> and then promoted.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>CREATED_FROM_POLICY</b> – The customer
+   *                     manually shared a resource by attaching a resource-based policy. That policy did
+   *                     not match any existing managed permissions, so RAM created this customer managed permission automatically on the
+   *                     customer's behalf based on the attached policy document. This type of resource share
+   *                     is visible only to the Amazon Web Services account that created it. You can't modify it in
+   *                     RAM unless you promote it. For more information,
+   *                     see <a>PromoteResourceShareCreatedFromPolicy</a>.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>PROMOTING_TO_STANDARD</b> – This
+   *                     resource share was originally <code>CREATED_FROM_POLICY</code>, but the customer ran
+   *                     the <a>PromoteResourceShareCreatedFromPolicy</a> and that operation
+   *                     is still in progress. This value changes to <code>STANDARD</code> when
+   *                     complete.</p>
+   *             </li>
+   *          </ul>
+   */
+  featureSet?: PermissionFeatureSet | string;
+
+  /**
+   * <p>The current status of the association between the permission and the resource share.
+   *             The following are the possible values:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>ATTACHABLE</code> – This permission or version can be associated
+   *                 with resource shares.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>UNATTACHABLE</code> – This permission or version can't
+   *                 currently be associated with resource shares.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>DELETING</code> – This permission or version is in the process of
+   *                     being deleted.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>DELETED</code> – This permission or version is deleted.</p>
+   *             </li>
+   *          </ul>
+   */
+  status?: PermissionStatus | string;
+
+  /**
+   * <p>The tag key and value pairs attached to the resource share.</p>
+   */
+  tags?: Tag[];
 }
 
 /**
  * @public
  */
-export interface AssociateResourceSharePermissionResponse {
+export interface CreatePermissionVersionResponse {
   /**
-   * <p>A return value of <code>true</code> indicates that the request succeeded.
-   *              A value of <code>false</code> indicates that the request failed.</p>
+   * <p>Information about a RAM managed permission.</p>
    */
-  returnValue?: boolean;
+  permission?: ResourceSharePermissionDetail;
 
   /**
    * <p>The idempotency identifier associated with this request. If you
@@ -686,25 +1286,24 @@ export interface AssociateResourceSharePermissionResponse {
 
 /**
  * @public
- * <p>A structure containing a tag. A tag is metadata that you can attach to your resources
- *             to help organize and categorize them. You can also use them to help you secure your
- *             resources. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">Controlling access to Amazon Web Services resources
- *                 using tags</a>.</p>
- *          <p>For more information about tags, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services resources</a> in the
- *                 <i>Amazon Web Services General Reference Guide</i>.</p>
+ * <p>The operation failed because it would exceed the limit for the number of versions you
+ *             can have for a permission. To view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the
+ *                 Service Quotas console</a>.</p>
  */
-export interface Tag {
-  /**
-   * <p>The key, or name, attached to the tag. Every tag must have a key. Key names are case
-   *             sensitive.</p>
-   */
-  key?: string;
-
+export class PermissionVersionsLimitExceededException extends __BaseException {
+  readonly name: "PermissionVersionsLimitExceededException" = "PermissionVersionsLimitExceededException";
+  readonly $fault: "client" = "client";
   /**
-   * <p>The string value attached to the tag. The value can be an empty string. Key values are
-   *             case sensitive.</p>
+   * @internal
    */
-  value?: string;
+  constructor(opts: __ExceptionOptionType<PermissionVersionsLimitExceededException, __BaseException>) {
+    super({
+      name: "PermissionVersionsLimitExceededException",
+      $fault: "client",
+      ...opts,
+    });
+    Object.setPrototypeOf(this, PermissionVersionsLimitExceededException.prototype);
+  }
 }
 
 /**
@@ -731,7 +1330,7 @@ export interface CreateResourceShareRequest {
    *                </p>
    *             </li>
    *             <li>
-   *                <p>An <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of an organization in Organizations, for example:
+   *                <p>An <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of an organization in Organizations, for example:
    *                         <code>organizations::123456789012:organization/o-exampleorgid</code>
    *                </p>
    *             </li>
@@ -783,6 +1382,9 @@ export interface CreateResourceShareRequest {
    *              value.</a>.</p>
    *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
    *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
    */
   clientToken?: string;
 
@@ -833,7 +1435,7 @@ export type ResourceShareStatus = (typeof ResourceShareStatus)[keyof typeof Reso
  */
 export interface ResourceShare {
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share</p>
    */
   resourceShareArn?: string;
 
@@ -850,6 +1452,19 @@ export interface ResourceShare {
   /**
    * <p>Indicates whether principals outside your organization in Organizations can be associated
    *             with a resource share.</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>True</code> – the resource share can be shared with any
+   *                     Amazon Web Services account.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>False</code> – the resource share can be shared with only
+   *                     accounts in the same organization as the account that owns the resource
+   *                     share.</p>
+   *             </li>
+   *          </ul>
    */
   allowExternalPrincipals?: boolean;
 
@@ -879,25 +1494,33 @@ export interface ResourceShare {
   lastUpdatedTime?: Date;
 
   /**
-   * <p>Indicates how the resource share was created. Possible values include:</p>
+   * <p>Indicates what features are available for this resource share. This parameter can have one of
+   *             the following values:</p>
    *          <ul>
    *             <li>
    *                <p>
-   *                   <code>CREATED_FROM_POLICY</code> - Indicates that the resource share was created from an
-   *                     Identity and Access Management (IAM) resource-based permission policy attached to the resource.
-   *                     This type of resource share is visible only to the Amazon Web Services account that created it. You
-   *                     can't modify it in RAM unless you promote it. For more information, see <a>PromoteResourceShareCreatedFromPolicy</a>.</p>
+   *                   <b>STANDARD</b> – A resource share that supports all
+   *                     functionality. These resource shares are visible to all principals you share the resource share with.
+   *                     You can modify these resource shares in RAM using the console or APIs. This resource share might
+   *                     have been created by RAM, or it might have been <b>CREATED_FROM_POLICY</b> and then promoted.</p>
    *             </li>
    *             <li>
    *                <p>
-   *                   <code>PROMOTING_TO_STANDARD</code> - The resource share is in the process of being
-   *                     promoted. For more information, see <a>PromoteResourceShareCreatedFromPolicy</a>.</p>
+   *                   <b>CREATED_FROM_POLICY</b> – The customer
+   *                     manually shared a resource by attaching a resource-based policy. That policy did
+   *                     not match any existing managed permissions, so RAM created this customer managed permission automatically on the
+   *                     customer's behalf based on the attached policy document. This type of resource share
+   *                     is visible only to the Amazon Web Services account that created it. You can't modify it in
+   *                     RAM unless you promote it. For more information,
+   *                     see <a>PromoteResourceShareCreatedFromPolicy</a>.</p>
    *             </li>
    *             <li>
    *                <p>
-   *                   <code>STANDARD</code> - Indicates that the resource share was created in RAM using the
-   *                     console or APIs. These resource shares are visible to all principals you share the resource share
-   *                     with. You can modify these resource shares in RAM using the console or APIs.</p>
+   *                   <b>PROMOTING_TO_STANDARD</b> – This
+   *                     resource share was originally <code>CREATED_FROM_POLICY</code>, but the customer ran
+   *                     the <a>PromoteResourceShareCreatedFromPolicy</a> and that operation
+   *                     is still in progress. This value changes to <code>STANDARD</code> when
+   *                     complete.</p>
    *             </li>
    *          </ul>
    */
@@ -924,7 +1547,8 @@ export interface CreateResourceShareResponse {
 
 /**
  * @public
- * <p>The specified tag key is a reserved word and can't be used.</p>
+ * <p>The operation failed because the specified tag key is a reserved word and can't be
+ *             used.</p>
  */
 export class TagPolicyViolationException extends __BaseException {
   readonly name: "TagPolicyViolationException" = "TagPolicyViolationException";
@@ -942,12 +1566,122 @@ export class TagPolicyViolationException extends __BaseException {
   }
 }
 
+/**
+ * @public
+ */
+export interface DeletePermissionRequest {
+  /**
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the customer managed permission that you want to delete.</p>
+   */
+  permissionArn: string | undefined;
+
+  /**
+   * <p>Specifies a unique, case-sensitive identifier that you provide to
+   *              ensure the idempotency of the request. This lets you safely retry the request without
+   *              accidentally performing the same operation a second time. Passing the same value to a
+   *              later call to an operation requires that you also pass the same value for all other
+   *              parameters. We recommend that you use a <a href="https://wikipedia.org/wiki/Universally_unique_identifier">UUID type of
+   *              value.</a>.</p>
+   *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
+   *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
+   */
+  clientToken?: string;
+}
+
+/**
+ * @public
+ */
+export interface DeletePermissionResponse {
+  /**
+   * <p>A boolean that indicates whether the delete operations succeeded.</p>
+   */
+  returnValue?: boolean;
+
+  /**
+   * <p>The idempotency identifier associated with this request. If you
+   *              want to repeat the same operation in an idempotent manner then you must include this
+   *              value in the <code>clientToken</code> request parameter of that later call. All other
+   *              parameters must also have the same values that you used in the first call.</p>
+   */
+  clientToken?: string;
+
+  /**
+   * <p>This operation is performed asynchronously, and this response parameter indicates the
+   *             current status.</p>
+   */
+  permissionStatus?: PermissionStatus | string;
+}
+
+/**
+ * @public
+ */
+export interface DeletePermissionVersionRequest {
+  /**
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the permission with the version you want to delete.</p>
+   */
+  permissionArn: string | undefined;
+
+  /**
+   * <p>Specifies the version number to delete.</p>
+   *          <p>You can't delete the default version for a customer managed permission.</p>
+   *          <p>You can't delete a version if it's the only version of the permission. You must either
+   *             first create another version, or delete the permission completely.</p>
+   *          <p>You can't delete a version if it is attached to any resource shares. If the version is
+   *             the default, you must first use <a>SetDefaultPermissionVersion</a> to set a
+   *             different version as the default for the customer managed permission, and then use <a>AssociateResourceSharePermission</a> to update your resource shares to use
+   *             the new default version.</p>
+   */
+  permissionVersion: number | undefined;
+
+  /**
+   * <p>Specifies a unique, case-sensitive identifier that you provide to
+   *              ensure the idempotency of the request. This lets you safely retry the request without
+   *              accidentally performing the same operation a second time. Passing the same value to a
+   *              later call to an operation requires that you also pass the same value for all other
+   *              parameters. We recommend that you use a <a href="https://wikipedia.org/wiki/Universally_unique_identifier">UUID type of
+   *              value.</a>.</p>
+   *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
+   *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
+   */
+  clientToken?: string;
+}
+
+/**
+ * @public
+ */
+export interface DeletePermissionVersionResponse {
+  /**
+   * <p>A boolean value that indicates whether the operation is successful.</p>
+   */
+  returnValue?: boolean;
+
+  /**
+   * <p>The idempotency identifier associated with this request. If you
+   *              want to repeat the same operation in an idempotent manner then you must include this
+   *              value in the <code>clientToken</code> request parameter of that later call. All other
+   *              parameters must also have the same values that you used in the first call.</p>
+   */
+  clientToken?: string;
+
+  /**
+   * <p>This operation is performed asynchronously, and this response parameter indicates the
+   *             current status.</p>
+   */
+  permissionStatus?: PermissionStatus | string;
+}
+
 /**
  * @public
  */
 export interface DeleteResourceShareRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share to delete.</p>
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share to delete.</p>
    */
   resourceShareArn: string | undefined;
 
@@ -960,6 +1694,9 @@ export interface DeleteResourceShareRequest {
    *              value.</a>.</p>
    *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
    *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
    */
   clientToken?: string;
 }
@@ -988,14 +1725,15 @@ export interface DeleteResourceShareResponse {
  */
 export interface DisassociateResourceShareRequest {
   /**
-   * <p>Specifies <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share that you want to remove resources from.</p>
+   * <p>Specifies <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share that you want to remove resources or principals
+   *             from.</p>
    */
   resourceShareArn: string | undefined;
 
   /**
    * <p>Specifies a list of <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Names (ARNs)</a> for one or more resources that you want to remove from
    *             the resource share. After the operation runs, these resources are no longer shared with principals
-   *             outside of the Amazon Web Services account that created the resources.</p>
+   *             associated with the resource share.</p>
    */
   resourceArns?: string[];
 
@@ -1009,7 +1747,7 @@ export interface DisassociateResourceShareRequest {
    *                </p>
    *             </li>
    *             <li>
-   *                <p>An <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of an organization in Organizations, for example:
+   *                <p>An <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of an organization in Organizations, for example:
    *                         <code>organizations::123456789012:organization/o-exampleorgid</code>
    *                </p>
    *             </li>
@@ -1046,6 +1784,9 @@ export interface DisassociateResourceShareRequest {
    *              value.</a>.</p>
    *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
    *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
    */
   clientToken?: string;
 }
@@ -1055,7 +1796,7 @@ export interface DisassociateResourceShareRequest {
  */
 export interface DisassociateResourceShareResponse {
   /**
-   * <p>An array of objects that contain information about the updated associations for this
+   * <p>An array of objects with information about the updated associations for this
    *             resource share.</p>
    */
   resourceShareAssociations?: ResourceShareAssociation[];
@@ -1074,13 +1815,13 @@ export interface DisassociateResourceShareResponse {
  */
 export interface DisassociateResourceSharePermissionRequest {
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share from which you want to disassociate a permission.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share that you want to remove the managed permission from.</p>
    */
   resourceShareArn: string | undefined;
 
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the permission to disassociate from the resource share. Changes to permissions
-   *             take effect immediately.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the managed permission to disassociate from the resource share. Changes to permissions take
+   *             effect immediately.</p>
    */
   permissionArn: string | undefined;
 
@@ -1093,6 +1834,9 @@ export interface DisassociateResourceSharePermissionRequest {
    *              value.</a>.</p>
    *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
    *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
    */
   clientToken?: string;
 }
@@ -1121,88 +1865,34 @@ export interface DisassociateResourceSharePermissionResponse {
  */
 export interface EnableSharingWithAwsOrganizationRequest {}
 
-/**
- * @public
- */
-export interface EnableSharingWithAwsOrganizationResponse {
-  /**
-   * <p>A return value of <code>true</code> indicates that the request succeeded.
-   *              A value of <code>false</code> indicates that the request failed.</p>
-   */
-  returnValue?: boolean;
-}
-
-/**
- * @public
- */
-export interface GetPermissionRequest {
-  /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the permission whose contents you want to retrieve.
-   *             To find the ARN for a permission, use either the <a>ListPermissions</a> operation or go to the <a href="https://console.aws.amazon.com/ram/home#Permissions:">Permissions library</a> page in the RAM console and
-   *              then choose the name of the permission. The ARN is displayed on the detail page.</p>
-   */
-  permissionArn: string | undefined;
-
-  /**
-   * <p>Specifies identifier for the version of the RAM permission to retrieve. If you don't
-   *             specify this parameter, the operation retrieves the default version.</p>
-   */
-  permissionVersion?: number;
-}
-
-/**
- * @public
- * <p>Information about an RAM permission.</p>
- */
-export interface ResourceSharePermissionDetail {
-  /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of this RAM permission.</p>
-   */
-  arn?: string;
-
-  /**
-   * <p>The version of the permission represented in this structure.</p>
-   */
-  version?: string;
-
-  /**
-   * <p>Specifies whether the version of the permission represented in this structure is the
-   *             default version for this permission.</p>
-   */
-  defaultVersion?: boolean;
-
-  /**
-   * <p>The name of this permission.</p>
-   */
-  name?: string;
-
-  /**
-   * <p>The resource type to which this permission applies.</p>
-   */
-  resourceType?: string;
-
-  /**
-   * <p>The permission's effect and actions in JSON format. The <code>effect</code> indicates
-   *             whether the specified actions are allowed or denied. The <code>actions</code> list the
-   *             operations to which the principal is granted or denied access.</p>
-   */
-  permission?: string;
-
+/**
+ * @public
+ */
+export interface EnableSharingWithAwsOrganizationResponse {
   /**
-   * <p>The date and time when the permission was created.</p>
+   * <p>A return value of <code>true</code> indicates that the request succeeded.
+   *              A value of <code>false</code> indicates that the request failed.</p>
    */
-  creationTime?: Date;
+  returnValue?: boolean;
+}
 
+/**
+ * @public
+ */
+export interface GetPermissionRequest {
   /**
-   * <p>The date and time when the permission was last updated.</p>
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the permission whose contents you want to retrieve.
+   *             To find the ARN for a permission, use either the <a>ListPermissions</a> operation or go to the <a href="https://console.aws.amazon.com/ram/home#Permissions:">Permissions library</a> page in the RAM console and
+   *              then choose the name of the permission. The ARN is displayed on the detail page.</p>
    */
-  lastUpdatedTime?: Date;
+  permissionArn: string | undefined;
 
   /**
-   * <p>Specifies whether the version of the permission represented in this structure is the
-   *             default version for all resources of this resource type.</p>
+   * <p>Specifies the version number of the RAM permission to retrieve. If you don't specify
+   *             this parameter, the operation retrieves the default version.</p>
+   *          <p>To see the list of available versions, use <a>ListPermissionVersions</a>.</p>
    */
-  isResourceTypeDefault?: boolean;
+  permissionVersion?: number;
 }
 
 /**
@@ -1210,7 +1900,7 @@ export interface ResourceSharePermissionDetail {
  */
 export interface GetPermissionResponse {
   /**
-   * <p>An object that contains information about the permission.</p>
+   * <p>An object with details about the permission.</p>
    */
   permission?: ResourceSharePermissionDetail;
 }
@@ -1273,7 +1963,9 @@ export interface GetResourcePoliciesResponse {
 
 /**
  * @public
- * <p>The specified value for <code>NextToken</code> is not valid.</p>
+ * <p>The operation failed because the specified value for <code>NextToken</code> isn't
+ *             valid. You must specify a value you received in the <code>NextToken</code> response of a
+ *             previous call to this operation.</p>
  */
 export class InvalidNextTokenException extends __BaseException {
   readonly name: "InvalidNextTokenException" = "InvalidNextTokenException";
@@ -1293,7 +1985,7 @@ export class InvalidNextTokenException extends __BaseException {
 
 /**
  * @public
- * <p>The specified Amazon Resource Name (ARN) was not found.</p>
+ * <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> was not found.</p>
  */
 export class ResourceArnNotFoundException extends __BaseException {
   readonly name: "ResourceArnNotFoundException" = "ResourceArnNotFoundException";
@@ -1321,13 +2013,13 @@ export interface GetResourceShareAssociationsRequest {
    *          <ul>
    *             <li>
    *                <p>
-   *                   <code>PRINCIPAL</code> – list the principals that are associated with
-   *                     the specified resource share.</p>
+   *                   <code>PRINCIPAL</code> – list the principals whose associations you
+   *                     want to see.</p>
    *             </li>
    *             <li>
    *                <p>
-   *                   <code>RESOURCE</code> – list the resources that are associated with the
-   *                     specified resource share.</p>
+   *                   <code>RESOURCE</code> – list the resources whose associations you want
+   *                     to see.</p>
    *             </li>
    *          </ul>
    */
@@ -1340,7 +2032,7 @@ export interface GetResourceShareAssociationsRequest {
   resourceShareArns?: string[];
 
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource whose resource shares you want to retrieve.</p>
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of a resource whose resource shares you want to retrieve.</p>
    *          <p>You cannot specify this parameter if the association type is
    *             <code>PRINCIPAL</code>.</p>
    */
@@ -1348,7 +2040,7 @@ export interface GetResourceShareAssociationsRequest {
 
   /**
    * <p>Specifies the ID of the principal whose resource shares you want to retrieve. This can be an
-   *             Amazon Web Services account ID, an organization ID, an organizational unit ID, or the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of an
+   *             Amazon Web Services account ID, an organization ID, an organizational unit ID, or the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of an
    *             individual IAM user or role.</p>
    *          <p>You cannot specify this parameter if the association type is
    *             <code>RESOURCE</code>.</p>
@@ -1356,7 +2048,7 @@ export interface GetResourceShareAssociationsRequest {
   principal?: string;
 
   /**
-   * <p>Specifies that you want to retrieve only associations with this status.</p>
+   * <p>Specifies that you want to retrieve only associations that have this status.</p>
    */
   associationStatus?: ResourceShareAssociationStatus | string;
 
@@ -1462,7 +2154,8 @@ export interface GetResourceShareInvitationsResponse {
 
 /**
  * @public
- * <p>The specified value for <code>MaxResults</code> is not valid.</p>
+ * <p>The operation failed because the specified value for <code>MaxResults</code> isn't
+ *             valid.</p>
  */
 export class InvalidMaxResultsException extends __BaseException {
   readonly name: "InvalidMaxResultsException" = "InvalidMaxResultsException";
@@ -1584,10 +2277,16 @@ export interface GetResourceSharesRequest {
   maxResults?: number;
 
   /**
-   * <p>Specifies that you want to retrieve details of only those resource shares that use the RAM
-   *             permission with this <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a>.</p>
+   * <p>Specifies that you want to retrieve details of only those resource shares that use the managed permission with
+   *             this <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a>.</p>
    */
   permissionArn?: string;
+
+  /**
+   * <p>Specifies that you want to retrieve details for only those resource shares that use the
+   *             specified version of the managed permission.</p>
+   */
+  permissionVersion?: number;
 }
 
 /**
@@ -1629,7 +2328,7 @@ export type ResourceRegionScopeFilter = (typeof ResourceRegionScopeFilter)[keyof
  */
 export interface ListPendingInvitationResourcesRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the invitation. You can use <a>GetResourceShareInvitations</a> to find the ARN of the invitation.</p>
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the invitation. You can use <a>GetResourceShareInvitations</a> to find the ARN of the invitation.</p>
    */
   resourceShareInvitationArn: string | undefined;
 
@@ -1717,24 +2416,25 @@ export type ResourceStatus = (typeof ResourceStatus)[keyof typeof ResourceStatus
  */
 export interface Resource {
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource.</p>
    */
   arn?: string;
 
   /**
    * <p>The resource type. This takes the form of:
-   *                 <code>service-code</code>:<code>resource-code</code>
-   *          </p>
+   *                 <code>service-code</code>:<code>resource-code</code>, and is case-insensitive. For
+   *             example, an Amazon EC2 Subnet would be represented by the string
+   *             <code>ec2:subnet</code>.</p>
    */
   type?: string;
 
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share this resource is associated with.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share this resource is associated with.</p>
    */
   resourceShareArn?: string;
 
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource group. This value is available only if the resource is
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource group. This value is available only if the resource is
    *             part of a resource group.</p>
    */
   resourceGroupArn?: string;
@@ -1755,7 +2455,8 @@ export interface Resource {
   creationTime?: Date;
 
   /**
-   * <p>The date an time when the association was last updated.</p>
+   * <p>The date an time when the association between the resource and the resource share was
+   *             last updated.</p>
    */
   lastUpdatedTime?: Date;
 
@@ -1800,7 +2501,7 @@ export interface ListPendingInvitationResourcesResponse {
 
 /**
  * @public
- * <p>A required input parameter is missing.</p>
+ * <p>The operation failed because a required input parameter is missing.</p>
  */
 export class MissingRequiredParameterException extends __BaseException {
   readonly name: "MissingRequiredParameterException" = "MissingRequiredParameterException";
@@ -1821,15 +2522,46 @@ export class MissingRequiredParameterException extends __BaseException {
 /**
  * @public
  */
-export interface ListPermissionsRequest {
+export interface ListPermissionAssociationsRequest {
   /**
-   * <p>Specifies that you want to list permissions for only the specified resource type. For
-   *             example, to list only permissions that apply to EC2 subnets, specify
-   *                 <code>ec2:Subnet</code>. You can use the <a>ListResourceTypes</a>
-   *             operation to get the specific string required.</p>
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the managed permission.</p>
+   */
+  permissionArn?: string;
+
+  /**
+   * <p>Specifies that you want to list only those associations with resource shares that use this
+   *             version of the managed permission. If you don't provide a value for this parameter, then the operation
+   *             returns information about associations with resource shares that use any version of the
+   *             managed permission.</p>
+   */
+  permissionVersion?: number;
+
+  /**
+   * <p>Specifies that you want to list only those associations with resource shares that match this
+   *             status.</p>
+   */
+  associationStatus?: ResourceShareAssociationStatus | string;
+
+  /**
+   * <p>Specifies that you want to list only those associations with resource shares that include at
+   *             least one resource of this resource type.</p>
    */
   resourceType?: string;
 
+  /**
+   * <p>Specifies that you want to list only those associations with resource shares that have a
+   *                 <code>featureSet</code> with this value.</p>
+   */
+  featureSet?: PermissionFeatureSet | string;
+
+  /**
+   * <p>When <code>true</code>, specifies that you want to list only those associations with
+   *             resource shares that use the default version of the specified managed permission.</p>
+   *          <p>When <code>false</code> (the default value), lists associations with resource shares that use
+   *             any version of the specified managed permission.</p>
+   */
+  defaultVersion?: boolean;
+
   /**
    * <p>Specifies that you want to receive the next page of results. Valid
    *              only if you received a <code>NextToken</code> response in the previous request. If you
@@ -1855,56 +2587,190 @@ export interface ListPermissionsRequest {
 
 /**
  * @public
- * <p>Information about an RAM permission that is associated with a resource share and any of its
- *             resources of a specified type.</p>
+ * <p>An object that describes a managed permission associated with a resource share.</p>
  */
-export interface ResourceSharePermissionSummary {
+export interface AssociatedPermission {
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the permission you want information about.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the associated managed permission.</p>
    */
   arn?: string;
 
   /**
-   * <p>The version of the permission represented in this structure.</p>
+   * <p>The version of the permission currently associated with the resource share.</p>
    */
-  version?: string;
+  permissionVersion?: string;
 
   /**
-   * <p>Specifies whether the version of the permission represented in this structure is the
-   *             default version for this permission.</p>
+   * <p>Indicates whether the associated resource share is using the default version of the
+   *             permission.</p>
    */
   defaultVersion?: boolean;
 
   /**
-   * <p>The name of this permission.</p>
-   */
-  name?: string;
-
-  /**
-   * <p>The type of resource to which this permission applies.</p>
+   * <p>The resource type to which this permission applies.</p>
    */
   resourceType?: string;
 
   /**
-   * <p>The current status of the permission.</p>
+   * <p>The current status of the association between the permission and the resource share.
+   *             The following are the possible values:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>ATTACHABLE</code> – This permission or version can be associated
+   *                 with resource shares.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>UNATTACHABLE</code> – This permission or version can't
+   *                 currently be associated with resource shares.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>DELETING</code> – This permission or version is in the process of
+   *                     being deleted.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>DELETED</code> – This permission or version is deleted.</p>
+   *             </li>
+   *          </ul>
    */
   status?: string;
 
   /**
-   * <p>The date and time when the permission was created.</p>
+   * <p>Indicates what features are available for this resource share. This parameter can have one of
+   *             the following values:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <b>STANDARD</b> – A resource share that supports all
+   *                     functionality. These resource shares are visible to all principals you share the resource share with.
+   *                     You can modify these resource shares in RAM using the console or APIs. This resource share might
+   *                     have been created by RAM, or it might have been <b>CREATED_FROM_POLICY</b> and then promoted.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>CREATED_FROM_POLICY</b> – The customer
+   *                     manually shared a resource by attaching a resource-based policy. That policy did
+   *                     not match any existing managed permissions, so RAM created this customer managed permission automatically on the
+   *                     customer's behalf based on the attached policy document. This type of resource share
+   *                     is visible only to the Amazon Web Services account that created it. You can't modify it in
+   *                     RAM unless you promote it. For more information,
+   *                     see <a>PromoteResourceShareCreatedFromPolicy</a>.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>PROMOTING_TO_STANDARD</b> – This
+   *                     resource share was originally <code>CREATED_FROM_POLICY</code>, but the customer ran
+   *                     the <a>PromoteResourceShareCreatedFromPolicy</a> and that operation
+   *                     is still in progress. This value changes to <code>STANDARD</code> when
+   *                     complete.</p>
+   *             </li>
+   *          </ul>
    */
-  creationTime?: Date;
+  featureSet?: PermissionFeatureSet | string;
 
   /**
-   * <p>The date and time when the permission was last updated.</p>
+   * <p>The date and time when the association between the permission and the resource share
+   *             was last updated.</p>
    */
   lastUpdatedTime?: Date;
 
   /**
-   * <p>Specifies whether the version of the permission represented in this structure is the
-   *             default version for all resources of this resource type.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of a resource share associated with this permission.</p>
    */
-  isResourceTypeDefault?: boolean;
+  resourceShareArn?: string;
+}
+
+/**
+ * @public
+ */
+export interface ListPermissionAssociationsResponse {
+  /**
+   * <p>A structure with information about this customer managed permission.</p>
+   */
+  permissions?: AssociatedPermission[];
+
+  /**
+   * <p>If present, this value indicates that more output is available than
+   *              is included in the current response. Use this value in the <code>NextToken</code>
+   *              request parameter in a subsequent call to the operation to get the next part of the
+   *              output. You should repeat this until the <code>NextToken</code> response element comes
+   *              back as <code>null</code>. This indicates that this is the last page of results.</p>
+   */
+  nextToken?: string;
+}
+
+/**
+ * @public
+ * @enum
+ */
+export const PermissionTypeFilter = {
+  ALL: "ALL",
+  AWS_MANAGED: "AWS_MANAGED",
+  CUSTOMER_MANAGED: "CUSTOMER_MANAGED",
+} as const;
+
+/**
+ * @public
+ */
+export type PermissionTypeFilter = (typeof PermissionTypeFilter)[keyof typeof PermissionTypeFilter];
+
+/**
+ * @public
+ */
+export interface ListPermissionsRequest {
+  /**
+   * <p>Specifies that you want to list only those permissions that apply to the specified
+   *             resource type. This parameter is not case sensitive.</p>
+   *          <p>For example, to list only permissions that apply to Amazon EC2 subnets, specify
+   *                 <code>ec2:subnet</code>. You can use the <a>ListResourceTypes</a>
+   *             operation to get the specific string required.</p>
+   */
+  resourceType?: string;
+
+  /**
+   * <p>Specifies that you want to receive the next page of results. Valid
+   *              only if you received a <code>NextToken</code> response in the previous request. If you
+   *              did, it indicates that more output is available. Set this parameter to the value
+   *              provided by the previous call's <code>NextToken</code> response to request the
+   *              next page of results.</p>
+   */
+  nextToken?: string;
+
+  /**
+   * <p>Specifies the total number of results that you want included on each page
+   *              of the response. If you do not include this parameter, it defaults to a value that is
+   *              specific to the operation. If additional items exist beyond the number you specify, the
+   *              <code>NextToken</code> response element is returned with a value (not null).
+   *              Include the specified value as the <code>NextToken</code> request parameter in the next
+   *              call to the operation to get the next part of the results. Note that the service might
+   *              return fewer results than the maximum even when there are more results available. You
+   *              should check <code>NextToken</code> after every operation to ensure that you receive all
+   *              of the results.</p>
+   */
+  maxResults?: number;
+
+  /**
+   * <p>Specifies that you want to list only permissions of this type:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>AWS</code> – returns only Amazon Web Services managed permissions.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>LOCAL</code> – returns only customer managed permissions</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>ALL</code> – returns both Amazon Web Services managed permissions and customer managed permissions.</p>
+   *             </li>
+   *          </ul>
+   *          <p>If you don't specify this parameter, the default is <code>All</code>.</p>
+   */
+  permissionType?: PermissionTypeFilter | string;
 }
 
 /**
@@ -1931,7 +2797,7 @@ export interface ListPermissionsResponse {
  */
 export interface ListPermissionVersionsRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the RAM permission whose versions you want to list. You
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the RAM permission whose versions you want to list. You
    *             can use the <code>permissionVersion</code> parameter on the <a>AssociateResourceSharePermission</a> operation to specify a non-default
    *             version to attach.</p>
    */
@@ -2007,7 +2873,7 @@ export interface ListPrincipalsRequest {
 
   /**
    * <p>Specifies that you want to list principal information for the resource share with the specified
-   *             <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a>.</p>
+   *             <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a>.</p>
    */
   resourceArn?: string;
 
@@ -2016,51 +2882,170 @@ export interface ListPrincipalsRequest {
    *          <p>You can include the following values:</p>
    *          <ul>
    *             <li>
-   *                <p>An Amazon Web Services account ID, for example: <code>123456789012</code>
-   *                </p>
-   *             </li>
-   *             <li>
-   *                <p>An <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of an organization in Organizations, for example:
-   *                         <code>organizations::123456789012:organization/o-exampleorgid</code>
-   *                </p>
-   *             </li>
-   *             <li>
-   *                <p>An ARN of an organizational unit (OU) in Organizations, for example:
-   *                         <code>organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123</code>
-   *                </p>
-   *             </li>
-   *             <li>
-   *                <p>An ARN of an IAM role, for example:
-   *                         <code>iam::123456789012:role/rolename</code>
-   *                </p>
+   *                <p>An Amazon Web Services account ID, for example: <code>123456789012</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>An <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of an organization in Organizations, for example:
+   *                         <code>organizations::123456789012:organization/o-exampleorgid</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>An ARN of an organizational unit (OU) in Organizations, for example:
+   *                         <code>organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>An ARN of an IAM role, for example:
+   *                         <code>iam::123456789012:role/rolename</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>An ARN of an IAM user, for example:
+   *                         <code>iam::123456789012user/username</code>
+   *                </p>
+   *             </li>
+   *          </ul>
+   *          <note>
+   *             <p>Not all resource types can be shared with IAM roles and users.
+   *              For more information, see <a href="https://docs.aws.amazon.com/ram/latest/userguide/permissions.html#permissions-rbp-supported-resource-types">Sharing with IAM roles and users</a> in the <i>Resource Access Manager User
+   *                     Guide</i>.</p>
+   *          </note>
+   */
+  principals?: string[];
+
+  /**
+   * <p>Specifies that you want to list information for only principals associated with resource shares
+   *             that include the specified resource type.</p>
+   *          <p>For a list of valid values, query the <a>ListResourceTypes</a>
+   *             operation.</p>
+   */
+  resourceType?: string;
+
+  /**
+   * <p>Specifies that you want to list information for only principals associated with the
+   *             resource shares specified by a list the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Names (ARNs)</a>.</p>
+   */
+  resourceShareArns?: string[];
+
+  /**
+   * <p>Specifies that you want to receive the next page of results. Valid
+   *              only if you received a <code>NextToken</code> response in the previous request. If you
+   *              did, it indicates that more output is available. Set this parameter to the value
+   *              provided by the previous call's <code>NextToken</code> response to request the
+   *              next page of results.</p>
+   */
+  nextToken?: string;
+
+  /**
+   * <p>Specifies the total number of results that you want included on each page
+   *              of the response. If you do not include this parameter, it defaults to a value that is
+   *              specific to the operation. If additional items exist beyond the number you specify, the
+   *              <code>NextToken</code> response element is returned with a value (not null).
+   *              Include the specified value as the <code>NextToken</code> request parameter in the next
+   *              call to the operation to get the next part of the results. Note that the service might
+   *              return fewer results than the maximum even when there are more results available. You
+   *              should check <code>NextToken</code> after every operation to ensure that you receive all
+   *              of the results.</p>
+   */
+  maxResults?: number;
+}
+
+/**
+ * @public
+ * <p>Describes a principal for use with Resource Access Manager.</p>
+ */
+export interface Principal {
+  /**
+   * <p>The ID of the principal that can be associated with a resource share.</p>
+   */
+  id?: string;
+
+  /**
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of a resource share the principal is associated with.</p>
+   */
+  resourceShareArn?: string;
+
+  /**
+   * <p>The date and time when the principal was associated with the resource share.</p>
+   */
+  creationTime?: Date;
+
+  /**
+   * <p>The date and time when the association between the resource share and the principal
+   *             was last updated.</p>
+   */
+  lastUpdatedTime?: Date;
+
+  /**
+   * <p>Indicates the relationship between the Amazon Web Services account the principal belongs to and the
+   *             account that owns the resource share:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>True</code> – The two accounts belong to same
+   *                     organization.</p>
    *             </li>
    *             <li>
-   *                <p>An ARN of an IAM user, for example:
-   *                         <code>iam::123456789012user/username</code>
-   *                </p>
+   *                <p>
+   *                   <code>False</code> – The two accounts do not belong to the same
+   *                     organization.</p>
    *             </li>
    *          </ul>
-   *          <note>
-   *             <p>Not all resource types can be shared with IAM roles and users.
-   *              For more information, see <a href="https://docs.aws.amazon.com/ram/latest/userguide/permissions.html#permissions-rbp-supported-resource-types">Sharing with IAM roles and users</a> in the <i>Resource Access Manager User
-   *                     Guide</i>.</p>
-   *          </note>
    */
-  principals?: string[];
+  external?: boolean;
+}
 
+/**
+ * @public
+ */
+export interface ListPrincipalsResponse {
   /**
-   * <p>Specifies that you want to list information for only principals associated with resource shares
-   *             that include the specified resource type.</p>
-   *          <p>For a list of valid values, query the <a>ListResourceTypes</a>
-   *             operation.</p>
+   * <p>An array of objects that contain the details about the principals.</p>
    */
-  resourceType?: string;
+  principals?: Principal[];
 
   /**
-   * <p>Specifies that you want to list information for only principals associated with the
-   *             resource shares specified by a list the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Names (ARNs)</a>.</p>
+   * <p>If present, this value indicates that more output is available than
+   *              is included in the current response. Use this value in the <code>NextToken</code>
+   *              request parameter in a subsequent call to the operation to get the next part of the
+   *              output. You should repeat this until the <code>NextToken</code> response element comes
+   *              back as <code>null</code>. This indicates that this is the last page of results.</p>
    */
-  resourceShareArns?: string[];
+  nextToken?: string;
+}
+
+/**
+ * @public
+ * @enum
+ */
+export const ReplacePermissionAssociationsWorkStatus = {
+  COMPLETED: "COMPLETED",
+  FAILED: "FAILED",
+  IN_PROGRESS: "IN_PROGRESS",
+} as const;
+
+/**
+ * @public
+ */
+export type ReplacePermissionAssociationsWorkStatus =
+  (typeof ReplacePermissionAssociationsWorkStatus)[keyof typeof ReplacePermissionAssociationsWorkStatus];
+
+/**
+ * @public
+ */
+export interface ListReplacePermissionAssociationsWorkRequest {
+  /**
+   * <p>A list of IDs. These values come from the <code>id</code>field of the
+   *                 <code>replacePermissionAssociationsWork</code>structure returned by the <a>ReplacePermissionAssociations</a> operation. </p>
+   */
+  workIds?: string[];
+
+  /**
+   * <p>Specifies that you want to see only the details about requests with a status that
+   *             matches this value.</p>
+   */
+  status?: ReplacePermissionAssociationsWorkStatus | string;
 
   /**
    * <p>Specifies that you want to receive the next page of results. Valid
@@ -2087,44 +3072,86 @@ export interface ListPrincipalsRequest {
 
 /**
  * @public
- * <p>Describes a principal for use with Resource Access Manager.</p>
+ * <p>A structure that represents the background work that RAM performs when you invoke
+ *             the <a>ReplacePermissionAssociations</a> operation.</p>
  */
-export interface Principal {
+export interface ReplacePermissionAssociationsWork {
   /**
-   * <p>The ID of the principal.</p>
+   * <p>The unique identifier for the background task associated with one <a>ReplacePermissionAssociations</a> request.</p>
    */
   id?: string;
 
   /**
-   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of a resource share the principal is associated with.</p>
+   * <p>The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the managed permission that this background task is replacing.</p>
    */
-  resourceShareArn?: string;
+  fromPermissionArn?: string;
 
   /**
-   * <p>The date and time when the principal was associated with the resource share.</p>
+   * <p>The version of the managed permission that this background task is replacing.</p>
    */
-  creationTime?: Date;
+  fromPermissionVersion?: string;
 
   /**
-   * <p>The date and time when the association was last updated.</p>
+   * <p>The ARN of the managed permission that this background task is associating with the resource shares in place
+   *             of the managed permission and version specified in <code>fromPermissionArn</code> and
+   *                 <code>fromPermissionVersion</code>.</p>
    */
-  lastUpdatedTime?: Date;
+  toPermissionArn?: string;
 
   /**
-   * <p>Indicates whether the principal belongs to the same organization in Organizations as the
-   *             Amazon Web Services account that owns the resource share.</p>
+   * <p>The version of the managed permission that this background task is associating with the resource shares. This
+   *             is always the version that is currently the default for this managed permission.</p>
    */
-  external?: boolean;
+  toPermissionVersion?: string;
+
+  /**
+   * <p>Specifies the current status of the background tasks for the specified ID. The output
+   *             is one of the following strings:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>IN_PROGRESS</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>COMPLETED</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>FAILED</code>
+   *                </p>
+   *             </li>
+   *          </ul>
+   */
+  status?: ReplacePermissionAssociationsWorkStatus | string;
+
+  /**
+   * <p>Specifies the reason for a <code>FAILED</code> status. This field is present only when
+   *             there <code>status</code> is <code>FAILED</code>.</p>
+   */
+  statusMessage?: string;
+
+  /**
+   * <p>The date and time when this asynchronous background task was created.</p>
+   */
+  creationTime?: Date;
+
+  /**
+   * <p>The date and time when the status of this background task was last updated.</p>
+   */
+  lastUpdatedTime?: Date;
 }
 
 /**
  * @public
  */
-export interface ListPrincipalsResponse {
+export interface ListReplacePermissionAssociationsWorkResponse {
   /**
-   * <p>An array of objects that contain the details about the principals.</p>
+   * <p>An array of data structures that provide details of the matching work IDs.</p>
    */
-  principals?: Principal[];
+  replacePermissionAssociationsWorks?: ReplacePermissionAssociationsWork[];
 
   /**
    * <p>If present, this value indicates that more output is available than
@@ -2138,7 +3165,7 @@ export interface ListPrincipalsResponse {
 
 /**
  * @public
- * <p>The specified resource type is not valid.</p>
+ * <p>The operation failed because the specified resource type isn't valid.</p>
  */
 export class InvalidResourceTypeException extends __BaseException {
   readonly name: "InvalidResourceTypeException" = "InvalidResourceTypeException";
@@ -2277,7 +3304,7 @@ export interface ListResourcesResponse {
  */
 export interface ListResourceSharePermissionsRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share for which you want to retrieve the associated
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share for which you want to retrieve the associated
    *             permissions.</p>
    */
   resourceShareArn: string | undefined;
@@ -2382,7 +3409,10 @@ export interface ListResourceTypesRequest {
  */
 export interface ServiceNameAndResourceType {
   /**
-   * <p>The type of the resource.</p>
+   * <p>The type of the resource. This takes the form of:
+   *                 <code>service-code</code>:<code>resource-code</code>, and is case-insensitive. For
+   *             example, an Amazon EC2 Subnet would be represented by the string
+   *             <code>ec2:subnet</code>.</p>
    */
   resourceType?: string;
 
@@ -2430,12 +3460,61 @@ export interface ListResourceTypesResponse {
   nextToken?: string;
 }
 
+/**
+ * @public
+ */
+export interface PromotePermissionCreatedFromPolicyRequest {
+  /**
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the <code>CREATED_FROM_POLICY</code> permission that you
+   *             want to promote. You can get this <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> by calling the <a>ListResourceSharePermissions</a> operation.</p>
+   */
+  permissionArn: string | undefined;
+
+  /**
+   * <p>Specifies a name for the promoted customer managed permission.</p>
+   */
+  name: string | undefined;
+
+  /**
+   * <p>Specifies a unique, case-sensitive identifier that you provide to
+   *              ensure the idempotency of the request. This lets you safely retry the request without
+   *              accidentally performing the same operation a second time. Passing the same value to a
+   *              later call to an operation requires that you also pass the same value for all other
+   *              parameters. We recommend that you use a <a href="https://wikipedia.org/wiki/Universally_unique_identifier">UUID type of
+   *              value.</a>.</p>
+   *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
+   *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
+   */
+  clientToken?: string;
+}
+
+/**
+ * @public
+ */
+export interface PromotePermissionCreatedFromPolicyResponse {
+  /**
+   * <p>Information about an RAM permission.</p>
+   */
+  permission?: ResourceSharePermissionSummary;
+
+  /**
+   * <p>The idempotency identifier associated with this request. If you
+   *              want to repeat the same operation in an idempotent manner then you must include this
+   *              value in the <code>clientToken</code> request parameter of that later call. All other
+   *              parameters must also have the same values that you used in the first call.</p>
+   */
+  clientToken?: string;
+}
+
 /**
  * @public
  */
 export interface PromoteResourceShareCreatedFromPolicyRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share to promote.</p>
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share to promote.</p>
    */
   resourceShareArn: string | undefined;
 }
@@ -2451,12 +3530,33 @@ export interface PromoteResourceShareCreatedFromPolicyResponse {
   returnValue?: boolean;
 }
 
+/**
+ * @public
+ * <p>There isn't an existing managed permission defined in RAM that has the same IAM permissions as
+ *             the resource-based policy attached to the resource. You should first run <a>PromotePermissionCreatedFromPolicy</a> to create that managed permission.</p>
+ */
+export class UnmatchedPolicyPermissionException extends __BaseException {
+  readonly name: "UnmatchedPolicyPermissionException" = "UnmatchedPolicyPermissionException";
+  readonly $fault: "client" = "client";
+  /**
+   * @internal
+   */
+  constructor(opts: __ExceptionOptionType<UnmatchedPolicyPermissionException, __BaseException>) {
+    super({
+      name: "UnmatchedPolicyPermissionException",
+      $fault: "client",
+      ...opts,
+    });
+    Object.setPrototypeOf(this, UnmatchedPolicyPermissionException.prototype);
+  }
+}
+
 /**
  * @public
  */
 export interface RejectResourceShareInvitationRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the invitation that you want to reject.</p>
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the invitation that you want to reject.</p>
    */
   resourceShareInvitationArn: string | undefined;
 
@@ -2469,6 +3569,9 @@ export interface RejectResourceShareInvitationRequest {
    *              value.</a>.</p>
    *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
    *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
    */
   clientToken?: string;
 }
@@ -2493,7 +3596,117 @@ export interface RejectResourceShareInvitationResponse {
 
 /**
  * @public
- * <p>This request would exceed the limit for tags for your account.</p>
+ */
+export interface ReplacePermissionAssociationsRequest {
+  /**
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the managed permission that you want to replace.</p>
+   */
+  fromPermissionArn: string | undefined;
+
+  /**
+   * <p>Specifies that you want to updated the permissions for only those resource shares that use the
+   *             specified version of the managed permission.</p>
+   */
+  fromPermissionVersion?: number;
+
+  /**
+   * <p>Specifies the ARN of the managed permission that you want to associate with resource
+   *             shares in place of the one specified by <code>fromPerssionArn</code> and
+   *                 <code>fromPermissionVersion</code>.</p>
+   *          <p>The operation always associates the version that is currently the default for the
+   *             specified managed permission.</p>
+   */
+  toPermissionArn: string | undefined;
+
+  /**
+   * <p>Specifies a unique, case-sensitive identifier that you provide to
+   *              ensure the idempotency of the request. This lets you safely retry the request without
+   *              accidentally performing the same operation a second time. Passing the same value to a
+   *              later call to an operation requires that you also pass the same value for all other
+   *              parameters. We recommend that you use a <a href="https://wikipedia.org/wiki/Universally_unique_identifier">UUID type of
+   *              value.</a>.</p>
+   *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
+   *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
+   */
+  clientToken?: string;
+}
+
+/**
+ * @public
+ */
+export interface ReplacePermissionAssociationsResponse {
+  /**
+   * <p>Specifies a data structure that you can use to track the asynchronous tasks that RAM
+   *             performs to complete this operation. You can use the <a>ListReplacePermissionAssociationsWork</a> operation and pass the
+   *                 <code>id</code> value returned in this structure.</p>
+   */
+  replacePermissionAssociationsWork?: ReplacePermissionAssociationsWork;
+
+  /**
+   * <p>The idempotency identifier associated with this request. If you
+   *              want to repeat the same operation in an idempotent manner then you must include this
+   *              value in the <code>clientToken</code> request parameter of that later call. All other
+   *              parameters must also have the same values that you used in the first call.</p>
+   */
+  clientToken?: string;
+}
+
+/**
+ * @public
+ */
+export interface SetDefaultPermissionVersionRequest {
+  /**
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the customer managed permission whose default version you want to change.</p>
+   */
+  permissionArn: string | undefined;
+
+  /**
+   * <p>Specifies the version number that you want to designate as the default for customer managed permission. To
+   *             see a list of all available version numbers, use <a>ListPermissionVersions</a>.</p>
+   */
+  permissionVersion: number | undefined;
+
+  /**
+   * <p>Specifies a unique, case-sensitive identifier that you provide to
+   *              ensure the idempotency of the request. This lets you safely retry the request without
+   *              accidentally performing the same operation a second time. Passing the same value to a
+   *              later call to an operation requires that you also pass the same value for all other
+   *              parameters. We recommend that you use a <a href="https://wikipedia.org/wiki/Universally_unique_identifier">UUID type of
+   *              value.</a>.</p>
+   *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
+   *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
+   */
+  clientToken?: string;
+}
+
+/**
+ * @public
+ */
+export interface SetDefaultPermissionVersionResponse {
+  /**
+   * <p>A boolean value that indicates whether the operation was successful.</p>
+   */
+  returnValue?: boolean;
+
+  /**
+   * <p>The idempotency identifier associated with this request. If you
+   *              want to repeat the same operation in an idempotent manner then you must include this
+   *              value in the <code>clientToken</code> request parameter of that later call. All other
+   *              parameters must also have the same values that you used in the first call.</p>
+   */
+  clientToken?: string;
+}
+
+/**
+ * @public
+ * <p>The operation failed because it would exceed the limit for tags for your
+ *             Amazon Web Services account.</p>
  */
 export class TagLimitExceededException extends __BaseException {
   readonly name: "TagLimitExceededException" = "TagLimitExceededException";
@@ -2516,15 +3729,24 @@ export class TagLimitExceededException extends __BaseException {
  */
 export interface TagResourceRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share that you want to add tags to.</p>
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share that you want to add tags to. You must specify
+   *                 <i>either</i>
+   *             <code>resourceShareArn</code>, or <code>resourceArn</code>, but not both.</p>
    */
-  resourceShareArn: string | undefined;
+  resourceShareArn?: string;
 
   /**
    * <p>A list of one or more tag key and value pairs. The tag key must be present and not be
    *             an empty string. The tag value must be present but can be an empty string.</p>
    */
   tags: Tag[] | undefined;
+
+  /**
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the managed permission that you want to add tags to. You must specify
+   *                 <i>either</i>
+   *             <code>resourceArn</code>, or <code>resourceShareArn</code>, but not both.</p>
+   */
+  resourceArn?: string;
 }
 
 /**
@@ -2537,15 +3759,23 @@ export interface TagResourceResponse {}
  */
 export interface UntagResourceRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share that you want to remove tags from. The tags are
-   *             removed from the resource share, not the resources in the resource share.</p>
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share that you want to remove tags from. The tags are
+   *             removed from the resource share, not the resources in the resource share. You must specify either
+   *                 <code>resourceShareArn</code>, or <code>resourceArn</code>, but not both.</p>
    */
-  resourceShareArn: string | undefined;
+  resourceShareArn?: string;
 
   /**
    * <p>Specifies a list of one or more tag keys that you want to remove.</p>
    */
   tagKeys: string[] | undefined;
+
+  /**
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the managed permission that you want to remove tags from. You must
+   *             specify either <code>resourceArn</code>, or <code>resourceShareArn</code>, but not
+   *             both.</p>
+   */
+  resourceArn?: string;
 }
 
 /**
@@ -2558,7 +3788,7 @@ export interface UntagResourceResponse {}
  */
 export interface UpdateResourceShareRequest {
   /**
-   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resoure Name (ARN)</a> of the resource share that you want to modify.</p>
+   * <p>Specifies the <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> of the resource share that you want to modify.</p>
    */
   resourceShareArn: string | undefined;
 
@@ -2582,6 +3812,9 @@ export interface UpdateResourceShareRequest {
    *              value.</a>.</p>
    *          <p>If you don't provide this value, then Amazon Web Services generates a random one for
    *              you.</p>
+   *          <p>If you retry the operation with the same <code>ClientToken</code>, but with
+   *              different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>
+   *              error.</p>
    */
   clientToken?: string;
 }
diff --git a/clients/client-ram/src/pagination/ListPermissionAssociationsPaginator.ts b/clients/client-ram/src/pagination/ListPermissionAssociationsPaginator.ts
new file mode 100644
index 000000000000..0a9ff46a9877
--- /dev/null
+++ b/clients/client-ram/src/pagination/ListPermissionAssociationsPaginator.ts
@@ -0,0 +1,50 @@
+// smithy-typescript generated code
+import { Paginator } from "@aws-sdk/types";
+
+import {
+  ListPermissionAssociationsCommand,
+  ListPermissionAssociationsCommandInput,
+  ListPermissionAssociationsCommandOutput,
+} from "../commands/ListPermissionAssociationsCommand";
+import { RAMClient } from "../RAMClient";
+import { RAMPaginationConfiguration } from "./Interfaces";
+
+/**
+ * @internal
+ */
+const makePagedClientRequest = async (
+  client: RAMClient,
+  input: ListPermissionAssociationsCommandInput,
+  ...args: any
+): Promise<ListPermissionAssociationsCommandOutput> => {
+  // @ts-ignore
+  return await client.send(new ListPermissionAssociationsCommand(input), ...args);
+};
+/**
+ * @public
+ */
+export async function* paginateListPermissionAssociations(
+  config: RAMPaginationConfiguration,
+  input: ListPermissionAssociationsCommandInput,
+  ...additionalArguments: any
+): Paginator<ListPermissionAssociationsCommandOutput> {
+  // ToDo: replace with actual type instead of typeof input.nextToken
+  let token: typeof input.nextToken | undefined = config.startingToken || undefined;
+  let hasNext = true;
+  let page: ListPermissionAssociationsCommandOutput;
+  while (hasNext) {
+    input.nextToken = token;
+    input["maxResults"] = config.pageSize;
+    if (config.client instanceof RAMClient) {
+      page = await makePagedClientRequest(config.client, input, ...additionalArguments);
+    } else {
+      throw new Error("Invalid client, expected RAM | RAMClient");
+    }
+    yield page;
+    const prevToken = token;
+    token = page.nextToken;
+    hasNext = !!(token && (!config.stopOnSameToken || token !== prevToken));
+  }
+  // @ts-ignore
+  return undefined;
+}
diff --git a/clients/client-ram/src/pagination/ListReplacePermissionAssociationsWorkPaginator.ts b/clients/client-ram/src/pagination/ListReplacePermissionAssociationsWorkPaginator.ts
new file mode 100644
index 000000000000..92e2fab40daa
--- /dev/null
+++ b/clients/client-ram/src/pagination/ListReplacePermissionAssociationsWorkPaginator.ts
@@ -0,0 +1,50 @@
+// smithy-typescript generated code
+import { Paginator } from "@aws-sdk/types";
+
+import {
+  ListReplacePermissionAssociationsWorkCommand,
+  ListReplacePermissionAssociationsWorkCommandInput,
+  ListReplacePermissionAssociationsWorkCommandOutput,
+} from "../commands/ListReplacePermissionAssociationsWorkCommand";
+import { RAMClient } from "../RAMClient";
+import { RAMPaginationConfiguration } from "./Interfaces";
+
+/**
+ * @internal
+ */
+const makePagedClientRequest = async (
+  client: RAMClient,
+  input: ListReplacePermissionAssociationsWorkCommandInput,
+  ...args: any
+): Promise<ListReplacePermissionAssociationsWorkCommandOutput> => {
+  // @ts-ignore
+  return await client.send(new ListReplacePermissionAssociationsWorkCommand(input), ...args);
+};
+/**
+ * @public
+ */
+export async function* paginateListReplacePermissionAssociationsWork(
+  config: RAMPaginationConfiguration,
+  input: ListReplacePermissionAssociationsWorkCommandInput,
+  ...additionalArguments: any
+): Paginator<ListReplacePermissionAssociationsWorkCommandOutput> {
+  // ToDo: replace with actual type instead of typeof input.nextToken
+  let token: typeof input.nextToken | undefined = config.startingToken || undefined;
+  let hasNext = true;
+  let page: ListReplacePermissionAssociationsWorkCommandOutput;
+  while (hasNext) {
+    input.nextToken = token;
+    input["maxResults"] = config.pageSize;
+    if (config.client instanceof RAMClient) {
+      page = await makePagedClientRequest(config.client, input, ...additionalArguments);
+    } else {
+      throw new Error("Invalid client, expected RAM | RAMClient");
+    }
+    yield page;
+    const prevToken = token;
+    token = page.nextToken;
+    hasNext = !!(token && (!config.stopOnSameToken || token !== prevToken));
+  }
+  // @ts-ignore
+  return undefined;
+}
diff --git a/clients/client-ram/src/pagination/index.ts b/clients/client-ram/src/pagination/index.ts
index b7ceff03df57..fcc004e6309a 100644
--- a/clients/client-ram/src/pagination/index.ts
+++ b/clients/client-ram/src/pagination/index.ts
@@ -8,9 +8,11 @@ export * from "./GetResourceSharesPaginator";
 // smithy-typescript generated code
 export * from "./Interfaces";
 export * from "./ListPendingInvitationResourcesPaginator";
+export * from "./ListPermissionAssociationsPaginator";
 export * from "./ListPermissionVersionsPaginator";
 export * from "./ListPermissionsPaginator";
 export * from "./ListPrincipalsPaginator";
+export * from "./ListReplacePermissionAssociationsWorkPaginator";
 export * from "./ListResourceSharePermissionsPaginator";
 export * from "./ListResourceTypesPaginator";
 export * from "./ListResourcesPaginator";
diff --git a/clients/client-ram/src/protocols/Aws_restJson1.ts b/clients/client-ram/src/protocols/Aws_restJson1.ts
index 7c3e6a018904..3509598c7154 100644
--- a/clients/client-ram/src/protocols/Aws_restJson1.ts
+++ b/clients/client-ram/src/protocols/Aws_restJson1.ts
@@ -32,10 +32,20 @@ import {
   AssociateResourceSharePermissionCommandInput,
   AssociateResourceSharePermissionCommandOutput,
 } from "../commands/AssociateResourceSharePermissionCommand";
+import { CreatePermissionCommandInput, CreatePermissionCommandOutput } from "../commands/CreatePermissionCommand";
+import {
+  CreatePermissionVersionCommandInput,
+  CreatePermissionVersionCommandOutput,
+} from "../commands/CreatePermissionVersionCommand";
 import {
   CreateResourceShareCommandInput,
   CreateResourceShareCommandOutput,
 } from "../commands/CreateResourceShareCommand";
+import { DeletePermissionCommandInput, DeletePermissionCommandOutput } from "../commands/DeletePermissionCommand";
+import {
+  DeletePermissionVersionCommandInput,
+  DeletePermissionVersionCommandOutput,
+} from "../commands/DeletePermissionVersionCommand";
 import {
   DeleteResourceShareCommandInput,
   DeleteResourceShareCommandOutput,
@@ -70,18 +80,30 @@ import {
   ListPendingInvitationResourcesCommandInput,
   ListPendingInvitationResourcesCommandOutput,
 } from "../commands/ListPendingInvitationResourcesCommand";
+import {
+  ListPermissionAssociationsCommandInput,
+  ListPermissionAssociationsCommandOutput,
+} from "../commands/ListPermissionAssociationsCommand";
 import { ListPermissionsCommandInput, ListPermissionsCommandOutput } from "../commands/ListPermissionsCommand";
 import {
   ListPermissionVersionsCommandInput,
   ListPermissionVersionsCommandOutput,
 } from "../commands/ListPermissionVersionsCommand";
 import { ListPrincipalsCommandInput, ListPrincipalsCommandOutput } from "../commands/ListPrincipalsCommand";
+import {
+  ListReplacePermissionAssociationsWorkCommandInput,
+  ListReplacePermissionAssociationsWorkCommandOutput,
+} from "../commands/ListReplacePermissionAssociationsWorkCommand";
 import { ListResourcesCommandInput, ListResourcesCommandOutput } from "../commands/ListResourcesCommand";
 import {
   ListResourceSharePermissionsCommandInput,
   ListResourceSharePermissionsCommandOutput,
 } from "../commands/ListResourceSharePermissionsCommand";
 import { ListResourceTypesCommandInput, ListResourceTypesCommandOutput } from "../commands/ListResourceTypesCommand";
+import {
+  PromotePermissionCreatedFromPolicyCommandInput,
+  PromotePermissionCreatedFromPolicyCommandOutput,
+} from "../commands/PromotePermissionCreatedFromPolicyCommand";
 import {
   PromoteResourceShareCreatedFromPolicyCommandInput,
   PromoteResourceShareCreatedFromPolicyCommandOutput,
@@ -90,6 +112,14 @@ import {
   RejectResourceShareInvitationCommandInput,
   RejectResourceShareInvitationCommandOutput,
 } from "../commands/RejectResourceShareInvitationCommand";
+import {
+  ReplacePermissionAssociationsCommandInput,
+  ReplacePermissionAssociationsCommandOutput,
+} from "../commands/ReplacePermissionAssociationsCommand";
+import {
+  SetDefaultPermissionVersionCommandInput,
+  SetDefaultPermissionVersionCommandOutput,
+} from "../commands/SetDefaultPermissionVersionCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "../commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "../commands/UntagResourceCommand";
 import {
@@ -97,17 +127,24 @@ import {
   UpdateResourceShareCommandOutput,
 } from "../commands/UpdateResourceShareCommand";
 import {
+  AssociatedPermission,
   IdempotentParameterMismatchException,
   InvalidClientTokenException,
   InvalidMaxResultsException,
   InvalidNextTokenException,
   InvalidParameterException,
+  InvalidPolicyException,
   InvalidResourceTypeException,
   InvalidStateTransitionException,
   MalformedArnException,
+  MalformedPolicyTemplateException,
   MissingRequiredParameterException,
   OperationNotPermittedException,
+  PermissionAlreadyExistsException,
+  PermissionLimitExceededException,
+  PermissionVersionsLimitExceededException,
   Principal,
+  ReplacePermissionAssociationsWork,
   Resource,
   ResourceArnNotFoundException,
   ResourceShare,
@@ -128,6 +165,7 @@ import {
   TagPolicyViolationException,
   ThrottlingException,
   UnknownResourceException,
+  UnmatchedPolicyPermissionException,
 } from "../models/models_0";
 import { RAMServiceException as __BaseException } from "../models/RAMServiceException";
 
@@ -229,6 +267,71 @@ export const se_AssociateResourceSharePermissionCommand = async (
   });
 };
 
+/**
+ * serializeAws_restJson1CreatePermissionCommand
+ */
+export const se_CreatePermissionCommand = async (
+  input: CreatePermissionCommandInput,
+  context: __SerdeContext
+): Promise<__HttpRequest> => {
+  const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+  const headers: any = {
+    "content-type": "application/json",
+  };
+  const resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/createpermission";
+  let body: any;
+  body = JSON.stringify(
+    take(input, {
+      clientToken: [],
+      name: [],
+      policyTemplate: [],
+      resourceType: [],
+      tags: (_) => _json(_),
+    })
+  );
+  return new __HttpRequest({
+    protocol,
+    hostname,
+    port,
+    method: "POST",
+    headers,
+    path: resolvedPath,
+    body,
+  });
+};
+
+/**
+ * serializeAws_restJson1CreatePermissionVersionCommand
+ */
+export const se_CreatePermissionVersionCommand = async (
+  input: CreatePermissionVersionCommandInput,
+  context: __SerdeContext
+): Promise<__HttpRequest> => {
+  const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+  const headers: any = {
+    "content-type": "application/json",
+  };
+  const resolvedPath =
+    `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/createpermissionversion";
+  let body: any;
+  body = JSON.stringify(
+    take(input, {
+      clientToken: [],
+      permissionArn: [],
+      policyTemplate: [],
+    })
+  );
+  return new __HttpRequest({
+    protocol,
+    hostname,
+    port,
+    method: "POST",
+    headers,
+    path: resolvedPath,
+    body,
+  });
+};
+
 /**
  * serializeAws_restJson1CreateResourceShareCommand
  */
@@ -264,6 +367,65 @@ export const se_CreateResourceShareCommand = async (
   });
 };
 
+/**
+ * serializeAws_restJson1DeletePermissionCommand
+ */
+export const se_DeletePermissionCommand = async (
+  input: DeletePermissionCommandInput,
+  context: __SerdeContext
+): Promise<__HttpRequest> => {
+  const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+  const headers: any = {};
+  const resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/deletepermission";
+  const query: any = map({
+    permissionArn: [, __expectNonNull(input.permissionArn!, `permissionArn`)],
+    clientToken: [, input.clientToken!],
+  });
+  let body: any;
+  return new __HttpRequest({
+    protocol,
+    hostname,
+    port,
+    method: "DELETE",
+    headers,
+    path: resolvedPath,
+    query,
+    body,
+  });
+};
+
+/**
+ * serializeAws_restJson1DeletePermissionVersionCommand
+ */
+export const se_DeletePermissionVersionCommand = async (
+  input: DeletePermissionVersionCommandInput,
+  context: __SerdeContext
+): Promise<__HttpRequest> => {
+  const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+  const headers: any = {};
+  const resolvedPath =
+    `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/deletepermissionversion";
+  const query: any = map({
+    permissionArn: [, __expectNonNull(input.permissionArn!, `permissionArn`)],
+    permissionVersion: [
+      __expectNonNull(input.permissionVersion, `permissionVersion`) != null,
+      () => input.permissionVersion!.toString(),
+    ],
+    clientToken: [, input.clientToken!],
+  });
+  let body: any;
+  return new __HttpRequest({
+    protocol,
+    hostname,
+    port,
+    method: "DELETE",
+    headers,
+    path: resolvedPath,
+    query,
+    body,
+  });
+};
+
 /**
  * serializeAws_restJson1DeleteResourceShareCommand
  */
@@ -532,6 +694,7 @@ export const se_GetResourceSharesCommand = async (
       name: [],
       nextToken: [],
       permissionArn: [],
+      permissionVersion: [],
       resourceOwner: [],
       resourceShareArns: (_) => _json(_),
       resourceShareStatus: [],
@@ -582,6 +745,43 @@ export const se_ListPendingInvitationResourcesCommand = async (
   });
 };
 
+/**
+ * serializeAws_restJson1ListPermissionAssociationsCommand
+ */
+export const se_ListPermissionAssociationsCommand = async (
+  input: ListPermissionAssociationsCommandInput,
+  context: __SerdeContext
+): Promise<__HttpRequest> => {
+  const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+  const headers: any = {
+    "content-type": "application/json",
+  };
+  const resolvedPath =
+    `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/listpermissionassociations";
+  let body: any;
+  body = JSON.stringify(
+    take(input, {
+      associationStatus: [],
+      defaultVersion: [],
+      featureSet: [],
+      maxResults: [],
+      nextToken: [],
+      permissionArn: [],
+      permissionVersion: [],
+      resourceType: [],
+    })
+  );
+  return new __HttpRequest({
+    protocol,
+    hostname,
+    port,
+    method: "POST",
+    headers,
+    path: resolvedPath,
+    body,
+  });
+};
+
 /**
  * serializeAws_restJson1ListPermissionsCommand
  */
@@ -599,6 +799,7 @@ export const se_ListPermissionsCommand = async (
     take(input, {
       maxResults: [],
       nextToken: [],
+      permissionType: [],
       resourceType: [],
     })
   );
@@ -680,6 +881,39 @@ export const se_ListPrincipalsCommand = async (
   });
 };
 
+/**
+ * serializeAws_restJson1ListReplacePermissionAssociationsWorkCommand
+ */
+export const se_ListReplacePermissionAssociationsWorkCommand = async (
+  input: ListReplacePermissionAssociationsWorkCommandInput,
+  context: __SerdeContext
+): Promise<__HttpRequest> => {
+  const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+  const headers: any = {
+    "content-type": "application/json",
+  };
+  const resolvedPath =
+    `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/listreplacepermissionassociationswork";
+  let body: any;
+  body = JSON.stringify(
+    take(input, {
+      maxResults: [],
+      nextToken: [],
+      status: [],
+      workIds: (_) => _json(_),
+    })
+  );
+  return new __HttpRequest({
+    protocol,
+    hostname,
+    port,
+    method: "POST",
+    headers,
+    path: resolvedPath,
+    body,
+  });
+};
+
 /**
  * serializeAws_restJson1ListResourcesCommand
  */
@@ -779,6 +1013,38 @@ export const se_ListResourceTypesCommand = async (
   });
 };
 
+/**
+ * serializeAws_restJson1PromotePermissionCreatedFromPolicyCommand
+ */
+export const se_PromotePermissionCreatedFromPolicyCommand = async (
+  input: PromotePermissionCreatedFromPolicyCommandInput,
+  context: __SerdeContext
+): Promise<__HttpRequest> => {
+  const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+  const headers: any = {
+    "content-type": "application/json",
+  };
+  const resolvedPath =
+    `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/promotepermissioncreatedfrompolicy";
+  let body: any;
+  body = JSON.stringify(
+    take(input, {
+      clientToken: [],
+      name: [],
+      permissionArn: [],
+    })
+  );
+  return new __HttpRequest({
+    protocol,
+    hostname,
+    port,
+    method: "POST",
+    headers,
+    path: resolvedPath,
+    body,
+  });
+};
+
 /**
  * serializeAws_restJson1PromoteResourceShareCreatedFromPolicyCommand
  */
@@ -837,6 +1103,71 @@ export const se_RejectResourceShareInvitationCommand = async (
   });
 };
 
+/**
+ * serializeAws_restJson1ReplacePermissionAssociationsCommand
+ */
+export const se_ReplacePermissionAssociationsCommand = async (
+  input: ReplacePermissionAssociationsCommandInput,
+  context: __SerdeContext
+): Promise<__HttpRequest> => {
+  const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+  const headers: any = {
+    "content-type": "application/json",
+  };
+  const resolvedPath =
+    `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/replacepermissionassociations";
+  let body: any;
+  body = JSON.stringify(
+    take(input, {
+      clientToken: [],
+      fromPermissionArn: [],
+      fromPermissionVersion: [],
+      toPermissionArn: [],
+    })
+  );
+  return new __HttpRequest({
+    protocol,
+    hostname,
+    port,
+    method: "POST",
+    headers,
+    path: resolvedPath,
+    body,
+  });
+};
+
+/**
+ * serializeAws_restJson1SetDefaultPermissionVersionCommand
+ */
+export const se_SetDefaultPermissionVersionCommand = async (
+  input: SetDefaultPermissionVersionCommandInput,
+  context: __SerdeContext
+): Promise<__HttpRequest> => {
+  const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+  const headers: any = {
+    "content-type": "application/json",
+  };
+  const resolvedPath =
+    `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/setdefaultpermissionversion";
+  let body: any;
+  body = JSON.stringify(
+    take(input, {
+      clientToken: [],
+      permissionArn: [],
+      permissionVersion: [],
+    })
+  );
+  return new __HttpRequest({
+    protocol,
+    hostname,
+    port,
+    method: "POST",
+    headers,
+    path: resolvedPath,
+    body,
+  });
+};
+
 /**
  * serializeAws_restJson1TagResourceCommand
  */
@@ -852,6 +1183,7 @@ export const se_TagResourceCommand = async (
   let body: any;
   body = JSON.stringify(
     take(input, {
+      resourceArn: [],
       resourceShareArn: [],
       tags: (_) => _json(_),
     })
@@ -882,6 +1214,7 @@ export const se_UntagResourceCommand = async (
   let body: any;
   body = JSON.stringify(
     take(input, {
+      resourceArn: [],
       resourceShareArn: [],
       tagKeys: (_) => _json(_),
     })
@@ -1149,14 +1482,14 @@ const de_AssociateResourceSharePermissionCommandError = async (
 };
 
 /**
- * deserializeAws_restJson1CreateResourceShareCommand
+ * deserializeAws_restJson1CreatePermissionCommand
  */
-export const de_CreateResourceShareCommand = async (
+export const de_CreatePermissionCommand = async (
   output: __HttpResponse,
   context: __SerdeContext
-): Promise<CreateResourceShareCommandOutput> => {
+): Promise<CreatePermissionCommandOutput> => {
   if (output.statusCode !== 200 && output.statusCode >= 300) {
-    return de_CreateResourceShareCommandError(output, context);
+    return de_CreatePermissionCommandError(output, context);
   }
   const contents: any = map({
     $metadata: deserializeMetadata(output),
@@ -1164,14 +1497,164 @@ export const de_CreateResourceShareCommand = async (
   const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
   const doc = take(data, {
     clientToken: __expectString,
-    resourceShare: (_) => de_ResourceShare(_, context),
+    permission: (_) => de_ResourceSharePermissionSummary(_, context),
   });
   Object.assign(contents, doc);
   return contents;
 };
 
 /**
- * deserializeAws_restJson1CreateResourceShareCommandError
+ * deserializeAws_restJson1CreatePermissionCommandError
+ */
+const de_CreatePermissionCommandError = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<CreatePermissionCommandOutput> => {
+  const parsedOutput: any = {
+    ...output,
+    body: await parseErrorBody(output.body, context),
+  };
+  const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+  switch (errorCode) {
+    case "IdempotentParameterMismatchException":
+    case "com.amazonaws.ram#IdempotentParameterMismatchException":
+      throw await de_IdempotentParameterMismatchExceptionRes(parsedOutput, context);
+    case "InvalidClientTokenException":
+    case "com.amazonaws.ram#InvalidClientTokenException":
+      throw await de_InvalidClientTokenExceptionRes(parsedOutput, context);
+    case "InvalidParameterException":
+    case "com.amazonaws.ram#InvalidParameterException":
+      throw await de_InvalidParameterExceptionRes(parsedOutput, context);
+    case "InvalidPolicyException":
+    case "com.amazonaws.ram#InvalidPolicyException":
+      throw await de_InvalidPolicyExceptionRes(parsedOutput, context);
+    case "MalformedPolicyTemplateException":
+    case "com.amazonaws.ram#MalformedPolicyTemplateException":
+      throw await de_MalformedPolicyTemplateExceptionRes(parsedOutput, context);
+    case "OperationNotPermittedException":
+    case "com.amazonaws.ram#OperationNotPermittedException":
+      throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
+    case "PermissionAlreadyExistsException":
+    case "com.amazonaws.ram#PermissionAlreadyExistsException":
+      throw await de_PermissionAlreadyExistsExceptionRes(parsedOutput, context);
+    case "PermissionLimitExceededException":
+    case "com.amazonaws.ram#PermissionLimitExceededException":
+      throw await de_PermissionLimitExceededExceptionRes(parsedOutput, context);
+    case "ServerInternalException":
+    case "com.amazonaws.ram#ServerInternalException":
+      throw await de_ServerInternalExceptionRes(parsedOutput, context);
+    case "ServiceUnavailableException":
+    case "com.amazonaws.ram#ServiceUnavailableException":
+      throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    default:
+      const parsedBody = parsedOutput.body;
+      return throwDefaultError({
+        output,
+        parsedBody,
+        errorCode,
+      });
+  }
+};
+
+/**
+ * deserializeAws_restJson1CreatePermissionVersionCommand
+ */
+export const de_CreatePermissionVersionCommand = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<CreatePermissionVersionCommandOutput> => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_CreatePermissionVersionCommandError(output, context);
+  }
+  const contents: any = map({
+    $metadata: deserializeMetadata(output),
+  });
+  const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+  const doc = take(data, {
+    clientToken: __expectString,
+    permission: (_) => de_ResourceSharePermissionDetail(_, context),
+  });
+  Object.assign(contents, doc);
+  return contents;
+};
+
+/**
+ * deserializeAws_restJson1CreatePermissionVersionCommandError
+ */
+const de_CreatePermissionVersionCommandError = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<CreatePermissionVersionCommandOutput> => {
+  const parsedOutput: any = {
+    ...output,
+    body: await parseErrorBody(output.body, context),
+  };
+  const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+  switch (errorCode) {
+    case "IdempotentParameterMismatchException":
+    case "com.amazonaws.ram#IdempotentParameterMismatchException":
+      throw await de_IdempotentParameterMismatchExceptionRes(parsedOutput, context);
+    case "InvalidClientTokenException":
+    case "com.amazonaws.ram#InvalidClientTokenException":
+      throw await de_InvalidClientTokenExceptionRes(parsedOutput, context);
+    case "InvalidParameterException":
+    case "com.amazonaws.ram#InvalidParameterException":
+      throw await de_InvalidParameterExceptionRes(parsedOutput, context);
+    case "InvalidPolicyException":
+    case "com.amazonaws.ram#InvalidPolicyException":
+      throw await de_InvalidPolicyExceptionRes(parsedOutput, context);
+    case "MalformedArnException":
+    case "com.amazonaws.ram#MalformedArnException":
+      throw await de_MalformedArnExceptionRes(parsedOutput, context);
+    case "MalformedPolicyTemplateException":
+    case "com.amazonaws.ram#MalformedPolicyTemplateException":
+      throw await de_MalformedPolicyTemplateExceptionRes(parsedOutput, context);
+    case "PermissionVersionsLimitExceededException":
+    case "com.amazonaws.ram#PermissionVersionsLimitExceededException":
+      throw await de_PermissionVersionsLimitExceededExceptionRes(parsedOutput, context);
+    case "ServerInternalException":
+    case "com.amazonaws.ram#ServerInternalException":
+      throw await de_ServerInternalExceptionRes(parsedOutput, context);
+    case "ServiceUnavailableException":
+    case "com.amazonaws.ram#ServiceUnavailableException":
+      throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    case "UnknownResourceException":
+    case "com.amazonaws.ram#UnknownResourceException":
+      throw await de_UnknownResourceExceptionRes(parsedOutput, context);
+    default:
+      const parsedBody = parsedOutput.body;
+      return throwDefaultError({
+        output,
+        parsedBody,
+        errorCode,
+      });
+  }
+};
+
+/**
+ * deserializeAws_restJson1CreateResourceShareCommand
+ */
+export const de_CreateResourceShareCommand = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<CreateResourceShareCommandOutput> => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_CreateResourceShareCommandError(output, context);
+  }
+  const contents: any = map({
+    $metadata: deserializeMetadata(output),
+  });
+  const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+  const doc = take(data, {
+    clientToken: __expectString,
+    resourceShare: (_) => de_ResourceShare(_, context),
+  });
+  Object.assign(contents, doc);
+  return contents;
+};
+
+/**
+ * deserializeAws_restJson1CreateResourceShareCommandError
  */
 const de_CreateResourceShareCommandError = async (
   output: __HttpResponse,
@@ -1226,6 +1709,143 @@ const de_CreateResourceShareCommandError = async (
   }
 };
 
+/**
+ * deserializeAws_restJson1DeletePermissionCommand
+ */
+export const de_DeletePermissionCommand = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<DeletePermissionCommandOutput> => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_DeletePermissionCommandError(output, context);
+  }
+  const contents: any = map({
+    $metadata: deserializeMetadata(output),
+  });
+  const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+  const doc = take(data, {
+    clientToken: __expectString,
+    permissionStatus: __expectString,
+    returnValue: __expectBoolean,
+  });
+  Object.assign(contents, doc);
+  return contents;
+};
+
+/**
+ * deserializeAws_restJson1DeletePermissionCommandError
+ */
+const de_DeletePermissionCommandError = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<DeletePermissionCommandOutput> => {
+  const parsedOutput: any = {
+    ...output,
+    body: await parseErrorBody(output.body, context),
+  };
+  const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+  switch (errorCode) {
+    case "IdempotentParameterMismatchException":
+    case "com.amazonaws.ram#IdempotentParameterMismatchException":
+      throw await de_IdempotentParameterMismatchExceptionRes(parsedOutput, context);
+    case "InvalidClientTokenException":
+    case "com.amazonaws.ram#InvalidClientTokenException":
+      throw await de_InvalidClientTokenExceptionRes(parsedOutput, context);
+    case "MalformedArnException":
+    case "com.amazonaws.ram#MalformedArnException":
+      throw await de_MalformedArnExceptionRes(parsedOutput, context);
+    case "OperationNotPermittedException":
+    case "com.amazonaws.ram#OperationNotPermittedException":
+      throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
+    case "ServerInternalException":
+    case "com.amazonaws.ram#ServerInternalException":
+      throw await de_ServerInternalExceptionRes(parsedOutput, context);
+    case "ServiceUnavailableException":
+    case "com.amazonaws.ram#ServiceUnavailableException":
+      throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    case "UnknownResourceException":
+    case "com.amazonaws.ram#UnknownResourceException":
+      throw await de_UnknownResourceExceptionRes(parsedOutput, context);
+    default:
+      const parsedBody = parsedOutput.body;
+      return throwDefaultError({
+        output,
+        parsedBody,
+        errorCode,
+      });
+  }
+};
+
+/**
+ * deserializeAws_restJson1DeletePermissionVersionCommand
+ */
+export const de_DeletePermissionVersionCommand = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<DeletePermissionVersionCommandOutput> => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_DeletePermissionVersionCommandError(output, context);
+  }
+  const contents: any = map({
+    $metadata: deserializeMetadata(output),
+  });
+  const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+  const doc = take(data, {
+    clientToken: __expectString,
+    permissionStatus: __expectString,
+    returnValue: __expectBoolean,
+  });
+  Object.assign(contents, doc);
+  return contents;
+};
+
+/**
+ * deserializeAws_restJson1DeletePermissionVersionCommandError
+ */
+const de_DeletePermissionVersionCommandError = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<DeletePermissionVersionCommandOutput> => {
+  const parsedOutput: any = {
+    ...output,
+    body: await parseErrorBody(output.body, context),
+  };
+  const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+  switch (errorCode) {
+    case "IdempotentParameterMismatchException":
+    case "com.amazonaws.ram#IdempotentParameterMismatchException":
+      throw await de_IdempotentParameterMismatchExceptionRes(parsedOutput, context);
+    case "InvalidClientTokenException":
+    case "com.amazonaws.ram#InvalidClientTokenException":
+      throw await de_InvalidClientTokenExceptionRes(parsedOutput, context);
+    case "InvalidParameterException":
+    case "com.amazonaws.ram#InvalidParameterException":
+      throw await de_InvalidParameterExceptionRes(parsedOutput, context);
+    case "MalformedArnException":
+    case "com.amazonaws.ram#MalformedArnException":
+      throw await de_MalformedArnExceptionRes(parsedOutput, context);
+    case "OperationNotPermittedException":
+    case "com.amazonaws.ram#OperationNotPermittedException":
+      throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
+    case "ServerInternalException":
+    case "com.amazonaws.ram#ServerInternalException":
+      throw await de_ServerInternalExceptionRes(parsedOutput, context);
+    case "ServiceUnavailableException":
+    case "com.amazonaws.ram#ServiceUnavailableException":
+      throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    case "UnknownResourceException":
+    case "com.amazonaws.ram#UnknownResourceException":
+      throw await de_UnknownResourceExceptionRes(parsedOutput, context);
+    default:
+      const parsedBody = parsedOutput.body;
+      return throwDefaultError({
+        output,
+        parsedBody,
+        errorCode,
+      });
+  }
+};
+
 /**
  * deserializeAws_restJson1DeleteResourceShareCommand
  */
@@ -1891,14 +2511,14 @@ const de_ListPendingInvitationResourcesCommandError = async (
 };
 
 /**
- * deserializeAws_restJson1ListPermissionsCommand
+ * deserializeAws_restJson1ListPermissionAssociationsCommand
  */
-export const de_ListPermissionsCommand = async (
+export const de_ListPermissionAssociationsCommand = async (
   output: __HttpResponse,
   context: __SerdeContext
-): Promise<ListPermissionsCommandOutput> => {
+): Promise<ListPermissionAssociationsCommandOutput> => {
   if (output.statusCode !== 200 && output.statusCode >= 300) {
-    return de_ListPermissionsCommandError(output, context);
+    return de_ListPermissionAssociationsCommandError(output, context);
   }
   const contents: any = map({
     $metadata: deserializeMetadata(output),
@@ -1906,19 +2526,19 @@ export const de_ListPermissionsCommand = async (
   const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
   const doc = take(data, {
     nextToken: __expectString,
-    permissions: (_) => de_ResourceSharePermissionList(_, context),
+    permissions: (_) => de_AssociatedPermissionList(_, context),
   });
   Object.assign(contents, doc);
   return contents;
 };
 
 /**
- * deserializeAws_restJson1ListPermissionsCommandError
+ * deserializeAws_restJson1ListPermissionAssociationsCommandError
  */
-const de_ListPermissionsCommandError = async (
+const de_ListPermissionAssociationsCommandError = async (
   output: __HttpResponse,
   context: __SerdeContext
-): Promise<ListPermissionsCommandOutput> => {
+): Promise<ListPermissionAssociationsCommandOutput> => {
   const parsedOutput: any = {
     ...output,
     body: await parseErrorBody(output.body, context),
@@ -1931,9 +2551,9 @@ const de_ListPermissionsCommandError = async (
     case "InvalidParameterException":
     case "com.amazonaws.ram#InvalidParameterException":
       throw await de_InvalidParameterExceptionRes(parsedOutput, context);
-    case "OperationNotPermittedException":
-    case "com.amazonaws.ram#OperationNotPermittedException":
-      throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
+    case "MalformedArnException":
+    case "com.amazonaws.ram#MalformedArnException":
+      throw await de_MalformedArnExceptionRes(parsedOutput, context);
     case "ServerInternalException":
     case "com.amazonaws.ram#ServerInternalException":
       throw await de_ServerInternalExceptionRes(parsedOutput, context);
@@ -1951,7 +2571,67 @@ const de_ListPermissionsCommandError = async (
 };
 
 /**
- * deserializeAws_restJson1ListPermissionVersionsCommand
+ * deserializeAws_restJson1ListPermissionsCommand
+ */
+export const de_ListPermissionsCommand = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<ListPermissionsCommandOutput> => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_ListPermissionsCommandError(output, context);
+  }
+  const contents: any = map({
+    $metadata: deserializeMetadata(output),
+  });
+  const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+  const doc = take(data, {
+    nextToken: __expectString,
+    permissions: (_) => de_ResourceSharePermissionList(_, context),
+  });
+  Object.assign(contents, doc);
+  return contents;
+};
+
+/**
+ * deserializeAws_restJson1ListPermissionsCommandError
+ */
+const de_ListPermissionsCommandError = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<ListPermissionsCommandOutput> => {
+  const parsedOutput: any = {
+    ...output,
+    body: await parseErrorBody(output.body, context),
+  };
+  const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+  switch (errorCode) {
+    case "InvalidNextTokenException":
+    case "com.amazonaws.ram#InvalidNextTokenException":
+      throw await de_InvalidNextTokenExceptionRes(parsedOutput, context);
+    case "InvalidParameterException":
+    case "com.amazonaws.ram#InvalidParameterException":
+      throw await de_InvalidParameterExceptionRes(parsedOutput, context);
+    case "OperationNotPermittedException":
+    case "com.amazonaws.ram#OperationNotPermittedException":
+      throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
+    case "ServerInternalException":
+    case "com.amazonaws.ram#ServerInternalException":
+      throw await de_ServerInternalExceptionRes(parsedOutput, context);
+    case "ServiceUnavailableException":
+    case "com.amazonaws.ram#ServiceUnavailableException":
+      throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    default:
+      const parsedBody = parsedOutput.body;
+      return throwDefaultError({
+        output,
+        parsedBody,
+        errorCode,
+      });
+  }
+};
+
+/**
+ * deserializeAws_restJson1ListPermissionVersionsCommand
  */
 export const de_ListPermissionVersionsCommand = async (
   output: __HttpResponse,
@@ -2079,6 +2759,63 @@ const de_ListPrincipalsCommandError = async (
   }
 };
 
+/**
+ * deserializeAws_restJson1ListReplacePermissionAssociationsWorkCommand
+ */
+export const de_ListReplacePermissionAssociationsWorkCommand = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<ListReplacePermissionAssociationsWorkCommandOutput> => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_ListReplacePermissionAssociationsWorkCommandError(output, context);
+  }
+  const contents: any = map({
+    $metadata: deserializeMetadata(output),
+  });
+  const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+  const doc = take(data, {
+    nextToken: __expectString,
+    replacePermissionAssociationsWorks: (_) => de_ReplacePermissionAssociationsWorkList(_, context),
+  });
+  Object.assign(contents, doc);
+  return contents;
+};
+
+/**
+ * deserializeAws_restJson1ListReplacePermissionAssociationsWorkCommandError
+ */
+const de_ListReplacePermissionAssociationsWorkCommandError = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<ListReplacePermissionAssociationsWorkCommandOutput> => {
+  const parsedOutput: any = {
+    ...output,
+    body: await parseErrorBody(output.body, context),
+  };
+  const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+  switch (errorCode) {
+    case "InvalidNextTokenException":
+    case "com.amazonaws.ram#InvalidNextTokenException":
+      throw await de_InvalidNextTokenExceptionRes(parsedOutput, context);
+    case "InvalidParameterException":
+    case "com.amazonaws.ram#InvalidParameterException":
+      throw await de_InvalidParameterExceptionRes(parsedOutput, context);
+    case "ServerInternalException":
+    case "com.amazonaws.ram#ServerInternalException":
+      throw await de_ServerInternalExceptionRes(parsedOutput, context);
+    case "ServiceUnavailableException":
+    case "com.amazonaws.ram#ServiceUnavailableException":
+      throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    default:
+      const parsedBody = parsedOutput.body;
+      return throwDefaultError({
+        output,
+        parsedBody,
+        errorCode,
+      });
+  }
+};
+
 /**
  * deserializeAws_restJson1ListResourcesCommand
  */
@@ -2212,46 +2949,261 @@ const de_ListResourceSharePermissionsCommandError = async (
 };
 
 /**
- * deserializeAws_restJson1ListResourceTypesCommand
+ * deserializeAws_restJson1ListResourceTypesCommand
+ */
+export const de_ListResourceTypesCommand = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<ListResourceTypesCommandOutput> => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_ListResourceTypesCommandError(output, context);
+  }
+  const contents: any = map({
+    $metadata: deserializeMetadata(output),
+  });
+  const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+  const doc = take(data, {
+    nextToken: __expectString,
+    resourceTypes: _json,
+  });
+  Object.assign(contents, doc);
+  return contents;
+};
+
+/**
+ * deserializeAws_restJson1ListResourceTypesCommandError
+ */
+const de_ListResourceTypesCommandError = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<ListResourceTypesCommandOutput> => {
+  const parsedOutput: any = {
+    ...output,
+    body: await parseErrorBody(output.body, context),
+  };
+  const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+  switch (errorCode) {
+    case "InvalidNextTokenException":
+    case "com.amazonaws.ram#InvalidNextTokenException":
+      throw await de_InvalidNextTokenExceptionRes(parsedOutput, context);
+    case "InvalidParameterException":
+    case "com.amazonaws.ram#InvalidParameterException":
+      throw await de_InvalidParameterExceptionRes(parsedOutput, context);
+    case "ServerInternalException":
+    case "com.amazonaws.ram#ServerInternalException":
+      throw await de_ServerInternalExceptionRes(parsedOutput, context);
+    case "ServiceUnavailableException":
+    case "com.amazonaws.ram#ServiceUnavailableException":
+      throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    default:
+      const parsedBody = parsedOutput.body;
+      return throwDefaultError({
+        output,
+        parsedBody,
+        errorCode,
+      });
+  }
+};
+
+/**
+ * deserializeAws_restJson1PromotePermissionCreatedFromPolicyCommand
+ */
+export const de_PromotePermissionCreatedFromPolicyCommand = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<PromotePermissionCreatedFromPolicyCommandOutput> => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_PromotePermissionCreatedFromPolicyCommandError(output, context);
+  }
+  const contents: any = map({
+    $metadata: deserializeMetadata(output),
+  });
+  const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+  const doc = take(data, {
+    clientToken: __expectString,
+    permission: (_) => de_ResourceSharePermissionSummary(_, context),
+  });
+  Object.assign(contents, doc);
+  return contents;
+};
+
+/**
+ * deserializeAws_restJson1PromotePermissionCreatedFromPolicyCommandError
+ */
+const de_PromotePermissionCreatedFromPolicyCommandError = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<PromotePermissionCreatedFromPolicyCommandOutput> => {
+  const parsedOutput: any = {
+    ...output,
+    body: await parseErrorBody(output.body, context),
+  };
+  const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+  switch (errorCode) {
+    case "InvalidParameterException":
+    case "com.amazonaws.ram#InvalidParameterException":
+      throw await de_InvalidParameterExceptionRes(parsedOutput, context);
+    case "MalformedArnException":
+    case "com.amazonaws.ram#MalformedArnException":
+      throw await de_MalformedArnExceptionRes(parsedOutput, context);
+    case "MissingRequiredParameterException":
+    case "com.amazonaws.ram#MissingRequiredParameterException":
+      throw await de_MissingRequiredParameterExceptionRes(parsedOutput, context);
+    case "OperationNotPermittedException":
+    case "com.amazonaws.ram#OperationNotPermittedException":
+      throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
+    case "ServerInternalException":
+    case "com.amazonaws.ram#ServerInternalException":
+      throw await de_ServerInternalExceptionRes(parsedOutput, context);
+    case "ServiceUnavailableException":
+    case "com.amazonaws.ram#ServiceUnavailableException":
+      throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    case "UnknownResourceException":
+    case "com.amazonaws.ram#UnknownResourceException":
+      throw await de_UnknownResourceExceptionRes(parsedOutput, context);
+    default:
+      const parsedBody = parsedOutput.body;
+      return throwDefaultError({
+        output,
+        parsedBody,
+        errorCode,
+      });
+  }
+};
+
+/**
+ * deserializeAws_restJson1PromoteResourceShareCreatedFromPolicyCommand
+ */
+export const de_PromoteResourceShareCreatedFromPolicyCommand = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<PromoteResourceShareCreatedFromPolicyCommandOutput> => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_PromoteResourceShareCreatedFromPolicyCommandError(output, context);
+  }
+  const contents: any = map({
+    $metadata: deserializeMetadata(output),
+  });
+  const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+  const doc = take(data, {
+    returnValue: __expectBoolean,
+  });
+  Object.assign(contents, doc);
+  return contents;
+};
+
+/**
+ * deserializeAws_restJson1PromoteResourceShareCreatedFromPolicyCommandError
+ */
+const de_PromoteResourceShareCreatedFromPolicyCommandError = async (
+  output: __HttpResponse,
+  context: __SerdeContext
+): Promise<PromoteResourceShareCreatedFromPolicyCommandOutput> => {
+  const parsedOutput: any = {
+    ...output,
+    body: await parseErrorBody(output.body, context),
+  };
+  const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+  switch (errorCode) {
+    case "InvalidParameterException":
+    case "com.amazonaws.ram#InvalidParameterException":
+      throw await de_InvalidParameterExceptionRes(parsedOutput, context);
+    case "InvalidStateTransitionException":
+    case "com.amazonaws.ram#InvalidStateTransitionException":
+      throw await de_InvalidStateTransitionExceptionRes(parsedOutput, context);
+    case "MalformedArnException":
+    case "com.amazonaws.ram#MalformedArnException":
+      throw await de_MalformedArnExceptionRes(parsedOutput, context);
+    case "MissingRequiredParameterException":
+    case "com.amazonaws.ram#MissingRequiredParameterException":
+      throw await de_MissingRequiredParameterExceptionRes(parsedOutput, context);
+    case "OperationNotPermittedException":
+    case "com.amazonaws.ram#OperationNotPermittedException":
+      throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
+    case "ResourceShareLimitExceededException":
+    case "com.amazonaws.ram#ResourceShareLimitExceededException":
+      throw await de_ResourceShareLimitExceededExceptionRes(parsedOutput, context);
+    case "ServerInternalException":
+    case "com.amazonaws.ram#ServerInternalException":
+      throw await de_ServerInternalExceptionRes(parsedOutput, context);
+    case "ServiceUnavailableException":
+    case "com.amazonaws.ram#ServiceUnavailableException":
+      throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    case "UnknownResourceException":
+    case "com.amazonaws.ram#UnknownResourceException":
+      throw await de_UnknownResourceExceptionRes(parsedOutput, context);
+    case "UnmatchedPolicyPermissionException":
+    case "com.amazonaws.ram#UnmatchedPolicyPermissionException":
+      throw await de_UnmatchedPolicyPermissionExceptionRes(parsedOutput, context);
+    default:
+      const parsedBody = parsedOutput.body;
+      return throwDefaultError({
+        output,
+        parsedBody,
+        errorCode,
+      });
+  }
+};
+
+/**
+ * deserializeAws_restJson1RejectResourceShareInvitationCommand
  */
-export const de_ListResourceTypesCommand = async (
+export const de_RejectResourceShareInvitationCommand = async (
   output: __HttpResponse,
   context: __SerdeContext
-): Promise<ListResourceTypesCommandOutput> => {
+): Promise<RejectResourceShareInvitationCommandOutput> => {
   if (output.statusCode !== 200 && output.statusCode >= 300) {
-    return de_ListResourceTypesCommandError(output, context);
+    return de_RejectResourceShareInvitationCommandError(output, context);
   }
   const contents: any = map({
     $metadata: deserializeMetadata(output),
   });
   const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
   const doc = take(data, {
-    nextToken: __expectString,
-    resourceTypes: _json,
+    clientToken: __expectString,
+    resourceShareInvitation: (_) => de_ResourceShareInvitation(_, context),
   });
   Object.assign(contents, doc);
   return contents;
 };
 
 /**
- * deserializeAws_restJson1ListResourceTypesCommandError
+ * deserializeAws_restJson1RejectResourceShareInvitationCommandError
  */
-const de_ListResourceTypesCommandError = async (
+const de_RejectResourceShareInvitationCommandError = async (
   output: __HttpResponse,
   context: __SerdeContext
-): Promise<ListResourceTypesCommandOutput> => {
+): Promise<RejectResourceShareInvitationCommandOutput> => {
   const parsedOutput: any = {
     ...output,
     body: await parseErrorBody(output.body, context),
   };
   const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
   switch (errorCode) {
-    case "InvalidNextTokenException":
-    case "com.amazonaws.ram#InvalidNextTokenException":
-      throw await de_InvalidNextTokenExceptionRes(parsedOutput, context);
-    case "InvalidParameterException":
-    case "com.amazonaws.ram#InvalidParameterException":
-      throw await de_InvalidParameterExceptionRes(parsedOutput, context);
+    case "IdempotentParameterMismatchException":
+    case "com.amazonaws.ram#IdempotentParameterMismatchException":
+      throw await de_IdempotentParameterMismatchExceptionRes(parsedOutput, context);
+    case "InvalidClientTokenException":
+    case "com.amazonaws.ram#InvalidClientTokenException":
+      throw await de_InvalidClientTokenExceptionRes(parsedOutput, context);
+    case "MalformedArnException":
+    case "com.amazonaws.ram#MalformedArnException":
+      throw await de_MalformedArnExceptionRes(parsedOutput, context);
+    case "OperationNotPermittedException":
+    case "com.amazonaws.ram#OperationNotPermittedException":
+      throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
+    case "ResourceShareInvitationAlreadyAcceptedException":
+    case "com.amazonaws.ram#ResourceShareInvitationAlreadyAcceptedException":
+      throw await de_ResourceShareInvitationAlreadyAcceptedExceptionRes(parsedOutput, context);
+    case "ResourceShareInvitationAlreadyRejectedException":
+    case "com.amazonaws.ram#ResourceShareInvitationAlreadyRejectedException":
+      throw await de_ResourceShareInvitationAlreadyRejectedExceptionRes(parsedOutput, context);
+    case "ResourceShareInvitationArnNotFoundException":
+    case "com.amazonaws.ram#ResourceShareInvitationArnNotFoundException":
+      throw await de_ResourceShareInvitationArnNotFoundExceptionRes(parsedOutput, context);
+    case "ResourceShareInvitationExpiredException":
+    case "com.amazonaws.ram#ResourceShareInvitationExpiredException":
+      throw await de_ResourceShareInvitationExpiredExceptionRes(parsedOutput, context);
     case "ServerInternalException":
     case "com.amazonaws.ram#ServerInternalException":
       throw await de_ServerInternalExceptionRes(parsedOutput, context);
@@ -2269,54 +3221,55 @@ const de_ListResourceTypesCommandError = async (
 };
 
 /**
- * deserializeAws_restJson1PromoteResourceShareCreatedFromPolicyCommand
+ * deserializeAws_restJson1ReplacePermissionAssociationsCommand
  */
-export const de_PromoteResourceShareCreatedFromPolicyCommand = async (
+export const de_ReplacePermissionAssociationsCommand = async (
   output: __HttpResponse,
   context: __SerdeContext
-): Promise<PromoteResourceShareCreatedFromPolicyCommandOutput> => {
+): Promise<ReplacePermissionAssociationsCommandOutput> => {
   if (output.statusCode !== 200 && output.statusCode >= 300) {
-    return de_PromoteResourceShareCreatedFromPolicyCommandError(output, context);
+    return de_ReplacePermissionAssociationsCommandError(output, context);
   }
   const contents: any = map({
     $metadata: deserializeMetadata(output),
   });
   const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
   const doc = take(data, {
-    returnValue: __expectBoolean,
+    clientToken: __expectString,
+    replacePermissionAssociationsWork: (_) => de_ReplacePermissionAssociationsWork(_, context),
   });
   Object.assign(contents, doc);
   return contents;
 };
 
 /**
- * deserializeAws_restJson1PromoteResourceShareCreatedFromPolicyCommandError
+ * deserializeAws_restJson1ReplacePermissionAssociationsCommandError
  */
-const de_PromoteResourceShareCreatedFromPolicyCommandError = async (
+const de_ReplacePermissionAssociationsCommandError = async (
   output: __HttpResponse,
   context: __SerdeContext
-): Promise<PromoteResourceShareCreatedFromPolicyCommandOutput> => {
+): Promise<ReplacePermissionAssociationsCommandOutput> => {
   const parsedOutput: any = {
     ...output,
     body: await parseErrorBody(output.body, context),
   };
   const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
   switch (errorCode) {
+    case "IdempotentParameterMismatchException":
+    case "com.amazonaws.ram#IdempotentParameterMismatchException":
+      throw await de_IdempotentParameterMismatchExceptionRes(parsedOutput, context);
+    case "InvalidClientTokenException":
+    case "com.amazonaws.ram#InvalidClientTokenException":
+      throw await de_InvalidClientTokenExceptionRes(parsedOutput, context);
     case "InvalidParameterException":
     case "com.amazonaws.ram#InvalidParameterException":
       throw await de_InvalidParameterExceptionRes(parsedOutput, context);
     case "MalformedArnException":
     case "com.amazonaws.ram#MalformedArnException":
       throw await de_MalformedArnExceptionRes(parsedOutput, context);
-    case "MissingRequiredParameterException":
-    case "com.amazonaws.ram#MissingRequiredParameterException":
-      throw await de_MissingRequiredParameterExceptionRes(parsedOutput, context);
     case "OperationNotPermittedException":
     case "com.amazonaws.ram#OperationNotPermittedException":
       throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
-    case "ResourceShareLimitExceededException":
-    case "com.amazonaws.ram#ResourceShareLimitExceededException":
-      throw await de_ResourceShareLimitExceededExceptionRes(parsedOutput, context);
     case "ServerInternalException":
     case "com.amazonaws.ram#ServerInternalException":
       throw await de_ServerInternalExceptionRes(parsedOutput, context);
@@ -2337,14 +3290,14 @@ const de_PromoteResourceShareCreatedFromPolicyCommandError = async (
 };
 
 /**
- * deserializeAws_restJson1RejectResourceShareInvitationCommand
+ * deserializeAws_restJson1SetDefaultPermissionVersionCommand
  */
-export const de_RejectResourceShareInvitationCommand = async (
+export const de_SetDefaultPermissionVersionCommand = async (
   output: __HttpResponse,
   context: __SerdeContext
-): Promise<RejectResourceShareInvitationCommandOutput> => {
+): Promise<SetDefaultPermissionVersionCommandOutput> => {
   if (output.statusCode !== 200 && output.statusCode >= 300) {
-    return de_RejectResourceShareInvitationCommandError(output, context);
+    return de_SetDefaultPermissionVersionCommandError(output, context);
   }
   const contents: any = map({
     $metadata: deserializeMetadata(output),
@@ -2352,19 +3305,19 @@ export const de_RejectResourceShareInvitationCommand = async (
   const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
   const doc = take(data, {
     clientToken: __expectString,
-    resourceShareInvitation: (_) => de_ResourceShareInvitation(_, context),
+    returnValue: __expectBoolean,
   });
   Object.assign(contents, doc);
   return contents;
 };
 
 /**
- * deserializeAws_restJson1RejectResourceShareInvitationCommandError
+ * deserializeAws_restJson1SetDefaultPermissionVersionCommandError
  */
-const de_RejectResourceShareInvitationCommandError = async (
+const de_SetDefaultPermissionVersionCommandError = async (
   output: __HttpResponse,
   context: __SerdeContext
-): Promise<RejectResourceShareInvitationCommandOutput> => {
+): Promise<SetDefaultPermissionVersionCommandOutput> => {
   const parsedOutput: any = {
     ...output,
     body: await parseErrorBody(output.body, context),
@@ -2377,30 +3330,21 @@ const de_RejectResourceShareInvitationCommandError = async (
     case "InvalidClientTokenException":
     case "com.amazonaws.ram#InvalidClientTokenException":
       throw await de_InvalidClientTokenExceptionRes(parsedOutput, context);
+    case "InvalidParameterException":
+    case "com.amazonaws.ram#InvalidParameterException":
+      throw await de_InvalidParameterExceptionRes(parsedOutput, context);
     case "MalformedArnException":
     case "com.amazonaws.ram#MalformedArnException":
       throw await de_MalformedArnExceptionRes(parsedOutput, context);
-    case "OperationNotPermittedException":
-    case "com.amazonaws.ram#OperationNotPermittedException":
-      throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
-    case "ResourceShareInvitationAlreadyAcceptedException":
-    case "com.amazonaws.ram#ResourceShareInvitationAlreadyAcceptedException":
-      throw await de_ResourceShareInvitationAlreadyAcceptedExceptionRes(parsedOutput, context);
-    case "ResourceShareInvitationAlreadyRejectedException":
-    case "com.amazonaws.ram#ResourceShareInvitationAlreadyRejectedException":
-      throw await de_ResourceShareInvitationAlreadyRejectedExceptionRes(parsedOutput, context);
-    case "ResourceShareInvitationArnNotFoundException":
-    case "com.amazonaws.ram#ResourceShareInvitationArnNotFoundException":
-      throw await de_ResourceShareInvitationArnNotFoundExceptionRes(parsedOutput, context);
-    case "ResourceShareInvitationExpiredException":
-    case "com.amazonaws.ram#ResourceShareInvitationExpiredException":
-      throw await de_ResourceShareInvitationExpiredExceptionRes(parsedOutput, context);
     case "ServerInternalException":
     case "com.amazonaws.ram#ServerInternalException":
       throw await de_ServerInternalExceptionRes(parsedOutput, context);
     case "ServiceUnavailableException":
     case "com.amazonaws.ram#ServiceUnavailableException":
       throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    case "UnknownResourceException":
+    case "com.amazonaws.ram#UnknownResourceException":
+      throw await de_UnknownResourceExceptionRes(parsedOutput, context);
     default:
       const parsedBody = parsedOutput.body;
       return throwDefaultError({
@@ -2508,12 +3452,18 @@ const de_UntagResourceCommandError = async (
     case "InvalidParameterException":
     case "com.amazonaws.ram#InvalidParameterException":
       throw await de_InvalidParameterExceptionRes(parsedOutput, context);
+    case "MalformedArnException":
+    case "com.amazonaws.ram#MalformedArnException":
+      throw await de_MalformedArnExceptionRes(parsedOutput, context);
     case "ServerInternalException":
     case "com.amazonaws.ram#ServerInternalException":
       throw await de_ServerInternalExceptionRes(parsedOutput, context);
     case "ServiceUnavailableException":
     case "com.amazonaws.ram#ServiceUnavailableException":
       throw await de_ServiceUnavailableExceptionRes(parsedOutput, context);
+    case "UnknownResourceException":
+    case "com.amazonaws.ram#UnknownResourceException":
+      throw await de_UnknownResourceExceptionRes(parsedOutput, context);
     default:
       const parsedBody = parsedOutput.body;
       return throwDefaultError({
@@ -2697,6 +3647,26 @@ const de_InvalidParameterExceptionRes = async (
   return __decorateServiceException(exception, parsedOutput.body);
 };
 
+/**
+ * deserializeAws_restJson1InvalidPolicyExceptionRes
+ */
+const de_InvalidPolicyExceptionRes = async (
+  parsedOutput: any,
+  context: __SerdeContext
+): Promise<InvalidPolicyException> => {
+  const contents: any = map({});
+  const data: any = parsedOutput.body;
+  const doc = take(data, {
+    message: __expectString,
+  });
+  Object.assign(contents, doc);
+  const exception = new InvalidPolicyException({
+    $metadata: deserializeMetadata(parsedOutput),
+    ...contents,
+  });
+  return __decorateServiceException(exception, parsedOutput.body);
+};
+
 /**
  * deserializeAws_restJson1InvalidResourceTypeExceptionRes
  */
@@ -2757,6 +3727,26 @@ const de_MalformedArnExceptionRes = async (
   return __decorateServiceException(exception, parsedOutput.body);
 };
 
+/**
+ * deserializeAws_restJson1MalformedPolicyTemplateExceptionRes
+ */
+const de_MalformedPolicyTemplateExceptionRes = async (
+  parsedOutput: any,
+  context: __SerdeContext
+): Promise<MalformedPolicyTemplateException> => {
+  const contents: any = map({});
+  const data: any = parsedOutput.body;
+  const doc = take(data, {
+    message: __expectString,
+  });
+  Object.assign(contents, doc);
+  const exception = new MalformedPolicyTemplateException({
+    $metadata: deserializeMetadata(parsedOutput),
+    ...contents,
+  });
+  return __decorateServiceException(exception, parsedOutput.body);
+};
+
 /**
  * deserializeAws_restJson1MissingRequiredParameterExceptionRes
  */
@@ -2797,6 +3787,66 @@ const de_OperationNotPermittedExceptionRes = async (
   return __decorateServiceException(exception, parsedOutput.body);
 };
 
+/**
+ * deserializeAws_restJson1PermissionAlreadyExistsExceptionRes
+ */
+const de_PermissionAlreadyExistsExceptionRes = async (
+  parsedOutput: any,
+  context: __SerdeContext
+): Promise<PermissionAlreadyExistsException> => {
+  const contents: any = map({});
+  const data: any = parsedOutput.body;
+  const doc = take(data, {
+    message: __expectString,
+  });
+  Object.assign(contents, doc);
+  const exception = new PermissionAlreadyExistsException({
+    $metadata: deserializeMetadata(parsedOutput),
+    ...contents,
+  });
+  return __decorateServiceException(exception, parsedOutput.body);
+};
+
+/**
+ * deserializeAws_restJson1PermissionLimitExceededExceptionRes
+ */
+const de_PermissionLimitExceededExceptionRes = async (
+  parsedOutput: any,
+  context: __SerdeContext
+): Promise<PermissionLimitExceededException> => {
+  const contents: any = map({});
+  const data: any = parsedOutput.body;
+  const doc = take(data, {
+    message: __expectString,
+  });
+  Object.assign(contents, doc);
+  const exception = new PermissionLimitExceededException({
+    $metadata: deserializeMetadata(parsedOutput),
+    ...contents,
+  });
+  return __decorateServiceException(exception, parsedOutput.body);
+};
+
+/**
+ * deserializeAws_restJson1PermissionVersionsLimitExceededExceptionRes
+ */
+const de_PermissionVersionsLimitExceededExceptionRes = async (
+  parsedOutput: any,
+  context: __SerdeContext
+): Promise<PermissionVersionsLimitExceededException> => {
+  const contents: any = map({});
+  const data: any = parsedOutput.body;
+  const doc = take(data, {
+    message: __expectString,
+  });
+  Object.assign(contents, doc);
+  const exception = new PermissionVersionsLimitExceededException({
+    $metadata: deserializeMetadata(parsedOutput),
+    ...contents,
+  });
+  return __decorateServiceException(exception, parsedOutput.body);
+};
+
 /**
  * deserializeAws_restJson1ResourceArnNotFoundExceptionRes
  */
@@ -3034,10 +4084,32 @@ const de_UnknownResourceExceptionRes = async (
   return __decorateServiceException(exception, parsedOutput.body);
 };
 
+/**
+ * deserializeAws_restJson1UnmatchedPolicyPermissionExceptionRes
+ */
+const de_UnmatchedPolicyPermissionExceptionRes = async (
+  parsedOutput: any,
+  context: __SerdeContext
+): Promise<UnmatchedPolicyPermissionException> => {
+  const contents: any = map({});
+  const data: any = parsedOutput.body;
+  const doc = take(data, {
+    message: __expectString,
+  });
+  Object.assign(contents, doc);
+  const exception = new UnmatchedPolicyPermissionException({
+    $metadata: deserializeMetadata(parsedOutput),
+    ...contents,
+  });
+  return __decorateServiceException(exception, parsedOutput.body);
+};
+
 // se_PermissionArnList omitted.
 
 // se_PrincipalArnOrIdList omitted.
 
+// se_ReplacePermissionAssociationsWorkIdList omitted.
+
 // se_ResourceArnList omitted.
 
 // se_ResourceShareArnList omitted.
@@ -3056,6 +4128,34 @@ const de_UnknownResourceExceptionRes = async (
 
 // se_TagValueList omitted.
 
+/**
+ * deserializeAws_restJson1AssociatedPermission
+ */
+const de_AssociatedPermission = (output: any, context: __SerdeContext): AssociatedPermission => {
+  return take(output, {
+    arn: __expectString,
+    defaultVersion: __expectBoolean,
+    featureSet: __expectString,
+    lastUpdatedTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
+    permissionVersion: __expectString,
+    resourceShareArn: __expectString,
+    resourceType: __expectString,
+    status: __expectString,
+  }) as any;
+};
+
+/**
+ * deserializeAws_restJson1AssociatedPermissionList
+ */
+const de_AssociatedPermissionList = (output: any, context: __SerdeContext): AssociatedPermission[] => {
+  const retVal = (output || [])
+    .filter((e: any) => e != null)
+    .map((entry: any) => {
+      return de_AssociatedPermission(entry, context);
+    });
+  return retVal;
+};
+
 // de_PolicyList omitted.
 
 /**
@@ -3083,6 +4183,41 @@ const de_PrincipalList = (output: any, context: __SerdeContext): Principal[] =>
   return retVal;
 };
 
+/**
+ * deserializeAws_restJson1ReplacePermissionAssociationsWork
+ */
+const de_ReplacePermissionAssociationsWork = (
+  output: any,
+  context: __SerdeContext
+): ReplacePermissionAssociationsWork => {
+  return take(output, {
+    creationTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
+    fromPermissionArn: __expectString,
+    fromPermissionVersion: __expectString,
+    id: __expectString,
+    lastUpdatedTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
+    status: __expectString,
+    statusMessage: __expectString,
+    toPermissionArn: __expectString,
+    toPermissionVersion: __expectString,
+  }) as any;
+};
+
+/**
+ * deserializeAws_restJson1ReplacePermissionAssociationsWorkList
+ */
+const de_ReplacePermissionAssociationsWorkList = (
+  output: any,
+  context: __SerdeContext
+): ReplacePermissionAssociationsWork[] => {
+  const retVal = (output || [])
+    .filter((e: any) => e != null)
+    .map((entry: any) => {
+      return de_ReplacePermissionAssociationsWork(entry, context);
+    });
+  return retVal;
+};
+
 /**
  * deserializeAws_restJson1Resource
  */
@@ -3208,11 +4343,15 @@ const de_ResourceSharePermissionDetail = (output: any, context: __SerdeContext):
     arn: __expectString,
     creationTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
     defaultVersion: __expectBoolean,
+    featureSet: __expectString,
     isResourceTypeDefault: __expectBoolean,
     lastUpdatedTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
     name: __expectString,
     permission: __expectString,
+    permissionType: __expectString,
     resourceType: __expectString,
+    status: __expectString,
+    tags: _json,
     version: __expectString,
   }) as any;
 };
@@ -3237,11 +4376,14 @@ const de_ResourceSharePermissionSummary = (output: any, context: __SerdeContext)
     arn: __expectString,
     creationTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
     defaultVersion: __expectBoolean,
+    featureSet: __expectString,
     isResourceTypeDefault: __expectBoolean,
     lastUpdatedTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
     name: __expectString,
+    permissionType: __expectString,
     resourceType: __expectString,
     status: __expectString,
+    tags: _json,
     version: __expectString,
   }) as any;
 };
diff --git a/codegen/sdk-codegen/aws-models/ram.json b/codegen/sdk-codegen/aws-models/ram.json
index 0360f32add6f..128cce5c7579 100644
--- a/codegen/sdk-codegen/aws-models/ram.json
+++ b/codegen/sdk-codegen/aws-models/ram.json
@@ -84,16 +84,19 @@
         "resourceShareInvitationArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the invitation that you want to accept.</p>",
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the invitation that you want to accept.</p>",
             "smithy.api#required": {}
           }
         },
         "clientToken": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>"
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#AcceptResourceShareInvitationResponse": {
@@ -111,6 +114,9 @@
             "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#AmazonResourceSharing": {
@@ -126,9 +132,21 @@
         {
           "target": "com.amazonaws.ram#AssociateResourceSharePermission"
         },
+        {
+          "target": "com.amazonaws.ram#CreatePermission"
+        },
+        {
+          "target": "com.amazonaws.ram#CreatePermissionVersion"
+        },
         {
           "target": "com.amazonaws.ram#CreateResourceShare"
         },
+        {
+          "target": "com.amazonaws.ram#DeletePermission"
+        },
+        {
+          "target": "com.amazonaws.ram#DeletePermissionVersion"
+        },
         {
           "target": "com.amazonaws.ram#DeleteResourceShare"
         },
@@ -159,6 +177,9 @@
         {
           "target": "com.amazonaws.ram#ListPendingInvitationResources"
         },
+        {
+          "target": "com.amazonaws.ram#ListPermissionAssociations"
+        },
         {
           "target": "com.amazonaws.ram#ListPermissions"
         },
@@ -168,6 +189,9 @@
         {
           "target": "com.amazonaws.ram#ListPrincipals"
         },
+        {
+          "target": "com.amazonaws.ram#ListReplacePermissionAssociationsWork"
+        },
         {
           "target": "com.amazonaws.ram#ListResources"
         },
@@ -177,12 +201,21 @@
         {
           "target": "com.amazonaws.ram#ListResourceTypes"
         },
+        {
+          "target": "com.amazonaws.ram#PromotePermissionCreatedFromPolicy"
+        },
         {
           "target": "com.amazonaws.ram#PromoteResourceShareCreatedFromPolicy"
         },
         {
           "target": "com.amazonaws.ram#RejectResourceShareInvitation"
         },
+        {
+          "target": "com.amazonaws.ram#ReplacePermissionAssociations"
+        },
+        {
+          "target": "com.amazonaws.ram#SetDefaultPermissionVersion"
+        },
         {
           "target": "com.amazonaws.ram#TagResource"
         },
@@ -205,14 +238,14 @@
           "name": "ram"
         },
         "aws.protocols#restJson1": {},
-        "smithy.api#documentation": "<p>This is the <i>Resource Access Manager API Reference</i>. This documentation provides\n            descriptions and syntax for each of the actions and data types in RAM. RAM is a\n            service that helps you securely share your Amazon Web Services resources across Amazon Web Services accounts. If you\n            have multiple Amazon Web Services accounts, you can use RAM to share those resources with other\n            accounts. If you use Organizations to manage your accounts, then you share your resources\n            with your organization or organizational units (OUs). For supported resource types, you\n            can also share resources with individual Identity and Access Management (IAM) roles an users. </p>\n         <p>To learn more about RAM, see the following resources:</p>\n         <ul>\n            <li>\n               <p>\n                  <a href=\"http://aws.amazon.com/ram\">Resource Access Manager product page</a>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <a href=\"https://docs.aws.amazon.com/ram/latest/userguide/\">Resource Access Manager User\n                        Guide</a>\n               </p>\n            </li>\n         </ul>",
+        "smithy.api#documentation": "<p>This is the <i>Resource Access Manager API Reference</i>. This documentation provides\n            descriptions and syntax for each of the actions and data types in RAM. RAM is a\n            service that helps you securely share your Amazon Web Services resources to other Amazon Web Services accounts. If\n            you use Organizations to manage your accounts, then you can share your resources with your\n            entire organization or to organizational units (OUs). For supported resource types, you\n            can also share resources with individual Identity and Access Management (IAM) roles and users. </p>\n         <p>To learn more about RAM, see the following resources:</p>\n         <ul>\n            <li>\n               <p>\n                  <a href=\"http://aws.amazon.com/ram\">Resource Access Manager product page</a>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <a href=\"https://docs.aws.amazon.com/ram/latest/userguide/\">Resource Access Manager User\n                        Guide</a>\n               </p>\n            </li>\n         </ul>",
         "smithy.api#title": "AWS Resource Access Manager",
         "smithy.rules#endpointRuleSet": {
           "version": "1.0",
           "parameters": {
             "Region": {
               "builtIn": "AWS::Region",
-              "required": true,
+              "required": false,
               "documentation": "The AWS region used to dispatch the request.",
               "type": "String"
             },
@@ -241,13 +274,12 @@
             {
               "conditions": [
                 {
-                  "fn": "aws.partition",
+                  "fn": "isSet",
                   "argv": [
                     {
-                      "ref": "Region"
+                      "ref": "Endpoint"
                     }
-                  ],
-                  "assign": "PartitionResult"
+                  ]
                 }
               ],
               "type": "tree",
@@ -255,14 +287,20 @@
                 {
                   "conditions": [
                     {
-                      "fn": "isSet",
+                      "fn": "booleanEquals",
                       "argv": [
                         {
-                          "ref": "Endpoint"
-                        }
+                          "ref": "UseFIPS"
+                        },
+                        true
                       ]
                     }
                   ],
+                  "error": "Invalid Configuration: FIPS and custom endpoint are not supported",
+                  "type": "error"
+                },
+                {
+                  "conditions": [],
                   "type": "tree",
                   "rules": [
                     {
@@ -271,67 +309,42 @@
                           "fn": "booleanEquals",
                           "argv": [
                             {
-                              "ref": "UseFIPS"
+                              "ref": "UseDualStack"
                             },
                             true
                           ]
                         }
                       ],
-                      "error": "Invalid Configuration: FIPS and custom endpoint are not supported",
+                      "error": "Invalid Configuration: Dualstack and custom endpoint are not supported",
                       "type": "error"
                     },
                     {
                       "conditions": [],
-                      "type": "tree",
-                      "rules": [
-                        {
-                          "conditions": [
-                            {
-                              "fn": "booleanEquals",
-                              "argv": [
-                                {
-                                  "ref": "UseDualStack"
-                                },
-                                true
-                              ]
-                            }
-                          ],
-                          "error": "Invalid Configuration: Dualstack and custom endpoint are not supported",
-                          "type": "error"
+                      "endpoint": {
+                        "url": {
+                          "ref": "Endpoint"
                         },
-                        {
-                          "conditions": [],
-                          "endpoint": {
-                            "url": {
-                              "ref": "Endpoint"
-                            },
-                            "properties": {},
-                            "headers": {}
-                          },
-                          "type": "endpoint"
-                        }
-                      ]
+                        "properties": {},
+                        "headers": {}
+                      },
+                      "type": "endpoint"
                     }
                   ]
-                },
+                }
+              ]
+            },
+            {
+              "conditions": [],
+              "type": "tree",
+              "rules": [
                 {
                   "conditions": [
                     {
-                      "fn": "booleanEquals",
-                      "argv": [
-                        {
-                          "ref": "UseFIPS"
-                        },
-                        true
-                      ]
-                    },
-                    {
-                      "fn": "booleanEquals",
+                      "fn": "isSet",
                       "argv": [
                         {
-                          "ref": "UseDualStack"
-                        },
-                        true
+                          "ref": "Region"
+                        }
                       ]
                     }
                   ],
@@ -340,129 +353,248 @@
                     {
                       "conditions": [
                         {
-                          "fn": "booleanEquals",
+                          "fn": "aws.partition",
                           "argv": [
-                            true,
                             {
-                              "fn": "getAttr",
+                              "ref": "Region"
+                            }
+                          ],
+                          "assign": "PartitionResult"
+                        }
+                      ],
+                      "type": "tree",
+                      "rules": [
+                        {
+                          "conditions": [
+                            {
+                              "fn": "booleanEquals",
+                              "argv": [
+                                {
+                                  "ref": "UseFIPS"
+                                },
+                                true
+                              ]
+                            },
+                            {
+                              "fn": "booleanEquals",
                               "argv": [
                                 {
-                                  "ref": "PartitionResult"
+                                  "ref": "UseDualStack"
+                                },
+                                true
+                              ]
+                            }
+                          ],
+                          "type": "tree",
+                          "rules": [
+                            {
+                              "conditions": [
+                                {
+                                  "fn": "booleanEquals",
+                                  "argv": [
+                                    true,
+                                    {
+                                      "fn": "getAttr",
+                                      "argv": [
+                                        {
+                                          "ref": "PartitionResult"
+                                        },
+                                        "supportsFIPS"
+                                      ]
+                                    }
+                                  ]
                                 },
-                                "supportsFIPS"
+                                {
+                                  "fn": "booleanEquals",
+                                  "argv": [
+                                    true,
+                                    {
+                                      "fn": "getAttr",
+                                      "argv": [
+                                        {
+                                          "ref": "PartitionResult"
+                                        },
+                                        "supportsDualStack"
+                                      ]
+                                    }
+                                  ]
+                                }
+                              ],
+                              "type": "tree",
+                              "rules": [
+                                {
+                                  "conditions": [],
+                                  "type": "tree",
+                                  "rules": [
+                                    {
+                                      "conditions": [],
+                                      "endpoint": {
+                                        "url": "https://ram-fips.{Region}.{PartitionResult#dualStackDnsSuffix}",
+                                        "properties": {},
+                                        "headers": {}
+                                      },
+                                      "type": "endpoint"
+                                    }
+                                  ]
+                                }
                               ]
+                            },
+                            {
+                              "conditions": [],
+                              "error": "FIPS and DualStack are enabled, but this partition does not support one or both",
+                              "type": "error"
                             }
                           ]
                         },
                         {
-                          "fn": "booleanEquals",
-                          "argv": [
-                            true,
+                          "conditions": [
                             {
-                              "fn": "getAttr",
+                              "fn": "booleanEquals",
                               "argv": [
                                 {
-                                  "ref": "PartitionResult"
+                                  "ref": "UseFIPS"
                                 },
-                                "supportsDualStack"
+                                true
                               ]
                             }
-                          ]
-                        }
-                      ],
-                      "type": "tree",
-                      "rules": [
-                        {
-                          "conditions": [],
+                          ],
                           "type": "tree",
                           "rules": [
+                            {
+                              "conditions": [
+                                {
+                                  "fn": "booleanEquals",
+                                  "argv": [
+                                    true,
+                                    {
+                                      "fn": "getAttr",
+                                      "argv": [
+                                        {
+                                          "ref": "PartitionResult"
+                                        },
+                                        "supportsFIPS"
+                                      ]
+                                    }
+                                  ]
+                                }
+                              ],
+                              "type": "tree",
+                              "rules": [
+                                {
+                                  "conditions": [],
+                                  "type": "tree",
+                                  "rules": [
+                                    {
+                                      "conditions": [
+                                        {
+                                          "fn": "stringEquals",
+                                          "argv": [
+                                            "aws-us-gov",
+                                            {
+                                              "fn": "getAttr",
+                                              "argv": [
+                                                {
+                                                  "ref": "PartitionResult"
+                                                },
+                                                "name"
+                                              ]
+                                            }
+                                          ]
+                                        }
+                                      ],
+                                      "endpoint": {
+                                        "url": "https://ram.{Region}.amazonaws.com",
+                                        "properties": {},
+                                        "headers": {}
+                                      },
+                                      "type": "endpoint"
+                                    },
+                                    {
+                                      "conditions": [],
+                                      "endpoint": {
+                                        "url": "https://ram-fips.{Region}.{PartitionResult#dnsSuffix}",
+                                        "properties": {},
+                                        "headers": {}
+                                      },
+                                      "type": "endpoint"
+                                    }
+                                  ]
+                                }
+                              ]
+                            },
                             {
                               "conditions": [],
-                              "endpoint": {
-                                "url": "https://ram-fips.{Region}.{PartitionResult#dualStackDnsSuffix}",
-                                "properties": {},
-                                "headers": {}
-                              },
-                              "type": "endpoint"
+                              "error": "FIPS is enabled but this partition does not support FIPS",
+                              "type": "error"
                             }
                           ]
-                        }
-                      ]
-                    },
-                    {
-                      "conditions": [],
-                      "error": "FIPS and DualStack are enabled, but this partition does not support one or both",
-                      "type": "error"
-                    }
-                  ]
-                },
-                {
-                  "conditions": [
-                    {
-                      "fn": "booleanEquals",
-                      "argv": [
-                        {
-                          "ref": "UseFIPS"
                         },
-                        true
-                      ]
-                    }
-                  ],
-                  "type": "tree",
-                  "rules": [
-                    {
-                      "conditions": [
                         {
-                          "fn": "booleanEquals",
-                          "argv": [
-                            true,
+                          "conditions": [
                             {
-                              "fn": "getAttr",
+                              "fn": "booleanEquals",
                               "argv": [
                                 {
-                                  "ref": "PartitionResult"
+                                  "ref": "UseDualStack"
                                 },
-                                "supportsFIPS"
+                                true
                               ]
                             }
-                          ]
-                        }
-                      ],
-                      "type": "tree",
-                      "rules": [
-                        {
-                          "conditions": [],
+                          ],
                           "type": "tree",
                           "rules": [
                             {
                               "conditions": [
                                 {
-                                  "fn": "stringEquals",
+                                  "fn": "booleanEquals",
                                   "argv": [
-                                    "aws-us-gov",
+                                    true,
                                     {
                                       "fn": "getAttr",
                                       "argv": [
                                         {
                                           "ref": "PartitionResult"
                                         },
-                                        "name"
+                                        "supportsDualStack"
                                       ]
                                     }
                                   ]
                                 }
                               ],
-                              "endpoint": {
-                                "url": "https://ram.{Region}.amazonaws.com",
-                                "properties": {},
-                                "headers": {}
-                              },
-                              "type": "endpoint"
+                              "type": "tree",
+                              "rules": [
+                                {
+                                  "conditions": [],
+                                  "type": "tree",
+                                  "rules": [
+                                    {
+                                      "conditions": [],
+                                      "endpoint": {
+                                        "url": "https://ram.{Region}.{PartitionResult#dualStackDnsSuffix}",
+                                        "properties": {},
+                                        "headers": {}
+                                      },
+                                      "type": "endpoint"
+                                    }
+                                  ]
+                                }
+                              ]
                             },
+                            {
+                              "conditions": [],
+                              "error": "DualStack is enabled but this partition does not support DualStack",
+                              "type": "error"
+                            }
+                          ]
+                        },
+                        {
+                          "conditions": [],
+                          "type": "tree",
+                          "rules": [
                             {
                               "conditions": [],
                               "endpoint": {
-                                "url": "https://ram-fips.{Region}.{PartitionResult#dnsSuffix}",
+                                "url": "https://ram.{Region}.{PartitionResult#dnsSuffix}",
                                 "properties": {},
                                 "headers": {}
                               },
@@ -471,124 +603,13 @@
                           ]
                         }
                       ]
-                    },
-                    {
-                      "conditions": [],
-                      "error": "FIPS is enabled but this partition does not support FIPS",
-                      "type": "error"
-                    }
-                  ]
-                },
-                {
-                  "conditions": [
-                    {
-                      "fn": "booleanEquals",
-                      "argv": [
-                        {
-                          "ref": "UseDualStack"
-                        },
-                        true
-                      ]
-                    }
-                  ],
-                  "type": "tree",
-                  "rules": [
-                    {
-                      "conditions": [
-                        {
-                          "fn": "booleanEquals",
-                          "argv": [
-                            true,
-                            {
-                              "fn": "getAttr",
-                              "argv": [
-                                {
-                                  "ref": "PartitionResult"
-                                },
-                                "supportsDualStack"
-                              ]
-                            }
-                          ]
-                        }
-                      ],
-                      "type": "tree",
-                      "rules": [
-                        {
-                          "conditions": [],
-                          "type": "tree",
-                          "rules": [
-                            {
-                              "conditions": [],
-                              "endpoint": {
-                                "url": "https://ram.{Region}.{PartitionResult#dualStackDnsSuffix}",
-                                "properties": {},
-                                "headers": {}
-                              },
-                              "type": "endpoint"
-                            }
-                          ]
-                        }
-                      ]
-                    },
-                    {
-                      "conditions": [],
-                      "error": "DualStack is enabled but this partition does not support DualStack",
-                      "type": "error"
                     }
                   ]
                 },
                 {
                   "conditions": [],
-                  "type": "tree",
-                  "rules": [
-                    {
-                      "conditions": [
-                        {
-                          "fn": "stringEquals",
-                          "argv": [
-                            {
-                              "ref": "Region"
-                            },
-                            "us-gov-east-1"
-                          ]
-                        }
-                      ],
-                      "endpoint": {
-                        "url": "https://ram.us-gov-east-1.amazonaws.com",
-                        "properties": {},
-                        "headers": {}
-                      },
-                      "type": "endpoint"
-                    },
-                    {
-                      "conditions": [
-                        {
-                          "fn": "stringEquals",
-                          "argv": [
-                            {
-                              "ref": "Region"
-                            },
-                            "us-gov-west-1"
-                          ]
-                        }
-                      ],
-                      "endpoint": {
-                        "url": "https://ram.us-gov-west-1.amazonaws.com",
-                        "properties": {},
-                        "headers": {}
-                      },
-                      "type": "endpoint"
-                    },
-                    {
-                      "conditions": [],
-                      "endpoint": {
-                        "url": "https://ram.{Region}.{PartitionResult#dnsSuffix}",
-                        "properties": {},
-                        "headers": {}
-                      },
-                      "type": "endpoint"
-                    }
-                  ]
+                  "error": "Invalid Configuration: Missing Region",
+                  "type": "error"
                 }
               ]
             }
@@ -597,222 +618,209 @@
         "smithy.rules#endpointTests": {
           "testCases": [
             {
-              "documentation": "For region cn-north-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region af-south-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.cn-north-1.amazonaws.com.cn"
+                  "url": "https://ram.af-south-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "cn-north-1",
+                "Region": "af-south-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region cn-northwest-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region ap-east-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.cn-northwest-1.amazonaws.com.cn"
+                  "url": "https://ram.ap-east-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "cn-northwest-1",
+                "Region": "ap-east-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region cn-north-1 with FIPS enabled and DualStack enabled",
-              "expect": {
-                "endpoint": {
-                  "url": "https://ram-fips.cn-north-1.api.amazonwebservices.com.cn"
-                }
-              },
-              "params": {
-                "Region": "cn-north-1",
-                "UseFIPS": true,
-                "UseDualStack": true
-              }
-            },
-            {
-              "documentation": "For region cn-north-1 with FIPS enabled and DualStack disabled",
+              "documentation": "For region ap-northeast-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram-fips.cn-north-1.amazonaws.com.cn"
+                  "url": "https://ram.ap-northeast-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "cn-north-1",
-                "UseFIPS": true,
+                "Region": "ap-northeast-1",
+                "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region cn-north-1 with FIPS disabled and DualStack enabled",
+              "documentation": "For region ap-northeast-2 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.cn-north-1.api.amazonwebservices.com.cn"
+                  "url": "https://ram.ap-northeast-2.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "cn-north-1",
+                "Region": "ap-northeast-2",
                 "UseFIPS": false,
-                "UseDualStack": true
+                "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-isob-east-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region ap-northeast-3 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-isob-east-1.sc2s.sgov.gov"
+                  "url": "https://ram.ap-northeast-3.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "us-isob-east-1",
+                "Region": "ap-northeast-3",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-isob-east-1 with FIPS enabled and DualStack disabled",
+              "documentation": "For region ap-south-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram-fips.us-isob-east-1.sc2s.sgov.gov"
+                  "url": "https://ram.ap-south-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "us-isob-east-1",
-                "UseFIPS": true,
+                "Region": "ap-south-1",
+                "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region ap-southeast-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-gov-east-1.amazonaws.com"
+                  "url": "https://ram.ap-southeast-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "us-gov-east-1",
+                "Region": "ap-southeast-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack disabled",
+              "documentation": "For region ap-southeast-2 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-gov-east-1.amazonaws.com"
+                  "url": "https://ram.ap-southeast-2.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "us-gov-east-1",
-                "UseFIPS": true,
+                "Region": "ap-southeast-2",
+                "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-gov-west-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region ap-southeast-3 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-gov-west-1.amazonaws.com"
+                  "url": "https://ram.ap-southeast-3.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "us-gov-west-1",
+                "Region": "ap-southeast-3",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-gov-west-1 with FIPS enabled and DualStack disabled",
+              "documentation": "For region ca-central-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-gov-west-1.amazonaws.com"
+                  "url": "https://ram.ca-central-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "us-gov-west-1",
-                "UseFIPS": true,
+                "Region": "ca-central-1",
+                "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack enabled",
+              "documentation": "For region ca-central-1 with FIPS enabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram-fips.us-gov-east-1.api.aws"
+                  "url": "https://ram-fips.ca-central-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "us-gov-east-1",
+                "Region": "ca-central-1",
                 "UseFIPS": true,
-                "UseDualStack": true
+                "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack enabled",
+              "documentation": "For region eu-central-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-gov-east-1.api.aws"
+                  "url": "https://ram.eu-central-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "us-gov-east-1",
+                "Region": "eu-central-1",
                 "UseFIPS": false,
-                "UseDualStack": true
+                "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-east-2 with FIPS disabled and DualStack disabled",
+              "documentation": "For region eu-north-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-east-2.amazonaws.com"
+                  "url": "https://ram.eu-north-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "us-east-2",
+                "Region": "eu-north-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-east-2 with FIPS enabled and DualStack disabled",
+              "documentation": "For region eu-south-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram-fips.us-east-2.amazonaws.com"
+                  "url": "https://ram.eu-south-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "us-east-2",
-                "UseFIPS": true,
+                "Region": "eu-south-1",
+                "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region eu-north-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region eu-west-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.eu-north-1.amazonaws.com"
+                  "url": "https://ram.eu-west-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "eu-north-1",
+                "Region": "eu-west-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region me-south-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region eu-west-2 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.me-south-1.amazonaws.com"
+                  "url": "https://ram.eu-west-2.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "me-south-1",
+                "Region": "eu-west-2",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
@@ -831,27 +839,27 @@
               }
             },
             {
-              "documentation": "For region eu-west-2 with FIPS disabled and DualStack disabled",
+              "documentation": "For region me-south-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.eu-west-2.amazonaws.com"
+                  "url": "https://ram.me-south-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "eu-west-2",
+                "Region": "me-south-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region eu-west-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region sa-east-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.eu-west-1.amazonaws.com"
+                  "url": "https://ram.sa-east-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "eu-west-1",
+                "Region": "sa-east-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
@@ -883,293 +891,350 @@
               }
             },
             {
-              "documentation": "For region ap-northeast-3 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-east-2 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.ap-northeast-3.amazonaws.com"
+                  "url": "https://ram.us-east-2.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "ap-northeast-3",
+                "Region": "us-east-2",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region ap-northeast-2 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-east-2 with FIPS enabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.ap-northeast-2.amazonaws.com"
+                  "url": "https://ram-fips.us-east-2.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "ap-northeast-2",
-                "UseFIPS": false,
+                "Region": "us-east-2",
+                "UseFIPS": true,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region ap-northeast-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-west-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.ap-northeast-1.amazonaws.com"
+                  "url": "https://ram.us-west-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "ap-northeast-1",
+                "Region": "us-west-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region ap-south-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-west-1 with FIPS enabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.ap-south-1.amazonaws.com"
+                  "url": "https://ram-fips.us-west-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "ap-south-1",
-                "UseFIPS": false,
+                "Region": "us-west-1",
+                "UseFIPS": true,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region af-south-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-west-2 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.af-south-1.amazonaws.com"
+                  "url": "https://ram.us-west-2.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "af-south-1",
+                "Region": "us-west-2",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-west-2 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-west-2 with FIPS enabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-west-2.amazonaws.com"
+                  "url": "https://ram-fips.us-west-2.amazonaws.com"
                 }
               },
               "params": {
                 "Region": "us-west-2",
-                "UseFIPS": false,
+                "UseFIPS": true,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-west-2 with FIPS enabled and DualStack disabled",
+              "documentation": "For region us-east-1 with FIPS enabled and DualStack enabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram-fips.us-west-2.amazonaws.com"
+                  "url": "https://ram-fips.us-east-1.api.aws"
                 }
               },
               "params": {
-                "Region": "us-west-2",
+                "Region": "us-east-1",
                 "UseFIPS": true,
-                "UseDualStack": false
+                "UseDualStack": true
               }
             },
             {
-              "documentation": "For region us-west-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-east-1 with FIPS disabled and DualStack enabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-west-1.amazonaws.com"
+                  "url": "https://ram.us-east-1.api.aws"
                 }
               },
               "params": {
-                "Region": "us-west-1",
+                "Region": "us-east-1",
                 "UseFIPS": false,
-                "UseDualStack": false
+                "UseDualStack": true
               }
             },
             {
-              "documentation": "For region us-west-1 with FIPS enabled and DualStack disabled",
+              "documentation": "For region cn-north-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram-fips.us-west-1.amazonaws.com"
+                  "url": "https://ram.cn-north-1.amazonaws.com.cn"
                 }
               },
               "params": {
-                "Region": "us-west-1",
-                "UseFIPS": true,
+                "Region": "cn-north-1",
+                "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region ca-central-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region cn-northwest-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.ca-central-1.amazonaws.com"
+                  "url": "https://ram.cn-northwest-1.amazonaws.com.cn"
                 }
               },
               "params": {
-                "Region": "ca-central-1",
+                "Region": "cn-northwest-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region ca-central-1 with FIPS enabled and DualStack disabled",
+              "documentation": "For region cn-north-1 with FIPS enabled and DualStack enabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram-fips.ca-central-1.amazonaws.com"
+                  "url": "https://ram-fips.cn-north-1.api.amazonwebservices.com.cn"
                 }
               },
               "params": {
-                "Region": "ca-central-1",
+                "Region": "cn-north-1",
                 "UseFIPS": true,
-                "UseDualStack": false
+                "UseDualStack": true
               }
             },
             {
-              "documentation": "For region ap-southeast-3 with FIPS disabled and DualStack disabled",
+              "documentation": "For region cn-north-1 with FIPS enabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.ap-southeast-3.amazonaws.com"
+                  "url": "https://ram-fips.cn-north-1.amazonaws.com.cn"
                 }
               },
               "params": {
-                "Region": "ap-southeast-3",
-                "UseFIPS": false,
+                "Region": "cn-north-1",
+                "UseFIPS": true,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region ap-southeast-2 with FIPS disabled and DualStack disabled",
+              "documentation": "For region cn-north-1 with FIPS disabled and DualStack enabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.ap-southeast-2.amazonaws.com"
+                  "url": "https://ram.cn-north-1.api.amazonwebservices.com.cn"
                 }
               },
               "params": {
-                "Region": "ap-southeast-2",
+                "Region": "cn-north-1",
                 "UseFIPS": false,
-                "UseDualStack": false
+                "UseDualStack": true
               }
             },
             {
-              "documentation": "For region ap-southeast-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.ap-southeast-1.amazonaws.com"
+                  "url": "https://ram.us-gov-east-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "ap-southeast-1",
+                "Region": "us-gov-east-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region eu-central-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.eu-central-1.amazonaws.com"
+                  "url": "https://ram.us-gov-east-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "eu-central-1",
-                "UseFIPS": false,
+                "Region": "us-gov-east-1",
+                "UseFIPS": true,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region eu-south-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-gov-west-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.eu-south-1.amazonaws.com"
+                  "url": "https://ram.us-gov-west-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "eu-south-1",
+                "Region": "us-gov-west-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region ap-east-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-gov-west-1 with FIPS enabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.ap-east-1.amazonaws.com"
+                  "url": "https://ram.us-gov-west-1.amazonaws.com"
                 }
               },
               "params": {
-                "Region": "ap-east-1",
-                "UseFIPS": false,
+                "Region": "us-gov-west-1",
+                "UseFIPS": true,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region sa-east-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack enabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.sa-east-1.amazonaws.com"
+                  "url": "https://ram-fips.us-gov-east-1.api.aws"
                 }
               },
               "params": {
-                "Region": "sa-east-1",
+                "Region": "us-gov-east-1",
+                "UseFIPS": true,
+                "UseDualStack": true
+              }
+            },
+            {
+              "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack enabled",
+              "expect": {
+                "endpoint": {
+                  "url": "https://ram.us-gov-east-1.api.aws"
+                }
+              },
+              "params": {
+                "Region": "us-gov-east-1",
                 "UseFIPS": false,
-                "UseDualStack": false
+                "UseDualStack": true
               }
             },
             {
-              "documentation": "For region us-east-1 with FIPS enabled and DualStack enabled",
+              "documentation": "For region us-iso-east-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram-fips.us-east-1.api.aws"
+                  "url": "https://ram.us-iso-east-1.c2s.ic.gov"
                 }
               },
               "params": {
-                "Region": "us-east-1",
+                "Region": "us-iso-east-1",
+                "UseFIPS": false,
+                "UseDualStack": false
+              }
+            },
+            {
+              "documentation": "For region us-iso-east-1 with FIPS enabled and DualStack enabled",
+              "expect": {
+                "error": "FIPS and DualStack are enabled, but this partition does not support one or both"
+              },
+              "params": {
+                "Region": "us-iso-east-1",
                 "UseFIPS": true,
                 "UseDualStack": true
               }
             },
             {
-              "documentation": "For region us-east-1 with FIPS disabled and DualStack enabled",
+              "documentation": "For region us-iso-east-1 with FIPS enabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-east-1.api.aws"
+                  "url": "https://ram-fips.us-iso-east-1.c2s.ic.gov"
                 }
               },
               "params": {
-                "Region": "us-east-1",
+                "Region": "us-iso-east-1",
+                "UseFIPS": true,
+                "UseDualStack": false
+              }
+            },
+            {
+              "documentation": "For region us-iso-east-1 with FIPS disabled and DualStack enabled",
+              "expect": {
+                "error": "DualStack is enabled but this partition does not support DualStack"
+              },
+              "params": {
+                "Region": "us-iso-east-1",
                 "UseFIPS": false,
                 "UseDualStack": true
               }
             },
             {
-              "documentation": "For region us-iso-east-1 with FIPS disabled and DualStack disabled",
+              "documentation": "For region us-isob-east-1 with FIPS disabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram.us-iso-east-1.c2s.ic.gov"
+                  "url": "https://ram.us-isob-east-1.sc2s.sgov.gov"
                 }
               },
               "params": {
-                "Region": "us-iso-east-1",
+                "Region": "us-isob-east-1",
                 "UseFIPS": false,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For region us-iso-east-1 with FIPS enabled and DualStack disabled",
+              "documentation": "For region us-isob-east-1 with FIPS enabled and DualStack enabled",
+              "expect": {
+                "error": "FIPS and DualStack are enabled, but this partition does not support one or both"
+              },
+              "params": {
+                "Region": "us-isob-east-1",
+                "UseFIPS": true,
+                "UseDualStack": true
+              }
+            },
+            {
+              "documentation": "For region us-isob-east-1 with FIPS enabled and DualStack disabled",
               "expect": {
                 "endpoint": {
-                  "url": "https://ram-fips.us-iso-east-1.c2s.ic.gov"
+                  "url": "https://ram-fips.us-isob-east-1.sc2s.sgov.gov"
                 }
               },
               "params": {
-                "Region": "us-iso-east-1",
+                "Region": "us-isob-east-1",
                 "UseFIPS": true,
                 "UseDualStack": false
               }
             },
             {
-              "documentation": "For custom endpoint with fips disabled and dualstack disabled",
+              "documentation": "For region us-isob-east-1 with FIPS disabled and DualStack enabled",
+              "expect": {
+                "error": "DualStack is enabled but this partition does not support DualStack"
+              },
+              "params": {
+                "Region": "us-isob-east-1",
+                "UseFIPS": false,
+                "UseDualStack": true
+              }
+            },
+            {
+              "documentation": "For custom endpoint with region set and fips disabled and dualstack disabled",
               "expect": {
                 "endpoint": {
                   "url": "https://example.com"
@@ -1182,6 +1247,19 @@
                 "Endpoint": "https://example.com"
               }
             },
+            {
+              "documentation": "For custom endpoint with region not set and fips disabled and dualstack disabled",
+              "expect": {
+                "endpoint": {
+                  "url": "https://example.com"
+                }
+              },
+              "params": {
+                "UseFIPS": false,
+                "UseDualStack": false,
+                "Endpoint": "https://example.com"
+              }
+            },
             {
               "documentation": "For custom endpoint with fips enabled and dualstack disabled",
               "expect": {
@@ -1205,6 +1283,12 @@
                 "UseDualStack": true,
                 "Endpoint": "https://example.com"
               }
+            },
+            {
+              "documentation": "Missing region",
+              "expect": {
+                "error": "Invalid Configuration: Missing Region"
+              }
             }
           ],
           "version": "1.0"
@@ -1309,35 +1393,38 @@
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share to which you want to add or replace\n            permissions.</p>",
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share to which you want to add or replace\n            permissions.</p>",
             "smithy.api#required": {}
           }
         },
         "permissionArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the RAM permission to associate with the resource share.\n            To find the ARN for a permission, use either the <a>ListPermissions</a> operation or go to the <a href=\"https://console.aws.amazon.com/ram/home#Permissions:\">Permissions library</a> page in the RAM console and \n             then choose the name of the permission. The ARN is displayed on the detail page.</p>",
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the RAM permission to associate with the resource share.\n            To find the ARN for a permission, use either the <a>ListPermissions</a> operation or go to the <a href=\"https://console.aws.amazon.com/ram/home#Permissions:\">Permissions library</a> page in the RAM console and \n             then choose the name of the permission. The ARN is displayed on the detail page.</p>",
             "smithy.api#required": {}
           }
         },
         "replace": {
           "target": "com.amazonaws.ram#Boolean",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies whether the specified permission should replace or add to the existing\n            permission associated with the resource share. Use <code>true</code> to replace the current\n            permissions. Use <code>false</code> to add the permission to the current permission. The\n            default value is <code>false</code>.</p>\n         <note>\n            <p>A resource share can have only one permission per resource type. If a resource share already has a\n                permission for the specified resource type and you don't set <code>replace</code> to\n                    <code>true</code> then the operation returns an error. This helps prevent\n                accidental overwriting of a permission.</p>\n         </note>"
+            "smithy.api#documentation": "<p>Specifies whether the specified permission should replace the existing permission\n            associated with the resource share. Use <code>true</code> to replace the current permissions. Use\n                <code>false</code> to add the permission to a resource share that currently doesn't\n            have a permission. The default value is <code>false</code>.</p>\n         <note>\n            <p>A resource share can have only one permission per resource type. If a resource share already has a\n                permission for the specified resource type and you don't set <code>replace</code> to\n                    <code>true</code> then the operation returns an error. This helps prevent\n                accidental overwriting of a permission.</p>\n         </note>"
           }
         },
         "clientToken": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>"
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
           }
         },
         "permissionVersion": {
           "target": "com.amazonaws.ram#Integer",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the version of the RAM permission to associate with the resource share. If you don't\n            specify this parameter, the operation uses the version designated as the default. You\n            can use the <a>ListPermissionVersions</a> operation to discover the available\n            versions of a permission.</p>"
+            "smithy.api#documentation": "<p>Specifies the version of the RAM permission to associate with the resource share. You can\n            specify <i>only</i> the version that is currently set as the default\n            version for the permission. If you also set the <code>replace</code> pararameter to\n                <code>true</code>, then this operation updates an outdated version of the permission\n            to the current default version.</p>\n         <note>\n            <p>You don't need to specify this parameter because the default behavior is to use\n                the version that is currently set as the default version for the permission. This\n                parameter is supported for backwards compatibility.</p>\n         </note>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#AssociateResourceSharePermissionResponse": {
@@ -1355,6 +1442,9 @@
             "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#AssociateResourceShareRequest": {
@@ -1363,7 +1453,7 @@
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share that you want to add principals or resources\n            to.</p>",
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share that you want to add principals or resources\n            to.</p>",
             "smithy.api#required": {}
           }
         },
@@ -1376,15 +1466,18 @@
         "principals": {
           "target": "com.amazonaws.ram#PrincipalArnOrIdList",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a list of principals to whom you want to the resource share. This can be\n                <code>null</code> if you want to add only resources.</p>\n         <p>What the principals can do with the resources in the share is determined by the RAM\n            permissions that you associate with the resource share. See <a>AssociateResourceSharePermission</a>.</p>\n         <p>You can include the following values:</p>\n         <ul>\n            <li>\n               <p>An Amazon Web Services account ID, for example: <code>123456789012</code>\n               </p>\n            </li>\n            <li>\n               <p>An <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of an organization in Organizations, for example:\n                        <code>organizations::123456789012:organization/o-exampleorgid</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an organizational unit (OU) in Organizations, for example:\n                        <code>organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM role, for example:\n                        <code>iam::123456789012:role/rolename</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM user, for example:\n                        <code>iam::123456789012user/username</code>\n               </p>\n            </li>\n         </ul>\n         <note>\n            <p>Not all resource types can be shared with IAM roles and users. \n             For more information, see <a href=\"https://docs.aws.amazon.com/ram/latest/userguide/permissions.html#permissions-rbp-supported-resource-types\">Sharing with IAM roles and users</a> in the <i>Resource Access Manager User\n                    Guide</i>.</p>\n         </note>"
+            "smithy.api#documentation": "<p>Specifies a list of principals to whom you want to the resource share. This can be\n                <code>null</code> if you want to add only resources.</p>\n         <p>What the principals can do with the resources in the share is determined by the RAM\n            permissions that you associate with the resource share. See <a>AssociateResourceSharePermission</a>.</p>\n         <p>You can include the following values:</p>\n         <ul>\n            <li>\n               <p>An Amazon Web Services account ID, for example: <code>123456789012</code>\n               </p>\n            </li>\n            <li>\n               <p>An <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an organization in Organizations, for example:\n                        <code>organizations::123456789012:organization/o-exampleorgid</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an organizational unit (OU) in Organizations, for example:\n                        <code>organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM role, for example:\n                        <code>iam::123456789012:role/rolename</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM user, for example:\n                        <code>iam::123456789012user/username</code>\n               </p>\n            </li>\n         </ul>\n         <note>\n            <p>Not all resource types can be shared with IAM roles and users. \n             For more information, see <a href=\"https://docs.aws.amazon.com/ram/latest/userguide/permissions.html#permissions-rbp-supported-resource-types\">Sharing with IAM roles and users</a> in the <i>Resource Access Manager User\n                    Guide</i>.</p>\n         </note>"
           }
         },
         "clientToken": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>"
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#AssociateResourceShareResponse": {
@@ -1402,18 +1495,86 @@
             "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#AssociatedPermission": {
+      "type": "structure",
+      "members": {
+        "arn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the associated managed permission.</p>"
+          }
+        },
+        "permissionVersion": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The version of the permission currently associated with the resource share.</p>"
+          }
+        },
+        "defaultVersion": {
+          "target": "com.amazonaws.ram#Boolean",
+          "traits": {
+            "smithy.api#documentation": "<p>Indicates whether the associated resource share is using the default version of the\n            permission.</p>"
+          }
+        },
+        "resourceType": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The resource type to which this permission applies.</p>"
+          }
+        },
+        "status": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The current status of the association between the permission and the resource share.\n            The following are the possible values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>ATTACHABLE</code> – This permission or version can be associated \n                with resource shares.</p>\n            </li>\n            <li>\n               <p>\n                  <code>UNATTACHABLE</code> – This permission or version can't \n                currently be associated with resource shares.</p>\n            </li>\n            <li>\n               <p>\n                  <code>DELETING</code> – This permission or version is in the process of\n                    being deleted.</p>\n            </li>\n            <li>\n               <p>\n                  <code>DELETED</code> – This permission or version is deleted.</p>\n            </li>\n         </ul>"
+          }
+        },
+        "featureSet": {
+          "target": "com.amazonaws.ram#PermissionFeatureSet",
+          "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>"
+          }
+        },
+        "lastUpdatedTime": {
+          "target": "com.amazonaws.ram#DateTime",
+          "traits": {
+            "smithy.api#documentation": "<p>The date and time when the association between the permission and the resource share\n            was last updated.</p>"
+          }
+        },
+        "resourceShareArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of a resource share associated with this permission.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#documentation": "<p>An object that describes a managed permission associated with a resource share.</p>"
+      }
+    },
+    "com.amazonaws.ram#AssociatedPermissionList": {
+      "type": "list",
+      "member": {
+        "target": "com.amazonaws.ram#AssociatedPermission",
+        "traits": {
+          "smithy.api#xmlName": "item"
+        }
       }
     },
     "com.amazonaws.ram#Boolean": {
       "type": "boolean"
     },
-    "com.amazonaws.ram#CreateResourceShare": {
+    "com.amazonaws.ram#CreatePermission": {
       "type": "operation",
       "input": {
-        "target": "com.amazonaws.ram#CreateResourceShareRequest"
+        "target": "com.amazonaws.ram#CreatePermissionRequest"
       },
       "output": {
-        "target": "com.amazonaws.ram#CreateResourceShareResponse"
+        "target": "com.amazonaws.ram#CreatePermissionResponse"
       },
       "errors": [
         {
@@ -1426,94 +1587,84 @@
           "target": "com.amazonaws.ram#InvalidParameterException"
         },
         {
-          "target": "com.amazonaws.ram#InvalidStateTransitionException"
+          "target": "com.amazonaws.ram#InvalidPolicyException"
         },
         {
-          "target": "com.amazonaws.ram#MalformedArnException"
+          "target": "com.amazonaws.ram#MalformedPolicyTemplateException"
         },
         {
           "target": "com.amazonaws.ram#OperationNotPermittedException"
         },
         {
-          "target": "com.amazonaws.ram#ResourceShareLimitExceededException"
+          "target": "com.amazonaws.ram#PermissionAlreadyExistsException"
         },
         {
-          "target": "com.amazonaws.ram#ServerInternalException"
+          "target": "com.amazonaws.ram#PermissionLimitExceededException"
         },
         {
-          "target": "com.amazonaws.ram#ServiceUnavailableException"
+          "target": "com.amazonaws.ram#ServerInternalException"
         },
         {
-          "target": "com.amazonaws.ram#TagPolicyViolationException"
-        },
-        {
-          "target": "com.amazonaws.ram#UnknownResourceException"
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Creates a resource share. You can provide a list of the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Names (ARNs)</a> for the resources that you\n            want to share, a list of principals you want to share the resources with, and the\n            permissions to grant those principals.</p>\n         <note>\n            <p>Sharing a resource makes it available for use by principals outside of the\n                Amazon Web Services account that created the resource. Sharing doesn't change any permissions or\n                quotas that apply to the resource in the account that created it.</p>\n         </note>",
+        "smithy.api#documentation": "<p>Creates a customer managed permission for a specified resource type that you can attach to resource shares.\n            It is created in the Amazon Web Services Region in which you call the operation.</p>",
         "smithy.api#http": {
           "method": "POST",
-          "uri": "/createresourceshare",
+          "uri": "/createpermission",
           "code": 200
         }
       }
     },
-    "com.amazonaws.ram#CreateResourceShareRequest": {
+    "com.amazonaws.ram#CreatePermissionRequest": {
       "type": "structure",
       "members": {
         "name": {
-          "target": "com.amazonaws.ram#String",
+          "target": "com.amazonaws.ram#PermissionName",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the name of the resource share.</p>",
+            "smithy.api#documentation": "<p>Specifies the name of the customer managed permission. The name must be unique within the\n            Amazon Web Services Region.</p>",
             "smithy.api#required": {}
           }
         },
-        "resourceArns": {
-          "target": "com.amazonaws.ram#ResourceArnList",
-          "traits": {
-            "smithy.api#documentation": "<p>Specifies a list of one or more ARNs of the resources to associate with the\n            resource share.</p>"
-          }
-        },
-        "principals": {
-          "target": "com.amazonaws.ram#PrincipalArnOrIdList",
-          "traits": {
-            "smithy.api#documentation": "<p>Specifies a list of one or more principals to associate with the resource share.</p>\n         <p>You can include the following values:</p>\n         <ul>\n            <li>\n               <p>An Amazon Web Services account ID, for example: <code>123456789012</code>\n               </p>\n            </li>\n            <li>\n               <p>An <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of an organization in Organizations, for example:\n                        <code>organizations::123456789012:organization/o-exampleorgid</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an organizational unit (OU) in Organizations, for example:\n                        <code>organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM role, for example:\n                        <code>iam::123456789012:role/rolename</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM user, for example:\n                        <code>iam::123456789012user/username</code>\n               </p>\n            </li>\n         </ul>\n         <note>\n            <p>Not all resource types can be shared with IAM roles and users. \n             For more information, see <a href=\"https://docs.aws.amazon.com/ram/latest/userguide/permissions.html#permissions-rbp-supported-resource-types\">Sharing with IAM roles and users</a> in the <i>Resource Access Manager User\n                    Guide</i>.</p>\n         </note>"
-          }
-        },
-        "tags": {
-          "target": "com.amazonaws.ram#TagList",
+        "resourceType": {
+          "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies one or more tags to attach to the resource share itself. It doesn't attach the tags to\n            the resources associated with the resource share.</p>"
+            "smithy.api#documentation": "<p>Specifies the name of the resource type that this customer managed permission applies to.</p>\n         <p>The format is\n                    <code>\n               <i><service-code></i>:<i><resource-type></i>\n            </code>\n            and is not case sensitive. For example, to specify an Amazon EC2 Subnet, you can use the\n            string <code>ec2:subnet</code>. To see the list of valid values for this parameter,\n            query the <a>ListResourceTypes</a> operation.</p>",
+            "smithy.api#required": {}
           }
         },
-        "allowExternalPrincipals": {
-          "target": "com.amazonaws.ram#Boolean",
+        "policyTemplate": {
+          "target": "com.amazonaws.ram#Policy",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies whether principals outside your organization in Organizations can be associated\n            with a resource share. A value of <code>true</code> lets you share with individual Amazon Web Services accounts\n            that are <i>not</i> in your organization. A value of <code>false</code>\n            only has meaning if your account is a member of an Amazon Web Services Organization. The default value\n            is <code>true</code>.</p>"
+            "smithy.api#documentation": "<p>A string in JSON format string that contains the following elements of a\n            resource-based policy:</p>\n         <ul>\n            <li>\n               <p>\n                  <b>Effect</b>: must be set to\n                    <code>ALLOW</code>.</p>\n            </li>\n            <li>\n               <p>\n                  <b>Action</b>: specifies the actions that are\n                    allowed by this customer managed permission. The list must contain only actions that are supported by\n                    the specified resource type. For a list of all actions supported by each\n                    resource type, see <a href=\"https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html\">Actions, resources, and condition keys for Amazon Web Services services</a> in the\n                        <i>Identity and Access Management User Guide</i>.</p>\n            </li>\n            <li>\n               <p>\n                  <b>Condition</b>: (optional) specifies conditional \n                    parameters that must evaluate to true when a user attempts an action for that \n                    action to be allowed. For more information about the Condition element, see \n                    <a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html\">IAM\n                        policies: Condition element</a> in the <i>Identity and Access Management User\n                    Guide</i>.</p>\n            </li>\n         </ul>\n         <p>This template can't include either the <code>Resource</code> or\n            <code>Principal</code> elements. Those are both filled in by RAM when it instantiates \n            the resource-based policy on each resource shared using this managed permission. The \n            <code>Resource</code> comes from the ARN of the specific resource that you are sharing. \n            The <code>Principal</code> comes from the list of identities added to the resource \n            share.</p>",
+            "smithy.api#required": {}
           }
         },
         "clientToken": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>"
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
           }
         },
-        "permissionArns": {
-          "target": "com.amazonaws.ram#PermissionArnList",
+        "tags": {
+          "target": "com.amazonaws.ram#TagList",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Names (ARNs)</a> of the RAM permission to associate with the resource share. If you do\n            not specify an ARN for the permission, RAM automatically attaches the default version\n            of the permission for each resource type. You can associate only one permission with\n            each resource type included in the resource share.</p>"
+            "smithy.api#documentation": "<p>Specifies a list of one or more tag key and value pairs to attach to the\n            permission.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
-    "com.amazonaws.ram#CreateResourceShareResponse": {
+    "com.amazonaws.ram#CreatePermissionResponse": {
       "type": "structure",
       "members": {
-        "resourceShare": {
-          "target": "com.amazonaws.ram#ResourceShare",
+        "permission": {
+          "target": "com.amazonaws.ram#ResourceSharePermissionSummary",
           "traits": {
-            "smithy.api#documentation": "<p>An object with information about the new resource share.</p>"
+            "smithy.api#documentation": "<p>A structure with information about this customer managed permission.</p>"
           }
         },
         "clientToken": {
@@ -1522,18 +1673,18 @@
             "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
-    "com.amazonaws.ram#DateTime": {
-      "type": "timestamp"
-    },
-    "com.amazonaws.ram#DeleteResourceShare": {
+    "com.amazonaws.ram#CreatePermissionVersion": {
       "type": "operation",
       "input": {
-        "target": "com.amazonaws.ram#DeleteResourceShareRequest"
+        "target": "com.amazonaws.ram#CreatePermissionVersionRequest"
       },
       "output": {
-        "target": "com.amazonaws.ram#DeleteResourceShareResponse"
+        "target": "com.amazonaws.ram#CreatePermissionVersionResponse"
       },
       "errors": [
         {
@@ -1546,13 +1697,16 @@
           "target": "com.amazonaws.ram#InvalidParameterException"
         },
         {
-          "target": "com.amazonaws.ram#InvalidStateTransitionException"
+          "target": "com.amazonaws.ram#InvalidPolicyException"
         },
         {
           "target": "com.amazonaws.ram#MalformedArnException"
         },
         {
-          "target": "com.amazonaws.ram#OperationNotPermittedException"
+          "target": "com.amazonaws.ram#MalformedPolicyTemplateException"
+        },
+        {
+          "target": "com.amazonaws.ram#PermissionVersionsLimitExceededException"
         },
         {
           "target": "com.amazonaws.ram#ServerInternalException"
@@ -1565,43 +1719,47 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Deletes the specified resource share. This doesn't delete any of the resources that were\n            associated with the resource share; it only stops the sharing of those resources outside of the\n            Amazon Web Services account that created them.</p>",
+        "smithy.api#documentation": "<p>Creates a new version of the specified customer managed permission. The new version is automatically set as\n            the default version of the customer managed permission. New resource shares automatically use the default\n            permission. Existing resource shares continue to use their original permission versions,\n            but you can use <a>ReplacePermissionAssociations</a> to update them.</p>\n         <p>If the specified customer managed permission already has the maximum of 5 versions, then\n            you must delete one of the existing versions before you can create a new one.</p>",
         "smithy.api#http": {
-          "method": "DELETE",
-          "uri": "/deleteresourceshare",
+          "method": "POST",
+          "uri": "/createpermissionversion",
           "code": 200
         }
       }
     },
-    "com.amazonaws.ram#DeleteResourceShareRequest": {
+    "com.amazonaws.ram#CreatePermissionVersionRequest": {
       "type": "structure",
       "members": {
-        "resourceShareArn": {
+        "permissionArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share to delete.</p>",
-            "smithy.api#httpQuery": "resourceShareArn",
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the customer managed permission you're creating a new version for.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "policyTemplate": {
+          "target": "com.amazonaws.ram#Policy",
+          "traits": {
+            "smithy.api#documentation": "<p>A string in JSON format string that contains the following elements of a\n            resource-based policy:</p>\n         <ul>\n            <li>\n               <p>\n                  <b>Effect</b>: must be set to\n                    <code>ALLOW</code>.</p>\n            </li>\n            <li>\n               <p>\n                  <b>Action</b>: specifies the actions that are\n                    allowed by this customer managed permission. The list must contain only actions that are supported by\n                    the specified resource type. For a list of all actions supported by each\n                    resource type, see <a href=\"https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html\">Actions, resources, and condition keys for Amazon Web Services services</a> in the\n                        <i>Identity and Access Management User Guide</i>.</p>\n            </li>\n            <li>\n               <p>\n                  <b>Condition</b>: (optional) specifies conditional \n                    parameters that must evaluate to true when a user attempts an action for that \n                    action to be allowed. For more information about the Condition element, see \n                    <a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html\">IAM\n                        policies: Condition element</a> in the <i>Identity and Access Management User\n                    Guide</i>.</p>\n            </li>\n         </ul>\n         <p>This template can't include either the <code>Resource</code> or\n            <code>Principal</code> elements. Those are both filled in by RAM when it instantiates \n            the resource-based policy on each resource shared using this managed permission. The \n            <code>Resource</code> comes from the ARN of the specific resource that you are sharing. \n            The <code>Principal</code> comes from the list of identities added to the resource \n            share.</p>",
             "smithy.api#required": {}
           }
         },
         "clientToken": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>",
-            "smithy.api#httpQuery": "clientToken"
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
-    "com.amazonaws.ram#DeleteResourceShareResponse": {
+    "com.amazonaws.ram#CreatePermissionVersionResponse": {
       "type": "structure",
       "members": {
-        "returnValue": {
-          "target": "com.amazonaws.ram#Boolean",
-          "traits": {
-            "smithy.api#documentation": "<p>A return value of <code>true</code> indicates that the request succeeded. \n             A value of <code>false</code> indicates that the request failed.</p>",
-            "smithy.api#xmlName": "return"
-          }
+        "permission": {
+          "target": "com.amazonaws.ram#ResourceSharePermissionDetail"
         },
         "clientToken": {
           "target": "com.amazonaws.ram#String",
@@ -1609,15 +1767,18 @@
             "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
-    "com.amazonaws.ram#DisassociateResourceShare": {
+    "com.amazonaws.ram#CreateResourceShare": {
       "type": "operation",
       "input": {
-        "target": "com.amazonaws.ram#DisassociateResourceShareRequest"
+        "target": "com.amazonaws.ram#CreateResourceShareRequest"
       },
       "output": {
-        "target": "com.amazonaws.ram#DisassociateResourceShareResponse"
+        "target": "com.amazonaws.ram#CreateResourceShareResponse"
       },
       "errors": [
         {
@@ -1648,140 +1809,79 @@
           "target": "com.amazonaws.ram#ServiceUnavailableException"
         },
         {
-          "target": "com.amazonaws.ram#UnknownResourceException"
-        }
-      ],
-      "traits": {
-        "smithy.api#documentation": "<p>Disassociates the specified principals or resources from the specified resource share.</p>",
-        "smithy.api#http": {
-          "method": "POST",
-          "uri": "/disassociateresourceshare",
-          "code": 200
-        }
-      }
-    },
-    "com.amazonaws.ram#DisassociateResourceSharePermission": {
-      "type": "operation",
-      "input": {
-        "target": "com.amazonaws.ram#DisassociateResourceSharePermissionRequest"
-      },
-      "output": {
-        "target": "com.amazonaws.ram#DisassociateResourceSharePermissionResponse"
-      },
-      "errors": [
-        {
-          "target": "com.amazonaws.ram#InvalidClientTokenException"
-        },
-        {
-          "target": "com.amazonaws.ram#InvalidParameterException"
-        },
-        {
-          "target": "com.amazonaws.ram#InvalidStateTransitionException"
-        },
-        {
-          "target": "com.amazonaws.ram#MalformedArnException"
-        },
-        {
-          "target": "com.amazonaws.ram#OperationNotPermittedException"
-        },
-        {
-          "target": "com.amazonaws.ram#ServerInternalException"
-        },
-        {
-          "target": "com.amazonaws.ram#ServiceUnavailableException"
+          "target": "com.amazonaws.ram#TagPolicyViolationException"
         },
         {
           "target": "com.amazonaws.ram#UnknownResourceException"
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Disassociates an RAM permission from a resource share. Permission changes take effect\n            immediately. You can remove a RAM permission from a resource share only if there are currently\n            no resources of the relevant resource type currently attached to the resource share.</p>",
+        "smithy.api#documentation": "<p>Creates a resource share. You can provide a list of the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Names (ARNs)</a> for the resources that you\n            want to share, a list of principals you want to share the resources with, and the\n            permissions to grant those principals.</p>\n         <note>\n            <p>Sharing a resource makes it available for use by principals outside of the\n                Amazon Web Services account that created the resource. Sharing doesn't change any permissions or\n                quotas that apply to the resource in the account that created it.</p>\n         </note>",
         "smithy.api#http": {
           "method": "POST",
-          "uri": "/disassociateresourcesharepermission",
+          "uri": "/createresourceshare",
           "code": 200
         }
       }
     },
-    "com.amazonaws.ram#DisassociateResourceSharePermissionRequest": {
+    "com.amazonaws.ram#CreateResourceShareRequest": {
       "type": "structure",
       "members": {
-        "resourceShareArn": {
+        "name": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share from which you want to disassociate a permission.</p>",
+            "smithy.api#documentation": "<p>Specifies the name of the resource share.</p>",
             "smithy.api#required": {}
           }
         },
-        "permissionArn": {
-          "target": "com.amazonaws.ram#String",
+        "resourceArns": {
+          "target": "com.amazonaws.ram#ResourceArnList",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the permission to disassociate from the resource share. Changes to permissions\n            take effect immediately.</p>",
-            "smithy.api#required": {}
+            "smithy.api#documentation": "<p>Specifies a list of one or more ARNs of the resources to associate with the\n            resource share.</p>"
           }
         },
-        "clientToken": {
-          "target": "com.amazonaws.ram#String",
-          "traits": {
-            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>"
-          }
-        }
-      }
-    },
-    "com.amazonaws.ram#DisassociateResourceSharePermissionResponse": {
-      "type": "structure",
-      "members": {
-        "returnValue": {
-          "target": "com.amazonaws.ram#Boolean",
+        "principals": {
+          "target": "com.amazonaws.ram#PrincipalArnOrIdList",
           "traits": {
-            "smithy.api#documentation": "<p>A return value of <code>true</code> indicates that the request succeeded. \n             A value of <code>false</code> indicates that the request failed.</p>"
+            "smithy.api#documentation": "<p>Specifies a list of one or more principals to associate with the resource share.</p>\n         <p>You can include the following values:</p>\n         <ul>\n            <li>\n               <p>An Amazon Web Services account ID, for example: <code>123456789012</code>\n               </p>\n            </li>\n            <li>\n               <p>An <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an organization in Organizations, for example:\n                        <code>organizations::123456789012:organization/o-exampleorgid</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an organizational unit (OU) in Organizations, for example:\n                        <code>organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM role, for example:\n                        <code>iam::123456789012:role/rolename</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM user, for example:\n                        <code>iam::123456789012user/username</code>\n               </p>\n            </li>\n         </ul>\n         <note>\n            <p>Not all resource types can be shared with IAM roles and users. \n             For more information, see <a href=\"https://docs.aws.amazon.com/ram/latest/userguide/permissions.html#permissions-rbp-supported-resource-types\">Sharing with IAM roles and users</a> in the <i>Resource Access Manager User\n                    Guide</i>.</p>\n         </note>"
           }
         },
-        "clientToken": {
-          "target": "com.amazonaws.ram#String",
-          "traits": {
-            "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
-          }
-        }
-      }
-    },
-    "com.amazonaws.ram#DisassociateResourceShareRequest": {
-      "type": "structure",
-      "members": {
-        "resourceShareArn": {
-          "target": "com.amazonaws.ram#String",
+        "tags": {
+          "target": "com.amazonaws.ram#TagList",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share that you want to remove resources from.</p>",
-            "smithy.api#required": {}
+            "smithy.api#documentation": "<p>Specifies one or more tags to attach to the resource share itself. It doesn't attach the tags to\n            the resources associated with the resource share.</p>"
           }
         },
-        "resourceArns": {
-          "target": "com.amazonaws.ram#ResourceArnList",
+        "allowExternalPrincipals": {
+          "target": "com.amazonaws.ram#Boolean",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a list of <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Names (ARNs)</a> for one or more resources that you want to remove from\n            the resource share. After the operation runs, these resources are no longer shared with principals\n            outside of the Amazon Web Services account that created the resources.</p>"
+            "smithy.api#documentation": "<p>Specifies whether principals outside your organization in Organizations can be associated\n            with a resource share. A value of <code>true</code> lets you share with individual Amazon Web Services accounts\n            that are <i>not</i> in your organization. A value of <code>false</code>\n            only has meaning if your account is a member of an Amazon Web Services Organization. The default value\n            is <code>true</code>.</p>"
           }
         },
-        "principals": {
-          "target": "com.amazonaws.ram#PrincipalArnOrIdList",
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a list of one or more principals that no longer are to have access to the\n            resources in this resource share.</p>\n         <p>You can include the following values:</p>\n         <ul>\n            <li>\n               <p>An Amazon Web Services account ID, for example: <code>123456789012</code>\n               </p>\n            </li>\n            <li>\n               <p>An <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of an organization in Organizations, for example:\n                        <code>organizations::123456789012:organization/o-exampleorgid</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an organizational unit (OU) in Organizations, for example:\n                        <code>organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM role, for example:\n                        <code>iam::123456789012:role/rolename</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM user, for example:\n                        <code>iam::123456789012user/username</code>\n               </p>\n            </li>\n         </ul>\n         <note>\n            <p>Not all resource types can be shared with IAM roles and users. \n             For more information, see <a href=\"https://docs.aws.amazon.com/ram/latest/userguide/permissions.html#permissions-rbp-supported-resource-types\">Sharing with IAM roles and users</a> in the <i>Resource Access Manager User\n                    Guide</i>.</p>\n         </note>"
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
           }
         },
-        "clientToken": {
-          "target": "com.amazonaws.ram#String",
+        "permissionArns": {
+          "target": "com.amazonaws.ram#PermissionArnList",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>"
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Names (ARNs)</a> of the RAM permission to associate with the resource share. If you do\n            not specify an ARN for the permission, RAM automatically attaches the default version\n            of the permission for each resource type. You can associate only one permission with\n            each resource type included in the resource share.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
-    "com.amazonaws.ram#DisassociateResourceShareResponse": {
+    "com.amazonaws.ram#CreateResourceShareResponse": {
       "type": "structure",
       "members": {
-        "resourceShareAssociations": {
-          "target": "com.amazonaws.ram#ResourceShareAssociationList",
+        "resourceShare": {
+          "target": "com.amazonaws.ram#ResourceShare",
           "traits": {
-            "smithy.api#documentation": "<p>An array of objects that contain information about the updated associations for this\n            resource share.</p>"
+            "smithy.api#documentation": "<p>An object with information about the new resource share.</p>"
           }
         },
         "clientToken": {
@@ -1790,63 +1890,28 @@
             "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
           }
         }
-      }
-    },
-    "com.amazonaws.ram#EnableSharingWithAwsOrganization": {
-      "type": "operation",
-      "input": {
-        "target": "com.amazonaws.ram#EnableSharingWithAwsOrganizationRequest"
-      },
-      "output": {
-        "target": "com.amazonaws.ram#EnableSharingWithAwsOrganizationResponse"
       },
-      "errors": [
-        {
-          "target": "com.amazonaws.ram#OperationNotPermittedException"
-        },
-        {
-          "target": "com.amazonaws.ram#ServerInternalException"
-        },
-        {
-          "target": "com.amazonaws.ram#ServiceUnavailableException"
-        }
-      ],
       "traits": {
-        "smithy.api#documentation": "<p>Enables resource sharing within your organization in Organizations. Calling this operation\n            enables RAM to retrieve information about the organization and its structure. This\n            lets you share resources with all of the accounts in an organization by specifying the\n            organization's ID, or all of the accounts in an organizational unit (OU) by specifying\n            the OU's ID. Until you enable sharing within the organization, you can specify only\n            individual Amazon Web Services accounts, or for supported resource types, IAM users and\n            roles.</p>\n         <p>You must call this operation from an IAM user or role in the organization's\n            management account.</p>",
-        "smithy.api#http": {
-          "method": "POST",
-          "uri": "/enablesharingwithawsorganization",
-          "code": 200
-        }
+        "smithy.api#output": {}
       }
     },
-    "com.amazonaws.ram#EnableSharingWithAwsOrganizationRequest": {
-      "type": "structure",
-      "members": {}
-    },
-    "com.amazonaws.ram#EnableSharingWithAwsOrganizationResponse": {
-      "type": "structure",
-      "members": {
-        "returnValue": {
-          "target": "com.amazonaws.ram#Boolean",
-          "traits": {
-            "smithy.api#documentation": "<p>A return value of <code>true</code> indicates that the request succeeded. \n             A value of <code>false</code> indicates that the request failed.</p>",
-            "smithy.api#xmlName": "return"
-          }
-        }
-      }
+    "com.amazonaws.ram#DateTime": {
+      "type": "timestamp"
     },
-    "com.amazonaws.ram#GetPermission": {
+    "com.amazonaws.ram#DeletePermission": {
       "type": "operation",
       "input": {
-        "target": "com.amazonaws.ram#GetPermissionRequest"
+        "target": "com.amazonaws.ram#DeletePermissionRequest"
       },
       "output": {
-        "target": "com.amazonaws.ram#GetPermissionResponse"
+        "target": "com.amazonaws.ram#DeletePermissionResponse"
       },
       "errors": [
         {
-          "target": "com.amazonaws.ram#InvalidParameterException"
+          "target": "com.amazonaws.ram#IdempotentParameterMismatchException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidClientTokenException"
         },
         {
           "target": "com.amazonaws.ram#MalformedArnException"
@@ -1865,41 +1930,568 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Gets the contents of an RAM permission in JSON format.</p>",
+        "smithy.api#documentation": "<p>Deletes the specified customer managed permission in the Amazon Web Services Region in which you call this operation. You\n            can delete a customer managed permission only if it isn't attached to any resource share. The operation deletes all\n            versions associated with the customer managed permission.</p>",
         "smithy.api#http": {
-          "method": "POST",
-          "uri": "/getpermission",
+          "method": "DELETE",
+          "uri": "/deletepermission",
           "code": 200
         }
       }
     },
-    "com.amazonaws.ram#GetPermissionRequest": {
+    "com.amazonaws.ram#DeletePermissionRequest": {
       "type": "structure",
       "members": {
         "permissionArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the permission whose contents you want to retrieve.\n            To find the ARN for a permission, use either the <a>ListPermissions</a> operation or go to the <a href=\"https://console.aws.amazon.com/ram/home#Permissions:\">Permissions library</a> page in the RAM console and \n             then choose the name of the permission. The ARN is displayed on the detail page.</p>",
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the customer managed permission that you want to delete.</p>",
+            "smithy.api#httpQuery": "permissionArn",
             "smithy.api#required": {}
           }
         },
-        "permissionVersion": {
-          "target": "com.amazonaws.ram#Integer",
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies identifier for the version of the RAM permission to retrieve. If you don't\n            specify this parameter, the operation retrieves the default version.</p>"
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>",
+            "smithy.api#httpQuery": "clientToken"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
-    "com.amazonaws.ram#GetPermissionResponse": {
+    "com.amazonaws.ram#DeletePermissionResponse": {
+      "type": "structure",
+      "members": {
+        "returnValue": {
+          "target": "com.amazonaws.ram#Boolean",
+          "traits": {
+            "smithy.api#documentation": "<p>A boolean that indicates whether the delete operations succeeded.</p>",
+            "smithy.api#xmlName": "return"
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
+          }
+        },
+        "permissionStatus": {
+          "target": "com.amazonaws.ram#PermissionStatus",
+          "traits": {
+            "smithy.api#documentation": "<p>This operation is performed asynchronously, and this response parameter indicates the\n            current status.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#DeletePermissionVersion": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#DeletePermissionVersionRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#DeletePermissionVersionResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#IdempotentParameterMismatchException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidClientTokenException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#MalformedArnException"
+        },
+        {
+          "target": "com.amazonaws.ram#OperationNotPermittedException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        },
+        {
+          "target": "com.amazonaws.ram#UnknownResourceException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>Deletes one version of a customer managed permission. The version you specify must not be attached to any\n            resource share and must not be the default version for the permission.</p>\n         <p>If a customer managed permission has the maximum of 5 versions, then you must delete at\n            least one version before you can create another.</p>",
+        "smithy.api#http": {
+          "method": "DELETE",
+          "uri": "/deletepermissionversion",
+          "code": 200
+        }
+      }
+    },
+    "com.amazonaws.ram#DeletePermissionVersionRequest": {
+      "type": "structure",
+      "members": {
+        "permissionArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the permission with the version you want to delete.</p>",
+            "smithy.api#httpQuery": "permissionArn",
+            "smithy.api#required": {}
+          }
+        },
+        "permissionVersion": {
+          "target": "com.amazonaws.ram#Integer",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the version number to delete.</p>\n         <p>You can't delete the default version for a customer managed permission.</p>\n         <p>You can't delete a version if it's the only version of the permission. You must either\n            first create another version, or delete the permission completely.</p>\n         <p>You can't delete a version if it is attached to any resource shares. If the version is\n            the default, you must first use <a>SetDefaultPermissionVersion</a> to set a\n            different version as the default for the customer managed permission, and then use <a>AssociateResourceSharePermission</a> to update your resource shares to use\n            the new default version.</p>",
+            "smithy.api#httpQuery": "permissionVersion",
+            "smithy.api#required": {}
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>",
+            "smithy.api#httpQuery": "clientToken"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#DeletePermissionVersionResponse": {
+      "type": "structure",
+      "members": {
+        "returnValue": {
+          "target": "com.amazonaws.ram#Boolean",
+          "traits": {
+            "smithy.api#documentation": "<p>A boolean value that indicates whether the operation is successful.</p>",
+            "smithy.api#xmlName": "return"
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
+          }
+        },
+        "permissionStatus": {
+          "target": "com.amazonaws.ram#PermissionStatus",
+          "traits": {
+            "smithy.api#documentation": "<p>This operation is performed asynchronously, and this response parameter indicates the\n            current status.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#DeleteResourceShare": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#DeleteResourceShareRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#DeleteResourceShareResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#IdempotentParameterMismatchException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidClientTokenException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidStateTransitionException"
+        },
+        {
+          "target": "com.amazonaws.ram#MalformedArnException"
+        },
+        {
+          "target": "com.amazonaws.ram#OperationNotPermittedException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        },
+        {
+          "target": "com.amazonaws.ram#UnknownResourceException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>Deletes the specified resource share.</p>\n         <important>\n            <p>This doesn't delete any of the resources that were associated with the resource share; it\n                only stops the sharing of those resources through this resource share.</p>\n         </important>",
+        "smithy.api#http": {
+          "method": "DELETE",
+          "uri": "/deleteresourceshare",
+          "code": 200
+        }
+      }
+    },
+    "com.amazonaws.ram#DeleteResourceShareRequest": {
+      "type": "structure",
+      "members": {
+        "resourceShareArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share to delete.</p>",
+            "smithy.api#httpQuery": "resourceShareArn",
+            "smithy.api#required": {}
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>",
+            "smithy.api#httpQuery": "clientToken"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#DeleteResourceShareResponse": {
+      "type": "structure",
+      "members": {
+        "returnValue": {
+          "target": "com.amazonaws.ram#Boolean",
+          "traits": {
+            "smithy.api#documentation": "<p>A return value of <code>true</code> indicates that the request succeeded. \n             A value of <code>false</code> indicates that the request failed.</p>",
+            "smithy.api#xmlName": "return"
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#DisassociateResourceShare": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#DisassociateResourceShareRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#DisassociateResourceShareResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#IdempotentParameterMismatchException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidClientTokenException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidStateTransitionException"
+        },
+        {
+          "target": "com.amazonaws.ram#MalformedArnException"
+        },
+        {
+          "target": "com.amazonaws.ram#OperationNotPermittedException"
+        },
+        {
+          "target": "com.amazonaws.ram#ResourceShareLimitExceededException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        },
+        {
+          "target": "com.amazonaws.ram#UnknownResourceException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>Removes the specified principals or resources from participating in the specified\n            resource share.</p>",
+        "smithy.api#http": {
+          "method": "POST",
+          "uri": "/disassociateresourceshare",
+          "code": 200
+        }
+      }
+    },
+    "com.amazonaws.ram#DisassociateResourceSharePermission": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#DisassociateResourceSharePermissionRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#DisassociateResourceSharePermissionResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#InvalidClientTokenException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidStateTransitionException"
+        },
+        {
+          "target": "com.amazonaws.ram#MalformedArnException"
+        },
+        {
+          "target": "com.amazonaws.ram#OperationNotPermittedException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        },
+        {
+          "target": "com.amazonaws.ram#UnknownResourceException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>Removes a managed permission from a resource share. Permission changes take effect immediately. You can\n            remove a managed permission from a resource share only if there are currently no resources of the relevant\n            resource type currently attached to the resource share.</p>",
+        "smithy.api#http": {
+          "method": "POST",
+          "uri": "/disassociateresourcesharepermission",
+          "code": 200
+        }
+      }
+    },
+    "com.amazonaws.ram#DisassociateResourceSharePermissionRequest": {
+      "type": "structure",
+      "members": {
+        "resourceShareArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share that you want to remove the managed permission from.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "permissionArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the managed permission to disassociate from the resource share. Changes to permissions take\n            effect immediately.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#DisassociateResourceSharePermissionResponse": {
+      "type": "structure",
+      "members": {
+        "returnValue": {
+          "target": "com.amazonaws.ram#Boolean",
+          "traits": {
+            "smithy.api#documentation": "<p>A return value of <code>true</code> indicates that the request succeeded. \n             A value of <code>false</code> indicates that the request failed.</p>"
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#DisassociateResourceShareRequest": {
+      "type": "structure",
+      "members": {
+        "resourceShareArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share that you want to remove resources or principals\n            from.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "resourceArns": {
+          "target": "com.amazonaws.ram#ResourceArnList",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a list of <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Names (ARNs)</a> for one or more resources that you want to remove from\n            the resource share. After the operation runs, these resources are no longer shared with principals\n            associated with the resource share.</p>"
+          }
+        },
+        "principals": {
+          "target": "com.amazonaws.ram#PrincipalArnOrIdList",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a list of one or more principals that no longer are to have access to the\n            resources in this resource share.</p>\n         <p>You can include the following values:</p>\n         <ul>\n            <li>\n               <p>An Amazon Web Services account ID, for example: <code>123456789012</code>\n               </p>\n            </li>\n            <li>\n               <p>An <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an organization in Organizations, for example:\n                        <code>organizations::123456789012:organization/o-exampleorgid</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an organizational unit (OU) in Organizations, for example:\n                        <code>organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM role, for example:\n                        <code>iam::123456789012:role/rolename</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM user, for example:\n                        <code>iam::123456789012user/username</code>\n               </p>\n            </li>\n         </ul>\n         <note>\n            <p>Not all resource types can be shared with IAM roles and users. \n             For more information, see <a href=\"https://docs.aws.amazon.com/ram/latest/userguide/permissions.html#permissions-rbp-supported-resource-types\">Sharing with IAM roles and users</a> in the <i>Resource Access Manager User\n                    Guide</i>.</p>\n         </note>"
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#DisassociateResourceShareResponse": {
+      "type": "structure",
+      "members": {
+        "resourceShareAssociations": {
+          "target": "com.amazonaws.ram#ResourceShareAssociationList",
+          "traits": {
+            "smithy.api#documentation": "<p>An array of objects with information about the updated associations for this\n            resource share.</p>"
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#EnableSharingWithAwsOrganization": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#EnableSharingWithAwsOrganizationRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#EnableSharingWithAwsOrganizationResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#OperationNotPermittedException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>Enables resource sharing within your organization in Organizations. This operation creates\n            a service-linked role called <code>AWSServiceRoleForResourceAccessManager</code> that has the IAM managed policy\n            named AWSResourceAccessManagerServiceRolePolicy attached. This role permits RAM to retrieve information about\n            the organization and its structure. This lets you share resources with all of the\n            accounts in the calling account's organization by specifying the organization ID, or all\n            of the accounts in an organizational unit (OU) by specifying the OU ID. Until you enable\n            sharing within the organization, you can specify only individual Amazon Web Services accounts, or for\n            supported resource types, IAM roles and users.</p>\n         <p>You must call this operation from an IAM role or user in the organization's\n            management account.</p>\n         <p></p>",
+        "smithy.api#http": {
+          "method": "POST",
+          "uri": "/enablesharingwithawsorganization",
+          "code": 200
+        }
+      }
+    },
+    "com.amazonaws.ram#EnableSharingWithAwsOrganizationRequest": {
+      "type": "structure",
+      "members": {},
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#EnableSharingWithAwsOrganizationResponse": {
+      "type": "structure",
+      "members": {
+        "returnValue": {
+          "target": "com.amazonaws.ram#Boolean",
+          "traits": {
+            "smithy.api#documentation": "<p>A return value of <code>true</code> indicates that the request succeeded. \n             A value of <code>false</code> indicates that the request failed.</p>",
+            "smithy.api#xmlName": "return"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#GetPermission": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#GetPermissionRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#GetPermissionResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#InvalidParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#MalformedArnException"
+        },
+        {
+          "target": "com.amazonaws.ram#OperationNotPermittedException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        },
+        {
+          "target": "com.amazonaws.ram#UnknownResourceException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>Retrieves the contents of a managed permission in JSON format.</p>",
+        "smithy.api#http": {
+          "method": "POST",
+          "uri": "/getpermission",
+          "code": 200
+        }
+      }
+    },
+    "com.amazonaws.ram#GetPermissionRequest": {
+      "type": "structure",
+      "members": {
+        "permissionArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the permission whose contents you want to retrieve.\n            To find the ARN for a permission, use either the <a>ListPermissions</a> operation or go to the <a href=\"https://console.aws.amazon.com/ram/home#Permissions:\">Permissions library</a> page in the RAM console and \n             then choose the name of the permission. The ARN is displayed on the detail page.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "permissionVersion": {
+          "target": "com.amazonaws.ram#Integer",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the version number of the RAM permission to retrieve. If you don't specify\n            this parameter, the operation retrieves the default version.</p>\n         <p>To see the list of available versions, use <a>ListPermissionVersions</a>.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#GetPermissionResponse": {
       "type": "structure",
       "members": {
         "permission": {
           "target": "com.amazonaws.ram#ResourceSharePermissionDetail",
           "traits": {
-            "smithy.api#documentation": "<p>An object that contains information about the permission.</p>"
+            "smithy.api#documentation": "<p>An object with details about the permission.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#GetResourcePolicies": {
@@ -1972,6 +2564,9 @@
             "smithy.api#documentation": "<p>Specifies the total number of results that you want included on each page \n             of the response. If you do not include this parameter, it defaults to a value that is \n             specific to the operation. If additional items exist beyond the number you specify, the\n             <code>NextToken</code> response element is returned with a value (not null).\n             Include the specified value as the <code>NextToken</code> request parameter in the next \n             call to the operation to get the next part of the results. Note that the service might \n             return fewer results than the maximum even when there are more results available. You \n             should check <code>NextToken</code> after every operation to ensure that you receive all\n             of the results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#GetResourcePoliciesResponse": {
@@ -1989,6 +2584,9 @@
             "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#GetResourceShareAssociations": {
@@ -2023,7 +2621,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Retrieves the resource and principal associations for resource shares that you own.</p>",
+        "smithy.api#documentation": "<p>Retrieves the lists of resources and principals that associated for resource shares that you\n            own.</p>",
         "smithy.api#http": {
           "method": "POST",
           "uri": "/getresourceshareassociations",
@@ -2042,7 +2640,7 @@
         "associationType": {
           "target": "com.amazonaws.ram#ResourceShareAssociationType",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies whether you want to retrieve the associations that involve a specified\n            resource or principal.</p>\n         <ul>\n            <li>\n               <p>\n                  <code>PRINCIPAL</code> – list the principals that are associated with\n                    the specified resource share.</p>\n            </li>\n            <li>\n               <p>\n                  <code>RESOURCE</code> – list the resources that are associated with the\n                    specified resource share.</p>\n            </li>\n         </ul>",
+            "smithy.api#documentation": "<p>Specifies whether you want to retrieve the associations that involve a specified\n            resource or principal.</p>\n         <ul>\n            <li>\n               <p>\n                  <code>PRINCIPAL</code> – list the principals whose associations you\n                    want to see.</p>\n            </li>\n            <li>\n               <p>\n                  <code>RESOURCE</code> – list the resources whose associations you want\n                    to see.</p>\n            </li>\n         </ul>",
             "smithy.api#required": {}
           }
         },
@@ -2055,19 +2653,19 @@
         "resourceArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource whose resource shares you want to retrieve.</p>\n         <p>You cannot specify this parameter if the association type is\n            <code>PRINCIPAL</code>.</p>"
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of a resource whose resource shares you want to retrieve.</p>\n         <p>You cannot specify this parameter if the association type is\n            <code>PRINCIPAL</code>.</p>"
           }
         },
         "principal": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the ID of the principal whose resource shares you want to retrieve. This can be an\n            Amazon Web Services account ID, an organization ID, an organizational unit ID, or the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of an\n            individual IAM user or role.</p>\n         <p>You cannot specify this parameter if the association type is\n            <code>RESOURCE</code>.</p>"
+            "smithy.api#documentation": "<p>Specifies the ID of the principal whose resource shares you want to retrieve. This can be an\n            Amazon Web Services account ID, an organization ID, an organizational unit ID, or the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an\n            individual IAM user or role.</p>\n         <p>You cannot specify this parameter if the association type is\n            <code>RESOURCE</code>.</p>"
           }
         },
         "associationStatus": {
           "target": "com.amazonaws.ram#ResourceShareAssociationStatus",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies that you want to retrieve only associations with this status.</p>"
+            "smithy.api#documentation": "<p>Specifies that you want to retrieve only associations that have this status.</p>"
           }
         },
         "nextToken": {
@@ -2082,6 +2680,9 @@
             "smithy.api#documentation": "<p>Specifies the total number of results that you want included on each page \n             of the response. If you do not include this parameter, it defaults to a value that is \n             specific to the operation. If additional items exist beyond the number you specify, the\n             <code>NextToken</code> response element is returned with a value (not null).\n             Include the specified value as the <code>NextToken</code> request parameter in the next \n             call to the operation to get the next part of the results. Note that the service might \n             return fewer results than the maximum even when there are more results available. You \n             should check <code>NextToken</code> after every operation to ensure that you receive all\n             of the results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#GetResourceShareAssociationsResponse": {
@@ -2099,6 +2700,9 @@
             "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#GetResourceShareInvitations": {
@@ -2176,6 +2780,9 @@
             "smithy.api#documentation": "<p>Specifies the total number of results that you want included on each page \n             of the response. If you do not include this parameter, it defaults to a value that is \n             specific to the operation. If additional items exist beyond the number you specify, the\n             <code>NextToken</code> response element is returned with a value (not null).\n             Include the specified value as the <code>NextToken</code> request parameter in the next \n             call to the operation to get the next part of the results. Note that the service might \n             return fewer results than the maximum even when there are more results available. You \n             should check <code>NextToken</code> after every operation to ensure that you receive all\n             of the results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#GetResourceShareInvitationsResponse": {
@@ -2193,6 +2800,9 @@
             "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#GetResourceShares": {
@@ -2286,9 +2896,18 @@
         "permissionArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies that you want to retrieve details of only those resource shares that use the RAM\n            permission with this <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a>.</p>"
+            "smithy.api#documentation": "<p>Specifies that you want to retrieve details of only those resource shares that use the managed permission with\n            this <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a>.</p>"
+          }
+        },
+        "permissionVersion": {
+          "target": "com.amazonaws.ram#Integer",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want to retrieve details for only those resource shares that use the\n            specified version of the managed permission.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#GetResourceSharesResponse": {
@@ -2306,6 +2925,9 @@
             "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#IdempotentParameterMismatchException": {
@@ -2323,7 +2945,7 @@
           "code": "IdempotentParameterMismatch",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The client token input parameter was matched one used with a previous call to the\n            operation, but at least one of the other input parameters is different from the previous\n            call.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the client token input parameter matched one that was\n            used with a previous call to the operation, but at least one of the other input\n            parameters is different from the previous call.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -2346,7 +2968,7 @@
           "code": "InvalidClientToken",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The client token is not valid.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the specified client token isn't valid.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -2366,7 +2988,7 @@
           "code": "InvalidMaxResults",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The specified value for <code>MaxResults</code> is not valid.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the specified value for <code>MaxResults</code> isn't\n            valid.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -2386,7 +3008,7 @@
           "code": "InvalidNextToken",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The specified value for <code>NextToken</code> is not valid.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the specified value for <code>NextToken</code> isn't\n            valid. You must specify a value you received in the <code>NextToken</code> response of a\n            previous call to this operation.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -2406,7 +3028,27 @@
           "code": "InvalidParameter",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>A parameter is not valid.</p>",
+        "smithy.api#documentation": "<p>The operation failed because a parameter you specified isn't valid.</p>",
+        "smithy.api#error": "client",
+        "smithy.api#httpError": 400
+      }
+    },
+    "com.amazonaws.ram#InvalidPolicyException": {
+      "type": "structure",
+      "members": {
+        "message": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#required": {}
+          }
+        }
+      },
+      "traits": {
+        "aws.protocols#awsQueryError": {
+          "code": "InvalidPolicy",
+          "httpResponseCode": 400
+        },
+        "smithy.api#documentation": "<p>The operation failed because a policy you specified isn't valid.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -2426,7 +3068,7 @@
           "code": "InvalidResourceType.Unknown",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The specified resource type is not valid.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the specified resource type isn't valid.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -2446,7 +3088,7 @@
           "code": "InvalidStateTransitionException.Unknown",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The requested state transition is not valid.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the requested operation isn't valid for the resource\n            share in its current state.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -2508,8 +3150,129 @@
         "resourceShareInvitationArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the invitation. You can use <a>GetResourceShareInvitations</a> to find the ARN of the invitation.</p>",
-            "smithy.api#required": {}
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the invitation. You can use <a>GetResourceShareInvitations</a> to find the ARN of the invitation.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "nextToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want to receive the next page of results. Valid \n             only if you received a <code>NextToken</code> response in the previous request. If you\n             did, it indicates that more output is available. Set this parameter to the value \n             provided by the previous call's <code>NextToken</code> response to request the \n             next page of results.</p>"
+          }
+        },
+        "maxResults": {
+          "target": "com.amazonaws.ram#MaxResults",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the total number of results that you want included on each page \n             of the response. If you do not include this parameter, it defaults to a value that is \n             specific to the operation. If additional items exist beyond the number you specify, the\n             <code>NextToken</code> response element is returned with a value (not null).\n             Include the specified value as the <code>NextToken</code> request parameter in the next \n             call to the operation to get the next part of the results. Note that the service might \n             return fewer results than the maximum even when there are more results available. You \n             should check <code>NextToken</code> after every operation to ensure that you receive all\n             of the results.</p>"
+          }
+        },
+        "resourceRegionScope": {
+          "target": "com.amazonaws.ram#ResourceRegionScopeFilter",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want the results to include only \n            resources that have the specified scope.</p>\n         <ul>\n            <li>\n               <p>\n                  <code>ALL</code> – the results include both global and \n                    regional resources or resource types.</p>\n            </li>\n            <li>\n               <p>\n                  <code>GLOBAL</code> – the results include only global \n                    resources or resource types.</p>\n            </li>\n            <li>\n               <p>\n                  <code>REGIONAL</code> – the results include only regional \n                    resources or resource types.</p>\n            </li>\n         </ul>\n         <p>The default value is <code>ALL</code>.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#ListPendingInvitationResourcesResponse": {
+      "type": "structure",
+      "members": {
+        "resources": {
+          "target": "com.amazonaws.ram#ResourceList",
+          "traits": {
+            "smithy.api#documentation": "<p>An array of objects that contain the information about the resources included the\n            specified resource share.</p>"
+          }
+        },
+        "nextToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#ListPermissionAssociations": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#ListPermissionAssociationsRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#ListPermissionAssociationsResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#InvalidNextTokenException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#MalformedArnException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>Lists information about the managed permission and its associations to any resource shares that use\n            this managed permission. This lets you see which resource shares use which versions of the specified\n            managed permission.</p>",
+        "smithy.api#http": {
+          "method": "POST",
+          "uri": "/listpermissionassociations",
+          "code": 200
+        },
+        "smithy.api#paginated": {
+          "inputToken": "nextToken",
+          "outputToken": "nextToken",
+          "pageSize": "maxResults"
+        }
+      }
+    },
+    "com.amazonaws.ram#ListPermissionAssociationsRequest": {
+      "type": "structure",
+      "members": {
+        "permissionArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the managed permission.</p>"
+          }
+        },
+        "permissionVersion": {
+          "target": "com.amazonaws.ram#Integer",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want to list only those associations with resource shares that use this\n            version of the managed permission. If you don't provide a value for this parameter, then the operation\n            returns information about associations with resource shares that use any version of the\n            managed permission.</p>"
+          }
+        },
+        "associationStatus": {
+          "target": "com.amazonaws.ram#ResourceShareAssociationStatus",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want to list only those associations with resource shares that match this\n            status.</p>"
+          }
+        },
+        "resourceType": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want to list only those associations with resource shares that include at\n            least one resource of this resource type.</p>"
+          }
+        },
+        "featureSet": {
+          "target": "com.amazonaws.ram#PermissionFeatureSet",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want to list only those associations with resource shares that have a\n                <code>featureSet</code> with this value.</p>"
+          }
+        },
+        "defaultVersion": {
+          "target": "com.amazonaws.ram#Boolean",
+          "traits": {
+            "smithy.api#documentation": "<p>When <code>true</code>, specifies that you want to list only those associations with\n            resource shares that use the default version of the specified managed permission.</p>\n         <p>When <code>false</code> (the default value), lists associations with resource shares that use\n            any version of the specified managed permission.</p>"
           }
         },
         "nextToken": {
@@ -2523,22 +3286,19 @@
           "traits": {
             "smithy.api#documentation": "<p>Specifies the total number of results that you want included on each page \n             of the response. If you do not include this parameter, it defaults to a value that is \n             specific to the operation. If additional items exist beyond the number you specify, the\n             <code>NextToken</code> response element is returned with a value (not null).\n             Include the specified value as the <code>NextToken</code> request parameter in the next \n             call to the operation to get the next part of the results. Note that the service might \n             return fewer results than the maximum even when there are more results available. You \n             should check <code>NextToken</code> after every operation to ensure that you receive all\n             of the results.</p>"
           }
-        },
-        "resourceRegionScope": {
-          "target": "com.amazonaws.ram#ResourceRegionScopeFilter",
-          "traits": {
-            "smithy.api#documentation": "<p>Specifies that you want the results to include only \n            resources that have the specified scope.</p>\n         <ul>\n            <li>\n               <p>\n                  <code>ALL</code> – the results include both global and \n                    regional resources or resource types.</p>\n            </li>\n            <li>\n               <p>\n                  <code>GLOBAL</code> – the results include only global \n                    resources or resource types.</p>\n            </li>\n            <li>\n               <p>\n                  <code>REGIONAL</code> – the results include only regional \n                    resources or resource types.</p>\n            </li>\n         </ul>\n         <p>The default value is <code>ALL</code>.</p>"
-          }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
-    "com.amazonaws.ram#ListPendingInvitationResourcesResponse": {
+    "com.amazonaws.ram#ListPermissionAssociationsResponse": {
       "type": "structure",
       "members": {
-        "resources": {
-          "target": "com.amazonaws.ram#ResourceList",
+        "permissions": {
+          "target": "com.amazonaws.ram#AssociatedPermissionList",
           "traits": {
-            "smithy.api#documentation": "<p>An array of objects that contain the information about the resources included the\n            specified resource share.</p>"
+            "smithy.api#documentation": "<p>A structure with information about this customer managed permission.</p>"
           }
         },
         "nextToken": {
@@ -2547,6 +3307,9 @@
             "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#ListPermissionVersions": {
@@ -2600,7 +3363,7 @@
         "permissionArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the RAM permission whose versions you want to list. You\n            can use the <code>permissionVersion</code> parameter on the <a>AssociateResourceSharePermission</a> operation to specify a non-default\n            version to attach.</p>",
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the RAM permission whose versions you want to list. You\n            can use the <code>permissionVersion</code> parameter on the <a>AssociateResourceSharePermission</a> operation to specify a non-default\n            version to attach.</p>",
             "smithy.api#required": {}
           }
         },
@@ -2616,6 +3379,9 @@
             "smithy.api#documentation": "<p>Specifies the total number of results that you want included on each page \n             of the response. If you do not include this parameter, it defaults to a value that is \n             specific to the operation. If additional items exist beyond the number you specify, the\n             <code>NextToken</code> response element is returned with a value (not null).\n             Include the specified value as the <code>NextToken</code> request parameter in the next \n             call to the operation to get the next part of the results. Note that the service might \n             return fewer results than the maximum even when there are more results available. You \n             should check <code>NextToken</code> after every operation to ensure that you receive all\n             of the results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#ListPermissionVersionsResponse": {
@@ -2633,6 +3399,9 @@
             "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#ListPermissions": {
@@ -2680,7 +3449,7 @@
         "resourceType": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies that you want to list permissions for only the specified resource type. For\n            example, to list only permissions that apply to EC2 subnets, specify\n                <code>ec2:Subnet</code>. You can use the <a>ListResourceTypes</a>\n            operation to get the specific string required.</p>"
+            "smithy.api#documentation": "<p>Specifies that you want to list only those permissions that apply to the specified\n            resource type. This parameter is not case sensitive.</p>\n         <p>For example, to list only permissions that apply to Amazon EC2 subnets, specify\n                <code>ec2:subnet</code>. You can use the <a>ListResourceTypes</a>\n            operation to get the specific string required.</p>"
           }
         },
         "nextToken": {
@@ -2694,7 +3463,16 @@
           "traits": {
             "smithy.api#documentation": "<p>Specifies the total number of results that you want included on each page \n             of the response. If you do not include this parameter, it defaults to a value that is \n             specific to the operation. If additional items exist beyond the number you specify, the\n             <code>NextToken</code> response element is returned with a value (not null).\n             Include the specified value as the <code>NextToken</code> request parameter in the next \n             call to the operation to get the next part of the results. Note that the service might \n             return fewer results than the maximum even when there are more results available. You \n             should check <code>NextToken</code> after every operation to ensure that you receive all\n             of the results.</p>"
           }
+        },
+        "permissionType": {
+          "target": "com.amazonaws.ram#PermissionTypeFilter",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want to list only permissions of this type:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>AWS</code> – returns only Amazon Web Services managed permissions.</p>\n            </li>\n            <li>\n               <p>\n                  <code>LOCAL</code> – returns only customer managed permissions</p>\n            </li>\n            <li>\n               <p>\n                  <code>ALL</code> – returns both Amazon Web Services managed permissions and customer managed permissions.</p>\n            </li>\n         </ul>\n         <p>If you don't specify this parameter, the default is <code>All</code>.</p>"
+          }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#ListPermissionsResponse": {
@@ -2712,6 +3490,9 @@
             "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#ListPrincipals": {
@@ -2769,13 +3550,13 @@
         "resourceArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies that you want to list principal information for the resource share with the specified\n            <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a>.</p>"
+            "smithy.api#documentation": "<p>Specifies that you want to list principal information for the resource share with the specified\n            <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a>.</p>"
           }
         },
         "principals": {
           "target": "com.amazonaws.ram#PrincipalArnOrIdList",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies that you want to list information for only the listed principals.</p>\n         <p>You can include the following values:</p>\n         <ul>\n            <li>\n               <p>An Amazon Web Services account ID, for example: <code>123456789012</code>\n               </p>\n            </li>\n            <li>\n               <p>An <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of an organization in Organizations, for example:\n                        <code>organizations::123456789012:organization/o-exampleorgid</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an organizational unit (OU) in Organizations, for example:\n                        <code>organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM role, for example:\n                        <code>iam::123456789012:role/rolename</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM user, for example:\n                        <code>iam::123456789012user/username</code>\n               </p>\n            </li>\n         </ul>\n         <note>\n            <p>Not all resource types can be shared with IAM roles and users. \n             For more information, see <a href=\"https://docs.aws.amazon.com/ram/latest/userguide/permissions.html#permissions-rbp-supported-resource-types\">Sharing with IAM roles and users</a> in the <i>Resource Access Manager User\n                    Guide</i>.</p>\n         </note>"
+            "smithy.api#documentation": "<p>Specifies that you want to list information for only the listed principals.</p>\n         <p>You can include the following values:</p>\n         <ul>\n            <li>\n               <p>An Amazon Web Services account ID, for example: <code>123456789012</code>\n               </p>\n            </li>\n            <li>\n               <p>An <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an organization in Organizations, for example:\n                        <code>organizations::123456789012:organization/o-exampleorgid</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an organizational unit (OU) in Organizations, for example:\n                        <code>organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM role, for example:\n                        <code>iam::123456789012:role/rolename</code>\n               </p>\n            </li>\n            <li>\n               <p>An ARN of an IAM user, for example:\n                        <code>iam::123456789012user/username</code>\n               </p>\n            </li>\n         </ul>\n         <note>\n            <p>Not all resource types can be shared with IAM roles and users. \n             For more information, see <a href=\"https://docs.aws.amazon.com/ram/latest/userguide/permissions.html#permissions-rbp-supported-resource-types\">Sharing with IAM roles and users</a> in the <i>Resource Access Manager User\n                    Guide</i>.</p>\n         </note>"
           }
         },
         "resourceType": {
@@ -2802,6 +3583,9 @@
             "smithy.api#documentation": "<p>Specifies the total number of results that you want included on each page \n             of the response. If you do not include this parameter, it defaults to a value that is \n             specific to the operation. If additional items exist beyond the number you specify, the\n             <code>NextToken</code> response element is returned with a value (not null).\n             Include the specified value as the <code>NextToken</code> request parameter in the next \n             call to the operation to get the next part of the results. Note that the service might \n             return fewer results than the maximum even when there are more results available. You \n             should check <code>NextToken</code> after every operation to ensure that you receive all\n             of the results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#ListPrincipalsResponse": {
@@ -2819,6 +3603,97 @@
             "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#ListReplacePermissionAssociationsWork": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#ListReplacePermissionAssociationsWorkRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#ListReplacePermissionAssociationsWorkResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#InvalidNextTokenException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>Retrieves the current status of the asynchronous tasks performed by RAM when you\n            perform the <a>ReplacePermissionAssociationsWork</a> operation.</p>",
+        "smithy.api#http": {
+          "method": "POST",
+          "uri": "/listreplacepermissionassociationswork",
+          "code": 200
+        },
+        "smithy.api#paginated": {
+          "inputToken": "nextToken",
+          "outputToken": "nextToken",
+          "pageSize": "maxResults"
+        }
+      }
+    },
+    "com.amazonaws.ram#ListReplacePermissionAssociationsWorkRequest": {
+      "type": "structure",
+      "members": {
+        "workIds": {
+          "target": "com.amazonaws.ram#ReplacePermissionAssociationsWorkIdList",
+          "traits": {
+            "smithy.api#documentation": "<p>A list of IDs. These values come from the <code>id</code>field of the\n                <code>replacePermissionAssociationsWork</code>structure returned by the <a>ReplacePermissionAssociations</a> operation. </p>"
+          }
+        },
+        "status": {
+          "target": "com.amazonaws.ram#ReplacePermissionAssociationsWorkStatus",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want to see only the details about requests with a status that\n            matches this value.</p>"
+          }
+        },
+        "nextToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want to receive the next page of results. Valid \n             only if you received a <code>NextToken</code> response in the previous request. If you\n             did, it indicates that more output is available. Set this parameter to the value \n             provided by the previous call's <code>NextToken</code> response to request the \n             next page of results.</p>"
+          }
+        },
+        "maxResults": {
+          "target": "com.amazonaws.ram#MaxResults",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the total number of results that you want included on each page \n             of the response. If you do not include this parameter, it defaults to a value that is \n             specific to the operation. If additional items exist beyond the number you specify, the\n             <code>NextToken</code> response element is returned with a value (not null).\n             Include the specified value as the <code>NextToken</code> request parameter in the next \n             call to the operation to get the next part of the results. Note that the service might \n             return fewer results than the maximum even when there are more results available. You \n             should check <code>NextToken</code> after every operation to ensure that you receive all\n             of the results.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#ListReplacePermissionAssociationsWorkResponse": {
+      "type": "structure",
+      "members": {
+        "replacePermissionAssociationsWorks": {
+          "target": "com.amazonaws.ram#ReplacePermissionAssociationsWorkList",
+          "traits": {
+            "smithy.api#documentation": "<p>An array of data structures that provide details of the matching work IDs.</p>"
+          }
+        },
+        "nextToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#ListResourceSharePermissions": {
@@ -2872,7 +3747,7 @@
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share for which you want to retrieve the associated\n            permissions.</p>",
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share for which you want to retrieve the associated\n            permissions.</p>",
             "smithy.api#required": {}
           }
         },
@@ -2888,6 +3763,9 @@
             "smithy.api#documentation": "<p>Specifies the total number of results that you want included on each page \n             of the response. If you do not include this parameter, it defaults to a value that is \n             specific to the operation. If additional items exist beyond the number you specify, the\n             <code>NextToken</code> response element is returned with a value (not null).\n             Include the specified value as the <code>NextToken</code> request parameter in the next \n             call to the operation to get the next part of the results. Note that the service might \n             return fewer results than the maximum even when there are more results available. You \n             should check <code>NextToken</code> after every operation to ensure that you receive all\n             of the results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#ListResourceSharePermissionsResponse": {
@@ -2905,6 +3783,9 @@
             "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#ListResourceTypes": {
@@ -2964,6 +3845,9 @@
             "smithy.api#documentation": "<p>Specifies that you want the results to include only \n            resources that have the specified scope.</p>\n         <ul>\n            <li>\n               <p>\n                  <code>ALL</code> – the results include both global and \n                    regional resources or resource types.</p>\n            </li>\n            <li>\n               <p>\n                  <code>GLOBAL</code> – the results include only global \n                    resources or resource types.</p>\n            </li>\n            <li>\n               <p>\n                  <code>REGIONAL</code> – the results include only regional \n                    resources or resource types.</p>\n            </li>\n         </ul>\n         <p>The default value is <code>ALL</code>.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#ListResourceTypesResponse": {
@@ -2981,6 +3865,9 @@
             "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#ListResources": {
@@ -3080,26 +3967,173 @@
             "smithy.api#documentation": "<p>Specifies that you want the results to include only \n            resources that have the specified scope.</p>\n         <ul>\n            <li>\n               <p>\n                  <code>ALL</code> – the results include both global and \n                    regional resources or resource types.</p>\n            </li>\n            <li>\n               <p>\n                  <code>GLOBAL</code> – the results include only global \n                    resources or resource types.</p>\n            </li>\n            <li>\n               <p>\n                  <code>REGIONAL</code> – the results include only regional \n                    resources or resource types.</p>\n            </li>\n         </ul>\n         <p>The default value is <code>ALL</code>.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#ListResourcesResponse": {
+      "type": "structure",
+      "members": {
+        "resources": {
+          "target": "com.amazonaws.ram#ResourceList",
+          "traits": {
+            "smithy.api#documentation": "<p>An array of objects that contain information about the resources.</p>"
+          }
+        },
+        "nextToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#MalformedArnException": {
+      "type": "structure",
+      "members": {
+        "message": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#required": {}
+          }
+        }
+      },
+      "traits": {
+        "aws.protocols#awsQueryError": {
+          "code": "InvalidArn.Malformed",
+          "httpResponseCode": 400
+        },
+        "smithy.api#documentation": "<p>The operation failed because the specified <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> has a format that isn't\n            valid.</p>",
+        "smithy.api#error": "client",
+        "smithy.api#httpError": 400
+      }
+    },
+    "com.amazonaws.ram#MalformedPolicyTemplateException": {
+      "type": "structure",
+      "members": {
+        "message": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#required": {}
+          }
+        }
+      },
+      "traits": {
+        "aws.protocols#awsQueryError": {
+          "code": "MalformedPolicyTemplateException",
+          "httpResponseCode": 400
+        },
+        "smithy.api#documentation": "<p>The operation failed because the policy template that you provided isn't valid.</p>",
+        "smithy.api#error": "client",
+        "smithy.api#httpError": 400
+      }
+    },
+    "com.amazonaws.ram#MaxResults": {
+      "type": "integer",
+      "traits": {
+        "smithy.api#range": {
+          "min": 1,
+          "max": 500
+        }
+      }
+    },
+    "com.amazonaws.ram#MissingRequiredParameterException": {
+      "type": "structure",
+      "members": {
+        "message": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#required": {}
+          }
+        }
+      },
+      "traits": {
+        "aws.protocols#awsQueryError": {
+          "code": "MissingRequiredParameter",
+          "httpResponseCode": 400
+        },
+        "smithy.api#documentation": "<p>The operation failed because a required input parameter is missing.</p>",
+        "smithy.api#error": "client",
+        "smithy.api#httpError": 400
+      }
+    },
+    "com.amazonaws.ram#OperationNotPermittedException": {
+      "type": "structure",
+      "members": {
+        "message": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#required": {}
+          }
+        }
+      },
+      "traits": {
+        "aws.protocols#awsQueryError": {
+          "code": "OperationNotPermitted",
+          "httpResponseCode": 400
+        },
+        "smithy.api#documentation": "<p>The operation failed because the requested operation isn't permitted.</p>",
+        "smithy.api#error": "client",
+        "smithy.api#httpError": 400
+      }
+    },
+    "com.amazonaws.ram#PermissionAlreadyExistsException": {
+      "type": "structure",
+      "members": {
+        "message": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#required": {}
+          }
+        }
+      },
+      "traits": {
+        "aws.protocols#awsQueryError": {
+          "code": "PermissionAlreadyExistsException",
+          "httpResponseCode": 409
+        },
+        "smithy.api#documentation": "<p>The operation failed because a permission with the specified name already exists in\n            the requested Amazon Web Services Region. Choose a different name.</p>",
+        "smithy.api#error": "client",
+        "smithy.api#httpError": 409
+      }
+    },
+    "com.amazonaws.ram#PermissionArnList": {
+      "type": "list",
+      "member": {
+        "target": "com.amazonaws.ram#String",
+        "traits": {
+          "smithy.api#xmlName": "item"
+        }
       }
     },
-    "com.amazonaws.ram#ListResourcesResponse": {
-      "type": "structure",
+    "com.amazonaws.ram#PermissionFeatureSet": {
+      "type": "enum",
       "members": {
-        "resources": {
-          "target": "com.amazonaws.ram#ResourceList",
+        "CREATED_FROM_POLICY": {
+          "target": "smithy.api#Unit",
           "traits": {
-            "smithy.api#documentation": "<p>An array of objects that contain information about the resources.</p>"
+            "smithy.api#enumValue": "CREATED_FROM_POLICY"
           }
         },
-        "nextToken": {
-          "target": "com.amazonaws.ram#String",
+        "PROMOTING_TO_STANDARD": {
+          "target": "smithy.api#Unit",
           "traits": {
-            "smithy.api#documentation": "<p>If present, this value indicates that more output is available than \n             is included in the current response. Use this value in the <code>NextToken</code> \n             request parameter in a subsequent call to the operation to get the next part of the \n             output. You should repeat this until the <code>NextToken</code> response element comes \n             back as <code>null</code>. This indicates that this is the last page of results.</p>"
+            "smithy.api#enumValue": "PROMOTING_TO_STANDARD"
+          }
+        },
+        "STANDARD": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "STANDARD"
           }
         }
       }
     },
-    "com.amazonaws.ram#MalformedArnException": {
+    "com.amazonaws.ram#PermissionLimitExceededException": {
       "type": "structure",
       "members": {
         "message": {
@@ -3111,44 +4145,94 @@
       },
       "traits": {
         "aws.protocols#awsQueryError": {
-          "code": "InvalidArn.Malformed",
+          "code": "PermissionLimitExceededException",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The format of an Amazon Resource Name (ARN) is not valid.</p>",
+        "smithy.api#documentation": "<p>The operation failed because it would exceed the maximum number of permissions you can\n            create in each Amazon Web Services Region. To view the limits for your Amazon Web Services account, see the <a href=\"https://console.aws.amazon.com/servicequotas/home/services/ram/quotas\">RAM page in the\n                Service Quotas console</a>.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
     },
-    "com.amazonaws.ram#MaxResults": {
-      "type": "integer",
+    "com.amazonaws.ram#PermissionName": {
+      "type": "string",
       "traits": {
-        "smithy.api#range": {
+        "smithy.api#length": {
           "min": 1,
-          "max": 500
+          "max": 36
+        },
+        "smithy.api#pattern": "^[\\w.-]*$"
+      }
+    },
+    "com.amazonaws.ram#PermissionStatus": {
+      "type": "enum",
+      "members": {
+        "ATTACHABLE": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "ATTACHABLE"
+          }
+        },
+        "UNATTACHABLE": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "UNATTACHABLE"
+          }
+        },
+        "DELETING": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "DELETING"
+          }
+        },
+        "DELETED": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "DELETED"
+          }
         }
       }
     },
-    "com.amazonaws.ram#MissingRequiredParameterException": {
-      "type": "structure",
+    "com.amazonaws.ram#PermissionType": {
+      "type": "enum",
       "members": {
-        "message": {
-          "target": "com.amazonaws.ram#String",
+        "CUSTOMER_MANAGED": {
+          "target": "smithy.api#Unit",
           "traits": {
-            "smithy.api#required": {}
+            "smithy.api#enumValue": "CUSTOMER_MANAGED"
+          }
+        },
+        "AWS_MANAGED": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "AWS_MANAGED"
           }
         }
-      },
-      "traits": {
-        "aws.protocols#awsQueryError": {
-          "code": "MissingRequiredParameter",
-          "httpResponseCode": 400
+      }
+    },
+    "com.amazonaws.ram#PermissionTypeFilter": {
+      "type": "enum",
+      "members": {
+        "ALL": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "ALL"
+          }
         },
-        "smithy.api#documentation": "<p>A required input parameter is missing.</p>",
-        "smithy.api#error": "client",
-        "smithy.api#httpError": 400
+        "AWS_MANAGED": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "AWS_MANAGED"
+          }
+        },
+        "CUSTOMER_MANAGED": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "CUSTOMER_MANAGED"
+          }
+        }
       }
     },
-    "com.amazonaws.ram#OperationNotPermittedException": {
+    "com.amazonaws.ram#PermissionVersionsLimitExceededException": {
       "type": "structure",
       "members": {
         "message": {
@@ -3160,23 +4244,14 @@
       },
       "traits": {
         "aws.protocols#awsQueryError": {
-          "code": "OperationNotPermitted",
+          "code": "PermissionVersionsLimitExceededException",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The requested operation is not permitted.</p>",
+        "smithy.api#documentation": "<p>The operation failed because it would exceed the limit for the number of versions you\n            can have for a permission. To view the limits for your Amazon Web Services account, see the <a href=\"https://console.aws.amazon.com/servicequotas/home/services/ram/quotas\">RAM page in the\n                Service Quotas console</a>.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
     },
-    "com.amazonaws.ram#PermissionArnList": {
-      "type": "list",
-      "member": {
-        "target": "com.amazonaws.ram#String",
-        "traits": {
-          "smithy.api#xmlName": "item"
-        }
-      }
-    },
     "com.amazonaws.ram#Policy": {
       "type": "string"
     },
@@ -3195,13 +4270,13 @@
         "id": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The ID of the principal.</p>"
+            "smithy.api#documentation": "<p>The ID of the principal that can be associated with a resource share.</p>"
           }
         },
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of a resource share the principal is associated with.</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of a resource share the principal is associated with.</p>"
           }
         },
         "creationTime": {
@@ -3213,13 +4288,13 @@
         "lastUpdatedTime": {
           "target": "com.amazonaws.ram#DateTime",
           "traits": {
-            "smithy.api#documentation": "<p>The date and time when the association was last updated.</p>"
+            "smithy.api#documentation": "<p>The date and time when the association between the resource share and the principal\n            was last updated.</p>"
           }
         },
         "external": {
           "target": "com.amazonaws.ram#Boolean",
           "traits": {
-            "smithy.api#documentation": "<p>Indicates whether the principal belongs to the same organization in Organizations as the\n            Amazon Web Services account that owns the resource share.</p>"
+            "smithy.api#documentation": "<p>Indicates the relationship between the Amazon Web Services account the principal belongs to and the\n            account that owns the resource share:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>True</code> – The two accounts belong to same\n                    organization.</p>\n            </li>\n            <li>\n               <p>\n                  <code>False</code> – The two accounts do not belong to the same\n                    organization.</p>\n            </li>\n         </ul>"
           }
         }
       },
@@ -3245,6 +4320,91 @@
         }
       }
     },
+    "com.amazonaws.ram#PromotePermissionCreatedFromPolicy": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#PromotePermissionCreatedFromPolicyRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#PromotePermissionCreatedFromPolicyResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#InvalidParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#MalformedArnException"
+        },
+        {
+          "target": "com.amazonaws.ram#MissingRequiredParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#OperationNotPermittedException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        },
+        {
+          "target": "com.amazonaws.ram#UnknownResourceException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>When you attach a resource-based policy to a resource, RAM automatically creates\n            a resource share of <code>featureSet</code>=<code>CREATED_FROM_POLICY</code> with a managed permission that\n            has the same IAM permissions as the original resource-based policy. However, this type\n            of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by\n            using RAM.</p>\n         <p>This operation creates a separate, fully manageable customer managed permission that has the same IAM\n            permissions as the original resource-based policy. You can associate this customer managed permission to any\n            resource shares.</p>\n         <p>Before you use <a>PromoteResourceShareCreatedFromPolicy</a>, you should\n            first run this operation to ensure that you have an appropriate customer managed permission that can be\n            associated with the promoted resource share.</p>\n         <note>\n            <ul>\n               <li>\n                  <p>The original <code>CREATED_FROM_POLICY</code> policy isn't deleted, and\n                        resource shares using that original policy aren't automatically\n                        updated.</p>\n               </li>\n               <li>\n                  <p>You can't modify a <code>CREATED_FROM_POLICY</code> resource share so you can't\n                        associate the new customer managed permission by using\n                        <code>ReplacePermsissionAssociations</code>. However, if you use <a>PromoteResourceShareCreatedFromPolicy</a>, that operation\n                        automatically associates the fully manageable customer managed permission to the newly promoted\n                            <code>STANDARD</code> resource share.</p>\n               </li>\n               <li>\n                  <p>After you promote a resource share, if the original <code>CREATED_FROM_POLICY</code>\n                        managed permission has no other associations to A resource share, then RAM automatically deletes\n                        it.</p>\n               </li>\n            </ul>\n         </note>",
+        "smithy.api#http": {
+          "method": "POST",
+          "uri": "/promotepermissioncreatedfrompolicy",
+          "code": 200
+        }
+      }
+    },
+    "com.amazonaws.ram#PromotePermissionCreatedFromPolicyRequest": {
+      "type": "structure",
+      "members": {
+        "permissionArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the <code>CREATED_FROM_POLICY</code> permission that you\n            want to promote. You can get this <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> by calling the <a>ListResourceSharePermissions</a> operation.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "name": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a name for the promoted customer managed permission.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#PromotePermissionCreatedFromPolicyResponse": {
+      "type": "structure",
+      "members": {
+        "permission": {
+          "target": "com.amazonaws.ram#ResourceSharePermissionSummary"
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
     "com.amazonaws.ram#PromoteResourceShareCreatedFromPolicy": {
       "type": "operation",
       "input": {
@@ -3257,6 +4417,9 @@
         {
           "target": "com.amazonaws.ram#InvalidParameterException"
         },
+        {
+          "target": "com.amazonaws.ram#InvalidStateTransitionException"
+        },
         {
           "target": "com.amazonaws.ram#MalformedArnException"
         },
@@ -3277,10 +4440,13 @@
         },
         {
           "target": "com.amazonaws.ram#UnknownResourceException"
+        },
+        {
+          "target": "com.amazonaws.ram#UnmatchedPolicyPermissionException"
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>When you attach a resource-based permission policy to a resource, it automatically\n            creates a resource share. However, resource shares created this way are visible only to the resource share owner, and\n            the resource share can't be modified in RAM.</p>\n         <p>You can use this operation to promote the resource share to a full RAM resource share. When you promote\n            a resource share, you can then manage the resource share in RAM and it becomes visible to all of the\n            principals you shared it with.</p>",
+        "smithy.api#documentation": "<p>When you attach a resource-based policy to a resource, RAM automatically creates\n            a resource share of <code>featureSet</code>=<code>CREATED_FROM_POLICY</code> with a managed permission that\n            has the same IAM permissions as the original resource-based policy. However, this type\n            of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by\n            using RAM.</p>\n         <p>This operation promotes the resource share to a <code>STANDARD</code> resource share that is fully\n            manageable in RAM. When you promote a resource share, you can then manage the resource share in RAM and\n            it becomes visible to all of the principals you shared it with.</p>\n         <important>\n            <p>Before you perform this operation, you should first run <a>PromotePermissionCreatedFromPolicy</a>to ensure that you have an\n                appropriate customer managed permission that can be associated with this resource share after its is promoted. If\n                this operation can't find a managed permission that exactly matches the existing\n                    <code>CREATED_FROM_POLICY</code> permission, then this operation fails.</p>\n         </important>",
         "smithy.api#http": {
           "method": "POST",
           "uri": "/promoteresourcesharecreatedfrompolicy",
@@ -3294,11 +4460,14 @@
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share to promote.</p>",
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share to promote.</p>",
             "smithy.api#httpQuery": "resourceShareArn",
             "smithy.api#required": {}
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#PromoteResourceShareCreatedFromPolicyResponse": {
@@ -3311,6 +4480,9 @@
             "smithy.api#xmlName": "return"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     },
     "com.amazonaws.ram#RejectResourceShareInvitation": {
@@ -3354,39 +4526,139 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Rejects an invitation to a resource share from another Amazon Web Services account.</p>",
+        "smithy.api#documentation": "<p>Rejects an invitation to a resource share from another Amazon Web Services account.</p>",
+        "smithy.api#http": {
+          "method": "POST",
+          "uri": "/rejectresourceshareinvitation",
+          "code": 200
+        }
+      }
+    },
+    "com.amazonaws.ram#RejectResourceShareInvitationRequest": {
+      "type": "structure",
+      "members": {
+        "resourceShareInvitationArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the invitation that you want to reject.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#RejectResourceShareInvitationResponse": {
+      "type": "structure",
+      "members": {
+        "resourceShareInvitation": {
+          "target": "com.amazonaws.ram#ResourceShareInvitation",
+          "traits": {
+            "smithy.api#documentation": "<p>An object that contains the details about the rejected invitation.</p>"
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#ReplacePermissionAssociations": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#ReplacePermissionAssociationsRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#ReplacePermissionAssociationsResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#IdempotentParameterMismatchException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidClientTokenException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#MalformedArnException"
+        },
+        {
+          "target": "com.amazonaws.ram#OperationNotPermittedException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        },
+        {
+          "target": "com.amazonaws.ram#UnknownResourceException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>Updates all resource shares that use a managed permission to a different managed\n            permission. This operation always applies the default version of the target managed\n            permission. You can optionally specify that the update applies to only resource shares that\n            currently use a specified version. This enables you to update to the latest version,\n            without changing the which managed permission is used.</p>\n         <p>You can use this operation to update all of your resource shares to use the current\n            default version of the permission by specifying the same value for the\n                <code>fromPermissionArn</code> and <code>toPermissionArn</code> parameters.</p>\n         <p>You can use the optional <code>fromPermissionVersion</code> parameter to update only\n            those resources that use a specified version of the managed permission to the new managed\n            permission.</p>\n         <important>\n            <p>To successfully perform this operation, you must have permission to update the\n                resource-based policy on all affected resource types.</p>\n         </important>",
         "smithy.api#http": {
           "method": "POST",
-          "uri": "/rejectresourceshareinvitation",
+          "uri": "/replacepermissionassociations",
           "code": 200
         }
       }
     },
-    "com.amazonaws.ram#RejectResourceShareInvitationRequest": {
+    "com.amazonaws.ram#ReplacePermissionAssociationsRequest": {
       "type": "structure",
       "members": {
-        "resourceShareInvitationArn": {
+        "fromPermissionArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the managed permission that you want to replace.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "fromPermissionVersion": {
+          "target": "com.amazonaws.ram#Integer",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies that you want to updated the permissions for only those resource shares that use the\n            specified version of the managed permission.</p>"
+          }
+        },
+        "toPermissionArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the invitation that you want to reject.</p>",
+            "smithy.api#documentation": "<p>Specifies the ARN of the managed permission that you want to associate with resource\n            shares in place of the one specified by <code>fromPerssionArn</code> and\n                <code>fromPermissionVersion</code>.</p>\n         <p>The operation always associates the version that is currently the default for the\n            specified managed permission.</p>",
             "smithy.api#required": {}
           }
         },
         "clientToken": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>"
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
-    "com.amazonaws.ram#RejectResourceShareInvitationResponse": {
+    "com.amazonaws.ram#ReplacePermissionAssociationsResponse": {
       "type": "structure",
       "members": {
-        "resourceShareInvitation": {
-          "target": "com.amazonaws.ram#ResourceShareInvitation",
+        "replacePermissionAssociationsWork": {
+          "target": "com.amazonaws.ram#ReplacePermissionAssociationsWork",
           "traits": {
-            "smithy.api#documentation": "<p>An object that contains the details about the rejected invitation.</p>"
+            "smithy.api#documentation": "<p>Specifies a data structure that you can use to track the asynchronous tasks that RAM\n            performs to complete this operation. You can use the <a>ListReplacePermissionAssociationsWork</a> operation and pass the\n                <code>id</code> value returned in this structure.</p>"
           }
         },
         "clientToken": {
@@ -3395,6 +4667,112 @@
             "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
+    "com.amazonaws.ram#ReplacePermissionAssociationsWork": {
+      "type": "structure",
+      "members": {
+        "id": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The unique identifier for the background task associated with one <a>ReplacePermissionAssociations</a> request.</p>"
+          }
+        },
+        "fromPermissionArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the managed permission that this background task is replacing.</p>"
+          }
+        },
+        "fromPermissionVersion": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The version of the managed permission that this background task is replacing.</p>"
+          }
+        },
+        "toPermissionArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the managed permission that this background task is associating with the resource shares in place\n            of the managed permission and version specified in <code>fromPermissionArn</code> and\n                <code>fromPermissionVersion</code>.</p>"
+          }
+        },
+        "toPermissionVersion": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The version of the managed permission that this background task is associating with the resource shares. This\n            is always the version that is currently the default for this managed permission.</p>"
+          }
+        },
+        "status": {
+          "target": "com.amazonaws.ram#ReplacePermissionAssociationsWorkStatus",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the current status of the background tasks for the specified ID. The output\n            is one of the following strings:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>IN_PROGRESS</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>COMPLETED</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>FAILED</code>\n               </p>\n            </li>\n         </ul>"
+          }
+        },
+        "statusMessage": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the reason for a <code>FAILED</code> status. This field is present only when\n            there <code>status</code> is <code>FAILED</code>.</p>"
+          }
+        },
+        "creationTime": {
+          "target": "com.amazonaws.ram#DateTime",
+          "traits": {
+            "smithy.api#documentation": "<p>The date and time when this asynchronous background task was created.</p>"
+          }
+        },
+        "lastUpdatedTime": {
+          "target": "com.amazonaws.ram#DateTime",
+          "traits": {
+            "smithy.api#documentation": "<p>The date and time when the status of this background task was last updated.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#documentation": "<p>A structure that represents the background work that RAM performs when you invoke\n            the <a>ReplacePermissionAssociations</a> operation.</p>"
+      }
+    },
+    "com.amazonaws.ram#ReplacePermissionAssociationsWorkIdList": {
+      "type": "list",
+      "member": {
+        "target": "com.amazonaws.ram#String",
+        "traits": {
+          "smithy.api#xmlName": "item"
+        }
+      }
+    },
+    "com.amazonaws.ram#ReplacePermissionAssociationsWorkList": {
+      "type": "list",
+      "member": {
+        "target": "com.amazonaws.ram#ReplacePermissionAssociationsWork",
+        "traits": {
+          "smithy.api#xmlName": "item"
+        }
+      }
+    },
+    "com.amazonaws.ram#ReplacePermissionAssociationsWorkStatus": {
+      "type": "enum",
+      "members": {
+        "IN_PROGRESS": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "IN_PROGRESS"
+          }
+        },
+        "COMPLETED": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "COMPLETED"
+          }
+        },
+        "FAILED": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "FAILED"
+          }
+        }
       }
     },
     "com.amazonaws.ram#Resource": {
@@ -3403,25 +4781,25 @@
         "arn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource.</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource.</p>"
           }
         },
         "type": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The resource type. This takes the form of:\n                <code>service-code</code>:<code>resource-code</code>\n         </p>"
+            "smithy.api#documentation": "<p>The resource type. This takes the form of:\n                <code>service-code</code>:<code>resource-code</code>, and is case-insensitive. For\n            example, an Amazon EC2 Subnet would be represented by the string\n            <code>ec2:subnet</code>.</p>"
           }
         },
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share this resource is associated with.</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share this resource is associated with.</p>"
           }
         },
         "resourceGroupArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource group. This value is available only if the resource is\n            part of a resource group.</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource group. This value is available only if the resource is\n            part of a resource group.</p>"
           }
         },
         "status": {
@@ -3445,7 +4823,7 @@
         "lastUpdatedTime": {
           "target": "com.amazonaws.ram#DateTime",
           "traits": {
-            "smithy.api#documentation": "<p>The date an time when the association was last updated.</p>"
+            "smithy.api#documentation": "<p>The date an time when the association between the resource and the resource share was\n            last updated.</p>"
           }
         },
         "resourceRegionScope": {
@@ -3483,7 +4861,7 @@
           "code": "InvalidResourceArn.NotFound",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The specified Amazon Resource Name (ARN) was not found.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the specified <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> was not found.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -3560,7 +4938,7 @@
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share</p>"
           }
         },
         "name": {
@@ -3578,7 +4956,7 @@
         "allowExternalPrincipals": {
           "target": "com.amazonaws.ram#Boolean",
           "traits": {
-            "smithy.api#documentation": "<p>Indicates whether principals outside your organization in Organizations can be associated\n            with a resource share.</p>"
+            "smithy.api#documentation": "<p>Indicates whether principals outside your organization in Organizations can be associated\n            with a resource share.</p>\n         <ul>\n            <li>\n               <p>\n                  <code>True</code> – the resource share can be shared with any\n                    Amazon Web Services account.</p>\n            </li>\n            <li>\n               <p>\n                  <code>False</code> – the resource share can be shared with only\n                    accounts in the same organization as the account that owns the resource\n                    share.</p>\n            </li>\n         </ul>"
           }
         },
         "status": {
@@ -3614,7 +4992,7 @@
         "featureSet": {
           "target": "com.amazonaws.ram#ResourceShareFeatureSet",
           "traits": {
-            "smithy.api#documentation": "<p>Indicates how the resource share was created. Possible values include:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>CREATED_FROM_POLICY</code> - Indicates that the resource share was created from an\n                    Identity and Access Management (IAM) resource-based permission policy attached to the resource.\n                    This type of resource share is visible only to the Amazon Web Services account that created it. You\n                    can't modify it in RAM unless you promote it. For more information, see <a>PromoteResourceShareCreatedFromPolicy</a>.</p>\n            </li>\n            <li>\n               <p>\n                  <code>PROMOTING_TO_STANDARD</code> - The resource share is in the process of being\n                    promoted. For more information, see <a>PromoteResourceShareCreatedFromPolicy</a>.</p>\n            </li>\n            <li>\n               <p>\n                  <code>STANDARD</code> - Indicates that the resource share was created in RAM using the\n                    console or APIs. These resource shares are visible to all principals you share the resource share\n                    with. You can modify these resource shares in RAM using the console or APIs.</p>\n            </li>\n         </ul>"
+            "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>"
           }
         }
       },
@@ -3637,7 +5015,7 @@
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share.</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share.</p>"
           }
         },
         "resourceShareName": {
@@ -3649,7 +5027,7 @@
         "associatedEntity": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The associated entity. This can be either of the following:</p>\n         <ul>\n            <li>\n               <p>For a resource association, this is the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource.</p>\n            </li>\n            <li>\n               <p>For principal associations, this is one of the following:</p>\n               <ul>\n                  <li>\n                     <p>The ID of an Amazon Web Services account</p>\n                  </li>\n                  <li>\n                     <p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of an organization in Organizations</p>\n                  </li>\n                  <li>\n                     <p>The ARN of an organizational unit (OU) in Organizations</p>\n                  </li>\n                  <li>\n                     <p>The ARN of an IAM role</p>\n                  </li>\n                  <li>\n                     <p>The ARN of an IAM user</p>\n                  </li>\n               </ul>\n            </li>\n         </ul>"
+            "smithy.api#documentation": "<p>The associated entity. This can be either of the following:</p>\n         <ul>\n            <li>\n               <p>For a resource association, this is the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource.</p>\n            </li>\n            <li>\n               <p>For principal associations, this is one of the following:</p>\n               <ul>\n                  <li>\n                     <p>The ID of an Amazon Web Services account</p>\n                  </li>\n                  <li>\n                     <p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an organization in Organizations</p>\n                  </li>\n                  <li>\n                     <p>The ARN of an organizational unit (OU) in Organizations</p>\n                  </li>\n                  <li>\n                     <p>The ARN of an IAM role</p>\n                  </li>\n                  <li>\n                     <p>The ARN of an IAM user</p>\n                  </li>\n               </ul>\n            </li>\n         </ul>"
           }
         },
         "associationType": {
@@ -3690,7 +5068,7 @@
         }
       },
       "traits": {
-        "smithy.api#documentation": "<p>Describes an association with a resource share and either a principal or a resource.</p>"
+        "smithy.api#documentation": "<p>Describes an association between a resource share and either a principal or a resource.</p>"
       }
     },
     "com.amazonaws.ram#ResourceShareAssociationList": {
@@ -3783,7 +5161,7 @@
         "resourceShareInvitationArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the invitation.</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the invitation.</p>"
           }
         },
         "resourceShareName": {
@@ -3795,7 +5173,7 @@
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share</p>"
           }
         },
         "senderAccountId": {
@@ -3834,7 +5212,7 @@
         "receiverArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the IAM user or role that received the invitation.</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the IAM user or role that received the invitation.</p>"
           }
         }
       },
@@ -3857,7 +5235,7 @@
           "code": "InvalidResourceShareInvitationArn.AlreadyAccepted",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The specified invitation was already accepted.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the specified invitation was already accepted.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -3877,7 +5255,7 @@
           "code": "InvalidResourceShareInvitationArn.AlreadyRejected",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The specified invitation was already rejected.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the specified invitation was already rejected.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -3906,7 +5284,7 @@
           "code": "InvalidResourceShareInvitationArn.NotFound",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The specified Amazon Resource Name (ARN) for an invitation was not found.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the specified <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> for an invitation was not\n            found.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -3926,7 +5304,7 @@
           "code": "InvalidResourceShareInvitationArn.Expired",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The specified invitation is expired.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the specified invitation is past its expiration date and\n            time.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -3984,7 +5362,7 @@
           "code": "ResourceShareLimitExceeded",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>This request would exceed the limit for resource shares for your account.</p>",
+        "smithy.api#documentation": "<p>The operation failed because it would exceed the limit for resource shares for your account. To\n            view the limits for your Amazon Web Services account, see the <a href=\"https://console.aws.amazon.com/servicequotas/home/services/ram/quotas\">RAM page in the Service Quotas\n                console</a>.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -4004,19 +5382,19 @@
         "arn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of this RAM permission.</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of this RAM managed permission.</p>"
           }
         },
         "version": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The version of the permission represented in this structure.</p>"
+            "smithy.api#documentation": "<p>The version of the permission described in this response.</p>"
           }
         },
         "defaultVersion": {
           "target": "com.amazonaws.ram#Boolean",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies whether the version of the permission represented in this structure is the\n            default version for this permission.</p>"
+            "smithy.api#documentation": "<p>Specifies whether the version of the permission represented in this response is the\n            default version for this permission.</p>"
           }
         },
         "name": {
@@ -4052,12 +5430,36 @@
         "isResourceTypeDefault": {
           "target": "com.amazonaws.ram#Boolean",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies whether the version of the permission represented in this structure is the\n            default version for all resources of this resource type.</p>"
+            "smithy.api#documentation": "<p>Specifies whether the version of the permission represented in this response is the\n            default version for all resources of this resource type.</p>"
+          }
+        },
+        "permissionType": {
+          "target": "com.amazonaws.ram#PermissionType",
+          "traits": {
+            "smithy.api#documentation": "<p>The type of managed permission. This can be one of the following values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>AWS_MANAGED</code> – Amazon Web Services created and manages this\n                    managed permission. You can associate it with your resource shares, but you can't modify it.</p>\n            </li>\n            <li>\n               <p>\n                  <code>CUSTOMER_MANAGED</code> – You, or another principal in\n                    your account created this managed permission. You can associate it with your resource shares and create\n                    new versions that have different permissions.</p>\n            </li>\n         </ul>"
+          }
+        },
+        "featureSet": {
+          "target": "com.amazonaws.ram#PermissionFeatureSet",
+          "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>"
+          }
+        },
+        "status": {
+          "target": "com.amazonaws.ram#PermissionStatus",
+          "traits": {
+            "smithy.api#documentation": "<p>The current status of the association between the permission and the resource share.\n            The following are the possible values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>ATTACHABLE</code> – This permission or version can be associated \n                with resource shares.</p>\n            </li>\n            <li>\n               <p>\n                  <code>UNATTACHABLE</code> – This permission or version can't \n                currently be associated with resource shares.</p>\n            </li>\n            <li>\n               <p>\n                  <code>DELETING</code> – This permission or version is in the process of\n                    being deleted.</p>\n            </li>\n            <li>\n               <p>\n                  <code>DELETED</code> – This permission or version is deleted.</p>\n            </li>\n         </ul>"
+          }
+        },
+        "tags": {
+          "target": "com.amazonaws.ram#TagList",
+          "traits": {
+            "smithy.api#documentation": "<p>The tag key and value pairs attached to the resource share.</p>"
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "<p>Information about an RAM permission.</p>"
+        "smithy.api#documentation": "<p>Information about a RAM managed permission.</p>"
       }
     },
     "com.amazonaws.ram#ResourceSharePermissionList": {
@@ -4075,31 +5477,31 @@
         "arn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the permission you want information about.</p>"
+            "smithy.api#documentation": "<p>The <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the permission you want information about.</p>"
           }
         },
         "version": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The version of the permission represented in this structure.</p>"
+            "smithy.api#documentation": "<p>The version of the permission associated with this resource share.</p>"
           }
         },
         "defaultVersion": {
           "target": "com.amazonaws.ram#Boolean",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies whether the version of the permission represented in this structure is the\n            default version for this permission.</p>"
+            "smithy.api#documentation": "<p>Specifies whether the version of the managed permission used by this resource share is the default version for\n            this managed permission.</p>"
           }
         },
         "name": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The name of this permission.</p>"
+            "smithy.api#documentation": "<p>The name of this managed permission.</p>"
           }
         },
         "resourceType": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The type of resource to which this permission applies.</p>"
+            "smithy.api#documentation": "<p>The type of resource to which this permission applies. This takes the form of:\n                <code>service-code</code>:<code>resource-code</code>, and is case-insensitive. For\n            example, an Amazon EC2 Subnet would be represented by the string\n            <code>ec2:subnet</code>.</p>"
           }
         },
         "status": {
@@ -4123,12 +5525,30 @@
         "isResourceTypeDefault": {
           "target": "com.amazonaws.ram#Boolean",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies whether the version of the permission represented in this structure is the\n            default version for all resources of this resource type.</p>"
+            "smithy.api#documentation": "<p>Specifies whether the managed permission associated with this resource share is the default managed permission for all\n            resources of this resource type.</p>"
+          }
+        },
+        "permissionType": {
+          "target": "com.amazonaws.ram#PermissionType",
+          "traits": {
+            "smithy.api#documentation": "<p>The type of managed permission. This can be one of the following values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>AWS_MANAGED</code> – Amazon Web Services created and manages this\n                    managed permission. You can associate it with your resource shares, but you can't modify it.</p>\n            </li>\n            <li>\n               <p>\n                  <code>CUSTOMER_MANAGED</code> – You, or another principal in\n                    your account created this managed permission. You can associate it with your resource shares and create\n                    new versions that have different permissions.</p>\n            </li>\n         </ul>"
+          }
+        },
+        "featureSet": {
+          "target": "com.amazonaws.ram#PermissionFeatureSet",
+          "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>"
+          }
+        },
+        "tags": {
+          "target": "com.amazonaws.ram#TagList",
+          "traits": {
+            "smithy.api#documentation": "<p>A list of the tag key value pairs currently attached to the permission.</p>"
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "<p>Information about an RAM permission that is associated with a resource share and any of its\n            resources of a specified type.</p>"
+        "smithy.api#documentation": "<p>Information about an RAM permission.</p>"
       }
     },
     "com.amazonaws.ram#ResourceShareStatus": {
@@ -4216,7 +5636,7 @@
           "code": "InternalError",
           "httpResponseCode": 500
         },
-        "smithy.api#documentation": "<p>The service could not respond to the request due to an internal problem.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the service could not respond to the request due to an\n            internal problem. Try again later.</p>",
         "smithy.api#error": "server",
         "smithy.api#httpError": 500
       }
@@ -4227,7 +5647,7 @@
         "resourceType": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>The type of the resource.</p>"
+            "smithy.api#documentation": "<p>The type of the resource. This takes the form of:\n                <code>service-code</code>:<code>resource-code</code>, and is case-insensitive. For\n            example, an Amazon EC2 Subnet would be represented by the string\n            <code>ec2:subnet</code>.</p>"
           }
         },
         "serviceName": {
@@ -4271,11 +5691,100 @@
           "code": "Unavailable",
           "httpResponseCode": 503
         },
-        "smithy.api#documentation": "<p>The service is not available.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the service isn't available. Try again later.</p>",
         "smithy.api#error": "server",
         "smithy.api#httpError": 503
       }
     },
+    "com.amazonaws.ram#SetDefaultPermissionVersion": {
+      "type": "operation",
+      "input": {
+        "target": "com.amazonaws.ram#SetDefaultPermissionVersionRequest"
+      },
+      "output": {
+        "target": "com.amazonaws.ram#SetDefaultPermissionVersionResponse"
+      },
+      "errors": [
+        {
+          "target": "com.amazonaws.ram#IdempotentParameterMismatchException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidClientTokenException"
+        },
+        {
+          "target": "com.amazonaws.ram#InvalidParameterException"
+        },
+        {
+          "target": "com.amazonaws.ram#MalformedArnException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServerInternalException"
+        },
+        {
+          "target": "com.amazonaws.ram#ServiceUnavailableException"
+        },
+        {
+          "target": "com.amazonaws.ram#UnknownResourceException"
+        }
+      ],
+      "traits": {
+        "smithy.api#documentation": "<p>Designates the specified version number as the default version for the specified\n            customer managed permission. New resource shares automatically use this new default permission. Existing\n            resource shares continue to use their original permission version, but you can use <a>ReplacePermissionAssociations</a> to update them.</p>",
+        "smithy.api#http": {
+          "method": "POST",
+          "uri": "/setdefaultpermissionversion",
+          "code": 200
+        }
+      }
+    },
+    "com.amazonaws.ram#SetDefaultPermissionVersionRequest": {
+      "type": "structure",
+      "members": {
+        "permissionArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the customer managed permission whose default version you want to change.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "permissionVersion": {
+          "target": "com.amazonaws.ram#Integer",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the version number that you want to designate as the default for customer managed permission. To\n            see a list of all available version numbers, use <a>ListPermissionVersions</a>.</p>",
+            "smithy.api#required": {}
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#input": {}
+      }
+    },
+    "com.amazonaws.ram#SetDefaultPermissionVersionResponse": {
+      "type": "structure",
+      "members": {
+        "returnValue": {
+          "target": "com.amazonaws.ram#Boolean",
+          "traits": {
+            "smithy.api#documentation": "<p>A boolean value that indicates whether the operation was successful.</p>",
+            "smithy.api#xmlName": "return"
+          }
+        },
+        "clientToken": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
+          }
+        }
+      },
+      "traits": {
+        "smithy.api#output": {}
+      }
+    },
     "com.amazonaws.ram#String": {
       "type": "string"
     },
@@ -4349,7 +5858,7 @@
           "code": "TagLimitExceeded",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>This request would exceed the limit for tags for your account.</p>",
+        "smithy.api#documentation": "<p>The operation failed because it would exceed the limit for tags for your\n            Amazon Web Services account.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -4375,7 +5884,7 @@
           "code": "TagPolicyViolation",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>The specified tag key is a reserved word and can't be used.</p>",
+        "smithy.api#documentation": "<p>The operation failed because the specified tag key is a reserved word and can't be\n            used.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -4415,7 +5924,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Adds the specified tag keys and values to the specified resource share. The tags are attached\n            only to the resource share, not to the resources that are in the resource share.</p>",
+        "smithy.api#documentation": "<p>Adds the specified tag keys and values to a resource share or managed permission. If you choose a resource share, the\n            tags are attached to only the resource share, not to the resources that are in the resource share.</p>\n         <p>The tags on a managed permission are the same for all versions of the managed permission.</p>",
         "smithy.api#http": {
           "method": "POST",
           "uri": "/tagresource",
@@ -4429,8 +5938,7 @@
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share that you want to add tags to.</p>",
-            "smithy.api#required": {}
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share that you want to add tags to. You must specify\n                <i>either</i>\n            <code>resourceShareArn</code>, or <code>resourceArn</code>, but not both.</p>"
           }
         },
         "tags": {
@@ -4439,12 +5947,24 @@
             "smithy.api#documentation": "<p>A list of one or more tag key and value pairs. The tag key must be present and not be\n            an empty string. The tag value must be present but can be an empty string.</p>",
             "smithy.api#required": {}
           }
+        },
+        "resourceArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the managed permission that you want to add tags to. You must specify\n                <i>either</i>\n            <code>resourceArn</code>, or <code>resourceShareArn</code>, but not both.</p>"
+          }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#TagResourceResponse": {
       "type": "structure",
-      "members": {}
+      "members": {},
+      "traits": {
+        "smithy.api#output": {}
+      }
     },
     "com.amazonaws.ram#TagValue": {
       "type": "string"
@@ -4470,7 +5990,7 @@
           "code": "ThrottlingException",
           "httpResponseCode": 429
         },
-        "smithy.api#documentation": "<p>You exceeded the rate at which you are allowed to perform this operation. Please try\n            again later.</p>",
+        "smithy.api#documentation": "<p>The operation failed because it exceeded the rate at which you are allowed to perform\n            this operation. Please try again later.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 429
       }
@@ -4490,7 +6010,27 @@
           "code": "InvalidResourceShareArn.NotFound",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>A specified resource was not found.</p>",
+        "smithy.api#documentation": "<p>The operation failed because a specified resource couldn't be found.</p>",
+        "smithy.api#error": "client",
+        "smithy.api#httpError": 400
+      }
+    },
+    "com.amazonaws.ram#UnmatchedPolicyPermissionException": {
+      "type": "structure",
+      "members": {
+        "message": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#required": {}
+          }
+        }
+      },
+      "traits": {
+        "aws.protocols#awsQueryError": {
+          "code": "UnmatchedPolicyPermissionException",
+          "httpResponseCode": 400
+        },
+        "smithy.api#documentation": "<p>There isn't an existing managed permission defined in RAM that has the same IAM permissions as\n            the resource-based policy attached to the resource. You should first run <a>PromotePermissionCreatedFromPolicy</a> to create that managed permission.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -4507,15 +6047,21 @@
         {
           "target": "com.amazonaws.ram#InvalidParameterException"
         },
+        {
+          "target": "com.amazonaws.ram#MalformedArnException"
+        },
         {
           "target": "com.amazonaws.ram#ServerInternalException"
         },
         {
           "target": "com.amazonaws.ram#ServiceUnavailableException"
+        },
+        {
+          "target": "com.amazonaws.ram#UnknownResourceException"
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Removes the specified tag key and value pairs from the specified resource share.</p>",
+        "smithy.api#documentation": "<p>Removes the specified tag key and value pairs from the specified resource share or managed permission.</p>",
         "smithy.api#http": {
           "method": "POST",
           "uri": "/untagresource",
@@ -4529,8 +6075,7 @@
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share that you want to remove tags from. The tags are\n            removed from the resource share, not the resources in the resource share.</p>",
-            "smithy.api#required": {}
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share that you want to remove tags from. The tags are\n            removed from the resource share, not the resources in the resource share. You must specify either\n                <code>resourceShareArn</code>, or <code>resourceArn</code>, but not both.</p>"
           }
         },
         "tagKeys": {
@@ -4539,12 +6084,24 @@
             "smithy.api#documentation": "<p>Specifies a list of one or more tag keys that you want to remove.</p>",
             "smithy.api#required": {}
           }
+        },
+        "resourceArn": {
+          "target": "com.amazonaws.ram#String",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the managed permission that you want to remove tags from. You must\n            specify either <code>resourceArn</code>, or <code>resourceShareArn</code>, but not\n            both.</p>"
+          }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#UntagResourceResponse": {
       "type": "structure",
-      "members": {}
+      "members": {},
+      "traits": {
+        "smithy.api#output": {}
+      }
     },
     "com.amazonaws.ram#UpdateResourceShare": {
       "type": "operation",
@@ -4598,7 +6155,7 @@
         "resourceShareArn": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resoure Name (ARN)</a> of the resource share that you want to modify.</p>",
+            "smithy.api#documentation": "<p>Specifies the <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of the resource share that you want to modify.</p>",
             "smithy.api#required": {}
           }
         },
@@ -4617,9 +6174,12 @@
         "clientToken": {
           "target": "com.amazonaws.ram#String",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>"
+            "smithy.api#documentation": "<p>Specifies a unique, case-sensitive identifier that you provide to\n             ensure the idempotency of the request. This lets you safely retry the request without\n             accidentally performing the same operation a second time. Passing the same value to a\n             later call to an operation requires that you also pass the same value for all other \n             parameters. We recommend that you use a <a href=\"https://wikipedia.org/wiki/Universally_unique_identifier\">UUID type of \n             value.</a>.</p>\n         <p>If you don't provide this value, then Amazon Web Services generates a random one for\n             you.</p>\n         <p>If you retry the operation with the same <code>ClientToken</code>, but with \n             different parameters, the retry fails with an <code>IdempotentParameterMismatch</code>\n             error.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#input": {}
       }
     },
     "com.amazonaws.ram#UpdateResourceShareResponse": {
@@ -4637,6 +6197,9 @@
             "smithy.api#documentation": "<p>The idempotency identifier associated with this request. If you\n             want to repeat the same operation in an idempotent manner then you must include this\n             value in the <code>clientToken</code> request parameter of that later call. All other \n             parameters must also have the same values that you used in the first call.</p>"
           }
         }
+      },
+      "traits": {
+        "smithy.api#output": {}
       }
     }
   }