# CfnVirtualMFADeviceProps

Properties for defining a `CfnVirtualMFADevice`.

Extends: CfnVirtualMFADeviceProps
Used as props by: CfnVirtualMFADevice

- Source: Generated code

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_iam as iam } from 'aws-cdk-lib';
const cfnVirtualMFADeviceProps: iam.CfnVirtualMFADeviceProps = {
  users: ['users'],

  // the properties below are optional
  path: 'path',
  tags: [{
    key: 'key',
    value: 'value',
  }],
  virtualMfaDeviceName: 'virtualMfaDeviceName',
};
```

## Properties

- `path`: string — The path for the virtual MFA device.

  For more information about paths, see [IAM identifiers](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html) in the *IAM User Guide* .

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

  This parameter allows (through its [regex pattern](https://docs.aws.amazon.com/http://wikipedia.org/wiki/regex) ) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! ( `\u0021` ) through the DEL character ( `\u007F` ), including most punctuation characters, digits, and upper and lowercased letters.

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[] — 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) 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[] (required) — The IAM user associated with this virtual MFA device.

- `virtualMfaDeviceName`: string — The name of the virtual MFA device, which must be unique.

  Use with path to uniquely identify a virtual MFA device.

  This parameter allows (through its [regex pattern](https://docs.aws.amazon.com/http://wikipedia.org/wiki/regex) ) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-