
create-role
***********


DESCRIPTION
===========

Creates a new role for your AWS account. For more information about
roles, go to Working with Roles . For information about limitations on
role names and the number of roles you can create, go to Limitations
on IAM Entities in *Using AWS Identity and Access Management* .

The policy grants permission to an EC2 instance to assume the role.
The policy is URL-encoded according to RFC 3986. For more information
about RFC 3986, go to http://www.faqs.org/rfcs/rfc3986.html .
Currently, only EC2 instances can assume roles.


SYNOPSIS
========

   aws iam create-role
     --assume-role-policy-document <value>
     --role-name <value>
     [--path <value>]


REQUIRED PARAMETERS
===================

"--assume-role-policy-document"  (string)
   The policy that grants an entity permission to assume the role.

"--role-name"  (string)
   Name of the role to create.


OPTIONAL PARAMETERS
===================

"--path"  (string)
   The path to the role. For more information about paths, see
   Identifiers for IAM Entities in *Using AWS Identity and Access
   Management* .

   This parameter is optional. If it is not included, it defaults to a
   slash (/).
