NAME

Paws::DS::CreateDirectory - Arguments for method CreateDirectory on Paws::DS

DESCRIPTION

This class represents the parameters used for calling the method CreateDirectory on the AWS Directory Service service. Use the attributes of this class as arguments to method CreateDirectory.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to CreateDirectory.

SYNOPSIS

    my $ds = Paws->service('DS');
    my $CreateDirectoryResult = $ds->CreateDirectory(
      Name        => 'MyDirectoryName',
      Password    => 'MyPassword',
      Size        => 'Small',
      Description => 'MyDescription',           # OPTIONAL
      ShortName   => 'MyDirectoryShortName',    # OPTIONAL
      Tags        => [
        {
          Key   => 'MyTagKey',      # min: 1, max: 128
          Value => 'MyTagValue',    # max: 256
        },
        ...
      ],    # OPTIONAL
      VpcSettings => {
        SubnetIds => [ 'MySubnetId', ... ],
        VpcId     => 'MyVpcId',
      },    # OPTIONAL
    );
    # Results:
    my $DirectoryId = $CreateDirectoryResult->DirectoryId;
    # Returns a L<Paws::DS::CreateDirectoryResult> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see <https://docs.aws.amazon.com/goto/WebAPI/ds/CreateDirectory>

ATTRIBUTES

Description => Str

A description for the directory.

REQUIRED Name => Str

The fully qualified name for the directory, such as "corp.example.com".

REQUIRED Password => Str

The password for the directory administrator. The directory creation process creates a directory administrator account with the user name "Administrator" and this password.

If you need to change the password for the administrator account, you can use the ResetUserPassword API call.

The regex pattern for this string is made up of the following conditions:

•: Length (?=^.{8,64}$) – Must be between 8 and 64 characters

AND any 3 of the following password complexity rules required by Active Directory:

Numbers and upper case and lowercase (?=.*\d)(?=.*[A-Z])(?=.*[a-z])
Numbers and special characters and lower case (?=.*\d)(?=.*[^A-Za-z0-9\s])(?=.*[a-z])
Special characters and upper case and lower case (?=.*[^A-Za-z0-9\s])(?=.*[A-Z])(?=.*[a-z])
Numbers and upper case and special characters (?=.*\d)(?=.*[A-Z])(?=.*[^A-Za-z0-9\s])

For additional information about how Active Directory passwords are enforced, see Password must meet complexity requirements (https://docs.microsoft.com/en-us/windows/security/threat-protection/security-policy-settings/password-must-meet-complexity-requirements) on the Microsoft website.

ShortName => Str

The NetBIOS name of the directory, such as "CORP".

REQUIRED Size => Str

The size of the directory.

Valid values are: "Small", "Large"

Tags => ArrayRef[Paws::DS::Tag]

The tags to be assigned to the Simple AD directory.

VpcSettings => Paws::DS::DirectoryVpcSettings

A DirectoryVpcSettings object that contains additional information for the operation.

BUGS and CONTRIBUTIONS

The source code is located here: <https://github.com/pplu/aws-sdk-perl>

Please report bugs to: <https://github.com/pplu/aws-sdk-perl/issues>