1. Deep Sync Help Center
  2. Our Datasets
  3. Downstream Deletions - Suppression File

Accessing the Deep Sync Suppression File in S3

Step-by-Step Instructions for Programmatic Access to AWS Services using AWS CLI

Step 1: Install and Configure AWS CLI

  1. Install AWS CLI:
    1. Download and install the AWS CLI for your operating system from the official AWS CLI website.
  2. Open a terminal or command prompt:
    1. Launch a terminal (Linux/Mac) or command prompt (Windows).
  3. Configure AWS CLI:
    1. Run the following command to configure the AWS CLI:

      • aws configure

      • Provide the following information when prompted:
        • AWS Access Key ID: Your access key ID.
        • AWS Secret Access Key: Your secret access key.
        • Default region name: The AWS region you want to use (e.g., us-east-1).
        • Default output format (optional): The output format (e.g., json).

Step 2: List Objects in an S3 Bucket

  1. Run the command below to view a list of the objects/files that are present in the specified S3 bucket:
    1.  aws s3 ls s3://your-bucket-name
  2. In the case of the suppression file, the bucket name is 'deep-sync-30-day-suppression'. To view the contents of this bucket run:
    1. aws s3 ls s3://deep-sync-30-day-suppression

Step 3: Download a File from an S3 Bucket

  1. Determine the S3 URL and the directory to which you'd like to download the file.
    1. Identify the S3 URL of the file you want to download (e.g., s3://my-bucket/documents/example.txt).
    2. Decide the directory where you want to save the file (e.g., /home/user/downloads).
  2. Run the command below to download the file:
    1. aws s3 cp s3://bucket-name/path/to/file /path/to/local/directory
      1. Note: When running this command, you will replace s3://bucket-name/path/to/file with the S3 object's URL and /path/to/local/directory with the path to your desired directory from Step 1. 

Example Scenario:

Suppose you want to download a file named example.txt from the S3 bucket my-bucket located in the folder documents to your local /home/user/downloads directory.

Run the command below to download the file example.txt from the specified S3 bucket to the /home/user/downloads directory on your local machine.

aws s3 cp s3://my-bucket/documents/example.txt /home/user/downloads/

 

For more more information on accessing files via S3 please visit Amazon's AWS Documentation