@aws-sdk/client-ram 3.42.0 → 3.47.0

package/dist-types/RAM.d.ts

@@ -27,14 +27,13 @@ import { RAMClient } from "./RAMClient";
 /**
  * <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 and
- *             within your organization or organizational units (OUs) in Organizations. For supported
- *             resource types, you can also share resources with IAM roles and IAM users. If you have
- *             multiple Amazon Web Services accounts, you can use RAM to share those resources with other
- *             accounts.</p>
+ *             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>
  *
  *         <p>To learn more about RAM, see the following resources:</p>
- *
  *         <ul>
  *             <li>
  *                 <p>
@@ -51,27 +50,34 @@ import { RAMClient } from "./RAMClient";
  */
 export declare class RAM extends RAMClient {
     /**
-     * <p>Accepts an invitation to a resource share from another Amazon Web Services account.</p>
+     * <p>Accepts an invitation to a resource share from another Amazon Web Services account. After you accept the
+     *             invitation, the resources included in the resource share are available to interact with in the
+     *             relevant Amazon Web Services Management Consoles and tools.</p>
      */
     acceptResourceShareInvitation(args: AcceptResourceShareInvitationCommandInput, options?: __HttpHandlerOptions): Promise<AcceptResourceShareInvitationCommandOutput>;
     acceptResourceShareInvitation(args: AcceptResourceShareInvitationCommandInput, cb: (err: any, data?: AcceptResourceShareInvitationCommandOutput) => void): void;
     acceptResourceShareInvitation(args: AcceptResourceShareInvitationCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: AcceptResourceShareInvitationCommandOutput) => void): void;
     /**
-     * <p>Associates the specified resource share with the specified principals and resources.</p>
+     * <p>Adds the specified list of principals and list of resources to a resource share. Principals that
+     *             already have access to this resource share immediately receive access to the added resources.
+     *             Newly added principals immediately receive access to the resources shared in this resource share. </p>
      */
     associateResourceShare(args: AssociateResourceShareCommandInput, options?: __HttpHandlerOptions): Promise<AssociateResourceShareCommandOutput>;
     associateResourceShare(args: AssociateResourceShareCommandInput, cb: (err: any, data?: AssociateResourceShareCommandOutput) => void): void;
     associateResourceShare(args: AssociateResourceShareCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: AssociateResourceShareCommandOutput) => void): void;
     /**
-     * <p>Associates a permission with a resource share.</p>
+     * <p>Adds or replaces the RAM permission for a resource type included in a resource share. You can
+     *             have exactly one permission associated with each resource type in the resource share. You can add
+     *             a new RAM permission only if there are currently no resources of that resource type
+     *             currently in the resource share.</p>
      */
     associateResourceSharePermission(args: AssociateResourceSharePermissionCommandInput, options?: __HttpHandlerOptions): Promise<AssociateResourceSharePermissionCommandOutput>;
     associateResourceSharePermission(args: AssociateResourceSharePermissionCommandInput, cb: (err: any, data?: AssociateResourceSharePermissionCommandOutput) => void): void;
     associateResourceSharePermission(args: AssociateResourceSharePermissionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: AssociateResourceSharePermissionCommandOutput) => void): void;
     /**
-     * <p>Creates a resource share. You must provide a list of the Amazon Resource Names (ARNs) for the
-     *             resources you want to share. You must also specify who you want to share the resources
-     *             with, and the permissions that you grant them.</p>
+     * <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
+     *             want to share, a list of principals you want to share the resources with, and the
+     *             permissions to grant those principals.</p>
      *         <note>
      *             <p>Sharing a resource makes it available for use by principals outside of the
      *                 Amazon Web Services account that created the resource. Sharing doesn't change any permissions or
@@ -82,7 +88,9 @@ export declare class RAM extends RAMClient {
     createResourceShare(args: CreateResourceShareCommandInput, cb: (err: any, data?: CreateResourceShareCommandOutput) => void): void;
     createResourceShare(args: CreateResourceShareCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateResourceShareCommandOutput) => void): void;
     /**
-     * <p>Deletes the specified resource share.</p>
+     * <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>
      */
     deleteResourceShare(args: DeleteResourceShareCommandInput, options?: __HttpHandlerOptions): Promise<DeleteResourceShareCommandOutput>;
     deleteResourceShare(args: DeleteResourceShareCommandInput, cb: (err: any, data?: DeleteResourceShareCommandOutput) => void): void;
@@ -94,14 +102,23 @@ export declare class RAM extends RAMClient {
     disassociateResourceShare(args: DisassociateResourceShareCommandInput, cb: (err: any, data?: DisassociateResourceShareCommandOutput) => void): void;
     disassociateResourceShare(args: DisassociateResourceShareCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DisassociateResourceShareCommandOutput) => void): void;
     /**
-     * <p>Disassociates an RAM permission from a resource share.</p>
+     * <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>
      */
     disassociateResourceSharePermission(args: DisassociateResourceSharePermissionCommandInput, options?: __HttpHandlerOptions): Promise<DisassociateResourceSharePermissionCommandOutput>;
     disassociateResourceSharePermission(args: DisassociateResourceSharePermissionCommandInput, cb: (err: any, data?: DisassociateResourceSharePermissionCommandOutput) => void): void;
     disassociateResourceSharePermission(args: DisassociateResourceSharePermissionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DisassociateResourceSharePermissionCommandOutput) => void): void;
     /**
-     * <p>Enables resource sharing within your organization in Organizations.</p>
-     *         <p>The caller must be the master account for the organization.</p>
+     * <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
+     *             management account.</p>
      */
     enableSharingWithAwsOrganization(args: EnableSharingWithAwsOrganizationCommandInput, options?: __HttpHandlerOptions): Promise<EnableSharingWithAwsOrganizationCommandOutput>;
     enableSharingWithAwsOrganization(args: EnableSharingWithAwsOrganizationCommandInput, cb: (err: any, data?: EnableSharingWithAwsOrganizationCommandOutput) => void): void;
@@ -113,44 +130,47 @@ export declare class RAM extends RAMClient {
     getPermission(args: GetPermissionCommandInput, cb: (err: any, data?: GetPermissionCommandOutput) => void): void;
     getPermission(args: GetPermissionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetPermissionCommandOutput) => void): void;
     /**
-     * <p>Gets the policies for the specified resources that you own and have shared.</p>
+     * <p>Retrieves the resource policies for the specified resources that you own and have
+     *             shared.</p>
      */
     getResourcePolicies(args: GetResourcePoliciesCommandInput, options?: __HttpHandlerOptions): Promise<GetResourcePoliciesCommandOutput>;
     getResourcePolicies(args: GetResourcePoliciesCommandInput, cb: (err: any, data?: GetResourcePoliciesCommandOutput) => void): void;
     getResourcePolicies(args: GetResourcePoliciesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetResourcePoliciesCommandOutput) => void): void;
     /**
-     * <p>Gets the resources or principals for the resource shares that you own.</p>
+     * <p>Retrieves the resource and principal associations for resource shares that you own.</p>
      */
     getResourceShareAssociations(args: GetResourceShareAssociationsCommandInput, options?: __HttpHandlerOptions): Promise<GetResourceShareAssociationsCommandOutput>;
     getResourceShareAssociations(args: GetResourceShareAssociationsCommandInput, cb: (err: any, data?: GetResourceShareAssociationsCommandOutput) => void): void;
     getResourceShareAssociations(args: GetResourceShareAssociationsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetResourceShareAssociationsCommandOutput) => void): void;
     /**
-     * <p>Gets the invitations that you have received for resource shares.</p>
+     * <p>Retrieves details about invitations that you have received for resource shares.</p>
      */
     getResourceShareInvitations(args: GetResourceShareInvitationsCommandInput, options?: __HttpHandlerOptions): Promise<GetResourceShareInvitationsCommandOutput>;
     getResourceShareInvitations(args: GetResourceShareInvitationsCommandInput, cb: (err: any, data?: GetResourceShareInvitationsCommandOutput) => void): void;
     getResourceShareInvitations(args: GetResourceShareInvitationsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetResourceShareInvitationsCommandOutput) => void): void;
     /**
-     * <p>Gets the resource shares that you own or the resource shares that are shared with you.</p>
+     * <p>Retrieves details about the resource shares that you own or that are shared with you.</p>
      */
     getResourceShares(args: GetResourceSharesCommandInput, options?: __HttpHandlerOptions): Promise<GetResourceSharesCommandOutput>;
     getResourceShares(args: GetResourceSharesCommandInput, cb: (err: any, data?: GetResourceSharesCommandOutput) => void): void;
     getResourceShares(args: GetResourceSharesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetResourceSharesCommandOutput) => void): void;
     /**
-     * <p>Lists the resources in a resource share that is shared with you but that the invitation is still
-     *             pending for.</p>
+     * <p>Lists the resources in a resource share that is shared with you but for which the invitation is
+     *             still <code>PENDING</code>. That means that you haven't accepted or rejected the
+     *             invitation and the invitation hasn't expired.</p>
      */
     listPendingInvitationResources(args: ListPendingInvitationResourcesCommandInput, options?: __HttpHandlerOptions): Promise<ListPendingInvitationResourcesCommandOutput>;
     listPendingInvitationResources(args: ListPendingInvitationResourcesCommandInput, cb: (err: any, data?: ListPendingInvitationResourcesCommandOutput) => void): void;
     listPendingInvitationResources(args: ListPendingInvitationResourcesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListPendingInvitationResourcesCommandOutput) => void): void;
     /**
-     * <p>Lists the RAM permissions.</p>
+     * <p>Retrieves a list of available RAM permissions that you can use for the supported
+     *             resource types. </p>
      */
     listPermissions(args: ListPermissionsCommandInput, options?: __HttpHandlerOptions): Promise<ListPermissionsCommandOutput>;
     listPermissions(args: ListPermissionsCommandInput, cb: (err: any, data?: ListPermissionsCommandOutput) => void): void;
     listPermissions(args: ListPermissionsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListPermissionsCommandOutput) => void): void;
     /**
-     * <p>Lists the principals that you have shared resources with or that have shared resources
+     * <p>Lists the principals that you are sharing resources with or that are sharing resources
      *             with you.</p>
      */
     listPrincipals(args: ListPrincipalsCommandInput, options?: __HttpHandlerOptions): Promise<ListPrincipalsCommandOutput>;
@@ -170,25 +190,18 @@ export declare class RAM extends RAMClient {
     listResourceSharePermissions(args: ListResourceSharePermissionsCommandInput, cb: (err: any, data?: ListResourceSharePermissionsCommandOutput) => void): void;
     listResourceSharePermissions(args: ListResourceSharePermissionsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListResourceSharePermissionsCommandOutput) => void): void;
     /**
-     * <p>Lists the shareable resource types supported by RAM.</p>
+     * <p>Lists the resource types that can be shared by RAM.</p>
      */
     listResourceTypes(args: ListResourceTypesCommandInput, options?: __HttpHandlerOptions): Promise<ListResourceTypesCommandOutput>;
     listResourceTypes(args: ListResourceTypesCommandInput, cb: (err: any, data?: ListResourceTypesCommandOutput) => void): void;
     listResourceTypes(args: ListResourceTypesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListResourceTypesCommandOutput) => void): void;
     /**
-     * <p>Resource shares that were created by attaching a policy to a resource are visible only
-     *             to the resource share owner, and the resource share cannot be modified in RAM.</p>
-     *
-     *         <p>Use this API action to promote the resource share. When you promote the resource
-     *             share, it becomes:</p>
-     *         <ul>
-     *             <li>
-     *                 <p>Visible to all principals that it is shared with.</p>
-     *             </li>
-     *             <li>
-     *                 <p>Modifiable in RAM.</p>
-     *             </li>
-     *          </ul>
+     * <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>
      */
     promoteResourceShareCreatedFromPolicy(args: PromoteResourceShareCreatedFromPolicyCommandInput, options?: __HttpHandlerOptions): Promise<PromoteResourceShareCreatedFromPolicyCommandOutput>;
     promoteResourceShareCreatedFromPolicy(args: PromoteResourceShareCreatedFromPolicyCommandInput, cb: (err: any, data?: PromoteResourceShareCreatedFromPolicyCommandOutput) => void): void;
@@ -200,19 +213,20 @@ export declare class RAM extends RAMClient {
     rejectResourceShareInvitation(args: RejectResourceShareInvitationCommandInput, cb: (err: any, data?: RejectResourceShareInvitationCommandOutput) => void): void;
     rejectResourceShareInvitation(args: RejectResourceShareInvitationCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: RejectResourceShareInvitationCommandOutput) => void): void;
     /**
-     * <p>Adds the specified tags to the specified resource share that you own.</p>
+     * <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>
      */
     tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise<TagResourceCommandOutput>;
     tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
     tagResource(args: TagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
     /**
-     * <p>Removes the specified tags from the specified resource share that you own.</p>
+     * <p>Removes the specified tag key and value pairs from the specified resource share.</p>
      */
     untagResource(args: UntagResourceCommandInput, options?: __HttpHandlerOptions): Promise<UntagResourceCommandOutput>;
     untagResource(args: UntagResourceCommandInput, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
     untagResource(args: UntagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
     /**
-     * <p>Updates the specified resource share that you own.</p>
+     * <p>Modifies some of the properties of the specified resource share.</p>
      */
     updateResourceShare(args: UpdateResourceShareCommandInput, options?: __HttpHandlerOptions): Promise<UpdateResourceShareCommandOutput>;
     updateResourceShare(args: UpdateResourceShareCommandInput, cb: (err: any, data?: UpdateResourceShareCommandOutput) => void): void;

package/dist-types/RAMClient.d.ts

@@ -4,7 +4,7 @@ import { RetryInputConfig, RetryResolvedConfig } from "@aws-sdk/middleware-retry
 import { AwsAuthInputConfig, AwsAuthResolvedConfig } from "@aws-sdk/middleware-signing";
 import { UserAgentInputConfig, UserAgentResolvedConfig } from "@aws-sdk/middleware-user-agent";
 import { HttpHandler as __HttpHandler } from "@aws-sdk/protocol-http";
-import { Client as __Client, SmithyConfiguration as __SmithyConfiguration, SmithyResolvedConfiguration as __SmithyResolvedConfiguration } from "@aws-sdk/smithy-client";
+import { Client as __Client, DefaultsMode, SmithyConfiguration as __SmithyConfiguration, SmithyResolvedConfiguration as __SmithyResolvedConfiguration } from "@aws-sdk/smithy-client";
 import { Credentials as __Credentials, Decoder as __Decoder, Encoder as __Encoder, HashConstructor as __HashConstructor, HttpHandlerOptions as __HttpHandlerOptions, Logger as __Logger, Provider as __Provider, Provider, RegionInfoProvider, StreamCollector as __StreamCollector, UrlParser as __UrlParser, UserAgent as __UserAgent } from "@aws-sdk/types";
 import { AcceptResourceShareInvitationCommandInput, AcceptResourceShareInvitationCommandOutput } from "./commands/AcceptResourceShareInvitationCommand";
 import { AssociateResourceShareCommandInput, AssociateResourceShareCommandOutput } from "./commands/AssociateResourceShareCommand";
@@ -132,6 +132,10 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
      * @internal
      */
     defaultUserAgentProvider?: Provider<__UserAgent>;
+    /**
+     * The {@link DefaultsMode} that will be used to determine how certain default configuration options are resolved in the SDK.
+     */
+    defaultsMode?: DefaultsMode | Provider<DefaultsMode>;
 }
 declare type RAMClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> & ClientDefaults & RegionInputConfig & EndpointsInputConfig & RetryInputConfig & HostHeaderInputConfig & AwsAuthInputConfig & UserAgentInputConfig;
 /**
@@ -148,14 +152,13 @@ export interface RAMClientResolvedConfig extends RAMClientResolvedConfigType {
 /**
  * <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 and
- *             within your organization or organizational units (OUs) in Organizations. For supported
- *             resource types, you can also share resources with IAM roles and IAM users. If you have
- *             multiple Amazon Web Services accounts, you can use RAM to share those resources with other
- *             accounts.</p>
+ *             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>
  *
  *         <p>To learn more about RAM, see the following resources:</p>
- *
  *         <ul>
  *             <li>
  *                 <p>

package/dist-types/commands/AcceptResourceShareInvitationCommand.d.ts

@@ -7,7 +7,9 @@ export interface AcceptResourceShareInvitationCommandInput extends AcceptResourc
 export interface AcceptResourceShareInvitationCommandOutput extends AcceptResourceShareInvitationResponse, __MetadataBearer {
 }
 /**
- * <p>Accepts an invitation to a resource share from another Amazon Web Services account.</p>
+ * <p>Accepts an invitation to a resource share from another Amazon Web Services account. After you accept the
+ *             invitation, the resources included in the resource share are available to interact with in the
+ *             relevant Amazon Web Services Management Consoles and tools.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/AssociateResourceShareCommand.d.ts

@@ -7,7 +7,9 @@ export interface AssociateResourceShareCommandInput extends AssociateResourceSha
 export interface AssociateResourceShareCommandOutput extends AssociateResourceShareResponse, __MetadataBearer {
 }
 /**
- * <p>Associates the specified resource share with the specified principals and resources.</p>
+ * <p>Adds the specified list of principals and list of resources to a resource share. Principals that
+ *             already have access to this resource share immediately receive access to the added resources.
+ *             Newly added principals immediately receive access to the resources shared in this resource share. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/AssociateResourceSharePermissionCommand.d.ts

@@ -7,7 +7,10 @@ export interface AssociateResourceSharePermissionCommandInput extends AssociateR
 export interface AssociateResourceSharePermissionCommandOutput extends AssociateResourceSharePermissionResponse, __MetadataBearer {
 }
 /**
- * <p>Associates a permission with a resource share.</p>
+ * <p>Adds or replaces the RAM permission for a resource type included in a resource share. You can
+ *             have exactly one permission associated with each resource type in the resource share. You can add
+ *             a new RAM permission only if there are currently no resources of that resource type
+ *             currently in the resource share.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/CreateResourceShareCommand.d.ts

@@ -7,9 +7,9 @@ export interface CreateResourceShareCommandInput extends CreateResourceShareRequ
 export interface CreateResourceShareCommandOutput extends CreateResourceShareResponse, __MetadataBearer {
 }
 /**
- * <p>Creates a resource share. You must provide a list of the Amazon Resource Names (ARNs) for the
- *             resources you want to share. You must also specify who you want to share the resources
- *             with, and the permissions that you grant them.</p>
+ * <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
+ *             want to share, a list of principals you want to share the resources with, and the
+ *             permissions to grant those principals.</p>
  *         <note>
  *             <p>Sharing a resource makes it available for use by principals outside of the
  *                 Amazon Web Services account that created the resource. Sharing doesn't change any permissions or

package/dist-types/commands/DeleteResourceShareCommand.d.ts

@@ -7,7 +7,9 @@ export interface DeleteResourceShareCommandInput extends DeleteResourceShareRequ
 export interface DeleteResourceShareCommandOutput extends DeleteResourceShareResponse, __MetadataBearer {
 }
 /**
- * <p>Deletes the specified resource share.</p>
+ * <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DisassociateResourceSharePermissionCommand.d.ts

@@ -7,7 +7,9 @@ export interface DisassociateResourceSharePermissionCommandInput extends Disasso
 export interface DisassociateResourceSharePermissionCommandOutput extends DisassociateResourceSharePermissionResponse, __MetadataBearer {
 }
 /**
- * <p>Disassociates an RAM permission from a resource share.</p>
+ * <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/EnableSharingWithAwsOrganizationCommand.d.ts

@@ -7,8 +7,15 @@ export interface EnableSharingWithAwsOrganizationCommandInput extends EnableShar
 export interface EnableSharingWithAwsOrganizationCommandOutput extends EnableSharingWithAwsOrganizationResponse, __MetadataBearer {
 }
 /**
- * <p>Enables resource sharing within your organization in Organizations.</p>
- *         <p>The caller must be the master account for the organization.</p>
+ * <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
+ *             management account.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetResourcePoliciesCommand.d.ts

@@ -7,7 +7,8 @@ export interface GetResourcePoliciesCommandInput extends GetResourcePoliciesRequ
 export interface GetResourcePoliciesCommandOutput extends GetResourcePoliciesResponse, __MetadataBearer {
 }
 /**
- * <p>Gets the policies for the specified resources that you own and have shared.</p>
+ * <p>Retrieves the resource policies for the specified resources that you own and have
+ *             shared.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetResourceShareAssociationsCommand.d.ts

@@ -7,7 +7,7 @@ export interface GetResourceShareAssociationsCommandInput extends GetResourceSha
 export interface GetResourceShareAssociationsCommandOutput extends GetResourceShareAssociationsResponse, __MetadataBearer {
 }
 /**
- * <p>Gets the resources or principals for the resource shares that you own.</p>
+ * <p>Retrieves the resource and principal associations for resource shares that you own.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetResourceShareInvitationsCommand.d.ts

@@ -7,7 +7,7 @@ export interface GetResourceShareInvitationsCommandInput extends GetResourceShar
 export interface GetResourceShareInvitationsCommandOutput extends GetResourceShareInvitationsResponse, __MetadataBearer {
 }
 /**
- * <p>Gets the invitations that you have received for resource shares.</p>
+ * <p>Retrieves details about invitations that you have received for resource shares.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetResourceSharesCommand.d.ts

@@ -7,7 +7,7 @@ export interface GetResourceSharesCommandInput extends GetResourceSharesRequest
 export interface GetResourceSharesCommandOutput extends GetResourceSharesResponse, __MetadataBearer {
 }
 /**
- * <p>Gets the resource shares that you own or the resource shares that are shared with you.</p>
+ * <p>Retrieves details about the resource shares that you own or that are shared with you.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListPendingInvitationResourcesCommand.d.ts

@@ -7,8 +7,9 @@ export interface ListPendingInvitationResourcesCommandInput extends ListPendingI
 export interface ListPendingInvitationResourcesCommandOutput extends ListPendingInvitationResourcesResponse, __MetadataBearer {
 }
 /**
- * <p>Lists the resources in a resource share that is shared with you but that the invitation is still
- *             pending for.</p>
+ * <p>Lists the resources in a resource share that is shared with you but for which the invitation is
+ *             still <code>PENDING</code>. That means that you haven't accepted or rejected the
+ *             invitation and the invitation hasn't expired.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListPermissionsCommand.d.ts

@@ -7,7 +7,8 @@ export interface ListPermissionsCommandInput extends ListPermissionsRequest {
 export interface ListPermissionsCommandOutput extends ListPermissionsResponse, __MetadataBearer {
 }
 /**
- * <p>Lists the RAM permissions.</p>
+ * <p>Retrieves a list of available RAM permissions that you can use for the supported
+ *             resource types. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListPrincipalsCommand.d.ts

@@ -7,7 +7,7 @@ export interface ListPrincipalsCommandInput extends ListPrincipalsRequest {
 export interface ListPrincipalsCommandOutput extends ListPrincipalsResponse, __MetadataBearer {
 }
 /**
- * <p>Lists the principals that you have shared resources with or that have shared resources
+ * <p>Lists the principals that you are sharing resources with or that are sharing resources
  *             with you.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/ListResourceTypesCommand.d.ts

@@ -7,7 +7,7 @@ export interface ListResourceTypesCommandInput extends ListResourceTypesRequest
 export interface ListResourceTypesCommandOutput extends ListResourceTypesResponse, __MetadataBearer {
 }
 /**
- * <p>Lists the shareable resource types supported by RAM.</p>
+ * <p>Lists the resource types that can be shared by RAM.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/PromoteResourceShareCreatedFromPolicyCommand.d.ts

@@ -7,19 +7,12 @@ export interface PromoteResourceShareCreatedFromPolicyCommandInput extends Promo
 export interface PromoteResourceShareCreatedFromPolicyCommandOutput extends PromoteResourceShareCreatedFromPolicyResponse, __MetadataBearer {
 }
 /**
- * <p>Resource shares that were created by attaching a policy to a resource are visible only
- *             to the resource share owner, and the resource share cannot be modified in RAM.</p>
- *
- *         <p>Use this API action to promote the resource share. When you promote the resource
- *             share, it becomes:</p>
- *         <ul>
- *             <li>
- *                 <p>Visible to all principals that it is shared with.</p>
- *             </li>
- *             <li>
- *                 <p>Modifiable in RAM.</p>
- *             </li>
- *          </ul>
+ * <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/TagResourceCommand.d.ts

@@ -7,7 +7,8 @@ export interface TagResourceCommandInput extends TagResourceRequest {
 export interface TagResourceCommandOutput extends TagResourceResponse, __MetadataBearer {
 }
 /**
- * <p>Adds the specified tags to the specified resource share that you own.</p>
+ * <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/UntagResourceCommand.d.ts

@@ -7,7 +7,7 @@ export interface UntagResourceCommandInput extends UntagResourceRequest {
 export interface UntagResourceCommandOutput extends UntagResourceResponse, __MetadataBearer {
 }
 /**
- * <p>Removes the specified tags from the specified resource share that you own.</p>
+ * <p>Removes the specified tag key and value pairs from the specified resource share.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/UpdateResourceShareCommand.d.ts

@@ -7,7 +7,7 @@ export interface UpdateResourceShareCommandInput extends UpdateResourceShareRequ
 export interface UpdateResourceShareCommandOutput extends UpdateResourceShareResponse, __MetadataBearer {
 }
 /**
- * <p>Updates the specified resource share that you own.</p>
+ * <p>Modifies some of the properties of the specified resource share.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript