Joining SVMs to a Microsoft Active Directory - FSx for ONTAP
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Joining SVMs to a Microsoft Active Directory

Your organization might manage identities and devices using an Active Directory, whether on-premises or in the cloud. With FSx for ONTAP, you can join your SVMs directly to your existing Active Directory domain in the following ways:

  • Joining new SVMs to an Active Directory at creation:

    • Using the Standard create option in Amazon FSx console to create a new FSx for ONTAP file system, you can join the default SVM to a self-managed Active Directory. For more information, see To create a file system (console).

    • Using the Amazon FSx console, Amazon CLI, or Amazon FSx API to create a new SVM on an existing FSx for ONTAP file system. For more information, see Creating a storage virtual machine.

  • Joining existing SVMs to an Active Directory:

    • Using the Amazon Web Services Management Console, Amazon CLI, and API to join an SVM to an Active Directory, and to reattempt joining an SVM to an Active Directory if the initial attempt to join failed. You can also update some Active Directory configuration properties for SVMs that are already joined to an Active Directory. For more information, see Managing SVM Active Directory configurations.

    • Using the NetApp ONTAP CLI or REST API to join, reattempt joining, and unjoining SVM Active Directory configurations. For more information, see Managing your SVM Active Directory configuration using the NetApp CLI.

  • Amazon FSx only registers DNS records for an SVM if you use Microsoft DNS as the default DNS service. If you use a third-party DNS, you must set up DNS entries manually for your Amazon FSx SVMs after you create them.

  • If you use Amazon Managed Microsoft AD, you must specify a group such as Amazon Delegated FSx Administrators, Amazon Delegated Administrators, or a custom group with delegated permissions to the OU.

When you join an FSx for ONTAP SVM directly to a self-managed Active Directory, the SVM resides in the same Active Directory forest (the top-most logical container in an Active Directory configuration that contains domains, users, and computers) and in the same Active Directory domain as your users and existing resources, including existing file servers.

Information needed when joining an SVM to an Active Directory

You have to provide the following information about your Active Directory when joining an SVM to an Active Directory, regardless of the API operation you choose:

  • The NetBIOS name of the Active Directory computer object to create for your SVM. This is the name of the SVM in Active Directory, which must be unique within your Active Directory. Don't use the NetBIOS name of the home domain. The NetBIOS name can't exceed 15 characters.

  • The fully qualified domain name (FQDN) of your Active Directory. The FQDN can't exceed 255 characters.


    The FQDN can't be in the Single Label Domain (SLD) format. Amazon FSx doesn't support SLD domains.

  • Up to three IP addresses of the DNS servers or domain hosts for your domain.

    The DNS server IP addresses and Active Directory domain controller IP addresses can be in any IP address range, except:

    • IP addresses that conflict with Amazon Web Services-owned IP addresses in that Amazon Web Services Region. For a list of Amazon IP addresses by Region, see the Amazon IP address ranges.

    • IP addresses in the following CIDR block range:

  • Username and password for a service account on your Active Directory domain for Amazon FSx to use when joining the SVM to the Active Directory domain. For more information about service account requirements, see Active Directory service account requirements.

  • (Optional) The Organizational Unit (OU) in the domain that you join the SVM to.


    If you join your SVM to an Amazon Directory Service Active Directory, you must provide an OU that's within the default OU that Amazon Directory Service creates for the directory objects that are related to Amazon. This is because the Amazon Directory Service doesn't provide access to your Active Directory's default Computers OU. For example, if your Active Directory domain is, you can specify the following OU: OU=Computers,OU=example,DC=example,DC=com.

  • (Optional) The domain group that you are delegating authority to for performing administrative actions on your file system. For example, this domain group might manage Windows SMB file shares, take ownership of files and folders, and so on. If you don’t specify this group, Amazon FSx delegates this authority to the Domain Admins group in your Active Directory domain by default.