Skip to content

replace_iam_instance_profile_association

Operation

replace_iam_instance_profile_association

Replaces an IAM instance profile for the specified running instance. You can use this action to change the IAM instance profile that's associated with an instance without having to disassociate the existing IAM instance profile first.

Use DescribeIamInstanceProfileAssociations to get the association ID.

Parameters:

Name Type Description Default
request ReplaceIamInstanceProfileAssociationInput | ReplaceIamInstanceProfileAssociationInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[ReplaceIamInstanceProfileAssociationInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
ReplaceIamInstanceProfileAssociationOutput

An instance of ReplaceIamInstanceProfileAssociationOutput.

replace_iam_instance_profile_association async

Replaces an IAM instance profile for the specified running instance. You can use this action to change the IAM instance profile that's associated with an instance without having to disassociate the existing IAM instance profile first.

Use DescribeIamInstanceProfileAssociations to get the association ID.

Parameters:

Name Type Description Default
request ReplaceIamInstanceProfileAssociationInput | ReplaceIamInstanceProfileAssociationInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[ReplaceIamInstanceProfileAssociationInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
ReplaceIamInstanceProfileAssociationOutput

An instance of ReplaceIamInstanceProfileAssociationOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

ReplaceIamInstanceProfileAssociationInputDict

Bases: TypedDict

Dictionary form of ReplaceIamInstanceProfileAssociationInput.

Attributes

association_id instance-attribute
association_id: Required[str]

The ID of the existing IAM instance profile association.

iam_instance_profile instance-attribute

The IAM instance profile.

ReplaceIamInstanceProfileAssociationInput dataclass

Bases: _SerdeShape

Dataclass for ReplaceIamInstanceProfileAssociationInput structure.

Attributes

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

The ID of the existing IAM instance profile association.

iam_instance_profile class-attribute instance-attribute
iam_instance_profile: IamInstanceProfileSpecification | None = ...

The IAM instance profile.

Output

ReplaceIamInstanceProfileAssociationOutput dataclass

Bases: _SerdeShape

Dataclass for ReplaceIamInstanceProfileAssociationOutput structure.

Attributes

iam_instance_profile_association class-attribute instance-attribute
iam_instance_profile_association: IamInstanceProfileAssociation | None = ...

Information about the IAM instance profile association.

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.