Lists the IAM roles that have the specified path prefix. If there are none, the
operation returns an empty list. For more information about roles, see IAM roles in the
IAM User Guide.
IAM resource-listing operations return a subset of the available
attributes for the resource. This operation does not return the following attributes, even though they are an attribute of the returned object:
PermissionsBoundary
RoleLastUsed
Tags
To view all of the information for a role, see GetRole.
You can paginate the results using the MaxItems and Marker
parameters.
Example
Use a bare-bones client and the command you need to make an API call.
Lists the IAM roles that have the specified path prefix. If there are none, the operation returns an empty list. For more information about roles, see IAM roles in the IAM User Guide.
IAM resource-listing operations return a subset of the available attributes for the resource. This operation does not return the following attributes, even though they are an attribute of the returned object:
PermissionsBoundary
RoleLastUsed
Tags
To view all of the information for a role, see GetRole.
You can paginate the results using the
MaxItems
andMarker
parameters.Example
Use a bare-bones client and the command you need to make an API call.
Param
ListRolesCommandInput
Returns
ListRolesCommandOutput
See
input
shape.response
shape.config
shape.Throws
ServiceFailureException (server fault)
The request processing has failed because of an unknown error, exception or failure.
Throws
IAMServiceException
Base exception class for all service exceptions from IAM service.