1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. iam
  5. getVirtualMfaDevice

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Native v0.126.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.iam.getVirtualMfaDevice

aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Native v0.126.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-aws-native

    Resource Type definition for AWS::IAM::VirtualMFADevice

    Using getVirtualMfaDevice

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getVirtualMfaDevice(args: GetVirtualMfaDeviceArgs, opts?: InvokeOptions): Promise<GetVirtualMfaDeviceResult>
function getVirtualMfaDeviceOutput(args: GetVirtualMfaDeviceOutputArgs, opts?: InvokeOptions): Output<GetVirtualMfaDeviceResult>
    def get_virtual_mfa_device(serial_number: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetVirtualMfaDeviceResult
def get_virtual_mfa_device_output(serial_number: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetVirtualMfaDeviceResult]
    func LookupVirtualMfaDevice(ctx *Context, args *LookupVirtualMfaDeviceArgs, opts ...InvokeOption) (*LookupVirtualMfaDeviceResult, error)
func LookupVirtualMfaDeviceOutput(ctx *Context, args *LookupVirtualMfaDeviceOutputArgs, opts ...InvokeOption) LookupVirtualMfaDeviceResultOutput

    > Note: This function is named LookupVirtualMfaDevice in the Go SDK.

    public static class GetVirtualMfaDevice 
{
    public static Task<GetVirtualMfaDeviceResult> InvokeAsync(GetVirtualMfaDeviceArgs args, InvokeOptions? opts = null)
    public static Output<GetVirtualMfaDeviceResult> Invoke(GetVirtualMfaDeviceInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetVirtualMfaDeviceResult> getVirtualMfaDevice(GetVirtualMfaDeviceArgs args, InvokeOptions options)
public static Output<GetVirtualMfaDeviceResult> getVirtualMfaDevice(GetVirtualMfaDeviceArgs args, InvokeOptions options)

    fn::invoke:
  function: aws-native:iam:getVirtualMfaDevice
  arguments:
    # arguments dictionary

    The following arguments are supported:

    SerialNumber string
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    SerialNumber string
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    serialNumber String
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    serialNumber string
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    serial_number str
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    serialNumber String
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.

    getVirtualMfaDevice Result

    The following output properties are available:

    SerialNumber string
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    Tags List<Pulumi.AwsNative.Outputs.Tag>

    A list of tags that you want to attach to the new IAM virtual MFA device. Each tag consists of a key name and an associated value. For more information about tagging, see Tagging IAM resources in the IAM User Guide .

    If any one of the tags is invalid or if you exceed the allowed maximum number of tags, then the entire request fails and the resource is not created.

    Users List<string>
    The IAM user associated with this virtual MFA device.
    SerialNumber string
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    Tags Tag

    A list of tags that you want to attach to the new IAM virtual MFA device. Each tag consists of a key name and an associated value. For more information about tagging, see Tagging IAM resources in the IAM User Guide .

    If any one of the tags is invalid or if you exceed the allowed maximum number of tags, then the entire request fails and the resource is not created.

    Users []string
    The IAM user associated with this virtual MFA device.
    serialNumber String
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    tags List<Tag>

    A list of tags that you want to attach to the new IAM virtual MFA device. Each tag consists of a key name and an associated value. For more information about tagging, see Tagging IAM resources in the IAM User Guide .

    If any one of the tags is invalid or if you exceed the allowed maximum number of tags, then the entire request fails and the resource is not created.

    users List<String>
    The IAM user associated with this virtual MFA device.
    serialNumber string
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    tags Tag[]

    A list of tags that you want to attach to the new IAM virtual MFA device. Each tag consists of a key name and an associated value. For more information about tagging, see Tagging IAM resources in the IAM User Guide .

    If any one of the tags is invalid or if you exceed the allowed maximum number of tags, then the entire request fails and the resource is not created.

    users string[]
    The IAM user associated with this virtual MFA device.
    serial_number str
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    tags Sequence[root_Tag]

    A list of tags that you want to attach to the new IAM virtual MFA device. Each tag consists of a key name and an associated value. For more information about tagging, see Tagging IAM resources in the IAM User Guide .

    If any one of the tags is invalid or if you exceed the allowed maximum number of tags, then the entire request fails and the resource is not created.

    users Sequence[str]
    The IAM user associated with this virtual MFA device.
    serialNumber String
    Returns the serial number for the specified AWS::IAM::VirtualMFADevice resource.
    tags List<Property Map>

    A list of tags that you want to attach to the new IAM virtual MFA device. Each tag consists of a key name and an associated value. For more information about tagging, see Tagging IAM resources in the IAM User Guide .

    If any one of the tags is invalid or if you exceed the allowed maximum number of tags, then the entire request fails and the resource is not created.

    users List<String>
    The IAM user associated with this virtual MFA device.

    Supporting Types

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Native v0.126.0 (Older version)
    published on Monday, Mar 9, 2026 by Pulumi
    Go to latest version
    Schema (JSON)
    pulumi/pulumi-aws-native
      Try Pulumi Cloud free. Your team will thank you.