Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions,
see Getting Started with Amazon Web Services in China
(PDF).
Use GetInstanceProfile with a CLI
The following code examples show how to use GetInstanceProfile.
Action examples are code excerpts from larger programs and must be run in context. You can see this action in
context in the following code example:
- CLI
-
- Amazon CLI
-
To get information about an instance profile
The following get-instance-profile command gets information about the instance profile named ExampleInstanceProfile.
aws iam get-instance-profile \
--instance-profile-name ExampleInstanceProfile
Output:
{
"InstanceProfile": {
"InstanceProfileId": "AID2MAB8DPLSRHEXAMPLE",
"Roles": [
{
"AssumeRolePolicyDocument": "<URL-encoded-JSON>",
"RoleId": "AIDGPMS9RO4H3FEXAMPLE",
"CreateDate": "2013-01-09T06:33:26Z",
"RoleName": "Test-Role",
"Path": "/",
"Arn": "arn:aws:iam::336924118301:role/Test-Role"
}
],
"CreateDate": "2013-06-12T23:52:02Z",
"InstanceProfileName": "ExampleInstanceProfile",
"Path": "/",
"Arn": "arn:aws:iam::336924118301:instance-profile/ExampleInstanceProfile"
}
}
For more information, see Using instance profiles in the Amazon IAM User Guide.
- PowerShell
-
- Tools for PowerShell V4
-
Example 1: This example returns details of the instance profile named ec2instancerole that is defined in the current Amazon account.
Get-IAMInstanceProfile -InstanceProfileName ec2instancerole
Output:
Arn : arn:aws:iam::123456789012:instance-profile/ec2instancerole
CreateDate : 2/17/2015 2:49:04 PM
InstanceProfileId : HH36PTZQJUR32EXAMPLE1
InstanceProfileName : ec2instancerole
Path : /
Roles : {ec2instancerole}
- Tools for PowerShell V5
-
Example 1: This example returns details of the instance profile named ec2instancerole that is defined in the current Amazon account.
Get-IAMInstanceProfile -InstanceProfileName ec2instancerole
Output:
Arn : arn:aws:iam::123456789012:instance-profile/ec2instancerole
CreateDate : 2/17/2015 2:49:04 PM
InstanceProfileId : HH36PTZQJUR32EXAMPLE1
InstanceProfileName : ec2instancerole
Path : /
Roles : {ec2instancerole}
For a complete list of Amazon SDK developer guides and code examples, see
Using this service with an Amazon SDK.
This topic also includes information about getting started and details about previous SDK versions.