Sandbox UI guide

This document provides steps on how to perform various operations related to sandboxes in the Adobe Experience Platform user interface.

View sandboxes

In the Platform UI, select Sandboxes in the left navigation to open the Sandboxes dashboard. The dashboard lists all available sandboxes for your organization, including the sandbox type (production or development) and state (active, creating, deleted, or failed).

Switch between sandboxes

The sandbox switcher control at the top-left of the screen displays the currently active sandbox.

To switch between sandboxes, select the sandbox switcher and select the desired sandbox from the dropdown list.

Once a sandbox is selected, the screen refreshes with the selected sandbox now featured in the sandbox switcher.

Search for a sandbox

You can navigate through the list of sandboxes available to you by using the search function from the sandbox switcher menu. Type in the name of the sandbox you would like to access to filter through all sandboxes available to your organization.

Create a new sandbox

NOTE

When a new sandbox is created, you must first add that new sandbox to your product profile in Adobe Admin Console before you can start using the new sandbox. See the documentation on managing permissions for a product profile for information on how to provision a sandbox to a product profile.

Use the following video for a quick overview on how to use Sandboxes in Experience Platform.

To create a new sandbox, select Create sandbox on the top-right corner of the screen.

create

The Create sandbox dialog box appears. If you are creating a development sandbox, select Development in the dropdown panel. To create a new production sandbox, select Production.

type

After selecting the type, provide your sandbox with a name and a title. The title is meant to be human-readable and should be descriptive enough to be easily identifiable. The sandbox name is an all-lowercase identifier for use in API calls and should therefore be unique and concise. The sandbox name must begin with a letter, have a maximum of 256 characters, and consist only of alphanumeric characters and hyphens (-).

When finished, select Create.

info

Once you have finished creating the sandbox, refresh the page and the new sandbox appears in the Sandboxes dashboard with a status of “Creating”. New sandboxes take approximately 30 seconds to be provisioned by the system, after which their status changes to “Active”.

Reset a sandbox

IMPORTANT

The default production sandbox cannot be reset if the identity graph hosted within it is also being used by Adobe Analytics for the Cross Device Analytics (CDA) feature, or if the identity graph hosted within it is also being used by Adobe Audience Manager for the People Based Destinations (PBD) feature.

Resetting a production or development sandbox deletes all resources associated with that sandbox (schemas, datasets, and so on), while maintaining the sandbox’s name and associated permissions. This “clean” sandbox continues to be available under the same name for users that have access to it.

Select the sandbox you want to reset from the list of sandboxes. In the right-navigation panel that appears, select Sandbox reset.

reset

A dialog box appears prompting you to confirm your choice. Select Continue to proceed.

reset-warning

In the final confirmation window, enter the name of the sandbox in the dialog box and select Reset

reset-confirm

After a few moments, a confirmation box appears on the bottom of the screen to confirm a successful reset.

success

Warnings

A default production sandbox that contains CDA data cannot be reset and returns the following warning.

cda

A default production sandbox that contains PBD data also cannot be reset and returns the following warning.

pbd

A default production sandbox that contains data for both CDA and PBD also cannot be reset and returns the following warning.

both

You can reset a production sandbox that is used for bi-directional segment sharing with Audience Manager or Audience Core Service. Select Continue to proceed with the reset.

both

Delete a sandbox

IMPORTANT

The default production sandbox cannot be deleted.

Deleting a production or development sandbox permanently removes all resources associated with that sandbox, including permissions.

Select the sandbox you want to delete from the list of sandboxes. In the right-navigation panel that appears, select Delete.

delete

A dialog box appears prompting you to confirm your choice. Select Continue to proceed.

delete-warning

In the final confirmation window, enter the name of the sandbox in the dialog box and select Continue

delete-confirm

A user-created production sandbox that is used for bi-directional segment sharing with Audience Manager or Audience Core Service can still be deleted after the following warning.

seg

Next steps

This document demonstrated how to manage sandboxes within the Experience Platform UI. For information on how to manage sandboxes using the Sandbox API, see the sandbox developer guide.

On this page