| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
GetInstanceProfile
Description
Retrieves information about the specified instance profile, including the instance profile's path, GUID, ARN, and role. For more information about instance profiles, go to About Instance Profiles. For more information about ARNs, go to ARNs.
Request Parameters
For information about the common parameters that all actions use, see Common Parameters.
- InstanceProfileName
Name of the instance profile to get information about.
Type: String
Length constraints: Minimum length of 1. Maximum length of 128.
Required: Yes
Response Elements
The following
element is
returned in a GetInstanceProfileResult structure.
- InstanceProfile
Information about the instance profile.
Type: InstanceProfile
Errors
For information about the errors that are common to all actions, see Common Errors.
- NoSuchEntity
The request was rejected because it referenced an entity that does not exist. The error message describes the entity.
HTTP Status Code: 404
Examples
Sample Request
https://iam.amazonaws.com/
?Action=GetInstanceProfile
&InstanceProfileName=Webserver
&Version=2010-05-08
&AUTHPARAMS
Sample Response
<GetInstanceProfileResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/">
<GetInstanceProfileResult>
<InstanceProfile>
<InstanceProfileId>AIPAD5ARO2C5EXAMPLE3G</InstanceProfileId>
<Roles>
<member>
<Path>/application_abc/component_xyz/</Path>
<Arn>arn:aws:iam::123456789012:role/application_abc/component_xyz/S3Access</Arn>
<RoleName>S3Access</RoleName>
<AssumeRolePolicyDocument>{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":["ec2.amazonaws.com"]},"Action":["sts:AssumeRole"]}]}</AssumeRolePolicyDocument>
<CreateDate>2012-05-09T15:45:35Z</CreateDate>
<RoleId>AROACVYKSVTSZFEXAMPLE</RoleId>
</member>
</Roles>
<InstanceProfileName>Webserver</InstanceProfileName>
<Path>/application_abc/component_xyz/</Path>
<Arn>arn:aws:iam::123456789012:instance-profile/application_abc/component_xyz/Webserver</Arn>
<CreateDate>2012-05-09T16:11:10Z</CreateDate>
</InstanceProfile>
</GetInstanceProfileResult>
<ResponseMetadata>
<RequestId>37289fda-99f2-11e1-a4c3-27EXAMPLE804</RequestId>
</ResponseMetadata>
</GetInstanceProfileResponse>
