aws-sdk-iam 1.133.0 → 1.134.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -476,6 +476,43 @@ module Aws::IAM
476
476
 
477
477
  # @!group API Operations
478
478
 
479
+ # Accepts a delegation request, granting the requested temporary access.
480
+ #
481
+ # Once the delegation request is accepted, it is eligible to send the
482
+ # exchange token to the partner. The [SendDelegationToken][1] API has to
483
+ # be explicitly called to send the delegation token.
484
+ #
485
+ # At the time of acceptance, IAM records the details and the state of
486
+ # the identity that called this API. This is the identity that gets
487
+ # mapped to the delegated credential.
488
+ #
489
+ # An accepted request may be rejected before the exchange token is sent
490
+ # to the partner.
491
+ #
492
+ #
493
+ #
494
+ # [1]: https://docs.aws.amazon.com/IAM/latest/APIReference/API_SendDelegationToken.html
495
+ #
496
+ # @option params [required, String] :delegation_request_id
497
+ # The unique identifier of the delegation request to accept.
498
+ #
499
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
500
+ #
501
+ # @example Request syntax with placeholder values
502
+ #
503
+ # resp = client.accept_delegation_request({
504
+ # delegation_request_id: "delegationRequestIdType", # required
505
+ # })
506
+ #
507
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/AcceptDelegationRequest AWS API Documentation
508
+ #
509
+ # @overload accept_delegation_request(params = {})
510
+ # @param [Hash] params ({})
511
+ def accept_delegation_request(params = {}, options = {})
512
+ req = build_request(:accept_delegation_request, params)
513
+ req.send_request(options)
514
+ end
515
+
479
516
  # Adds a new client ID (also known as audience) to the list of client
480
517
  # IDs already registered for the specified IAM OpenID Connect (OIDC)
481
518
  # provider resource.
@@ -667,6 +704,50 @@ module Aws::IAM
667
704
  req.send_request(options)
668
705
  end
669
706
 
707
+ # Associates a delegation request with the current identity.
708
+ #
709
+ # If the partner that created the delegation request has specified the
710
+ # owner account during creation, only an identity from that owner
711
+ # account can call the `AssociateDelegationRequest` API for the
712
+ # specified delegation request. Once the `AssociateDelegationRequest`
713
+ # API call is successful, the ARN of the current calling identity will
714
+ # be stored as the `ownerId` of the request.
715
+ #
716
+ # If the partner that created the delegation request has not specified
717
+ # the owner account during creation, any caller from any account can
718
+ # call the `AssociateDelegationRequest` API for the delegation request.
719
+ # Once this API call is successful, the ARN of the current calling
720
+ # identity will be stored as the `ownerId` and the Amazon Web Services
721
+ # account ID of the current calling identity will be stored as the
722
+ # `ownerAccount` of the request.
723
+ #
724
+ # For more details, see [ Managing Permissions for Delegation
725
+ # Requests][1].
726
+ #
727
+ #
728
+ #
729
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-temporary-delegation.html#temporary-delegation-managing-permissions
730
+ #
731
+ # @option params [required, String] :delegation_request_id
732
+ # The unique identifier of the delegation request to associate.
733
+ #
734
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
735
+ #
736
+ # @example Request syntax with placeholder values
737
+ #
738
+ # resp = client.associate_delegation_request({
739
+ # delegation_request_id: "delegationRequestIdType", # required
740
+ # })
741
+ #
742
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/AssociateDelegationRequest AWS API Documentation
743
+ #
744
+ # @overload associate_delegation_request(params = {})
745
+ # @param [Hash] params ({})
746
+ def associate_delegation_request(params = {}, options = {})
747
+ req = build_request(:associate_delegation_request, params)
748
+ req.send_request(options)
749
+ end
750
+
670
751
  # Attaches the specified managed policy to the specified IAM group.
671
752
  #
672
753
  # You use this operation to attach a managed policy to a group. To embed
@@ -1075,25 +1156,92 @@ module Aws::IAM
1075
1156
  req.send_request(options)
1076
1157
  end
1077
1158
 
1078
- # This API is currently unavailable for general use.
1159
+ # Creates an IAM delegation request for temporary access delegation.
1160
+ #
1161
+ # This API is not available for general use. In order to use this API, a
1162
+ # caller first need to go through an onboarding process described in the
1163
+ # [partner onboarding documentation][1].
1164
+ #
1165
+ #
1166
+ #
1167
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-temporary-delegation-partner-guide.html
1079
1168
  #
1080
1169
  # @option params [String] :owner_account_id
1170
+ # The Amazon Web Services account ID this delegation request is targeted
1171
+ # to.
1172
+ #
1173
+ # If the account ID is not known, this parameter can be omitted,
1174
+ # resulting in a request that can be associated by any account. If the
1175
+ # account ID passed, then the created delegation request can only be
1176
+ # associated with an identity of that target account.
1081
1177
  #
1082
1178
  # @option params [required, String] :description
1179
+ # A description of the delegation request.
1083
1180
  #
1084
1181
  # @option params [required, Types::DelegationPermission] :permissions
1182
+ # The permissions to be delegated in this delegation request.
1085
1183
  #
1086
1184
  # @option params [String] :request_message
1185
+ # A message explaining the reason for the delegation request.
1186
+ #
1187
+ # Requesters can utilize this field to add a custom note to the
1188
+ # delegation request. This field is different from the description such
1189
+ # that this is to be utilized for a custom messaging on a case-by-case
1190
+ # basis.
1191
+ #
1192
+ # For example, if the current delegation request is in response to a
1193
+ # previous request being rejected, this explanation can be added to the
1194
+ # request via this field.
1087
1195
  #
1088
1196
  # @option params [required, String] :requestor_workflow_id
1197
+ # The workflow ID associated with the requestor.
1198
+ #
1199
+ # This is the unique identifier on the partner side that can be used to
1200
+ # track the progress of the request.
1201
+ #
1202
+ # IAM maintains a uniqueness check on this workflow id for each request
1203
+ # - if a workflow id for an existing request is passed, this API call
1204
+ # will fail.
1089
1205
  #
1090
1206
  # @option params [String] :redirect_url
1207
+ # The URL to redirect to after the delegation request is processed.
1208
+ #
1209
+ # This URL is used by the IAM console to show a link to the customer to
1210
+ # re-load the partner workflow.
1091
1211
  #
1092
1212
  # @option params [required, String] :notification_channel
1213
+ # The notification channel for updates about the delegation request.
1214
+ #
1215
+ # At this time,only SNS topic ARNs are accepted for notification. This
1216
+ # topic ARN must have a resource policy granting `SNS:Publish`
1217
+ # permission to the IAM service principal (`iam.amazonaws.com`). See
1218
+ # [partner onboarding documentation][1] for more details.
1219
+ #
1220
+ #
1221
+ #
1222
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-temporary-delegation-partner-guide.html
1093
1223
  #
1094
1224
  # @option params [required, Integer] :session_duration
1225
+ # The duration for which the delegated session should remain active, in
1226
+ # seconds.
1227
+ #
1228
+ # The active time window for the session starts when the customer calls
1229
+ # the [SendDelegationToken][1] API.
1230
+ #
1231
+ #
1232
+ #
1233
+ # [1]: https://docs.aws.amazon.com/IAM/latest/APIReference/API_SendDelegationToken.html
1095
1234
  #
1096
1235
  # @option params [Boolean] :only_send_by_owner
1236
+ # Specifies whether the delegation token should only be sent by the
1237
+ # owner.
1238
+ #
1239
+ # This flag prevents any party other than the owner from calling
1240
+ # `SendDelegationToken` API for this delegation request. This behavior
1241
+ # becomes useful when the delegation request owner needs to be present
1242
+ # for subsequent partner interactions, but the delegation request was
1243
+ # sent to a more privileged user for approval due to the owner lacking
1244
+ # sufficient delegation permissions.
1097
1245
  #
1098
1246
  # @return [Types::CreateDelegationRequestResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1099
1247
  #
@@ -4397,7 +4545,7 @@ module Aws::IAM
4397
4545
  # troubleshooting, and supported Regions see [Reducing permissions using
4398
4546
  # service last accessed data][1] in the *IAM User Guide*.
4399
4547
  #
4400
- # The data includes all attempts to access Amazon Web Services, not just
4548
+ # The data includes all attempts to access Amazon Web Services, not just
4401
4549
  # the successful ones. This includes all attempts that were made using
4402
4550
  # the Amazon Web Services Management Console, the Amazon Web Services
4403
4551
  # API through any of the SDKs, or any of the command line tools. An
@@ -4405,7 +4553,7 @@ module Aws::IAM
4405
4553
  # an account has been compromised, because the request might have been
4406
4554
  # denied. Refer to your CloudTrail logs as the authoritative source for
4407
4555
  # information about all API calls and whether they were successful or
4408
- # denied access. For more information, see [Logging IAM events with
4556
+ # denied access. For more information, see [Logging IAM events with
4409
4557
  # CloudTrail][2] in the *IAM User Guide*.
4410
4558
  #
4411
4559
  # This operation returns a `JobId`. Use this parameter in the `
@@ -4563,7 +4711,7 @@ module Aws::IAM
4563
4711
  # accessed information is displayed, see [IAM action last accessed
4564
4712
  # information services and actions][2].
4565
4713
  #
4566
- # The service last accessed data includes all attempts to access an
4714
+ # The service last accessed data includes all attempts to access an
4567
4715
  # Amazon Web Services API, not just the successful ones. This includes
4568
4716
  # all attempts that were made using the Amazon Web Services Management
4569
4717
  # Console, the Amazon Web Services API through any of the SDKs, or any
@@ -4572,7 +4720,7 @@ module Aws::IAM
4572
4720
  # because the request might have been denied. Refer to your CloudTrail
4573
4721
  # logs as the authoritative source for information about all API calls
4574
4722
  # and whether they were successful or denied access. For more
4575
- # information, see [Logging IAM events with CloudTrail][3] in the *IAM
4723
+ # information, see [Logging IAM events with CloudTrail][3] in the *IAM
4576
4724
  # User Guide*.
4577
4725
  #
4578
4726
  # The `GenerateServiceLastAccessedDetails` operation returns a `JobId`.
@@ -5207,6 +5355,89 @@ module Aws::IAM
5207
5355
  req.send_request(options)
5208
5356
  end
5209
5357
 
5358
+ # Retrieves information about a specific delegation request.
5359
+ #
5360
+ # If a delegation request has no owner or owner account,
5361
+ # `GetDelegationRequest` for that delegation request can be called by
5362
+ # any account. If the owner account is assigned but there is no owner
5363
+ # id, only identities within that owner account can call
5364
+ # `GetDelegationRequest` for the delegation request. Once the delegation
5365
+ # request is fully owned, the owner of the request gets a default
5366
+ # permission to get that delegation request. For more details, see [
5367
+ # Managing Permissions for Delegation Requests][1].
5368
+ #
5369
+ #
5370
+ #
5371
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-temporary-delegation.html#temporary-delegation-managing-permissions
5372
+ #
5373
+ # @option params [required, String] :delegation_request_id
5374
+ # The unique identifier of the delegation request to retrieve.
5375
+ #
5376
+ # @option params [Boolean] :delegation_permission_check
5377
+ # Specifies whether to perform a permission check for the delegation
5378
+ # request.
5379
+ #
5380
+ # If set to true, the `GetDelegationRequest` API call will start a
5381
+ # permission check process. This process calculates whether the caller
5382
+ # has sufficient permissions to cover the asks from this delegation
5383
+ # request.
5384
+ #
5385
+ # Setting this parameter to true does not guarantee an answer in the
5386
+ # response. See the `PermissionCheckStatus` and the
5387
+ # `PermissionCheckResult` response attributes for further details.
5388
+ #
5389
+ # @return [Types::GetDelegationRequestResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5390
+ #
5391
+ # * {Types::GetDelegationRequestResponse#delegation_request #delegation_request} => Types::DelegationRequest
5392
+ # * {Types::GetDelegationRequestResponse#permission_check_status #permission_check_status} => String
5393
+ # * {Types::GetDelegationRequestResponse#permission_check_result #permission_check_result} => String
5394
+ #
5395
+ # @example Request syntax with placeholder values
5396
+ #
5397
+ # resp = client.get_delegation_request({
5398
+ # delegation_request_id: "delegationRequestIdType", # required
5399
+ # delegation_permission_check: false,
5400
+ # })
5401
+ #
5402
+ # @example Response structure
5403
+ #
5404
+ # resp.delegation_request.delegation_request_id #=> String
5405
+ # resp.delegation_request.owner_account_id #=> String
5406
+ # resp.delegation_request.description #=> String
5407
+ # resp.delegation_request.request_message #=> String
5408
+ # resp.delegation_request.permissions.policy_template_arn #=> String
5409
+ # resp.delegation_request.permissions.parameters #=> Array
5410
+ # resp.delegation_request.permissions.parameters[0].name #=> String
5411
+ # resp.delegation_request.permissions.parameters[0].values #=> Array
5412
+ # resp.delegation_request.permissions.parameters[0].values[0] #=> String
5413
+ # resp.delegation_request.permissions.parameters[0].type #=> String, one of "string", "stringList"
5414
+ # resp.delegation_request.permission_policy #=> String
5415
+ # resp.delegation_request.role_permission_restriction_arns #=> Array
5416
+ # resp.delegation_request.role_permission_restriction_arns[0] #=> String
5417
+ # resp.delegation_request.owner_id #=> String
5418
+ # resp.delegation_request.approver_id #=> String
5419
+ # resp.delegation_request.state #=> String, one of "UNASSIGNED", "ASSIGNED", "PENDING_APPROVAL", "FINALIZED", "ACCEPTED", "REJECTED", "EXPIRED"
5420
+ # resp.delegation_request.requestor_id #=> String
5421
+ # resp.delegation_request.requestor_name #=> String
5422
+ # resp.delegation_request.create_date #=> Time
5423
+ # resp.delegation_request.session_duration #=> Integer
5424
+ # resp.delegation_request.redirect_url #=> String
5425
+ # resp.delegation_request.notes #=> String
5426
+ # resp.delegation_request.rejection_reason #=> String
5427
+ # resp.delegation_request.only_send_by_owner #=> Boolean
5428
+ # resp.delegation_request.updated_time #=> Time
5429
+ # resp.permission_check_status #=> String, one of "COMPLETE", "IN_PROGRESS", "FAILED"
5430
+ # resp.permission_check_result #=> String, one of "ALLOWED", "DENIED", "UNSURE"
5431
+ #
5432
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/GetDelegationRequest AWS API Documentation
5433
+ #
5434
+ # @overload get_delegation_request(params = {})
5435
+ # @param [Hash] params ({})
5436
+ def get_delegation_request(params = {}, options = {})
5437
+ req = build_request(:get_delegation_request, params)
5438
+ req.send_request(options)
5439
+ end
5440
+
5210
5441
  # Returns a list of IAM users that are in the specified IAM group. You
5211
5442
  # can paginate the results using the `MaxItems` and `Marker` parameters.
5212
5443
  #
@@ -5366,6 +5597,67 @@ module Aws::IAM
5366
5597
  req.send_request(options)
5367
5598
  end
5368
5599
 
5600
+ # Retrieves a human readable summary for a given entity. At this time,
5601
+ # the only supported entity type is `delegation-request`
5602
+ #
5603
+ # This method uses a Large Language Model (LLM) to generate the summary.
5604
+ #
5605
+ # If a delegation request has no owner or owner account,
5606
+ # `GetHumanReadableSummary` for that delegation request can be called by
5607
+ # any account. If the owner account is assigned but there is no owner
5608
+ # id, only identities within that owner account can call
5609
+ # `GetHumanReadableSummary` for the delegation request to retrieve a
5610
+ # summary of that request. Once the delegation request is fully owned,
5611
+ # the owner of the request gets a default permission to get that
5612
+ # delegation request. For more details, read [default permissions
5613
+ # granted to delegation requests](). These rules are identical to
5614
+ # [GetDelegationRequest][1] API behavior, such that a party who has
5615
+ # permissions to call [GetDelegationRequest][1] for a given delegation
5616
+ # request will always be able to retrieve the human readable summary for
5617
+ # that request.
5618
+ #
5619
+ #
5620
+ #
5621
+ # [1]: https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetDelegationRequest.html
5622
+ #
5623
+ # @option params [required, String] :entity_arn
5624
+ # Arn of the entity to be summarized. At this time, the only supported
5625
+ # entity type is `delegation-request`
5626
+ #
5627
+ # @option params [String] :locale
5628
+ # A string representing the locale to use for the summary generation.
5629
+ # The supported locale strings are based on the [ Supported languages of
5630
+ # the Amazon Web Services Management Console
5631
+ # ](/awsconsolehelpdocs/latest/gsg/change-language.html#supported-languages).
5632
+ #
5633
+ # @return [Types::GetHumanReadableSummaryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5634
+ #
5635
+ # * {Types::GetHumanReadableSummaryResponse#summary_content #summary_content} => String
5636
+ # * {Types::GetHumanReadableSummaryResponse#locale #locale} => String
5637
+ # * {Types::GetHumanReadableSummaryResponse#summary_state #summary_state} => String
5638
+ #
5639
+ # @example Request syntax with placeholder values
5640
+ #
5641
+ # resp = client.get_human_readable_summary({
5642
+ # entity_arn: "arnType", # required
5643
+ # locale: "localeType",
5644
+ # })
5645
+ #
5646
+ # @example Response structure
5647
+ #
5648
+ # resp.summary_content #=> String
5649
+ # resp.locale #=> String
5650
+ # resp.summary_state #=> String, one of "AVAILABLE", "NOT_AVAILABLE", "NOT_SUPPORTED", "FAILED"
5651
+ #
5652
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/GetHumanReadableSummary AWS API Documentation
5653
+ #
5654
+ # @overload get_human_readable_summary(params = {})
5655
+ # @param [Hash] params ({})
5656
+ def get_human_readable_summary(params = {}, options = {})
5657
+ req = build_request(:get_human_readable_summary, params)
5658
+ req.send_request(options)
5659
+ end
5660
+
5369
5661
  # Retrieves information about the specified instance profile, including
5370
5662
  # the instance profile's path, GUID, ARN, and role. For more
5371
5663
  # information about instance profiles, see [Using instance profiles][1]
@@ -6530,8 +6822,8 @@ module Aws::IAM
6530
6822
  # User Guide*. Choose the name of the service to view details for that
6531
6823
  # service. In the first paragraph, find the service prefix. For example,
6532
6824
  # `(service prefix: a4b)`. For more information about service
6533
- # namespaces, see [Amazon Web Services service namespaces][2] in
6534
- # the *Amazon Web Services General Reference*.
6825
+ # namespaces, see [Amazon Web Services service namespaces][2] in the
6826
+ # *Amazon Web Services General Reference*.
6535
6827
  #
6536
6828
  #
6537
6829
  #
@@ -7329,6 +7621,93 @@ module Aws::IAM
7329
7621
  req.send_request(options)
7330
7622
  end
7331
7623
 
7624
+ # Lists delegation requests based on the specified criteria.
7625
+ #
7626
+ # If a delegation request has no owner, even if it is assigned to a
7627
+ # specific account, it will not be part of the `ListDelegationRequests`
7628
+ # output for that account.
7629
+ #
7630
+ # For more details, see [ Managing Permissions for Delegation
7631
+ # Requests][1].
7632
+ #
7633
+ #
7634
+ #
7635
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-temporary-delegation.html#temporary-delegation-managing-permissions
7636
+ #
7637
+ # @option params [String] :owner_id
7638
+ # The owner ID to filter delegation requests by.
7639
+ #
7640
+ # @option params [String] :marker
7641
+ # Use this parameter only when paginating results and only after you
7642
+ # receive a response indicating that the results are truncated. Set it
7643
+ # to the value of the `Marker` element in the response that you received
7644
+ # to indicate where the next call should start.
7645
+ #
7646
+ # @option params [Integer] :max_items
7647
+ # Use this only when paginating results to indicate the maximum number
7648
+ # of items you want in the response. If additional items exist beyond
7649
+ # the maximum you specify, the `IsTruncated` response element is `true`.
7650
+ #
7651
+ # If you do not include this parameter, the number of items defaults to
7652
+ # 100. Note that IAM may return fewer results, even when there are more
7653
+ # results available. In that case, the `IsTruncated` response element
7654
+ # returns `true`, and `Marker` contains a value to include in the
7655
+ # subsequent call that tells the service where to continue from.
7656
+ #
7657
+ # @return [Types::ListDelegationRequestsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7658
+ #
7659
+ # * {Types::ListDelegationRequestsResponse#delegation_requests #delegation_requests} => Array<Types::DelegationRequest>
7660
+ # * {Types::ListDelegationRequestsResponse#marker #marker} => String
7661
+ # * {Types::ListDelegationRequestsResponse#is_truncated #is_truncated} => Boolean
7662
+ #
7663
+ # @example Request syntax with placeholder values
7664
+ #
7665
+ # resp = client.list_delegation_requests({
7666
+ # owner_id: "ownerIdType",
7667
+ # marker: "markerType",
7668
+ # max_items: 1,
7669
+ # })
7670
+ #
7671
+ # @example Response structure
7672
+ #
7673
+ # resp.delegation_requests #=> Array
7674
+ # resp.delegation_requests[0].delegation_request_id #=> String
7675
+ # resp.delegation_requests[0].owner_account_id #=> String
7676
+ # resp.delegation_requests[0].description #=> String
7677
+ # resp.delegation_requests[0].request_message #=> String
7678
+ # resp.delegation_requests[0].permissions.policy_template_arn #=> String
7679
+ # resp.delegation_requests[0].permissions.parameters #=> Array
7680
+ # resp.delegation_requests[0].permissions.parameters[0].name #=> String
7681
+ # resp.delegation_requests[0].permissions.parameters[0].values #=> Array
7682
+ # resp.delegation_requests[0].permissions.parameters[0].values[0] #=> String
7683
+ # resp.delegation_requests[0].permissions.parameters[0].type #=> String, one of "string", "stringList"
7684
+ # resp.delegation_requests[0].permission_policy #=> String
7685
+ # resp.delegation_requests[0].role_permission_restriction_arns #=> Array
7686
+ # resp.delegation_requests[0].role_permission_restriction_arns[0] #=> String
7687
+ # resp.delegation_requests[0].owner_id #=> String
7688
+ # resp.delegation_requests[0].approver_id #=> String
7689
+ # resp.delegation_requests[0].state #=> String, one of "UNASSIGNED", "ASSIGNED", "PENDING_APPROVAL", "FINALIZED", "ACCEPTED", "REJECTED", "EXPIRED"
7690
+ # resp.delegation_requests[0].requestor_id #=> String
7691
+ # resp.delegation_requests[0].requestor_name #=> String
7692
+ # resp.delegation_requests[0].create_date #=> Time
7693
+ # resp.delegation_requests[0].session_duration #=> Integer
7694
+ # resp.delegation_requests[0].redirect_url #=> String
7695
+ # resp.delegation_requests[0].notes #=> String
7696
+ # resp.delegation_requests[0].rejection_reason #=> String
7697
+ # resp.delegation_requests[0].only_send_by_owner #=> Boolean
7698
+ # resp.delegation_requests[0].updated_time #=> Time
7699
+ # resp.marker #=> String
7700
+ # resp.is_truncated #=> Boolean
7701
+ #
7702
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/ListDelegationRequests AWS API Documentation
7703
+ #
7704
+ # @overload list_delegation_requests(params = {})
7705
+ # @param [Hash] params ({})
7706
+ def list_delegation_requests(params = {}, options = {})
7707
+ req = build_request(:list_delegation_requests, params)
7708
+ req.send_request(options)
7709
+ end
7710
+
7332
7711
  # Lists all IAM users, groups, and roles that the specified managed
7333
7712
  # policy is attached to.
7334
7713
  #
@@ -7379,10 +7758,9 @@ module Aws::IAM
7379
7758
  # @option params [String] :policy_usage_filter
7380
7759
  # The policy usage method to use for filtering the results.
7381
7760
  #
7382
- # To list only permissions policies,
7383
- # set `PolicyUsageFilter` to `PermissionsPolicy`. To list only the
7384
- # policies used to set permissions boundaries, set the value
7385
- # to `PermissionsBoundary`.
7761
+ # To list only permissions policies, set `PolicyUsageFilter` to
7762
+ # `PermissionsPolicy`. To list only the policies used to set permissions
7763
+ # boundaries, set the value to `PermissionsBoundary`.
7386
7764
  #
7387
7765
  # This parameter is optional. If it is not included, all policies are
7388
7766
  # returned.
@@ -8392,10 +8770,9 @@ module Aws::IAM
8392
8770
  # @option params [String] :policy_usage_filter
8393
8771
  # The policy usage method to use for filtering the results.
8394
8772
  #
8395
- # To list only permissions policies,
8396
- # set `PolicyUsageFilter` to `PermissionsPolicy`. To list only the
8397
- # policies used to set permissions boundaries, set the value
8398
- # to `PermissionsBoundary`.
8773
+ # To list only permissions policies, set `PolicyUsageFilter` to
8774
+ # `PermissionsPolicy`. To list only the policies used to set permissions
8775
+ # boundaries, set the value to `PermissionsBoundary`.
8399
8776
  #
8400
8777
  # This parameter is optional. If it is not included, all policies are
8401
8778
  # returned.
@@ -8529,8 +8906,8 @@ module Aws::IAM
8529
8906
  # User Guide*. Choose the name of the service to view details for that
8530
8907
  # service. In the first paragraph, find the service prefix. For example,
8531
8908
  # `(service prefix: a4b)`. For more information about service
8532
- # namespaces, see [Amazon Web Services service namespaces][2] in
8533
- # the *Amazon Web Services General Reference*.
8909
+ # namespaces, see [Amazon Web Services service namespaces][2] in the
8910
+ # *Amazon Web Services General Reference*.
8534
8911
  #
8535
8912
  #
8536
8913
  #
@@ -10459,6 +10836,46 @@ module Aws::IAM
10459
10836
  req.send_request(options)
10460
10837
  end
10461
10838
 
10839
+ # Rejects a delegation request, denying the requested temporary access.
10840
+ #
10841
+ # Once a request is rejected, it cannot be accepted or updated later.
10842
+ # Rejected requests expire after 7 days.
10843
+ #
10844
+ # When rejecting a request, an optional explanation can be added using
10845
+ # the `Notes` request parameter.
10846
+ #
10847
+ # For more details, see [ Managing Permissions for Delegation
10848
+ # Requests][1].
10849
+ #
10850
+ #
10851
+ #
10852
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-temporary-delegation.html#temporary-delegation-managing-permissions
10853
+ #
10854
+ # @option params [required, String] :delegation_request_id
10855
+ # The unique identifier of the delegation request to reject.
10856
+ #
10857
+ # @option params [String] :notes
10858
+ # Optional notes explaining the reason for rejecting the delegation
10859
+ # request.
10860
+ #
10861
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
10862
+ #
10863
+ # @example Request syntax with placeholder values
10864
+ #
10865
+ # resp = client.reject_delegation_request({
10866
+ # delegation_request_id: "delegationRequestIdType", # required
10867
+ # notes: "notesType",
10868
+ # })
10869
+ #
10870
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/RejectDelegationRequest AWS API Documentation
10871
+ #
10872
+ # @overload reject_delegation_request(params = {})
10873
+ # @param [Hash] params ({})
10874
+ def reject_delegation_request(params = {}, options = {})
10875
+ req = build_request(:reject_delegation_request, params)
10876
+ req.send_request(options)
10877
+ end
10878
+
10462
10879
  # Removes the specified client ID (also known as audience) from the list
10463
10880
  # of client IDs registered for the specified IAM OpenID Connect (OIDC)
10464
10881
  # provider resource object.
@@ -10757,6 +11174,45 @@ module Aws::IAM
10757
11174
  req.send_request(options)
10758
11175
  end
10759
11176
 
11177
+ # Sends the exchange token for an accepted delegation request.
11178
+ #
11179
+ # The exchange token is sent to the partner via an asynchronous
11180
+ # notification channel, established by the partner.
11181
+ #
11182
+ # The delegation request must be in the `ACCEPTED` state when calling
11183
+ # this API. After the `SendDelegationToken` API call is successful, the
11184
+ # request transitions to a `FINALIZED` state and cannot be rolled back.
11185
+ # However, a user may reject an accepted request before the
11186
+ # `SendDelegationToken` API is called.
11187
+ #
11188
+ # For more details, see [ Managing Permissions for Delegation
11189
+ # Requests][1].
11190
+ #
11191
+ #
11192
+ #
11193
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-temporary-delegation.html#temporary-delegation-managing-permissions
11194
+ #
11195
+ # @option params [required, String] :delegation_request_id
11196
+ # The unique identifier of the delegation request for which to send the
11197
+ # token.
11198
+ #
11199
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
11200
+ #
11201
+ # @example Request syntax with placeholder values
11202
+ #
11203
+ # resp = client.send_delegation_token({
11204
+ # delegation_request_id: "delegationRequestIdType", # required
11205
+ # })
11206
+ #
11207
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/SendDelegationToken AWS API Documentation
11208
+ #
11209
+ # @overload send_delegation_token(params = {})
11210
+ # @param [Hash] params ({})
11211
+ def send_delegation_token(params = {}, options = {})
11212
+ req = build_request(:send_delegation_token, params)
11213
+ req.send_request(options)
11214
+ end
11215
+
10760
11216
  # Sets the specified version of the specified policy as the policy's
10761
11217
  # default (operative) version.
10762
11218
  #
@@ -12943,6 +13399,42 @@ module Aws::IAM
12943
13399
  req.send_request(options)
12944
13400
  end
12945
13401
 
13402
+ # Updates an existing delegation request with additional information.
13403
+ # When the delegation request is updated, it reaches the
13404
+ # `PENDING_APPROVAL` state.
13405
+ #
13406
+ # Once a delegation request has an owner, that owner gets a default
13407
+ # permission to update the delegation request. For more details, see [
13408
+ # Managing Permissions for Delegation Requests][1].
13409
+ #
13410
+ #
13411
+ #
13412
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-temporary-delegation.html#temporary-delegation-managing-permissions
13413
+ #
13414
+ # @option params [required, String] :delegation_request_id
13415
+ # The unique identifier of the delegation request to update.
13416
+ #
13417
+ # @option params [String] :notes
13418
+ # Additional notes or comments to add to the delegation request.
13419
+ #
13420
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
13421
+ #
13422
+ # @example Request syntax with placeholder values
13423
+ #
13424
+ # resp = client.update_delegation_request({
13425
+ # delegation_request_id: "delegationRequestIdType", # required
13426
+ # notes: "notesType",
13427
+ # })
13428
+ #
13429
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/UpdateDelegationRequest AWS API Documentation
13430
+ #
13431
+ # @overload update_delegation_request(params = {})
13432
+ # @param [Hash] params ({})
13433
+ def update_delegation_request(params = {}, options = {})
13434
+ req = build_request(:update_delegation_request, params)
13435
+ req.send_request(options)
13436
+ end
13437
+
12946
13438
  # Updates the name and/or the path of the specified IAM group.
12947
13439
  #
12948
13440
  # You should understand the implications of changing a group's path or
@@ -14131,7 +14623,7 @@ module Aws::IAM
14131
14623
  tracer: tracer
14132
14624
  )
14133
14625
  context[:gem_name] = 'aws-sdk-iam'
14134
- context[:gem_version] = '1.133.0'
14626
+ context[:gem_version] = '1.134.0'
14135
14627
  Seahorse::Client::Request.new(handlers, context)
14136
14628
  end
14137
14629