Skip to content

IAM  >  Operations  >  get_instance_profile

get_instance_profile

Operation

get_instance_profile async 

get_instance_profile(input: GetInstanceProfileInput, plugins: list[Plugin] | None = None) -> GetInstanceProfileOutput

Retrieves information about the specified instance profile, including the instance profile's path, GUID, ARN, and role. For more information about instance profiles, see Using instance profiles in the IAM User Guide.

Parameters:

Name Type Description Default
input GetInstanceProfileInput

An instance of GetInstanceProfileInput.

 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
GetInstanceProfileOutput

An instance of GetInstanceProfileOutput.

Input

GetInstanceProfileInput dataclass

Bases: _SerdeShape

Dataclass for GetInstanceProfileInput structure.

Attributes

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

The name of the instance profile to get information about.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

Output

GetInstanceProfileOutput dataclass

Bases: _SerdeShape

Contains the response to a successful GetInstanceProfile request.

Attributes

instance_profile instance-attribute 
instance_profile: InstanceProfile

A structure containing details about the instance profile.

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.