Managing DNS aliases on existing file systems - Amazon FSx for Windows File Server
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).

Managing DNS aliases on existing file systems

This topic describes how you use the Amazon Web Services Management Console and Amazon CLI to add and remove aliases on existing file systems.

  1. Open the Amazon FSx console at https://console.amazonaws.cn/fsx/.

  2. Navigate to File systems, and choose the Windows file system that you want to manage DNS aliases for.

  3. On the Network & security tab, choose Manage for DNS aliases to display the Manage DNS aliases dialog box.

    FSx console Manage DNS aliases window, use this window for associating and disassociating DNS aliases with an FSx for Windows File Server file system.

    • To associate DNS aliases – In the Associate new aliases box, enter the DNS aliases that you want to associate. Choose Associate.

    • To disassociate DNS aliases – In the Current aliases list, choose the aliases to disassociate from. Choose Disassociate.

    You can monitor the status of the aliases you have managed in the Current aliases list. Refresh the list to update the status. It takes up to 2.5 minutes for an alias to be associated or disassociated with a file system.

  4. When the alias is Available, you can access your file system using the DNS alias by configuring service principal names (SPNs) and updating or creating a DNS CNAME record for the alias. For more information, see Using DNS aliases to access your file system.

  1. Use the associate-file-system-aliases CLI command or the AssociateFileSystemAliases API operation to associate DNS aliases with an existing file system.

    The following CLI request associates two aliases with the specified file system.

    aws fsx associate-file-system-aliases \
  --file-system-id fs-0123456789abcdef0 \
  --aliases financials.corp.example.com transfers.corp.example.com

    The response shows the status of the aliases that Amazon FSx is associating with the file system.

    {
    "Aliases": [
        {
            "Name": "financials.corp.example.com",
            "Lifecycle": CREATING
        },
        {
            "Name": "transfers.corp.example.com",
            "Lifecycle": CREATING
        }
    ]
}

  2. Use the describe-file-system-aliases CLI command (DescribeFileSystemAliases is the equivalent API operation) to monitor the status of the aliases that you are associating.

  3. When the Lifecycle has a value of AVAILABLE (a process that takes up to 2.5 minutes), you can access your file system using the DNS alias by configuring service principal names (SPNs) and updating or creating a DNS CNAME record for the alias. For more information, see Using DNS aliases to access your file system.

  • Use the disassociate-file-system-aliases CLI command or the DisassociateFileSystemAliases API operation to disassociate DNS aliases from an existing file system.

    The following command disassociates one alias from a file system.

    aws fsx disassociate-file-system-aliases \
  --file-system-id fs-0123456789abcdef0 \
  --aliases financials.corp.example.com

    The response shows the status of the aliases that Amazon FSx is disassociating from the file system.

    {
    "Aliases": [
        {
            "Name": "financials.corp.example.com",
            "Lifecycle": DELETING
        }
    ]
}

    Use the describe-file-system-aliases CLI command (DescribeFileSystemAliases is the equivalent API operation) to monitor the status of the aliases. It takes up to 2.5 minutes for the alias to be deleted.