
list-roles
**********


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

Lists the roles that have the specified path prefix. If there are
none, the action returns an empty list. For more information about
roles, go to Working with Roles .

You can paginate the results using the "--max-items" and "--marker"
parameters.

The returned policy is URL-encoded according to RFC 3986. For more
information about RFC 3986, go to
http://www.faqs.org/rfcs/rfc3986.html .


SYNOPSIS
========

   aws iam list-roles
     [--marker <value>]
     [--path-prefix <value>]
     [--max-items <value>]


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

None


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

"--marker"  (string)
   Use this parameter only when paginating results, and only in a
   subsequent request after you've received a response where the
   results are truncated. Set it to the value of the "--marker"
   element in the response you just received.

"--path-prefix"  (string)
   The path prefix for filtering the results. For example:
   "/application_abc/component_xyz/" , which would get all roles whose
   path starts with "/application_abc/component_xyz/" .

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

"--max-items"  (integer)
   Use this parameter only when paginating results to indicate the
   maximum number of user names you want in the response. If there are
   additional user names beyond the maximum you specify, the
   "IsTruncated" response element is "true" .
