AWS IAM Remove Role from Instance Profile logo

AWS IAM Remove Role from Instance Profile Version 1

This handler uses the AWS REST API to remove a specified role from a specified instance profile. 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 will break any applications running on the instance. For more information see the AWS Amazon Virtual Private Cloud User Guide online.

Parameters

Name Description
Instance Profile Name The name of the role to update. No spaces allowed, alphanumeric characters and any of these '+=,.@_-' only. Must match an existing value in AWS.
Role Name The role you wish to remove. No spaces allowed, alphanumeric characters and any of these '+=,.@_-' only. Must match an existing value in AWS.

Sample Configuration

Name Description
Instance Profile Name DevProfileName
Role Name DevTestRole

Results

This handler does not return any results.

Changelog

AWS IAM Remove Role from Instance Profile V1 (2017-09-05)

  • Initial version. See README for details.


Related Handlers

AWS IAM Add Role to Instance Profile
Adds a specified role to a specified instance profile.
AWS IAM Attach Role Policy
Attaches a specified managed policy to a specified role in AWS IAM (Identify and Access Management)
AWS IAM Create Instance Profile
Creates a new instance profile. An instance profile is a container for an AWS IAM (Identify and Access Management) role that you can use to pass role information to an EC2 instance when the instance starts.
AWS IAM Create Role
Creates an AWS IAM (Identify and Access Management) Role
AWS IAM Delete Instance Profile
Deletes a specified instance profile. The instance profile must not have an associated role.
AWS IAM Delete Policy
Deletes the specified managed policy.
AWS IAM Delete Role
Deletes the specified role. The role must not have any policies attached.
AWS IAM Detach Role Policy
Removes the specified managed policy from the specified role.
AWS IAM List Instance Profiles
Lists the instance profiles that have the specified path prefix. If there are none, the action returns an empty list.