Creating an endpoint

You must create at least one endpoint of the correct type before you can enable a platform service.

Before you begin

  • You must be signed in to the Tenant Manager using a supported browser.
  • Platform services must be enabled for your tenant account by a StorageGRID Webscale grid administrator.
  • You must belong to a user group that has the Manage Endpoints permission.
  • You must ensure that the resource referenced by the endpoint has already been created:
    • CloudMirror replication: S3 bucket
    • Event notification: SNS topic
    • Search integration: Elasticsearch index
      Note: You must create the Elasticsearch index before you create the endpoint. Endpoint validation is done using the Elasticsearch index. The type will be dynamically created when object metadata is first sent to the destination.
  • You must have all of the information needed to create the endpoint, as outlined in "How endpoints are specified."


  1. Select S3 > Endpoints.
    The Endpoints page opens and shows the list of endpoints that have already been configured.
    screenshot of S3 > Endpoints page
  2. Click Create to create a new endpoint.

    Screenshot of the create endpoint dialog box
  3. Complete each of the fields shown on the Create Endpoint dialog box.
    See "How endpoints are specified" for more information.
  4. Click Save.
    When you save an endpoint, StorageGRID Webscale validates that the endpoint that you configured exists, and can be reached using the credentials that you specified.
    If endpoint validation fails, you receive an error message that explains why endpoint validation failed. Resolve the issue, then try creating the endpoint again.
    Note: Endpoint creation fails if platform services are not enabled for your tenant account. Contact your StorageGRID Webscale grid administrator.
  5. If you need to test an existing endpoint, select the endpoint, and click Test.
    • A success message appears if the endpoint can be reached using the specified credentials.
      screenshot showing Endpoint Test success message
    • An error message appears if endpoint validation fails. If you need to modify the endpoint to correct the error, select it, click Edit, and update the information. Then, click Save to validate your changes.
      Note: You cannot change an endpoint's URN after the endpoint has been created.

After you finish

After you have configured an endpoint, you can use its URN to configure a platform service.