Specifying S3 API endpoint domain names

To support S3 virtual-hosted style requests, you must configure the list of endpoint domain names that S3 clients will be connecting to.

Before you begin

About this task

API endpoint domain names are configured after you create the fully-qualified domain names on the DNS server, depending on the grid nodes that S3 clients will be connecting to:
  • If S3 clients are connecting to one or more API Gateway Nodes, you must include the domain name of each API Gateway Node.
  • If S3 clients are connecting to one or more Storage Nodes, you must include the domain name of each Storage Node.
  • If S3 clients are connecting through an external load balancer, you must include the domain name of the load balancer.

If this list is empty, support for S3 virtual hosted-style requests is disabled.

You must also configure a custom server certificate for the StorageGRID Webscale system with a wildcard Subject Alternative Name (SAN) for each endpoint, and possibly each IP address. These steps are required to validate the SSL certificate and verify the hostname when API client applications connect to the endpoint.

Steps

  1. Select Configuration > Domain Names.
    The Endpoint Domain Names page appears.

    screenshot of the Endpoint Domain Names dialog box

  2. Using the (+) icon to add additional fields, enter the list of S3 API endpoint domain names in the Endpoint number fields and click Save.
    Warning: Do not make any changes to the domain name configuration when a grid upgrade is in progress.