Skip to content

IAM  >  Operations  >  get_mfa_device

get_mfa_device

Operation

get_mfa_device async

get_mfa_device(request: GetMFADeviceInput | GetMFADeviceInputDict, /, *, plugins: list[Plugin] | None = None) -> GetMFADeviceOutput
get_mfa_device(*, plugins: list[Plugin] | None = None, **kwargs: Unpack[GetMFADeviceInputDict]) -> GetMFADeviceOutput

Retrieves information about an MFA device for a specified user.

Parameters:

Name Type Description Default
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
GetMFADeviceOutput

An instance of GetMFADeviceOutput.

Input

Pass the input fields as keyword arguments, or pass a model or dictionary as the first positional argument. Pass plugins separately as a keyword argument.

Model

GetMFADeviceInput dataclass

Bases: _SerdeShape

Dataclass for GetMFADeviceInput structure.

Attributes
serial_number class-attribute instance-attribute
serial_number: str | None = ...

Serial number that uniquely identifies the MFA device. For this API, we only accept FIDO security key ARNs.

user_name class-attribute instance-attribute
user_name: str | None = ...

The friendly name identifying the user.

Dictionaries

GetMFADeviceInputDict

Bases: TypedDict

Dictionary form of GetMFADeviceInput.

Attributes
serial_number instance-attribute
serial_number: Required[str]

Serial number that uniquely identifies the MFA device. For this API, we only accept FIDO security key ARNs.

user_name instance-attribute
user_name: str | None

The friendly name identifying the user.

Output

GetMFADeviceOutput dataclass

Bases: _SerdeShape

Dataclass for GetMFADeviceOutput structure.

Attributes

certifications class-attribute instance-attribute
certifications: dict[str, str] | None = ...

The certifications of a specified user's MFA device. We currently provide FIPS-140-2, FIPS-140-3, and FIDO certification levels obtained from FIDO Alliance Metadata Service (MDS).

enable_date class-attribute instance-attribute
enable_date: datetime | None = ...

The date that a specified user's MFA device was first enabled.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

serial_number instance-attribute
serial_number: str

Serial number that uniquely identifies the MFA device. For this API, we only accept FIDO security key ARNs.

user_name class-attribute instance-attribute
user_name: str | None = ...

The friendly name identifying the user.