Editing or removing an endpoint

You can edit an endpoint to change its name, URI, or other details; however, you cannot change the URN for an endpoint. You can remove an endpoint if you no longer want to use the associated platform service.

Before you begin

  • You must be signed in to the Tenant Manager using a supported browser.
  • You must belong to a user group that has the Manage Endpoints permission.


  1. Select S3 > Endpoints.
    The Endpoints page opens and shows the list of endpoints that have already been configured.
  2. Optionally, edit an endpoint.
    1. Select the radio button for the endpoint.
    2. Click Edit.
    3. As required, change the display name, URI, credentials, or certificate.
      For example, you might need to update expired credentials or change the URI to point to a backup Elasticsearch index for failover.
      Attention: You cannot change the URN for an endpoint.
    4. Click Save.
    When you save an endpoint, StorageGRID validates that the endpoint exists and that it can be reached with the current credentials. The connection to the endpoint is validated from one node at each site.

    If endpoint validation fails, you receive an error message that explains why validation failed.

  3. Optionally, remove an endpoint.
    Attention: If you remove an endpoint that is in use, the associated platform service will be disabled for any buckets that use the endpoint. Any requests that have not yet been completed will be dropped. Any new requests will continue to be generated until you change your bucket configuration to no longer reference the deleted URN. StorageGRID will report these requests as unrecoverable errors.
    1. Select the radio button for the endpoint.
    2. Click Remove.
      A confirmation warning is displayed.
    3. Click OK.