Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . iam ]

remove-role-from-instance-profile

Description

Removes the specified IAM role from the specified EC2 instance profile.

Warning

Make sure you do not have any Amazon EC2 instances running with the role you are about to remove from the instance profile. Removing a role from an instance profile that is associated with a running instance might break any applications running on the instance.

For more information about IAM roles, go to Working with Roles . For more information about instance profiles, go to About Instance Profiles .

See also: AWS API Documentation

Synopsis

  remove-role-from-instance-profile
--instance-profile-name <value>
--role-name <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--instance-profile-name (string)

The name of the instance profile to update.

This parameter allows (per 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: =,.@-

--role-name (string)

The name of the role to remove.

This parameter allows (per 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: _+=,.@-

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

Examples

To remove a role from an instance profile

The following remove-role-from-instance-profile command removes the role named Test-Role from the instance profile named ExampleInstanceProfile:

aws iam remove-role-from-instance-profile --instance-profile-name ExampleInstanceProfile --role-name Test-Role

For more information, see Instance Profiles in the Using IAM guide.

Output

None