aws-sdk-organizations 1.36.0 → 1.41.0

Sign up to get free protection for your applications and to get access to all the features.
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