aws-sdk-organizations 1.48.0 → 1.53.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5d96097520061e6114fc6fe94babd9ae3273b6500e9c5cbb8c939da23a21074
-  data.tar.gz: 256abcfe182414969fc84ef97db333f39bd1951c08fa3a26be52e5b9b519c31b
+  metadata.gz: e17c233b9f00cdf398e31c920ecc81219a1f4df141f9e2be1d3aefa40e1a04ab
+  data.tar.gz: 26f49eead8937477d592fa94b7817105da8a328f18377d4d9ce9a1114783922e
 SHA512:
-  metadata.gz: 5f673ac6b433f52999e50bcc64fa72a415e819505dc30ebc719c2a495d5432ae53797269d9cd2db7e7fd0ba1f00fc8e2bcd3bbfbd8592a8fdaef7e814de35b88
-  data.tar.gz: 58a2113b3d5535885cf194971cd61ac9432eee25e68251083a2c2b682d12c5cfb2c9ba4e0359d023d2ecdd66a609c5542ffb726a332af456f75779821780e3c1
+  metadata.gz: d7d2d950fe168072a9542da1b63c6e9b1ff501d81c4db363bbf3429305778d97233d4e25b4d4dfec79de7d66ba951cbbb7f47d2de805356fd9ac32a6d2fd2d25
+  data.tar.gz: 2d286d0d3f8b874af8e7ef4195ddb02256ba3305ae62c3bcea28655bf7c0728067a14052be89baf1b05f7d1106ec040c48f85eab07c56e60859b83a67b560793

data/lib/aws-sdk-organizations.rb

@@ -7,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -44,9 +45,9 @@ require_relative 'aws-sdk-organizations/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::Organizations
 
-  GEM_VERSION = '1.48.0'
+  GEM_VERSION = '1.53.0'
 
 end

data/lib/aws-sdk-organizations/client.rb

@@ -85,13 +85,28 @@ module Aws::Organizations
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::Organizations
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
+    #       are very aggressive. Construct and pass an instance of
+    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -477,10 +492,10 @@ module Aws::Organizations
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
-    # [2]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
-    # [3]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
-    # [4]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
+    # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
+    # [2]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
+    # [3]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
+    # [4]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
     #
     # @option params [required, String] :policy_id
     #   The unique identifier (ID) of the policy that you want to attach to
@@ -680,16 +695,15 @@ module Aws::Organizations
     # successfully access the account. To check the status of the request,
     # do one of the following:
     #
-    # * Use the `OperationId` response element from this operation to
-    #   provide as a parameter to the DescribeCreateAccountStatus operation.
+    # * Use the `Id` member of the `CreateAccountStatus` response element
+    #   from this operation to provide as a parameter to the
+    #   DescribeCreateAccountStatus operation.
     #
     # * Check the AWS CloudTrail log for the `CreateAccountResult` event.
     #   For information on using AWS CloudTrail with AWS Organizations, see
     #   [Monitoring the Activity in Your Organization][1] in the *AWS
     #   Organizations User Guide.*
     #
-    #
-    #
     # The user who calls the API to create an account must have the
     # `organizations:CreateAccount` permission. If you enabled all features
     # in the organization, AWS Organizations creates the required
@@ -697,6 +711,9 @@ module Aws::Organizations
     # information, see [AWS Organizations and Service-Linked Roles][2] in
     # the *AWS Organizations User Guide*.
     #
+    # If the request includes tags, then the requester must have the
+    # `organizations:TagResource` permission.
+    #
     # AWS Organizations preconfigures the new member account with a role
     # (named `OrganizationAccountAccessRole` by default) that grants users
     # in the master account administrator permissions in the new member
@@ -812,6 +829,23 @@ module Aws::Organizations
     #
     #   [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/grantaccess.html#ControllingAccessWebsite-Activate
     #
+    # @option params [Array<Types::Tag>] :tags
+    #   A list of tags that you want to attach to the newly created account.
+    #   For each tag in the list, you must specify both a tag key and a value.
+    #   You can set the value to an empty string, but you can't set it to
+    #   `null`. For more information about tagging, see [Tagging AWS
+    #   Organizations resources][1] in the AWS Organizations User Guide.
+    #
+    #   <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed number
+    #   of tags for an account, then the entire request fails and the account
+    #   is not created.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tagging.html
+    #
     # @return [Types::CreateAccountResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateAccountResponse#create_account_status #create_account_status} => Types::CreateAccountStatus
@@ -844,6 +878,12 @@ module Aws::Organizations
     #     account_name: "AccountName", # required
     #     role_name: "RoleName",
     #     iam_user_access_to_billing: "ALLOW", # accepts ALLOW, DENY
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -873,16 +913,18 @@ module Aws::Organizations
     #   the [ *AWS GovCloud User Guide*.][1]
     #
     # * You already have an account in the AWS GovCloud (US) Region that is
-    #   associated with your master account in the commercial Region.
+    #   paired with a master account of an organization in the commercial
+    #   Region.
     #
     # * You call this action from the master account of your organization in
     #   the commercial Region.
     #
-    # * You have the `organizations:CreateGovCloudAccount` permission. AWS
-    #   Organizations creates the required service-linked role named
-    #   `AWSServiceRoleForOrganizations`. For more information, see [AWS
-    #   Organizations and Service-Linked Roles][2] in the *AWS Organizations
-    #   User Guide.*
+    # * You have the `organizations:CreateGovCloudAccount` permission.
+    #
+    # AWS Organizations automatically creates the required service-linked
+    # role named `AWSServiceRoleForOrganizations`. For more information, see
+    # [AWS Organizations and Service-Linked Roles][2] in the *AWS
+    # Organizations User Guide.*
     #
     # AWS automatically enables AWS CloudTrail for AWS GovCloud (US)
     # accounts, but you should also do the following:
@@ -894,6 +936,13 @@ module Aws::Organizations
     #   For more information, see [Verifying AWS CloudTrail Is Enabled][3]
     #   in the *AWS GovCloud User Guide*.
     #
+    # If the request includes tags, then the requester must have the
+    # `organizations:TagResource` permission. The tags are attached to the
+    # commercial account associated with the GovCloud account, rather than
+    # the GovCloud account itself. To add tags to the GovCloud account, call
+    # the TagResource operation in the GovCloud Region after the new
+    # GovCloud account exists.
+    #
     # You call this action from the master account of your organization in
     # the commercial Region to create a standalone AWS account in the AWS
     # GovCloud (US) Region. After the account is created, the master account
@@ -930,10 +979,10 @@ module Aws::Organizations
     # allows the master account in the organization in the commercial Region
     # to assume it. An AWS GovCloud (US) account is then created and
     # associated with the commercial account that you just created. A role
-    # is created in the new AWS GovCloud (US) account that can be assumed by
-    # the AWS GovCloud (US) account that is associated with the master
-    # account of the commercial organization. For more information and to
-    # view a diagram that explains how account access works, see [AWS
+    # is also created in the new AWS GovCloud (US) account that can be
+    # assumed by the AWS GovCloud (US) account that is associated with the
+    # master account of the commercial organization. For more information
+    # and to view a diagram that explains how account access works, see [AWS
     # Organizations][4] in the *AWS GovCloud User Guide.*
     #
     # For more information about creating accounts, see [Creating an AWS
@@ -1047,6 +1096,28 @@ module Aws::Organizations
     #
     #   [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/grantaccess.html#ControllingAccessWebsite-Activate
     #
+    # @option params [Array<Types::Tag>] :tags
+    #   A list of tags that you want to attach to the newly created account.
+    #   These tags are attached to the commercial account associated with the
+    #   GovCloud account, and not to the GovCloud account itself. To add tags
+    #   to the actual GovCloud account, call the TagResource operation in the
+    #   GovCloud region after the new GovCloud account exists.
+    #
+    #   For each tag in the list, you must specify both a tag key and a value.
+    #   You can set the value to an empty string, but you can't set it to
+    #   `null`. For more information about tagging, see [Tagging AWS
+    #   Organizations resources][1] in the AWS Organizations User Guide.
+    #
+    #   <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed number
+    #   of tags for an account, then the entire request fails and the account
+    #   is not created.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tagging.html
+    #
     # @return [Types::CreateGovCloudAccountResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateGovCloudAccountResponse#create_account_status #create_account_status} => Types::CreateAccountStatus
@@ -1058,6 +1129,12 @@ module Aws::Organizations
     #     account_name: "AccountName", # required
     #     role_name: "RoleName",
     #     iam_user_access_to_billing: "ALLOW", # accepts ALLOW, DENY
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -1098,7 +1175,7 @@ module Aws::Organizations
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/orgs_getting-started_concepts.html#account
+    # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account
     #
     # @option params [String] :feature_set
     #   Specifies the feature set supported by the new organization. Each
@@ -1215,6 +1292,9 @@ module Aws::Organizations
     # For more information about OUs, see [Managing Organizational Units][1]
     # in the *AWS Organizations User Guide.*
     #
+    # If the request includes tags, then the requester must have the
+    # `organizations:TagResource` permission.
+    #
     # This operation can be called only from the organization's master
     # account.
     #
@@ -1244,6 +1324,23 @@ module Aws::Organizations
     # @option params [required, String] :name
     #   The friendly name to assign to the new OU.
     #
+    # @option params [Array<Types::Tag>] :tags
+    #   A list of tags that you want to attach to the newly created OU. For
+    #   each tag in the list, you must specify both a tag key and a value. You
+    #   can set the value to an empty string, but you can't set it to `null`.
+    #   For more information about tagging, see [Tagging AWS Organizations
+    #   resources][1] in the AWS Organizations User Guide.
+    #
+    #   <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed number
+    #   of tags for an OU, then the entire request fails and the OU is not
+    #   created.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tagging.html
+    #
     # @return [Types::CreateOrganizationalUnitResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateOrganizationalUnitResponse#organizational_unit #organizational_unit} => Types::OrganizationalUnit
@@ -1272,6 +1369,12 @@ module Aws::Organizations
     #   resp = client.create_organizational_unit({
     #     parent_id: "ParentId", # required
     #     name: "OrganizationalUnitName", # required
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -1295,6 +1398,9 @@ module Aws::Organizations
     # For more information about policies and their use, see [Managing
     # Organization Policies][1].
     #
+    # If the request includes tags, then the requester must have the
+    # `organizations:TagResource` permission.
+    #
     # This operation can be called only from the organization's master
     # account.
     #
@@ -1334,10 +1440,27 @@ module Aws::Organizations
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
-    #   [2]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
-    #   [3]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
-    #   [4]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
+    #   [2]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
+    #   [3]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
+    #   [4]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   A list of tags that you want to attach to the newly created policy.
+    #   For each tag in the list, you must specify both a tag key and a value.
+    #   You can set the value to an empty string, but you can't set it to
+    #   `null`. For more information about tagging, see [Tagging AWS
+    #   Organizations resources][1] in the AWS Organizations User Guide.
+    #
+    #   <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed number
+    #   of tags for a policy, then the entire request fails and the policy is
+    #   not created.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tagging.html
     #
     # @return [Types::CreatePolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1378,6 +1501,12 @@ module Aws::Organizations
     #     description: "PolicyDescription", # required
     #     name: "PolicyName", # required
     #     type: "SERVICE_CONTROL_POLICY", # required, accepts SERVICE_CONTROL_POLICY, TAG_POLICY, BACKUP_POLICY, AISERVICES_OPT_OUT_POLICY
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -1750,9 +1879,10 @@ module Aws::Organizations
     # an AWS service.
     #
     # @option params [required, String] :create_account_request_id
-    #   Specifies the `operationId` that uniquely identifies the request. You
-    #   can get the ID from the response to an earlier CreateAccount request,
-    #   or from the ListCreateAccountStatus operation.
+    #   Specifies the `Id` value that uniquely identifies the `CreateAccount`
+    #   request. You can get the value from the `CreateAccountStatus.Id`
+    #   response in an earlier CreateAccount request, or from the
+    #   ListCreateAccountStatus operation.
     #
     #   The [regex pattern][1] for a create account request ID string requires
     #   "car-" followed by from 8 to 32 lowercase letters or digits.
@@ -1842,9 +1972,9 @@ module Aws::Organizations
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
-    #   [2]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
-    #   [3]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
+    #   [2]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
+    #   [3]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
     #
     # @option params [String] :target_id
     #   When you're signed in as the master account, specify the ID of the
@@ -2381,10 +2511,10 @@ module Aws::Organizations
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
-    #   [2]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
-    #   [3]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
-    #   [4]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
+    #   [2]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
+    #   [3]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
+    #   [4]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
     #
     # @return [Types::DisablePolicyTypeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2631,10 +2761,10 @@ module Aws::Organizations
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
-    #   [2]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
-    #   [3]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
-    #   [4]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
+    #   [2]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
+    #   [3]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
+    #   [4]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
     #
     # @return [Types::EnablePolicyTypeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2711,6 +2841,9 @@ module Aws::Organizations
     #   then try again. If the error persists after an hour, contact [AWS
     #   Support][2].
     #
+    # If the request includes tags, then the requester must have the
+    # `organizations:TagResource` permission.
+    #
     # This operation can be called only from the organization's master
     # account.
     #
@@ -2741,6 +2874,33 @@ module Aws::Organizations
     #   Additional information that you want to include in the generated email
     #   to the recipient account owner.
     #
+    # @option params [Array<Types::Tag>] :tags
+    #   A list of tags that you want to attach to the account when it becomes
+    #   a member of the organization. For each tag in the list, you must
+    #   specify both a tag key and a value. You can set the value to an empty
+    #   string, but you can't set it to `null`. For more information about
+    #   tagging, see [Tagging AWS Organizations resources][1] in the AWS
+    #   Organizations User Guide.
+    #
+    #   Any tags in the request are checked for compliance with any applicable
+    #   tag policies when the request is made. The request is rejected if the
+    #   tags in the request don't match the requirements of the policy at
+    #   that time. Tag policy compliance is <i> <b>not</b> </i> checked again
+    #   when the invitation is accepted and the tags are actually attached to
+    #   the account. That means that if the tag policy changes between the
+    #   invitation and the acceptance, then that tags could potentially be
+    #   non-compliant.
+    #
+    #   <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed number
+    #   of tags for an account, then the entire request fails and invitations
+    #   are not sent.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tagging.html
+    #
     # @return [Types::InviteAccountToOrganizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::InviteAccountToOrganizationResponse#handshake #handshake} => Types::Handshake
@@ -2813,6 +2973,12 @@ module Aws::Organizations
     #       type: "ACCOUNT", # required, accepts ACCOUNT, ORGANIZATION, EMAIL
     #     },
     #     notes: "HandshakeNotes",
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -2860,9 +3026,8 @@ module Aws::Organizations
     #   using the AWS Organizations console, API, or CLI commands, the
     #   information required of standalone accounts is *not* automatically
     #   collected. For each account that you want to make standalone, you
-    #   must do the following steps:
-    #
-    #   * Accept the end user license agreement (EULA)
+    #   must perform the following steps. If any of the steps are already
+    #   completed for this account, that step doesn't appear.
     #
     #   * Choose a support plan
     #
@@ -2881,6 +3046,10 @@ module Aws::Organizations
     #   Access to the Billing and Cost Management Console][2] in the *AWS
     #   Billing and Cost Management User Guide.*
     #
+    # * After the account leaves the organization, all tags that were
+    #   attached to the account object in the organization are deleted. AWS
+    #   accounts outside of an organization do not support tags.
+    #
     #
     #
     # [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_remove.html#leave-without-all-info
@@ -4159,10 +4328,10 @@ module Aws::Organizations
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
-    #   [2]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
-    #   [3]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
-    #   [4]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
+    #   [2]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
+    #   [3]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
+    #   [4]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
     #
     # @option params [String] :next_token
     #   The parameter for receiving additional results if you receive a
@@ -4308,10 +4477,10 @@ module Aws::Organizations
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
-    #   [2]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
-    #   [3]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
-    #   [4]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
+    #   [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
+    #   [2]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_backup.html
+    #   [3]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
+    #   [4]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
     #
     # @option params [String] :next_token
     #   The parameter for receiving additional results if you receive a
@@ -4495,16 +4664,37 @@ module Aws::Organizations
       req.send_request(options)
     end
 
-    # Lists tags for the specified resource.
+    # Lists tags that are attached to the specified resource.
+    #
+    # You can attach tags to the following resources in AWS Organizations.
+    #
+    # * AWS account
+    #
+    # * Organization root
     #
-    # Currently, you can list tags on an account in AWS Organizations.
+    # * Organizational unit (OU)
+    #
+    # * Policy (any type)
     #
     # This operation can be called only from the organization's master
     # account or by a member account that is a delegated administrator for
     # an AWS service.
     #
     # @option params [required, String] :resource_id
-    #   The ID of the resource that you want to retrieve tags for.
+    #   The ID of the resource with the tags to list.
+    #
+    #   You can specify any of the following taggable resources.
+    #
+    #   * AWS account – specify the account ID number.
+    #
+    #   * Organizational unit – specify the OU ID that begins with `ou-` and
+    #     looks similar to: `ou-1a2b-34uvwxyz `
+    #
+    #   * Root – specify the root ID that begins with `r-` and looks similar
+    #     to: `r-1a2b `
+    #
+    #   * Policy – specify the policy ID that begins with `p-` andlooks
+    #     similar to: `p-12abcdefg3 `
     #
     # @option params [String] :next_token
     #   The parameter for receiving additional results if you receive a
@@ -4796,21 +4986,25 @@ module Aws::Organizations
     # account. Member accounts can remove themselves with LeaveOrganization
     # instead.
     #
-    # You can remove an account from your organization only if the account
-    # is configured with the information required to operate as a standalone
-    # account. When you create an account in an organization using the AWS
-    # Organizations console, API, or CLI commands, the information required
-    # of standalone accounts is *not* automatically collected. For an
-    # account that you want to make standalone, you must accept the end user
-    # license agreement (EULA), choose a support plan, provide and verify
-    # the required contact information, and provide a current payment
-    # method. AWS uses the payment method to charge for any billable (not
-    # free tier) AWS activity that occurs while the account isn't attached
-    # to an organization. To remove an account that doesn't yet have this
-    # information, you must sign in as the member account and follow the
-    # steps at [ To leave an organization when all required account
-    # information has not yet been provided][1] in the *AWS Organizations
-    # User Guide.*
+    # * You can remove an account from your organization only if the account
+    #   is configured with the information required to operate as a
+    #   standalone account. When you create an account in an organization
+    #   using the AWS Organizations console, API, or CLI commands, the
+    #   information required of standalone accounts is *not* automatically
+    #   collected. For an account that you want to make standalone, you must
+    #   choose a support plan, provide and verify the required contact
+    #   information, and provide a current payment method. AWS uses the
+    #   payment method to charge for any billable (not free tier) AWS
+    #   activity that occurs while the account isn't attached to an
+    #   organization. To remove an account that doesn't yet have this
+    #   information, you must sign in as the member account and follow the
+    #   steps at [ To leave an organization when all required account
+    #   information has not yet been provided][1] in the *AWS Organizations
+    #   User Guide.*
+    #
+    # * After the account leaves the organization, all tags that were
+    #   attached to the account object in the organization are deleted. AWS
+    #   accounts outside of an organization do not support tags.
     #
     #
     #
@@ -4855,7 +5049,16 @@ module Aws::Organizations
 
     # Adds one or more tags to the specified resource.
     #
-    # Currently, you can tag and untag accounts in AWS Organizations.
+    # Currently, you can attach tags to the following resources in AWS
+    # Organizations.
+    #
+    # * AWS account
+    #
+    # * Organization root
+    #
+    # * Organizational unit (OU)
+    #
+    # * Policy (any type)
     #
     # This operation can be called only from the organization's master
     # account.
@@ -4864,9 +5067,30 @@ module Aws::Organizations
     #   The ID of the resource to add a tag to.
     #
     # @option params [required, Array<Types::Tag>] :tags
-    #   The tag to add to the specified resource. You must specify both a tag
-    #   key and value. You can set the value of a tag to an empty string, but
-    #   you can't set it to null.
+    #   A list of tags to add to the specified resource.
+    #
+    #   You can specify any of the following taggable resources.
+    #
+    #   * AWS account – specify the account ID number.
+    #
+    #   * Organizational unit – specify the OU ID that begins with `ou-` and
+    #     looks similar to: `ou-1a2b-34uvwxyz `
+    #
+    #   * Root – specify the root ID that begins with `r-` and looks similar
+    #     to: `r-1a2b `
+    #
+    #   * Policy – specify the policy ID that begins with `p-` andlooks
+    #     similar to: `p-12abcdefg3 `
+    #
+    #   For each tag in the list, you must specify both a tag key and a value.
+    #   You can set the value to an empty string, but you can't set it to
+    #   `null`.
+    #
+    #   <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed number
+    #   of tags for an account user, then the entire request fails and the
+    #   account is not created.
+    #
+    #    </note>
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -4891,18 +5115,39 @@ module Aws::Organizations
       req.send_request(options)
     end
 
-    # Removes a tag from the specified resource.
+    # Removes any tags with the specified keys from the specified resource.
+    #
+    # You can attach tags to the following resources in AWS Organizations.
+    #
+    # * AWS account
     #
-    # Currently, you can tag and untag accounts in AWS Organizations.
+    # * Organization root
+    #
+    # * Organizational unit (OU)
+    #
+    # * Policy (any type)
     #
     # This operation can be called only from the organization's master
     # account.
     #
     # @option params [required, String] :resource_id
-    #   The ID of the resource to remove the tag from.
+    #   The ID of the resource to remove a tag from.
+    #
+    #   You can specify any of the following taggable resources.
+    #
+    #   * AWS account – specify the account ID number.
+    #
+    #   * Organizational unit – specify the OU ID that begins with `ou-` and
+    #     looks similar to: `ou-1a2b-34uvwxyz `
+    #
+    #   * Root – specify the root ID that begins with `r-` and looks similar
+    #     to: `r-1a2b `
+    #
+    #   * Policy – specify the policy ID that begins with `p-` andlooks
+    #     similar to: `p-12abcdefg3 `
     #
     # @option params [required, Array<String>] :tag_keys
-    #   The tag to remove from the specified resource.
+    #   The list of keys for tags to remove from the specified resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5135,7 +5380,7 @@ module Aws::Organizations
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-organizations'
-      context[:gem_version] = '1.48.0'
+      context[:gem_version] = '1.53.0'
       Seahorse::Client::Request.new(handlers, context)
     end