Skip to content

IAM  >  Operations  >  associate_delegation_request

associate_delegation_request

Operation

associate_delegation_request async

associate_delegation_request(input: AssociateDelegationRequestInput, plugins: list[Plugin] | None = None) -> AssociateDelegationRequestOutput

Associates a delegation request with the current identity.

If the partner that created the delegation request has specified the owner account during creation, only an identity from that owner account can call the AssociateDelegationRequest API for the specified delegation request. Once the AssociateDelegationRequest API call is successful, the ARN of the current calling identity will be stored as the ownerId of the request.

If the partner that created the delegation request has not specified the owner account during creation, any caller from any account can call the AssociateDelegationRequest API for the delegation request. Once this API call is successful, the ARN of the current calling identity will be stored as the ownerId and the Amazon Web Services account ID of the current calling identity will be stored as the ownerAccount of the request.

For more details, see Managing Permissions for Delegation Requests.

Parameters:

Name Type Description Default
input AssociateDelegationRequestInput

An instance of AssociateDelegationRequestInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
AssociateDelegationRequestOutput

An instance of AssociateDelegationRequestOutput.

Input

AssociateDelegationRequestInput dataclass

Bases: _SerdeShape

Dataclass for AssociateDelegationRequestInput structure.

Attributes

delegation_request_id class-attribute instance-attribute
delegation_request_id: str | None = ...

The unique identifier of the delegation request to associate.

Output

AssociateDelegationRequestOutput dataclass

Bases: _SerdeShape

Dataclass for AssociateDelegationRequestOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.