| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
ListMFADevices
Description
Lists the MFA devices. If the request includes the user name, then this action lists all the MFA devices associated with the specified user name. If you do not specify a user name, IAM determines the user name implicitly based on the AWS Access Key ID signing the request.
You can paginate the results using the MaxItems and Marker parameters.
Request Parameters
For information about the common parameters that all actions use, see Common Parameters.
- Marker
Use this 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
Markerelement in the response you just received.Type: String
Length constraints: Minimum length of 1. Maximum length of 320.
Required: No
- MaxItems
Use this only when paginating results to indicate the maximum number of MFA devices you want in the response. If there are additional MFA devices beyond the maximum you specify, the
IsTruncatedresponse element istrue. This parameter is optional. If you do not include it, it defaults to 100.Type: Integer
Required: No
- UserName
Name of the user whose MFA devices you want to list.
Type: String
Length constraints: Minimum length of 1. Maximum length of 128.
Required: No
Response Elements
The following
elements are
returned in a ListMFADevicesResult structure.
- IsTruncated
A flag that indicates whether there are more MFA devices to list. If your results were truncated, you can make a subsequent pagination request using the
Markerrequest parameter to retrieve more MFA devices in the list.Type: Boolean
- MFADevices
A list of MFA devices.
Type: MFADevice list
- Marker
If
IsTruncatedistrue, this element is present and contains the value to use for theMarkerparameter in a subsequent pagination request.Type: String
Errors
For information about the errors that are common to all actions, see Common Errors.
- NoSuchEntity
The request was rejected because it referenced an entity that does not exist. The error message describes the entity.
HTTP Status Code: 404
Examples
Sample Request
https://iam.amazonaws.com/
?Action=ListMFADevices
&UserName=Bob
&AUTHPARAMS
Sample Response
<ListMFADevicesResponse>
<ListMFADevicesResult>
<MFADevices>
<member>
<UserName>Bob</UserName>
<SerialNumber>R1234</SerialNumber>
</member>
</MFADevices>
<IsTruncated>false</IsTruncated>
</ListMFADevicesResult>
<ResponseMetadata>
<RequestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</RequestId>
</ResponseMetadata>
</ListMFADevicesResponse>
