aws-sdk-organizations 1.36.0 → 1.41.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA1:
3
- metadata.gz: e1b3d4fe4d6dad180c2092d703de77ca8bc84d23
4
- data.tar.gz: 58a1bc9500115b8682e325ca86ffedfa9afe7e42
2
+ SHA256:
3
+ metadata.gz: 58c30ed95f212b6acd0ce094c2a49b8b6f7954ba235ddeeef3b23647b9af5d60
4
+ data.tar.gz: 8552961865c2854a3ea3df9b928c5f05e621da7e361428cec0157e5e9dd3c6a1
5
5
  SHA512:
6
- metadata.gz: 7019c40b54cc3d12dc136d19fb35a29f529a2b92c8ae9a7b7b14f4b2981681ee0d3e20a900ec887e1f486f6db197be8d7c35aaa9ed04ec6135b26f7c33cfe3a5
7
- data.tar.gz: 15df42f5365bc93095b25cd05c3f6e3fb076b727b27e3c79466a1d97bd4acc7da0271942d00fdebaa7f211cb20c231e2581c7658e9197948ce09480f4d9137ab
6
+ metadata.gz: 8318c65439683203ceb2355004bc8532d61f5f4262657bfa23878e93aef0fbe93328d84358ebd5383f6576061c017a809dafaa554ecfbd467c4d965572ba5719
7
+ data.tar.gz: 5f904ef08c5f0764b3f619951c577151cbf2033effc96ad31fc69281f13c7ad782d82e7f3fae34bc7416016a3b65b959ae7dd1a769b29e362fd172bf2e4d95e5
@@ -24,17 +24,20 @@ require_relative 'aws-sdk-organizations/customizations'
24
24
  # methods each accept a hash of request parameters and return a response
25
25
  # structure.
26
26
  #
27
+ # organizations = Aws::Organizations::Client.new
28
+ # resp = organizations.accept_handshake(params)
29
+ #
27
30
  # See {Client} for more information.
28
31
  #
29
32
  # # Errors
30
33
  #
31
- # Errors returned from AWS Organizations all
32
- # extend {Errors::ServiceError}.
34
+ # Errors returned from AWS Organizations are defined in the
35
+ # {Errors} module and all extend {Errors::ServiceError}.
33
36
  #
34
37
  # begin
35
38
  # # do stuff
36
39
  # rescue Aws::Organizations::Errors::ServiceError
37
- # # rescues all service API errors
40
+ # # rescues all AWS Organizations API errors
38
41
  # end
39
42
  #
40
43
  # See {Errors} for more information.
@@ -42,6 +45,6 @@ require_relative 'aws-sdk-organizations/customizations'
42
45
  # @service
43
46
  module Aws::Organizations
44
47
 
45
- GEM_VERSION = '1.36.0'
48
+ GEM_VERSION = '1.41.0'
46
49
 
47
50
  end
@@ -30,6 +30,18 @@ require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
30
30
  Aws::Plugins::GlobalConfiguration.add_identifier(:organizations)
31
31
 
32
32
  module Aws::Organizations
33
+ # An API client for Organizations. To construct a client, you need to configure a `:region` and `:credentials`.
34
+ #
35
+ # client = Aws::Organizations::Client.new(
36
+ # region: region_name,
37
+ # credentials: credentials,
38
+ # # ...
39
+ # )
40
+ #
41
+ # For details on configuring region and credentials see
42
+ # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
43
+ #
44
+ # See {#initialize} for a full list of supported configuration options.
33
45
  class Client < Seahorse::Client::Base
34
46
 
35
47
  include Aws::ClientStubs
@@ -93,7 +105,7 @@ module Aws::Organizations
93
105
  # @option options [required, String] :region
94
106
  # The AWS region to connect to. The configured `:region` is
95
107
  # used to determine the service `:endpoint`. When not passed,
96
- # a default `:region` is search for in the following locations:
108
+ # a default `:region` is searched for in the following locations:
97
109
  #
98
110
  # * `Aws.config[:region]`
99
111
  # * `ENV['AWS_REGION']`
@@ -108,6 +120,12 @@ module Aws::Organizations
108
120
  # When set to `true`, a thread polling for endpoints will be running in
109
121
  # the background every 60 secs (default). Defaults to `false`.
110
122
  #
123
+ # @option options [Boolean] :adaptive_retry_wait_to_fill (true)
124
+ # Used only in `adaptive` retry mode. When true, the request will sleep
125
+ # until there is sufficent client side capacity to retry the request.
126
+ # When false, the request will raise a `RetryCapacityNotAvailableError` and will
127
+ # not retry instead of sleeping.
128
+ #
111
129
  # @option options [Boolean] :client_side_monitoring (false)
112
130
  # When `true`, client-side metrics will be collected for all API requests from
113
131
  # this client.
@@ -132,6 +150,10 @@ module Aws::Organizations
132
150
  # When `true`, an attempt is made to coerce request parameters into
133
151
  # the required types.
134
152
  #
153
+ # @option options [Boolean] :correct_clock_skew (true)
154
+ # Used only in `standard` and adaptive retry modes. Specifies whether to apply
155
+ # a clock skew correction and retry requests with skewed client clocks.
156
+ #
135
157
  # @option options [Boolean] :disable_host_prefix_injection (false)
136
158
  # Set to true to disable SDK automatically adding host prefix
137
159
  # to default service endpoint when available.
@@ -139,7 +161,7 @@ module Aws::Organizations
139
161
  # @option options [String] :endpoint
140
162
  # The client endpoint is normally constructed from the `:region`
141
163
  # option. You should only configure an `:endpoint` when connecting
142
- # to test endpoints. This should be avalid HTTP(S) URI.
164
+ # to test endpoints. This should be a valid HTTP(S) URI.
143
165
  #
144
166
  # @option options [Integer] :endpoint_cache_max_entries (1000)
145
167
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +176,7 @@ module Aws::Organizations
154
176
  # requests fetching endpoints information. Defaults to 60 sec.
155
177
  #
156
178
  # @option options [Boolean] :endpoint_discovery (false)
157
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
179
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
158
180
  #
159
181
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
160
182
  # The log formatter.
@@ -166,15 +188,29 @@ module Aws::Organizations
166
188
  # The Logger instance to send log messages to. If this option
167
189
  # is not set, logging will be disabled.
168
190
  #
191
+ # @option options [Integer] :max_attempts (3)
192
+ # An integer representing the maximum number attempts that will be made for
193
+ # a single request, including the initial attempt. For example,
194
+ # setting this value to 5 will result in a request being retried up to
195
+ # 4 times. Used in `standard` and `adaptive` retry modes.
196
+ #
169
197
  # @option options [String] :profile ("default")
170
198
  # Used when loading credentials from the shared credentials file
171
199
  # at HOME/.aws/credentials. When not specified, 'default' is used.
172
200
  #
201
+ # @option options [Proc] :retry_backoff
202
+ # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
203
+ # This option is only used in the `legacy` retry mode.
204
+ #
173
205
  # @option options [Float] :retry_base_delay (0.3)
174
- # The base delay in seconds used by the default backoff function.
206
+ # The base delay in seconds used by the default backoff function. This option
207
+ # is only used in the `legacy` retry mode.
175
208
  #
176
209
  # @option options [Symbol] :retry_jitter (:none)
177
- # A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
210
+ # A delay randomiser function used by the default backoff function.
211
+ # Some predefined functions can be referenced by name - :none, :equal, :full,
212
+ # otherwise a Proc that takes and returns a number. This option is only used
213
+ # in the `legacy` retry mode.
178
214
  #
179
215
  # @see https://www.awsarchitectureblog.com/2015/03/backoff.html
180
216
  #
@@ -182,11 +218,30 @@ module Aws::Organizations
182
218
  # The maximum number of times to retry failed requests. Only
183
219
  # ~ 500 level server errors and certain ~ 400 level client errors
184
220
  # are retried. Generally, these are throttling errors, data
185
- # checksum errors, networking errors, timeout errors and auth
186
- # errors from expired credentials.
221
+ # checksum errors, networking errors, timeout errors, auth errors,
222
+ # endpoint discovery, and errors from expired credentials.
223
+ # This option is only used in the `legacy` retry mode.
187
224
  #
188
225
  # @option options [Integer] :retry_max_delay (0)
189
- # The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
226
+ # The maximum number of seconds to delay between retries (0 for no limit)
227
+ # used by the default backoff function. This option is only used in the
228
+ # `legacy` retry mode.
229
+ #
230
+ # @option options [String] :retry_mode ("legacy")
231
+ # Specifies which retry algorithm to use. Values are:
232
+ #
233
+ # * `legacy` - The pre-existing retry behavior. This is default value if
234
+ # no retry mode is provided.
235
+ #
236
+ # * `standard` - A standardized set of retry rules across the AWS SDKs.
237
+ # This includes support for retry quotas, which limit the number of
238
+ # unsuccessful retries a client can make.
239
+ #
240
+ # * `adaptive` - An experimental retry mode that includes all the
241
+ # functionality of `standard` mode along with automatic client side
242
+ # throttling. This is a provisional mode that may change behavior
243
+ # in the future.
244
+ #
190
245
  #
191
246
  # @option options [String] :secret_access_key
192
247
  #
@@ -219,16 +274,15 @@ module Aws::Organizations
219
274
  # requests through. Formatted like 'http://proxy.com:123'.
220
275
  #
221
276
  # @option options [Float] :http_open_timeout (15) The number of
222
- # seconds to wait when opening a HTTP session before rasing a
277
+ # seconds to wait when opening a HTTP session before raising a
223
278
  # `Timeout::Error`.
224
279
  #
225
280
  # @option options [Integer] :http_read_timeout (60) The default
226
281
  # number of seconds to wait for response data. This value can
227
- # safely be set
228
- # per-request on the session yeidled by {#session_for}.
282
+ # safely be set per-request on the session.
229
283
  #
230
284
  # @option options [Float] :http_idle_timeout (5) The number of
231
- # seconds a connection is allowed to sit idble before it is
285
+ # seconds a connection is allowed to sit idle before it is
232
286
  # considered stale. Stale connections are closed and removed
233
287
  # from the pool before making a request.
234
288
  #
@@ -237,7 +291,7 @@ module Aws::Organizations
237
291
  # request body. This option has no effect unless the request has
238
292
  # "Expect" header set to "100-continue". Defaults to `nil` which
239
293
  # disables this behaviour. This value can safely be set per
240
- # request on the session yeidled by {#session_for}.
294
+ # request on the session.
241
295
  #
242
296
  # @option options [Boolean] :http_wire_trace (false) When `true`,
243
297
  # HTTP debug output will be sent to the `:logger`.
@@ -402,23 +456,54 @@ module Aws::Organizations
402
456
  end
403
457
 
404
458
  # Attaches a policy to a root, an organizational unit (OU), or an
405
- # individual account.
406
- #
407
- # How the policy affects accounts depends on the type of policy:
408
- #
409
- # * For more information about attaching SCPs, see [How SCPs Work][1] in
410
- # the *AWS Organizations User Guide.*
411
- #
412
- # * For information about attaching tag policies, see [How Policy
413
- # Inheritance Works][2] in the *AWS Organizations User Guide.*
459
+ # individual account. How the policy affects accounts depends on the
460
+ # type of policy:
461
+ #
462
+ # * **Service control policy (SCP)** - An SCP specifies what permissions
463
+ # can be delegated to users in affected member accounts. The scope of
464
+ # influence for a policy depends on what you attach the policy to:
465
+ #
466
+ # * If you attach an SCP to a root, it affects all accounts in the
467
+ # organization.
468
+ #
469
+ # * If you attach an SCP to an OU, it affects all accounts in that OU
470
+ # and in any child OUs.
471
+ #
472
+ # * If you attach the policy directly to an account, it affects only
473
+ # that account.
474
+ #
475
+ # SCPs are JSON policies that specify the maximum permissions for an
476
+ # organization or organizational unit (OU). You can attach one SCP to
477
+ # a higher level root or OU, and a different SCP to a child OU or to
478
+ # an account. The child policy can further restrict only the
479
+ # permissions that pass through the parent filter and are available to
480
+ # the child. An SCP that is attached to a child can't grant a
481
+ # permission that the parent hasn't already granted. For example,
482
+ # imagine that the parent SCP allows permissions A, B, C, D, and E.
483
+ # The child SCP allows C, D, E, F, and G. The result is that the
484
+ # accounts affected by the child SCP are allowed to use only C, D, and
485
+ # E. They can't use A or B because the child OU filtered them out.
486
+ # They also can't use F and G because the parent OU filtered them
487
+ # out. They can't be granted back by the child SCP; child SCPs can
488
+ # only filter the permissions they receive from the parent SCP.
489
+ #
490
+ # AWS Organizations attaches a default SCP named `"FullAWSAccess` to
491
+ # every root, OU, and account. This default SCP allows all services
492
+ # and actions, enabling any new child OU or account to inherit the
493
+ # permissions of the parent root or OU. If you detach the default
494
+ # policy, you must replace it with a policy that specifies the
495
+ # permissions that you want to allow in that OU or account.
496
+ #
497
+ # For more information about how AWS Organizations policies
498
+ # permissions work, see [Using Service Control Policies][1] in the
499
+ # *AWS Organizations User Guide.*
414
500
  #
415
501
  # This operation can be called only from the organization's master
416
502
  # account.
417
503
  #
418
504
  #
419
505
  #
420
- # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_about-scps.html
421
- # [2]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies-inheritance.html
506
+ # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html
422
507
  #
423
508
  # @option params [required, String] :policy_id
424
509
  # The unique identifier (ID) of the policy that you want to attach to
@@ -649,14 +734,14 @@ module Aws::Organizations
649
734
  # Account in Your Organization][3] in the *AWS Organizations User
650
735
  # Guide.*
651
736
  #
652
- # * When you create an account in an organization, the information
653
- # required for the account to operate as a standalone account is *not*
654
- # automatically collected. For example, information about the payment
655
- # method and signing the end user license agreement (EULA) is not
656
- # collected. If you must remove an account from your organization
657
- # later, you can do so only after you provide the missing information.
658
- # Follow the steps at [ To leave an organization as a member
659
- # account][4] in the *AWS Organizations User Guide*.
737
+ # * When you create an account in an organization using the AWS
738
+ # Organizations console, API, or CLI commands, the information
739
+ # required for the account to operate as a standalone account, such as
740
+ # a payment method and signing the end user license agreement (EULA)
741
+ # is *not* automatically collected. If you must remove an account from
742
+ # your organization later, you can do so only after you provide the
743
+ # missing information. Follow the steps at [ To leave an organization
744
+ # as a member account][4] in the *AWS Organizations User Guide*.
660
745
  #
661
746
  # * If you get an exception that indicates that you exceeded your
662
747
  # account limits for the organization, contact [AWS Support][5].
@@ -716,10 +801,13 @@ module Aws::Organizations
716
801
  # `OrganizationAccountAccessRole`.
717
802
  #
718
803
  # For more information about how to use this role to access the member
719
- # account, see [Accessing and Administering the Member Accounts in Your
720
- # Organization][1] in the *AWS Organizations User Guide*. Also see steps
721
- # 2 and 3 in [Tutorial: Delegate Access Across AWS Accounts Using IAM
722
- # Roles][2] in the *IAM User Guide.*
804
+ # account, see the following links:
805
+ #
806
+ # * [Accessing and Administering the Member Accounts in Your
807
+ # Organization][1] in the *AWS Organizations User Guide*
808
+ #
809
+ # * Steps 2 and 3 in [Tutorial: Delegate Access Across AWS Accounts
810
+ # Using IAM Roles][2] in the *IAM User Guide*
723
811
  #
724
812
  # The [regex pattern][3] that is used to validate this parameter. The
725
813
  # pattern can include uppercase letters, lowercase letters, digits with
@@ -739,9 +827,9 @@ module Aws::Organizations
739
827
  # the Billing and Cost Management Console][1] in the *AWS Billing and
740
828
  # Cost Management User Guide*.
741
829
  #
742
- # If you don't specify this parameter, the value defaults to `ALLOW`.
743
- # This value allows IAM users and roles with the required permissions to
744
- # access billing information for the new account.
830
+ # If you don't specify this parameter, the value defaults to `ALLOW`,
831
+ # and IAM users and roles with the required permissions can access
832
+ # billing information for the new account.
745
833
  #
746
834
  #
747
835
  #
@@ -865,24 +953,24 @@ module Aws::Organizations
865
953
  # allows the master account in the organization in the commercial Region
866
954
  # to assume it. An AWS GovCloud (US) account is then created and
867
955
  # associated with the commercial account that you just created. A role
868
- # is created in the new AWS GovCloud (US) account. This role can be
869
- # assumed by the AWS GovCloud (US) account that is associated with the
870
- # master account of the commercial organization. For more information
871
- # and to view a diagram that explains how account access works, see [AWS
956
+ # is created in the new AWS GovCloud (US) account that can be assumed by
957
+ # the AWS GovCloud (US) account that is associated with the master
958
+ # account of the commercial organization. For more information and to
959
+ # view a diagram that explains how account access works, see [AWS
872
960
  # Organizations][4] in the *AWS GovCloud User Guide.*
873
961
  #
874
962
  # For more information about creating accounts, see [Creating an AWS
875
963
  # Account in Your Organization][6] in the *AWS Organizations User
876
964
  # Guide.*
877
965
  #
878
- # * You can create an account in an organization using the AWS
879
- # Organizations console, API, or CLI commands. When you do, the
880
- # information required for the account to operate as a standalone
881
- # account, such as a payment method, is *not* automatically collected.
882
- # If you must remove an account from your organization later, you can
883
- # do so only after you provide the missing information. Follow the
884
- # steps at [ To leave an organization as a member account][7] in the
885
- # *AWS Organizations User Guide.*
966
+ # * When you create an account in an organization using the AWS
967
+ # Organizations console, API, or CLI commands, the information
968
+ # required for the account to operate as a standalone account, such as
969
+ # a payment method and signing the end user license agreement (EULA)
970
+ # is *not* automatically collected. If you must remove an account from
971
+ # your organization later, you can do so only after you provide the
972
+ # missing information. Follow the steps at [ To leave an organization
973
+ # as a member account][7] in the *AWS Organizations User Guide.*
886
974
  #
887
975
  # * If you get an exception that indicates that you exceeded your
888
976
  # account limits for the organization, contact [AWS Support][8].
@@ -930,8 +1018,8 @@ module Aws::Organizations
930
1018
  # of the account or remove an account that was created with an invalid
931
1019
  # email address. Like all request parameters for
932
1020
  # `CreateGovCloudAccount`, the request for the email address for the AWS
933
- # GovCloud (US) account originates from the commercial Region. It does
934
- # not come from the AWS GovCloud (US) Region.
1021
+ # GovCloud (US) account originates from the commercial Region, not from
1022
+ # the AWS GovCloud (US) Region.
935
1023
  #
936
1024
  # @option params [required, String] :account_name
937
1025
  # The friendly name of the member account.
@@ -951,8 +1039,8 @@ module Aws::Organizations
951
1039
  #
952
1040
  # For more information about how to use this role to access the member
953
1041
  # account, see [Accessing and Administering the Member Accounts in Your
954
- # Organization][1] in the *AWS Organizations User Guide*. See also steps
955
- # 2 and 3 in [Tutorial: Delegate Access Across AWS Accounts Using IAM
1042
+ # Organization][1] in the *AWS Organizations User Guide* and steps 2 and
1043
+ # 3 in [Tutorial: Delegate Access Across AWS Accounts Using IAM
956
1044
  # Roles][2] in the *IAM User Guide.*
957
1045
  #
958
1046
  # The [regex pattern][3] that is used to validate this parameter. The
@@ -1023,11 +1111,12 @@ module Aws::Organizations
1023
1111
  # must also have the relevant IAM permissions.
1024
1112
  #
1025
1113
  # By default (or if you set the `FeatureSet` parameter to `ALL`), the
1026
- # new organization is created with all features enabled. In addition,
1027
- # service control policies are automatically enabled in the root. If you
1028
- # instead create the organization supporting only the consolidated
1029
- # billing features, no policy types are enabled by default, and you
1030
- # can't use organization policies.
1114
+ # new organization is created with all features enabled and service
1115
+ # control policies automatically enabled in the root. If you instead
1116
+ # choose to create the organization supporting only the consolidated
1117
+ # billing features by setting the `FeatureSet` parameter to
1118
+ # `CONSOLIDATED_BILLING"`, no policy types are enabled by default, and
1119
+ # you can't use organization policies
1031
1120
  #
1032
1121
  #
1033
1122
  #
@@ -1045,9 +1134,9 @@ module Aws::Organizations
1045
1134
  # The consolidated billing feature subset isn't available for
1046
1135
  # organizations in the AWS GovCloud (US) Region.
1047
1136
  #
1048
- # * `ALL`\: In addition to all the features that consolidated billing
1049
- # feature set supports, the master account can also apply any policy
1050
- # type to any member account in the organization. For more
1137
+ # * `ALL`\: In addition to all the features supported by the
1138
+ # consolidated billing feature set, the master account can also apply
1139
+ # any policy type to any member account in the organization. For more
1051
1140
  # information, see [All features][2] in the *AWS Organizations User
1052
1141
  # Guide.*
1053
1142
  #
@@ -1236,12 +1325,12 @@ module Aws::Organizations
1236
1325
  # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies.html
1237
1326
  #
1238
1327
  # @option params [required, String] :content
1239
- # The policy content to add to the new policy. For example, you could
1240
- # create a [service control policy][1] (SCP) that specifies the
1241
- # permissions that administrators in attached accounts can delegate to
1242
- # their users, groups, and roles. The string for this SCP must be JSON
1243
- # text. For more information about the SCP syntax, see [Service Control
1244
- # Policy Syntax][2] in the *AWS Organizations User Guide.*
1328
+ # The policy content to add to the new policy. For example, if you
1329
+ # create a [service control policy][1] (SCP), this string must be JSON
1330
+ # text that specifies the permissions that admins in attached accounts
1331
+ # can delegate to their users, groups, and roles. For more information
1332
+ # about the SCP syntax, see [Service Control Policy Syntax][2] in the
1333
+ # *AWS Organizations User Guide.*
1245
1334
  #
1246
1335
  #
1247
1336
  #
@@ -1264,6 +1353,11 @@ module Aws::Organizations
1264
1353
  # @option params [required, String] :type
1265
1354
  # The type of policy to create.
1266
1355
  #
1356
+ # <note markdown="1"> In the current release, the only type of policy that you can create is
1357
+ # a service control policy (SCP).
1358
+ #
1359
+ # </note>
1360
+ #
1267
1361
  # @return [Types::CreatePolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1268
1362
  #
1269
1363
  # * {Types::CreatePolicyResponse#policy #policy} => Types::Policy
@@ -1333,8 +1427,7 @@ module Aws::Organizations
1333
1427
  # reinitiate the process with a new handshake request.
1334
1428
  #
1335
1429
  # After you decline a handshake, it continues to appear in the results
1336
- # of relevant API operations for only 30 days. After that, it's
1337
- # deleted.
1430
+ # of relevant APIs for only 30 days. After that, it's deleted.
1338
1431
  #
1339
1432
  # @option params [required, String] :handshake_id
1340
1433
  # The unique identifier (ID) of the handshake that you want to decline.
@@ -1548,12 +1641,61 @@ module Aws::Organizations
1548
1641
  req.send_request(options)
1549
1642
  end
1550
1643
 
1551
- # Retrieves AWS Organizations related information about the specified
1552
- # account.
1644
+ # Removes the specified member AWS account as a delegated administrator
1645
+ # for the specified AWS service.
1646
+ #
1647
+ # You can run this action only for AWS services that support this
1648
+ # feature. For a current list of services that support it, see the
1649
+ # column *Supports Delegated Administrator* in the table at [AWS
1650
+ # Services that you can use with AWS Organizations][1] in the *AWS
1651
+ # Organizations User Guide.*
1553
1652
  #
1554
1653
  # This operation can be called only from the organization's master
1555
1654
  # account.
1556
1655
  #
1656
+ #
1657
+ #
1658
+ # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrated-services-list.html
1659
+ #
1660
+ # @option params [required, String] :account_id
1661
+ # The account ID number of the member account in the organization that
1662
+ # you want to deregister as a delegated administrator.
1663
+ #
1664
+ # @option params [required, String] :service_principal
1665
+ # The service principal name of an AWS service for which the account is
1666
+ # a delegated administrator.
1667
+ #
1668
+ # Delegated administrator privileges are revoked for only the specified
1669
+ # AWS service from the member account. If the specified service is the
1670
+ # only service for which the member account is a delegated
1671
+ # administrator, the operation also revokes Organizations read action
1672
+ # permissions.
1673
+ #
1674
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1675
+ #
1676
+ # @example Request syntax with placeholder values
1677
+ #
1678
+ # resp = client.deregister_delegated_administrator({
1679
+ # account_id: "AccountId", # required
1680
+ # service_principal: "ServicePrincipal", # required
1681
+ # })
1682
+ #
1683
+ # @see http://docs.aws.amazon.com/goto/WebAPI/organizations-2016-11-28/DeregisterDelegatedAdministrator AWS API Documentation
1684
+ #
1685
+ # @overload deregister_delegated_administrator(params = {})
1686
+ # @param [Hash] params ({})
1687
+ def deregister_delegated_administrator(params = {}, options = {})
1688
+ req = build_request(:deregister_delegated_administrator, params)
1689
+ req.send_request(options)
1690
+ end
1691
+
1692
+ # Retrieves AWS Organizations-related information about the specified
1693
+ # account.
1694
+ #
1695
+ # This operation can be called only from the organization's master
1696
+ # account or by a member account that is a delegated administrator for
1697
+ # an AWS service.
1698
+ #
1557
1699
  # @option params [required, String] :account_id
1558
1700
  # The unique identifier (ID) of the AWS account that you want
1559
1701
  # information about. You can get the ID from the ListAccounts or
@@ -1618,7 +1760,8 @@ module Aws::Organizations
1618
1760
  # account.
1619
1761
  #
1620
1762
  # This operation can be called only from the organization's master
1621
- # account.
1763
+ # account or by a member account that is a delegated administrator for
1764
+ # an AWS service.
1622
1765
  #
1623
1766
  # @option params [required, String] :create_account_request_id
1624
1767
  # Specifies the `operationId` that uniquely identifies the request. You
@@ -1692,7 +1835,9 @@ module Aws::Organizations
1692
1835
  # For more information on policy inheritance, see [How Policy
1693
1836
  # Inheritance Works][1] in the *AWS Organizations User Guide*.
1694
1837
  #
1695
- # This operation can be called from any account in the organization.
1838
+ # This operation can be called only from the organization's master
1839
+ # account or by a member account that is a delegated administrator for
1840
+ # an AWS service.
1696
1841
  #
1697
1842
  #
1698
1843
  #
@@ -1908,7 +2053,8 @@ module Aws::Organizations
1908
2053
  # Retrieves information about an organizational unit (OU).
1909
2054
  #
1910
2055
  # This operation can be called only from the organization's master
1911
- # account.
2056
+ # account or by a member account that is a delegated administrator for
2057
+ # an AWS service.
1912
2058
  #
1913
2059
  # @option params [required, String] :organizational_unit_id
1914
2060
  # The unique identifier (ID) of the organizational unit that you want
@@ -1970,7 +2116,8 @@ module Aws::Organizations
1970
2116
  # Retrieves information about a policy.
1971
2117
  #
1972
2118
  # This operation can be called only from the organization's master
1973
- # account.
2119
+ # account or by a member account that is a delegated administrator for
2120
+ # an AWS service.
1974
2121
  #
1975
2122
  # @option params [required, String] :policy_id
1976
2123
  # The unique identifier (ID) of the policy that you want details about.
@@ -2044,15 +2191,15 @@ module Aws::Organizations
2044
2191
  # accounts are immediate.
2045
2192
  #
2046
2193
  # **Note:** Every root, OU, and account must have at least one SCP
2047
- # attached. You can replace the default `FullAWSAccess` policy with one
2048
- # that limits the permissions that can be delegated. To do that, you
2049
- # must attach the replacement policy before you can remove the default
2050
- # one. This is the authorization strategy of using an [allow list][1].
2051
- # You could instead attach a second SCP and leave the `FullAWSAccess`
2052
- # SCP still attached. You could then specify `"Effect": "Deny"` in the
2053
- # second SCP to override the `"Effect": "Allow"` in the `FullAWSAccess`
2054
- # policy (or any other attached SCP). If you take these steps, you're
2055
- # using the authorization strategy of a [deny list][2].
2194
+ # attached. If you want to replace the default `FullAWSAccess` policy
2195
+ # with one that limits the permissions that can be delegated, you must
2196
+ # attach the replacement policy before you can remove the default one.
2197
+ # This is the authorization strategy of an "[allow list][1]". If you
2198
+ # instead attach a second SCP and leave the `FullAWSAccess` SCP still
2199
+ # attached, and specify `"Effect": "Deny"` in the second SCP to override
2200
+ # the `"Effect": "Allow"` in the `FullAWSAccess` policy (or any other
2201
+ # attached SCP), you're using the authorization strategy of a "[deny
2202
+ # list][2]".
2056
2203
  #
2057
2204
  # This operation can be called only from the organization's master
2058
2205
  # account.
@@ -2145,9 +2292,8 @@ module Aws::Organizations
2145
2292
  #
2146
2293
  # After you perform the `DisableAWSServiceAccess` operation, the
2147
2294
  # specified service can no longer perform operations in your
2148
- # organization's accounts. The only exception is when the operations
2149
- # are explicitly permitted by IAM policies that are attached to your
2150
- # roles.
2295
+ # organization's accounts unless the operations are explicitly
2296
+ # permitted by the IAM policies that are attached to your roles.
2151
2297
  #
2152
2298
  # For more information about integrating other services with AWS
2153
2299
  # Organizations, including the list of services that work with
@@ -2184,13 +2330,12 @@ module Aws::Organizations
2184
2330
  req.send_request(options)
2185
2331
  end
2186
2332
 
2187
- # Disables an organizational control policy type in a root and detaches
2188
- # all policies of that type from the organization root, OUs, and
2189
- # accounts. A policy of a certain type can be attached to entities in a
2190
- # root only if that type is enabled in the root. After you perform this
2191
- # operation, you no longer can attach policies of the specified type to
2192
- # that root or to any organizational unit (OU) or account in that root.
2193
- # You can undo this by using the EnablePolicyType operation.
2333
+ # Disables an organizational control policy type in a root. A policy of
2334
+ # a certain type can be attached to entities in a root only if that type
2335
+ # is enabled in the root. After you perform this operation, you no
2336
+ # longer can attach policies of the specified type to that root or to
2337
+ # any organizational unit (OU) or account in that root. You can undo
2338
+ # this by using the EnablePolicyType operation.
2194
2339
  #
2195
2340
  # This is an asynchronous request that AWS performs in the background.
2196
2341
  # If you disable a policy for a root, it still appears enabled for the
@@ -2326,7 +2471,7 @@ module Aws::Organizations
2326
2471
  # Enables all features in an organization. This enables the use of
2327
2472
  # organization policies that can restrict the services and actions that
2328
2473
  # can be called in each account. Until you enable all features, you have
2329
- # access only to consolidated billing. You can't use any of the
2474
+ # access only to consolidated billing, and you can't use any of the
2330
2475
  # advanced account administration features that AWS Organizations
2331
2476
  # supports. For more information, see [Enabling All Features in Your
2332
2477
  # Organization][1] in the *AWS Organizations User Guide.*
@@ -2336,8 +2481,7 @@ module Aws::Organizations
2336
2481
  # Calling this operation sends a handshake to every invited account in
2337
2482
  # the organization. The feature set change can be finalized and the
2338
2483
  # additional features enabled only after all administrators in the
2339
- # invited accounts approve the change. Accepting the handshake approves
2340
- # the change.
2484
+ # invited accounts approve the change by accepting the handshake.
2341
2485
  #
2342
2486
  # After you enable all features, you can separately enable or disable
2343
2487
  # individual policy types in a root using EnablePolicyType and
@@ -2519,18 +2663,18 @@ module Aws::Organizations
2519
2663
  # response.
2520
2664
  #
2521
2665
  # * You can invite AWS accounts only from the same seller as the master
2522
- # account. For example, assume that your organization's master
2523
- # account was created by Amazon Internet Services Pvt. Ltd (AISPL), an
2524
- # AWS seller in India. You can invite only other AISPL accounts to
2525
- # your organization. You can't combine accounts from AISPL and AWS or
2526
- # from any other AWS seller. For more information, see [Consolidated
2666
+ # account. For example, if your organization's master account was
2667
+ # created by Amazon Internet Services Pvt. Ltd (AISPL), an AWS seller
2668
+ # in India, you can invite only other AISPL accounts to your
2669
+ # organization. You can't combine accounts from AISPL and AWS or from
2670
+ # any other AWS seller. For more information, see [Consolidated
2527
2671
  # Billing in India][1].
2528
2672
  #
2529
- # * You might receive an exception that indicates that you exceeded your
2673
+ # * If you receive an exception that indicates that you exceeded your
2530
2674
  # account limits for the organization or that the operation failed
2531
- # because your organization is still initializing. If so, wait one
2532
- # hour and then try again. If the error persists after an hour,
2533
- # contact [AWS Support][2].
2675
+ # because your organization is still initializing, wait one hour and
2676
+ # then try again. If the error persists after an hour, contact [AWS
2677
+ # Support][2].
2534
2678
  #
2535
2679
  # This operation can be called only from the organization's master
2536
2680
  # account.
@@ -2671,24 +2815,31 @@ module Aws::Organizations
2671
2815
  #
2672
2816
  # * The master account in an organization with all features enabled can
2673
2817
  # set service control policies (SCPs) that can restrict what
2674
- # administrators of member accounts can do. These restrictions can
2675
- # include preventing member accounts from successfully calling
2676
- # `LeaveOrganization`.
2818
+ # administrators of member accounts can do. This includes preventing
2819
+ # them from successfully calling `LeaveOrganization` and leaving the
2820
+ # organization.
2677
2821
  #
2678
2822
  # * You can leave an organization as a member account only if the
2679
2823
  # account is configured with the information required to operate as a
2680
2824
  # standalone account. When you create an account in an organization
2681
- # using the AWS Organizations console, API, or CLI, the information
2682
- # required of standalone accounts is *not* automatically collected.
2683
- # For each account that you want to make standalone, you must accept
2684
- # the end user license agreement (EULA). You must also choose a
2685
- # support plan, provide and verify the required contact information,
2686
- # and provide a current payment method. AWS uses the payment method to
2687
- # charge for any billable (not free tier) AWS activity that occurs
2688
- # while the account isn't attached to an organization. Follow the
2689
- # steps at [ To leave an organization when all required account
2690
- # information has not yet been provided][1] in the *AWS Organizations
2691
- # User Guide.*
2825
+ # using the AWS Organizations console, API, or CLI commands, the
2826
+ # information required of standalone accounts is *not* automatically
2827
+ # collected. For each account that you want to make standalone, you
2828
+ # must do the following steps:
2829
+ #
2830
+ # * Accept the end user license agreement (EULA)
2831
+ #
2832
+ # * Choose a support plan
2833
+ #
2834
+ # * Provide and verify the required contact information
2835
+ #
2836
+ # * Provide a current payment method
2837
+ #
2838
+ # AWS uses the payment method to charge for any billable (not free
2839
+ # tier) AWS activity that occurs while the account isn't attached to
2840
+ # an organization. Follow the steps at [ To leave an organization when
2841
+ # all required account information has not yet been provided][1] in
2842
+ # the *AWS Organizations User Guide.*
2692
2843
  #
2693
2844
  # * You can leave an organization only after you enable IAM user access
2694
2845
  # to billing in your account. For more information, see [Activating
@@ -2730,35 +2881,39 @@ module Aws::Organizations
2730
2881
  # Services][1] in the *AWS Organizations User Guide.*
2731
2882
  #
2732
2883
  # This operation can be called only from the organization's master
2733
- # account.
2884
+ # account or by a member account that is a delegated administrator for
2885
+ # an AWS service.
2734
2886
  #
2735
2887
  #
2736
2888
  #
2737
2889
  # [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html
2738
2890
  #
2739
2891
  # @option params [String] :next_token
2740
- # Use this parameter if you receive a `NextToken` response in a previous
2741
- # request that indicates that there is more output available. Set it to
2742
- # the value of the previous call's `NextToken` response to indicate
2743
- # where the output should continue from.
2892
+ # The parameter for receiving additional results if you receive a
2893
+ # `NextToken` response in a previous request. A `NextToken` response
2894
+ # indicates that more output is available. Set this parameter to the
2895
+ # value of the previous call's `NextToken` response to indicate where
2896
+ # the output should continue from.
2744
2897
  #
2745
2898
  # @option params [Integer] :max_results
2746
- # (Optional) Use this to limit the number of results you want included
2747
- # per page in the response. If you do not include this parameter, it
2748
- # defaults to a value that is specific to the operation. If additional
2749
- # items exist beyond the maximum you specify, the `NextToken` response
2750
- # element is present and has a value (is not null). Include that value
2751
- # as the `NextToken` request parameter in the next call to the operation
2752
- # to get the next part of the results. Note that Organizations might
2753
- # return fewer results than the maximum even when there are more results
2754
- # available. You should check `NextToken` after every operation to
2755
- # ensure that you receive all of the results.
2899
+ # The total number of results that you want included on each page of the
2900
+ # response. If you do not include this parameter, it defaults to a value
2901
+ # that is specific to the operation. If additional items exist beyond
2902
+ # the maximum you specify, the `NextToken` response element is present
2903
+ # and has a value (is not null). Include that value as the `NextToken`
2904
+ # request parameter in the next call to the operation to get the next
2905
+ # part of the results. Note that Organizations might return fewer
2906
+ # results than the maximum even when there are more results available.
2907
+ # You should check `NextToken` after every operation to ensure that you
2908
+ # receive all of the results.
2756
2909
  #
2757
2910
  # @return [Types::ListAWSServiceAccessForOrganizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2758
2911
  #
2759
2912
  # * {Types::ListAWSServiceAccessForOrganizationResponse#enabled_service_principals #enabled_service_principals} => Array&lt;Types::EnabledServicePrincipal&gt;
2760
2913
  # * {Types::ListAWSServiceAccessForOrganizationResponse#next_token #next_token} => String
2761
2914
  #
2915
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2916
+ #
2762
2917
  # @example Request syntax with placeholder values
2763
2918
  #
2764
2919
  # resp = client.list_aws_service_access_for_organization({
@@ -2795,31 +2950,35 @@ module Aws::Organizations
2795
2950
  # </note>
2796
2951
  #
2797
2952
  # This operation can be called only from the organization's master
2798
- # account.
2953
+ # account or by a member account that is a delegated administrator for
2954
+ # an AWS service.
2799
2955
  #
2800
2956
  # @option params [String] :next_token
2801
- # Use this parameter if you receive a `NextToken` response in a previous
2802
- # request that indicates that there is more output available. Set it to
2803
- # the value of the previous call's `NextToken` response to indicate
2804
- # where the output should continue from.
2957
+ # The parameter for receiving additional results if you receive a
2958
+ # `NextToken` response in a previous request. A `NextToken` response
2959
+ # indicates that more output is available. Set this parameter to the
2960
+ # value of the previous call's `NextToken` response to indicate where
2961
+ # the output should continue from.
2805
2962
  #
2806
2963
  # @option params [Integer] :max_results
2807
- # (Optional) Use this to limit the number of results you want included
2808
- # per page in the response. If you do not include this parameter, it
2809
- # defaults to a value that is specific to the operation. If additional
2810
- # items exist beyond the maximum you specify, the `NextToken` response
2811
- # element is present and has a value (is not null). Include that value
2812
- # as the `NextToken` request parameter in the next call to the operation
2813
- # to get the next part of the results. Note that Organizations might
2814
- # return fewer results than the maximum even when there are more results
2815
- # available. You should check `NextToken` after every operation to
2816
- # ensure that you receive all of the results.
2964
+ # The total number of results that you want included on each page of the
2965
+ # response. If you do not include this parameter, it defaults to a value
2966
+ # that is specific to the operation. If additional items exist beyond
2967
+ # the maximum you specify, the `NextToken` response element is present
2968
+ # and has a value (is not null). Include that value as the `NextToken`
2969
+ # request parameter in the next call to the operation to get the next
2970
+ # part of the results. Note that Organizations might return fewer
2971
+ # results than the maximum even when there are more results available.
2972
+ # You should check `NextToken` after every operation to ensure that you
2973
+ # receive all of the results.
2817
2974
  #
2818
2975
  # @return [Types::ListAccountsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2819
2976
  #
2820
2977
  # * {Types::ListAccountsResponse#accounts #accounts} => Array&lt;Types::Account&gt;
2821
2978
  # * {Types::ListAccountsResponse#next_token #next_token} => String
2822
2979
  #
2980
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2981
+ #
2823
2982
  #
2824
2983
  # @example Example: To retrieve a list of all of the accounts in an organization
2825
2984
  #
@@ -2914,35 +3073,39 @@ module Aws::Organizations
2914
3073
  # </note>
2915
3074
  #
2916
3075
  # This operation can be called only from the organization's master
2917
- # account.
3076
+ # account or by a member account that is a delegated administrator for
3077
+ # an AWS service.
2918
3078
  #
2919
3079
  # @option params [required, String] :parent_id
2920
3080
  # The unique identifier (ID) for the parent root or organization unit
2921
3081
  # (OU) whose accounts you want to list.
2922
3082
  #
2923
3083
  # @option params [String] :next_token
2924
- # Use this parameter if you receive a `NextToken` response in a previous
2925
- # request that indicates that there is more output available. Set it to
2926
- # the value of the previous call's `NextToken` response to indicate
2927
- # where the output should continue from.
3084
+ # The parameter for receiving additional results if you receive a
3085
+ # `NextToken` response in a previous request. A `NextToken` response
3086
+ # indicates that more output is available. Set this parameter to the
3087
+ # value of the previous call's `NextToken` response to indicate where
3088
+ # the output should continue from.
2928
3089
  #
2929
3090
  # @option params [Integer] :max_results
2930
- # (Optional) Use this to limit the number of results you want included
2931
- # per page in the response. If you do not include this parameter, it
2932
- # defaults to a value that is specific to the operation. If additional
2933
- # items exist beyond the maximum you specify, the `NextToken` response
2934
- # element is present and has a value (is not null). Include that value
2935
- # as the `NextToken` request parameter in the next call to the operation
2936
- # to get the next part of the results. Note that Organizations might
2937
- # return fewer results than the maximum even when there are more results
2938
- # available. You should check `NextToken` after every operation to
2939
- # ensure that you receive all of the results.
3091
+ # The total number of results that you want included on each page of the
3092
+ # response. If you do not include this parameter, it defaults to a value
3093
+ # that is specific to the operation. If additional items exist beyond
3094
+ # the maximum you specify, the `NextToken` response element is present
3095
+ # and has a value (is not null). Include that value as the `NextToken`
3096
+ # request parameter in the next call to the operation to get the next
3097
+ # part of the results. Note that Organizations might return fewer
3098
+ # results than the maximum even when there are more results available.
3099
+ # You should check `NextToken` after every operation to ensure that you
3100
+ # receive all of the results.
2940
3101
  #
2941
3102
  # @return [Types::ListAccountsForParentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2942
3103
  #
2943
3104
  # * {Types::ListAccountsForParentResponse#accounts #accounts} => Array&lt;Types::Account&gt;
2944
3105
  # * {Types::ListAccountsForParentResponse#next_token #next_token} => String
2945
3106
  #
3107
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3108
+ #
2946
3109
  #
2947
3110
  # @example Example: To retrieve a list of all of the accounts in a root or OU
2948
3111
  #
@@ -3019,7 +3182,8 @@ module Aws::Organizations
3019
3182
  # </note>
3020
3183
  #
3021
3184
  # This operation can be called only from the organization's master
3022
- # account.
3185
+ # account or by a member account that is a delegated administrator for
3186
+ # an AWS service.
3023
3187
  #
3024
3188
  # @option params [required, String] :parent_id
3025
3189
  # The unique identifier (ID) for the parent root or OU whose children
@@ -3044,28 +3208,31 @@ module Aws::Organizations
3044
3208
  # Filters the output to include only the specified child type.
3045
3209
  #
3046
3210
  # @option params [String] :next_token
3047
- # Use this parameter if you receive a `NextToken` response in a previous
3048
- # request that indicates that there is more output available. Set it to
3049
- # the value of the previous call's `NextToken` response to indicate
3050
- # where the output should continue from.
3211
+ # The parameter for receiving additional results if you receive a
3212
+ # `NextToken` response in a previous request. A `NextToken` response
3213
+ # indicates that more output is available. Set this parameter to the
3214
+ # value of the previous call's `NextToken` response to indicate where
3215
+ # the output should continue from.
3051
3216
  #
3052
3217
  # @option params [Integer] :max_results
3053
- # (Optional) Use this to limit the number of results you want included
3054
- # per page in the response. If you do not include this parameter, it
3055
- # defaults to a value that is specific to the operation. If additional
3056
- # items exist beyond the maximum you specify, the `NextToken` response
3057
- # element is present and has a value (is not null). Include that value
3058
- # as the `NextToken` request parameter in the next call to the operation
3059
- # to get the next part of the results. Note that Organizations might
3060
- # return fewer results than the maximum even when there are more results
3061
- # available. You should check `NextToken` after every operation to
3062
- # ensure that you receive all of the results.
3218
+ # The total number of results that you want included on each page of the
3219
+ # response. If you do not include this parameter, it defaults to a value
3220
+ # that is specific to the operation. If additional items exist beyond
3221
+ # the maximum you specify, the `NextToken` response element is present
3222
+ # and has a value (is not null). Include that value as the `NextToken`
3223
+ # request parameter in the next call to the operation to get the next
3224
+ # part of the results. Note that Organizations might return fewer
3225
+ # results than the maximum even when there are more results available.
3226
+ # You should check `NextToken` after every operation to ensure that you
3227
+ # receive all of the results.
3063
3228
  #
3064
3229
  # @return [Types::ListChildrenResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3065
3230
  #
3066
3231
  # * {Types::ListChildrenResponse#children #children} => Array&lt;Types::Child&gt;
3067
3232
  # * {Types::ListChildrenResponse#next_token #next_token} => String
3068
3233
  #
3234
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3235
+ #
3069
3236
  #
3070
3237
  # @example Example: To retrieve a list of all of the child accounts and OUs in a parent root or OU
3071
3238
  #
@@ -3127,7 +3294,8 @@ module Aws::Organizations
3127
3294
  # </note>
3128
3295
  #
3129
3296
  # This operation can be called only from the organization's master
3130
- # account.
3297
+ # account or by a member account that is a delegated administrator for
3298
+ # an AWS service.
3131
3299
  #
3132
3300
  # @option params [Array<String>] :states
3133
3301
  # A list of one or more states that you want included in the response.
@@ -3135,28 +3303,31 @@ module Aws::Organizations
3135
3303
  # response.
3136
3304
  #
3137
3305
  # @option params [String] :next_token
3138
- # Use this parameter if you receive a `NextToken` response in a previous
3139
- # request that indicates that there is more output available. Set it to
3140
- # the value of the previous call's `NextToken` response to indicate
3141
- # where the output should continue from.
3306
+ # The parameter for receiving additional results if you receive a
3307
+ # `NextToken` response in a previous request. A `NextToken` response
3308
+ # indicates that more output is available. Set this parameter to the
3309
+ # value of the previous call's `NextToken` response to indicate where
3310
+ # the output should continue from.
3142
3311
  #
3143
3312
  # @option params [Integer] :max_results
3144
- # (Optional) Use this to limit the number of results you want included
3145
- # per page in the response. If you do not include this parameter, it
3146
- # defaults to a value that is specific to the operation. If additional
3147
- # items exist beyond the maximum you specify, the `NextToken` response
3148
- # element is present and has a value (is not null). Include that value
3149
- # as the `NextToken` request parameter in the next call to the operation
3150
- # to get the next part of the results. Note that Organizations might
3151
- # return fewer results than the maximum even when there are more results
3152
- # available. You should check `NextToken` after every operation to
3153
- # ensure that you receive all of the results.
3313
+ # The total number of results that you want included on each page of the
3314
+ # response. If you do not include this parameter, it defaults to a value
3315
+ # that is specific to the operation. If additional items exist beyond
3316
+ # the maximum you specify, the `NextToken` response element is present
3317
+ # and has a value (is not null). Include that value as the `NextToken`
3318
+ # request parameter in the next call to the operation to get the next
3319
+ # part of the results. Note that Organizations might return fewer
3320
+ # results than the maximum even when there are more results available.
3321
+ # You should check `NextToken` after every operation to ensure that you
3322
+ # receive all of the results.
3154
3323
  #
3155
3324
  # @return [Types::ListCreateAccountStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3156
3325
  #
3157
3326
  # * {Types::ListCreateAccountStatusResponse#create_account_statuses #create_account_statuses} => Array&lt;Types::CreateAccountStatus&gt;
3158
3327
  # * {Types::ListCreateAccountStatusResponse#next_token #next_token} => String
3159
3328
  #
3329
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3330
+ #
3160
3331
  #
3161
3332
  # @example Example: To get a list of completed account creation requests made in the organization
3162
3333
  #
@@ -3236,6 +3407,137 @@ module Aws::Organizations
3236
3407
  req.send_request(options)
3237
3408
  end
3238
3409
 
3410
+ # Lists the AWS accounts that are designated as delegated administrators
3411
+ # in this organization.
3412
+ #
3413
+ # This operation can be called only from the organization's master
3414
+ # account or by a member account that is a delegated administrator for
3415
+ # an AWS service.
3416
+ #
3417
+ # @option params [String] :service_principal
3418
+ # Specifies a service principal name. If specified, then the operation
3419
+ # lists the delegated administrators only for the specified service.
3420
+ #
3421
+ # If you don't specify a service principal, the operation lists all
3422
+ # delegated administrators for all services in your organization.
3423
+ #
3424
+ # @option params [String] :next_token
3425
+ # The parameter for receiving additional results if you receive a
3426
+ # `NextToken` response in a previous request. A `NextToken` response
3427
+ # indicates that more output is available. Set this parameter to the
3428
+ # value of the previous call's `NextToken` response to indicate where
3429
+ # the output should continue from.
3430
+ #
3431
+ # @option params [Integer] :max_results
3432
+ # The total number of results that you want included on each page of the
3433
+ # response. If you do not include this parameter, it defaults to a value
3434
+ # that is specific to the operation. If additional items exist beyond
3435
+ # the maximum you specify, the `NextToken` response element is present
3436
+ # and has a value (is not null). Include that value as the `NextToken`
3437
+ # request parameter in the next call to the operation to get the next
3438
+ # part of the results. Note that Organizations might return fewer
3439
+ # results than the maximum even when there are more results available.
3440
+ # You should check `NextToken` after every operation to ensure that you
3441
+ # receive all of the results.
3442
+ #
3443
+ # @return [Types::ListDelegatedAdministratorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3444
+ #
3445
+ # * {Types::ListDelegatedAdministratorsResponse#delegated_administrators #delegated_administrators} => Array&lt;Types::DelegatedAdministrator&gt;
3446
+ # * {Types::ListDelegatedAdministratorsResponse#next_token #next_token} => String
3447
+ #
3448
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3449
+ #
3450
+ # @example Request syntax with placeholder values
3451
+ #
3452
+ # resp = client.list_delegated_administrators({
3453
+ # service_principal: "ServicePrincipal",
3454
+ # next_token: "NextToken",
3455
+ # max_results: 1,
3456
+ # })
3457
+ #
3458
+ # @example Response structure
3459
+ #
3460
+ # resp.delegated_administrators #=> Array
3461
+ # resp.delegated_administrators[0].id #=> String
3462
+ # resp.delegated_administrators[0].arn #=> String
3463
+ # resp.delegated_administrators[0].email #=> String
3464
+ # resp.delegated_administrators[0].name #=> String
3465
+ # resp.delegated_administrators[0].status #=> String, one of "ACTIVE", "SUSPENDED"
3466
+ # resp.delegated_administrators[0].joined_method #=> String, one of "INVITED", "CREATED"
3467
+ # resp.delegated_administrators[0].joined_timestamp #=> Time
3468
+ # resp.delegated_administrators[0].delegation_enabled_date #=> Time
3469
+ # resp.next_token #=> String
3470
+ #
3471
+ # @see http://docs.aws.amazon.com/goto/WebAPI/organizations-2016-11-28/ListDelegatedAdministrators AWS API Documentation
3472
+ #
3473
+ # @overload list_delegated_administrators(params = {})
3474
+ # @param [Hash] params ({})
3475
+ def list_delegated_administrators(params = {}, options = {})
3476
+ req = build_request(:list_delegated_administrators, params)
3477
+ req.send_request(options)
3478
+ end
3479
+
3480
+ # List the AWS services for which the specified account is a delegated
3481
+ # administrator.
3482
+ #
3483
+ # This operation can be called only from the organization's master
3484
+ # account or by a member account that is a delegated administrator for
3485
+ # an AWS service.
3486
+ #
3487
+ # @option params [required, String] :account_id
3488
+ # The account ID number of a delegated administrator account in the
3489
+ # organization.
3490
+ #
3491
+ # @option params [String] :next_token
3492
+ # The parameter for receiving additional results if you receive a
3493
+ # `NextToken` response in a previous request. A `NextToken` response
3494
+ # indicates that more output is available. Set this parameter to the
3495
+ # value of the previous call's `NextToken` response to indicate where
3496
+ # the output should continue from.
3497
+ #
3498
+ # @option params [Integer] :max_results
3499
+ # The total number of results that you want included on each page of the
3500
+ # response. If you do not include this parameter, it defaults to a value
3501
+ # that is specific to the operation. If additional items exist beyond
3502
+ # the maximum you specify, the `NextToken` response element is present
3503
+ # and has a value (is not null). Include that value as the `NextToken`
3504
+ # request parameter in the next call to the operation to get the next
3505
+ # part of the results. Note that Organizations might return fewer
3506
+ # results than the maximum even when there are more results available.
3507
+ # You should check `NextToken` after every operation to ensure that you
3508
+ # receive all of the results.
3509
+ #
3510
+ # @return [Types::ListDelegatedServicesForAccountResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3511
+ #
3512
+ # * {Types::ListDelegatedServicesForAccountResponse#delegated_services #delegated_services} => Array&lt;Types::DelegatedService&gt;
3513
+ # * {Types::ListDelegatedServicesForAccountResponse#next_token #next_token} => String
3514
+ #
3515
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3516
+ #
3517
+ # @example Request syntax with placeholder values
3518
+ #
3519
+ # resp = client.list_delegated_services_for_account({
3520
+ # account_id: "AccountId", # required
3521
+ # next_token: "NextToken",
3522
+ # max_results: 1,
3523
+ # })
3524
+ #
3525
+ # @example Response structure
3526
+ #
3527
+ # resp.delegated_services #=> Array
3528
+ # resp.delegated_services[0].service_principal #=> String
3529
+ # resp.delegated_services[0].delegation_enabled_date #=> Time
3530
+ # resp.next_token #=> String
3531
+ #
3532
+ # @see http://docs.aws.amazon.com/goto/WebAPI/organizations-2016-11-28/ListDelegatedServicesForAccount AWS API Documentation
3533
+ #
3534
+ # @overload list_delegated_services_for_account(params = {})
3535
+ # @param [Hash] params ({})
3536
+ def list_delegated_services_for_account(params = {}, options = {})
3537
+ req = build_request(:list_delegated_services_for_account, params)
3538
+ req.send_request(options)
3539
+ end
3540
+
3239
3541
  # Lists the current handshakes that are associated with the account of
3240
3542
  # the requesting user.
3241
3543
  #
@@ -3251,41 +3553,45 @@ module Aws::Organizations
3251
3553
  #
3252
3554
  # </note>
3253
3555
  #
3254
- # This operation can be called from any account in the organization.
3556
+ # This operation can be called only from the organization's master
3557
+ # account or by a member account that is a delegated administrator for
3558
+ # an AWS service.
3255
3559
  #
3256
3560
  # @option params [Types::HandshakeFilter] :filter
3257
3561
  # Filters the handshakes that you want included in the response. The
3258
3562
  # default is all types. Use the `ActionType` element to limit the output
3259
3563
  # to only a specified type, such as `INVITE`, `ENABLE_ALL_FEATURES`, or
3260
- # `APPROVE_ALL_FEATURES`. Alternatively, you can specify the
3261
- # `ENABLE_ALL_FEATURES` handshake, which generates a separate child
3262
- # handshake for each member account. When you do specify
3263
- # `ParentHandshakeId` to see only the handshakes that were generated by
3264
- # that parent request.
3564
+ # `APPROVE_ALL_FEATURES`. Alternatively, for the `ENABLE_ALL_FEATURES`
3565
+ # handshake that generates a separate child handshake for each member
3566
+ # account, you can specify `ParentHandshakeId` to see only the
3567
+ # handshakes that were generated by that parent request.
3265
3568
  #
3266
3569
  # @option params [String] :next_token
3267
- # Use this parameter if you receive a `NextToken` response in a previous
3268
- # request that indicates that there is more output available. Set it to
3269
- # the value of the previous call's `NextToken` response to indicate
3270
- # where the output should continue from.
3570
+ # The parameter for receiving additional results if you receive a
3571
+ # `NextToken` response in a previous request. A `NextToken` response
3572
+ # indicates that more output is available. Set this parameter to the
3573
+ # value of the previous call's `NextToken` response to indicate where
3574
+ # the output should continue from.
3271
3575
  #
3272
3576
  # @option params [Integer] :max_results
3273
- # (Optional) Use this to limit the number of results you want included
3274
- # per page in the response. If you do not include this parameter, it
3275
- # defaults to a value that is specific to the operation. If additional
3276
- # items exist beyond the maximum you specify, the `NextToken` response
3277
- # element is present and has a value (is not null). Include that value
3278
- # as the `NextToken` request parameter in the next call to the operation
3279
- # to get the next part of the results. Note that Organizations might
3280
- # return fewer results than the maximum even when there are more results
3281
- # available. You should check `NextToken` after every operation to
3282
- # ensure that you receive all of the results.
3577
+ # The total number of results that you want included on each page of the
3578
+ # response. If you do not include this parameter, it defaults to a value
3579
+ # that is specific to the operation. If additional items exist beyond
3580
+ # the maximum you specify, the `NextToken` response element is present
3581
+ # and has a value (is not null). Include that value as the `NextToken`
3582
+ # request parameter in the next call to the operation to get the next
3583
+ # part of the results. Note that Organizations might return fewer
3584
+ # results than the maximum even when there are more results available.
3585
+ # You should check `NextToken` after every operation to ensure that you
3586
+ # receive all of the results.
3283
3587
  #
3284
3588
  # @return [Types::ListHandshakesForAccountResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3285
3589
  #
3286
3590
  # * {Types::ListHandshakesForAccountResponse#handshakes #handshakes} => Array&lt;Types::Handshake&gt;
3287
3591
  # * {Types::ListHandshakesForAccountResponse#next_token #next_token} => String
3288
3592
  #
3593
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3594
+ #
3289
3595
  #
3290
3596
  # @example Example: To retrieve a list of the handshakes sent to an account
3291
3597
  #
@@ -3399,41 +3705,44 @@ module Aws::Organizations
3399
3705
  # </note>
3400
3706
  #
3401
3707
  # This operation can be called only from the organization's master
3402
- # account.
3708
+ # account or by a member account that is a delegated administrator for
3709
+ # an AWS service.
3403
3710
  #
3404
3711
  # @option params [Types::HandshakeFilter] :filter
3405
3712
  # A filter of the handshakes that you want included in the response. The
3406
3713
  # default is all types. Use the `ActionType` element to limit the output
3407
3714
  # to only a specified type, such as `INVITE`, `ENABLE-ALL-FEATURES`, or
3408
- # `APPROVE-ALL-FEATURES`. Alternatively, you can specify the
3409
- # `ENABLE-ALL-FEATURES` handshake, which generates a separate child
3410
- # handshake for each member account. When you do, specify the
3411
- # `ParentHandshakeId` to see only the handshakes that were generated by
3412
- # that parent request.
3715
+ # `APPROVE-ALL-FEATURES`. Alternatively, for the `ENABLE-ALL-FEATURES`
3716
+ # handshake that generates a separate child handshake for each member
3717
+ # account, you can specify the `ParentHandshakeId` to see only the
3718
+ # handshakes that were generated by that parent request.
3413
3719
  #
3414
3720
  # @option params [String] :next_token
3415
- # Use this parameter if you receive a `NextToken` response in a previous
3416
- # request that indicates that there is more output available. Set it to
3417
- # the value of the previous call's `NextToken` response to indicate
3418
- # where the output should continue from.
3721
+ # The parameter for receiving additional results if you receive a
3722
+ # `NextToken` response in a previous request. A `NextToken` response
3723
+ # indicates that more output is available. Set this parameter to the
3724
+ # value of the previous call's `NextToken` response to indicate where
3725
+ # the output should continue from.
3419
3726
  #
3420
3727
  # @option params [Integer] :max_results
3421
- # (Optional) Use this to limit the number of results you want included
3422
- # per page in the response. If you do not include this parameter, it
3423
- # defaults to a value that is specific to the operation. If additional
3424
- # items exist beyond the maximum you specify, the `NextToken` response
3425
- # element is present and has a value (is not null). Include that value
3426
- # as the `NextToken` request parameter in the next call to the operation
3427
- # to get the next part of the results. Note that Organizations might
3428
- # return fewer results than the maximum even when there are more results
3429
- # available. You should check `NextToken` after every operation to
3430
- # ensure that you receive all of the results.
3728
+ # The total number of results that you want included on each page of the
3729
+ # response. If you do not include this parameter, it defaults to a value
3730
+ # that is specific to the operation. If additional items exist beyond
3731
+ # the maximum you specify, the `NextToken` response element is present
3732
+ # and has a value (is not null). Include that value as the `NextToken`
3733
+ # request parameter in the next call to the operation to get the next
3734
+ # part of the results. Note that Organizations might return fewer
3735
+ # results than the maximum even when there are more results available.
3736
+ # You should check `NextToken` after every operation to ensure that you
3737
+ # receive all of the results.
3431
3738
  #
3432
3739
  # @return [Types::ListHandshakesForOrganizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3433
3740
  #
3434
3741
  # * {Types::ListHandshakesForOrganizationResponse#handshakes #handshakes} => Array&lt;Types::Handshake&gt;
3435
3742
  # * {Types::ListHandshakesForOrganizationResponse#next_token #next_token} => String
3436
3743
  #
3744
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3745
+ #
3437
3746
  #
3438
3747
  # @example Example: To retrieve a list of the handshakes associated with an organization
3439
3748
  #
@@ -3582,7 +3891,8 @@ module Aws::Organizations
3582
3891
  # </note>
3583
3892
  #
3584
3893
  # This operation can be called only from the organization's master
3585
- # account.
3894
+ # account or by a member account that is a delegated administrator for
3895
+ # an AWS service.
3586
3896
  #
3587
3897
  # @option params [required, String] :parent_id
3588
3898
  # The unique identifier (ID) of the root or OU whose child OUs you want
@@ -3604,28 +3914,31 @@ module Aws::Organizations
3604
3914
  # [1]: http://wikipedia.org/wiki/regex
3605
3915
  #
3606
3916
  # @option params [String] :next_token
3607
- # Use this parameter if you receive a `NextToken` response in a previous
3608
- # request that indicates that there is more output available. Set it to
3609
- # the value of the previous call's `NextToken` response to indicate
3610
- # where the output should continue from.
3917
+ # The parameter for receiving additional results if you receive a
3918
+ # `NextToken` response in a previous request. A `NextToken` response
3919
+ # indicates that more output is available. Set this parameter to the
3920
+ # value of the previous call's `NextToken` response to indicate where
3921
+ # the output should continue from.
3611
3922
  #
3612
3923
  # @option params [Integer] :max_results
3613
- # (Optional) Use this to limit the number of results you want included
3614
- # per page in the response. If you do not include this parameter, it
3615
- # defaults to a value that is specific to the operation. If additional
3616
- # items exist beyond the maximum you specify, the `NextToken` response
3617
- # element is present and has a value (is not null). Include that value
3618
- # as the `NextToken` request parameter in the next call to the operation
3619
- # to get the next part of the results. Note that Organizations might
3620
- # return fewer results than the maximum even when there are more results
3621
- # available. You should check `NextToken` after every operation to
3622
- # ensure that you receive all of the results.
3924
+ # The total number of results that you want included on each page of the
3925
+ # response. If you do not include this parameter, it defaults to a value
3926
+ # that is specific to the operation. If additional items exist beyond
3927
+ # the maximum you specify, the `NextToken` response element is present
3928
+ # and has a value (is not null). Include that value as the `NextToken`
3929
+ # request parameter in the next call to the operation to get the next
3930
+ # part of the results. Note that Organizations might return fewer
3931
+ # results than the maximum even when there are more results available.
3932
+ # You should check `NextToken` after every operation to ensure that you
3933
+ # receive all of the results.
3623
3934
  #
3624
3935
  # @return [Types::ListOrganizationalUnitsForParentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3625
3936
  #
3626
3937
  # * {Types::ListOrganizationalUnitsForParentResponse#organizational_units #organizational_units} => Array&lt;Types::OrganizationalUnit&gt;
3627
3938
  # * {Types::ListOrganizationalUnitsForParentResponse#next_token #next_token} => String
3628
3939
  #
3940
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3941
+ #
3629
3942
  #
3630
3943
  # @example Example: To retrieve a list of all of the child OUs in a parent root or OU
3631
3944
  #
@@ -3690,7 +4003,8 @@ module Aws::Organizations
3690
4003
  # </note>
3691
4004
  #
3692
4005
  # This operation can be called only from the organization's master
3693
- # account.
4006
+ # account or by a member account that is a delegated administrator for
4007
+ # an AWS service.
3694
4008
  #
3695
4009
  # <note markdown="1"> In the current release, a child can have only a single parent.
3696
4010
  #
@@ -3715,28 +4029,31 @@ module Aws::Organizations
3715
4029
  # [1]: http://wikipedia.org/wiki/regex
3716
4030
  #
3717
4031
  # @option params [String] :next_token
3718
- # Use this parameter if you receive a `NextToken` response in a previous
3719
- # request that indicates that there is more output available. Set it to
3720
- # the value of the previous call's `NextToken` response to indicate
3721
- # where the output should continue from.
4032
+ # The parameter for receiving additional results if you receive a
4033
+ # `NextToken` response in a previous request. A `NextToken` response
4034
+ # indicates that more output is available. Set this parameter to the
4035
+ # value of the previous call's `NextToken` response to indicate where
4036
+ # the output should continue from.
3722
4037
  #
3723
4038
  # @option params [Integer] :max_results
3724
- # (Optional) Use this to limit the number of results you want included
3725
- # per page in the response. If you do not include this parameter, it
3726
- # defaults to a value that is specific to the operation. If additional
3727
- # items exist beyond the maximum you specify, the `NextToken` response
3728
- # element is present and has a value (is not null). Include that value
3729
- # as the `NextToken` request parameter in the next call to the operation
3730
- # to get the next part of the results. Note that Organizations might
3731
- # return fewer results than the maximum even when there are more results
3732
- # available. You should check `NextToken` after every operation to
3733
- # ensure that you receive all of the results.
4039
+ # The total number of results that you want included on each page of the
4040
+ # response. If you do not include this parameter, it defaults to a value
4041
+ # that is specific to the operation. If additional items exist beyond
4042
+ # the maximum you specify, the `NextToken` response element is present
4043
+ # and has a value (is not null). Include that value as the `NextToken`
4044
+ # request parameter in the next call to the operation to get the next
4045
+ # part of the results. Note that Organizations might return fewer
4046
+ # results than the maximum even when there are more results available.
4047
+ # You should check `NextToken` after every operation to ensure that you
4048
+ # receive all of the results.
3734
4049
  #
3735
4050
  # @return [Types::ListParentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3736
4051
  #
3737
4052
  # * {Types::ListParentsResponse#parents #parents} => Array&lt;Types::Parent&gt;
3738
4053
  # * {Types::ListParentsResponse#next_token #next_token} => String
3739
4054
  #
4055
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4056
+ #
3740
4057
  #
3741
4058
  # @example Example: To retrieve a list of all of the parents of a child OU or account
3742
4059
  #
@@ -3792,34 +4109,38 @@ module Aws::Organizations
3792
4109
  # </note>
3793
4110
  #
3794
4111
  # This operation can be called only from the organization's master
3795
- # account.
4112
+ # account or by a member account that is a delegated administrator for
4113
+ # an AWS service.
3796
4114
  #
3797
4115
  # @option params [required, String] :filter
3798
4116
  # Specifies the type of policy that you want to include in the response.
3799
4117
  #
3800
4118
  # @option params [String] :next_token
3801
- # Use this parameter if you receive a `NextToken` response in a previous
3802
- # request that indicates that there is more output available. Set it to
3803
- # the value of the previous call's `NextToken` response to indicate
3804
- # where the output should continue from.
4119
+ # The parameter for receiving additional results if you receive a
4120
+ # `NextToken` response in a previous request. A `NextToken` response
4121
+ # indicates that more output is available. Set this parameter to the
4122
+ # value of the previous call's `NextToken` response to indicate where
4123
+ # the output should continue from.
3805
4124
  #
3806
4125
  # @option params [Integer] :max_results
3807
- # (Optional) Use this to limit the number of results you want included
3808
- # per page in the response. If you do not include this parameter, it
3809
- # defaults to a value that is specific to the operation. If additional
3810
- # items exist beyond the maximum you specify, the `NextToken` response
3811
- # element is present and has a value (is not null). Include that value
3812
- # as the `NextToken` request parameter in the next call to the operation
3813
- # to get the next part of the results. Note that Organizations might
3814
- # return fewer results than the maximum even when there are more results
3815
- # available. You should check `NextToken` after every operation to
3816
- # ensure that you receive all of the results.
4126
+ # The total number of results that you want included on each page of the
4127
+ # response. If you do not include this parameter, it defaults to a value
4128
+ # that is specific to the operation. If additional items exist beyond
4129
+ # the maximum you specify, the `NextToken` response element is present
4130
+ # and has a value (is not null). Include that value as the `NextToken`
4131
+ # request parameter in the next call to the operation to get the next
4132
+ # part of the results. Note that Organizations might return fewer
4133
+ # results than the maximum even when there are more results available.
4134
+ # You should check `NextToken` after every operation to ensure that you
4135
+ # receive all of the results.
3817
4136
  #
3818
4137
  # @return [Types::ListPoliciesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3819
4138
  #
3820
4139
  # * {Types::ListPoliciesResponse#policies #policies} => Array&lt;Types::PolicySummary&gt;
3821
4140
  # * {Types::ListPoliciesResponse#next_token #next_token} => String
3822
4141
  #
4142
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4143
+ #
3823
4144
  #
3824
4145
  # @example Example: To retrieve a list policies in the organization
3825
4146
  #
@@ -3900,7 +4221,8 @@ module Aws::Organizations
3900
4221
  # </note>
3901
4222
  #
3902
4223
  # This operation can be called only from the organization's master
3903
- # account.
4224
+ # account or by a member account that is a delegated administrator for
4225
+ # an AWS service.
3904
4226
  #
3905
4227
  # @option params [required, String] :target_id
3906
4228
  # The unique identifier (ID) of the root, organizational unit, or
@@ -3927,28 +4249,31 @@ module Aws::Organizations
3927
4249
  # The type of policy that you want to include in the returned list.
3928
4250
  #
3929
4251
  # @option params [String] :next_token
3930
- # Use this parameter if you receive a `NextToken` response in a previous
3931
- # request that indicates that there is more output available. Set it to
3932
- # the value of the previous call's `NextToken` response to indicate
3933
- # where the output should continue from.
4252
+ # The parameter for receiving additional results if you receive a
4253
+ # `NextToken` response in a previous request. A `NextToken` response
4254
+ # indicates that more output is available. Set this parameter to the
4255
+ # value of the previous call's `NextToken` response to indicate where
4256
+ # the output should continue from.
3934
4257
  #
3935
4258
  # @option params [Integer] :max_results
3936
- # (Optional) Use this to limit the number of results you want included
3937
- # per page in the response. If you do not include this parameter, it
3938
- # defaults to a value that is specific to the operation. If additional
3939
- # items exist beyond the maximum you specify, the `NextToken` response
3940
- # element is present and has a value (is not null). Include that value
3941
- # as the `NextToken` request parameter in the next call to the operation
3942
- # to get the next part of the results. Note that Organizations might
3943
- # return fewer results than the maximum even when there are more results
3944
- # available. You should check `NextToken` after every operation to
3945
- # ensure that you receive all of the results.
4259
+ # The total number of results that you want included on each page of the
4260
+ # response. If you do not include this parameter, it defaults to a value
4261
+ # that is specific to the operation. If additional items exist beyond
4262
+ # the maximum you specify, the `NextToken` response element is present
4263
+ # and has a value (is not null). Include that value as the `NextToken`
4264
+ # request parameter in the next call to the operation to get the next
4265
+ # part of the results. Note that Organizations might return fewer
4266
+ # results than the maximum even when there are more results available.
4267
+ # You should check `NextToken` after every operation to ensure that you
4268
+ # receive all of the results.
3946
4269
  #
3947
4270
  # @return [Types::ListPoliciesForTargetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3948
4271
  #
3949
4272
  # * {Types::ListPoliciesForTargetResponse#policies #policies} => Array&lt;Types::PolicySummary&gt;
3950
4273
  # * {Types::ListPoliciesForTargetResponse#next_token #next_token} => String
3951
4274
  #
4275
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4276
+ #
3952
4277
  #
3953
4278
  # @example Example: To retrieve a list policies attached to a root, OU, or account
3954
4279
  #
@@ -4015,7 +4340,8 @@ module Aws::Organizations
4015
4340
  # </note>
4016
4341
  #
4017
4342
  # This operation can be called only from the organization's master
4018
- # account.
4343
+ # account or by a member account that is a delegated administrator for
4344
+ # an AWS service.
4019
4345
  #
4020
4346
  # <note markdown="1"> Policy types can be enabled and disabled in roots. This is distinct
4021
4347
  # from whether they're available in the organization. When you enable
@@ -4027,28 +4353,31 @@ module Aws::Organizations
4027
4353
  # </note>
4028
4354
  #
4029
4355
  # @option params [String] :next_token
4030
- # Use this parameter if you receive a `NextToken` response in a previous
4031
- # request that indicates that there is more output available. Set it to
4032
- # the value of the previous call's `NextToken` response to indicate
4033
- # where the output should continue from.
4356
+ # The parameter for receiving additional results if you receive a
4357
+ # `NextToken` response in a previous request. A `NextToken` response
4358
+ # indicates that more output is available. Set this parameter to the
4359
+ # value of the previous call's `NextToken` response to indicate where
4360
+ # the output should continue from.
4034
4361
  #
4035
4362
  # @option params [Integer] :max_results
4036
- # (Optional) Use this to limit the number of results you want included
4037
- # per page in the response. If you do not include this parameter, it
4038
- # defaults to a value that is specific to the operation. If additional
4039
- # items exist beyond the maximum you specify, the `NextToken` response
4040
- # element is present and has a value (is not null). Include that value
4041
- # as the `NextToken` request parameter in the next call to the operation
4042
- # to get the next part of the results. Note that Organizations might
4043
- # return fewer results than the maximum even when there are more results
4044
- # available. You should check `NextToken` after every operation to
4045
- # ensure that you receive all of the results.
4363
+ # The total number of results that you want included on each page of the
4364
+ # response. If you do not include this parameter, it defaults to a value
4365
+ # that is specific to the operation. If additional items exist beyond
4366
+ # the maximum you specify, the `NextToken` response element is present
4367
+ # and has a value (is not null). Include that value as the `NextToken`
4368
+ # request parameter in the next call to the operation to get the next
4369
+ # part of the results. Note that Organizations might return fewer
4370
+ # results than the maximum even when there are more results available.
4371
+ # You should check `NextToken` after every operation to ensure that you
4372
+ # receive all of the results.
4046
4373
  #
4047
4374
  # @return [Types::ListRootsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4048
4375
  #
4049
4376
  # * {Types::ListRootsResponse#roots #roots} => Array&lt;Types::Root&gt;
4050
4377
  # * {Types::ListRootsResponse#next_token #next_token} => String
4051
4378
  #
4379
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4380
+ #
4052
4381
  #
4053
4382
  # @example Example: To retrieve a list of roots in the organization
4054
4383
  #
@@ -4106,22 +4435,26 @@ module Aws::Organizations
4106
4435
  # Currently, you can list tags on an account in AWS Organizations.
4107
4436
  #
4108
4437
  # This operation can be called only from the organization's master
4109
- # account.
4438
+ # account or by a member account that is a delegated administrator for
4439
+ # an AWS service.
4110
4440
  #
4111
4441
  # @option params [required, String] :resource_id
4112
4442
  # The ID of the resource that you want to retrieve tags for.
4113
4443
  #
4114
4444
  # @option params [String] :next_token
4115
- # Use this parameter if you receive a `NextToken` response in a previous
4116
- # request that indicates that there is more output available. Set it to
4117
- # the value of the previous call's `NextToken` response to indicate
4118
- # where the output should continue from.
4445
+ # The parameter for receiving additional results if you receive a
4446
+ # `NextToken` response in a previous request. A `NextToken` response
4447
+ # indicates that more output is available. Set this parameter to the
4448
+ # value of the previous call's `NextToken` response to indicate where
4449
+ # the output should continue from.
4119
4450
  #
4120
4451
  # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4121
4452
  #
4122
4453
  # * {Types::ListTagsForResourceResponse#tags #tags} => Array&lt;Types::Tag&gt;
4123
4454
  # * {Types::ListTagsForResourceResponse#next_token #next_token} => String
4124
4455
  #
4456
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4457
+ #
4125
4458
  # @example Request syntax with placeholder values
4126
4459
  #
4127
4460
  # resp = client.list_tags_for_resource({
@@ -4157,7 +4490,8 @@ module Aws::Organizations
4157
4490
  # </note>
4158
4491
  #
4159
4492
  # This operation can be called only from the organization's master
4160
- # account.
4493
+ # account or by a member account that is a delegated administrator for
4494
+ # an AWS service.
4161
4495
  #
4162
4496
  # @option params [required, String] :policy_id
4163
4497
  # The unique identifier (ID) of the policy whose attachments you want to
@@ -4172,28 +4506,31 @@ module Aws::Organizations
4172
4506
  # [1]: http://wikipedia.org/wiki/regex
4173
4507
  #
4174
4508
  # @option params [String] :next_token
4175
- # Use this parameter if you receive a `NextToken` response in a previous
4176
- # request that indicates that there is more output available. Set it to
4177
- # the value of the previous call's `NextToken` response to indicate
4178
- # where the output should continue from.
4509
+ # The parameter for receiving additional results if you receive a
4510
+ # `NextToken` response in a previous request. A `NextToken` response
4511
+ # indicates that more output is available. Set this parameter to the
4512
+ # value of the previous call's `NextToken` response to indicate where
4513
+ # the output should continue from.
4179
4514
  #
4180
4515
  # @option params [Integer] :max_results
4181
- # (Optional) Use this to limit the number of results you want included
4182
- # per page in the response. If you do not include this parameter, it
4183
- # defaults to a value that is specific to the operation. If additional
4184
- # items exist beyond the maximum you specify, the `NextToken` response
4185
- # element is present and has a value (is not null). Include that value
4186
- # as the `NextToken` request parameter in the next call to the operation
4187
- # to get the next part of the results. Note that Organizations might
4188
- # return fewer results than the maximum even when there are more results
4189
- # available. You should check `NextToken` after every operation to
4190
- # ensure that you receive all of the results.
4516
+ # The total number of results that you want included on each page of the
4517
+ # response. If you do not include this parameter, it defaults to a value
4518
+ # that is specific to the operation. If additional items exist beyond
4519
+ # the maximum you specify, the `NextToken` response element is present
4520
+ # and has a value (is not null). Include that value as the `NextToken`
4521
+ # request parameter in the next call to the operation to get the next
4522
+ # part of the results. Note that Organizations might return fewer
4523
+ # results than the maximum even when there are more results available.
4524
+ # You should check `NextToken` after every operation to ensure that you
4525
+ # receive all of the results.
4191
4526
  #
4192
4527
  # @return [Types::ListTargetsForPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4193
4528
  #
4194
4529
  # * {Types::ListTargetsForPolicyResponse#targets #targets} => Array&lt;Types::PolicyTargetSummary&gt;
4195
4530
  # * {Types::ListTargetsForPolicyResponse#next_token #next_token} => String
4196
4531
  #
4532
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4533
+ #
4197
4534
  #
4198
4535
  # @example Example: To retrieve a list of roots, OUs, and accounts to which a policy is attached
4199
4536
  #
@@ -4338,6 +4675,50 @@ module Aws::Organizations
4338
4675
  req.send_request(options)
4339
4676
  end
4340
4677
 
4678
+ # Enables the specified member account to administer the Organizations
4679
+ # features of the specified AWS service. It grants read-only access to
4680
+ # AWS Organizations service data. The account still requires IAM
4681
+ # permissions to access and administer the AWS service.
4682
+ #
4683
+ # You can run this action only for AWS services that support this
4684
+ # feature. For a current list of services that support it, see the
4685
+ # column *Supports Delegated Administrator* in the table at [AWS
4686
+ # Services that you can use with AWS Organizations][1] in the *AWS
4687
+ # Organizations User Guide.*
4688
+ #
4689
+ # This operation can be called only from the organization's master
4690
+ # account.
4691
+ #
4692
+ #
4693
+ #
4694
+ # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrated-services-list.html
4695
+ #
4696
+ # @option params [required, String] :account_id
4697
+ # The account ID number of the member account in the organization to
4698
+ # register as a delegated administrator.
4699
+ #
4700
+ # @option params [required, String] :service_principal
4701
+ # The service principal of the AWS service for which you want to make
4702
+ # the member account a delegated administrator.
4703
+ #
4704
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4705
+ #
4706
+ # @example Request syntax with placeholder values
4707
+ #
4708
+ # resp = client.register_delegated_administrator({
4709
+ # account_id: "AccountId", # required
4710
+ # service_principal: "ServicePrincipal", # required
4711
+ # })
4712
+ #
4713
+ # @see http://docs.aws.amazon.com/goto/WebAPI/organizations-2016-11-28/RegisterDelegatedAdministrator AWS API Documentation
4714
+ #
4715
+ # @overload register_delegated_administrator(params = {})
4716
+ # @param [Hash] params ({})
4717
+ def register_delegated_administrator(params = {}, options = {})
4718
+ req = build_request(:register_delegated_administrator, params)
4719
+ req.send_request(options)
4720
+ end
4721
+
4341
4722
  # Removes the specified account from the organization.
4342
4723
  #
4343
4724
  # The removed account becomes a standalone account that isn't a member
@@ -4353,15 +4734,15 @@ module Aws::Organizations
4353
4734
  # You can remove an account from your organization only if the account
4354
4735
  # is configured with the information required to operate as a standalone
4355
4736
  # account. When you create an account in an organization using the AWS
4356
- # Organizations console, API, or CLI, the information required of
4357
- # standalone accounts is *not* automatically collected. For an account
4358
- # that you want to make standalone, you must accept the end user license
4359
- # agreement (EULA). You must also choose a support plan, provide and
4360
- # verify the required contact information, and provide a current payment
4737
+ # Organizations console, API, or CLI commands, the information required
4738
+ # of standalone accounts is *not* automatically collected. For an
4739
+ # account that you want to make standalone, you must accept the end user
4740
+ # license agreement (EULA), choose a support plan, provide and verify
4741
+ # the required contact information, and provide a current payment
4361
4742
  # method. AWS uses the payment method to charge for any billable (not
4362
4743
  # free tier) AWS activity that occurs while the account isn't attached
4363
4744
  # to an organization. To remove an account that doesn't yet have this
4364
- # information, you must sign in as the member account. Then follow the
4745
+ # information, you must sign in as the member account and follow the
4365
4746
  # steps at [ To leave an organization when all required account
4366
4747
  # information has not yet been provided][1] in the *AWS Organizations
4367
4748
  # User Guide.*
@@ -4689,7 +5070,7 @@ module Aws::Organizations
4689
5070
  params: params,
4690
5071
  config: config)
4691
5072
  context[:gem_name] = 'aws-sdk-organizations'
4692
- context[:gem_version] = '1.36.0'
5073
+ context[:gem_version] = '1.41.0'
4693
5074
  Seahorse::Client::Request.new(handlers, context)
4694
5075
  end
4695
5076