Amazon S3

1. Select Authentication from the navigation menu or the dashboard.

2. Click the New Authentication button

3. Enter a unique name for the connection and give it a description

4. Select the connection type from the drop-down and click save.

5. Fill in the configuration settings on the edit connection page and click save.

1. Select integration and click on the new connection button.

2. Enter the name and description of your connection.

3. Select the connection type from the drop down list.

4. Click Save on the Create Connection form.

5. Click Save on the Edit Connection page.

1. Select List Jobs under Jobs on the navigation menu or the dashboard

2. Click the create job button

3. In the New Job form

   1. Name the job

   2. Select Simple Migration from the job type drop down

   3. Select the Repository Connection

   4. Select the Output connection

   5. Select your Content Service Connection

      (Only required if you will be using Federation)

   6. Click Save to open the Edit Job page

   7. Fill in the configurations for the Repo and Output Configuration tabs

4. Click save to save your new integration job

1. Select Run and Monitor Jobs under Integration in the navigation menu

2. Click the play button next to the job you want to run

3. Click the refresh button to view your completed job status

   (Larger jobs will take longer to run)

1. Click on the task tab in your integration job.

2. Find the task you want to create in the drop down. Tasks are grouped by type. You can also search for the task by name.

3. Select the create task button

4. Fill out the configuration fields. Some tasks do not require configuration.

5. Click Done to save the task to your job.

1. Select Content Service under Connections in the navigation menu

2. Click the New Connection button

3. Fill in the following configuration fields.

Get Permissions

GET /api/repo/s3/acls?id=/test-bucket/archive/testdoc.txt

{
  "success": true,
  "results": [
    "7cfbdbb50b0682227896f2b416777d4d74906ded4df472db3ace75768962c134:(adminuser):FULL_CONTROL"
  ]
}

Set Permissions

POST /api/repo/s3/acls?id=/test-bucket/archive/testdoc.txt

To add a user to a document, you can use their canonical id or email

Requires a JSON as a request body in the following format:

{"7cfb11150b0682227896f2b416777d4d74906ded4df472db3ace75769062c134":"READ"}

or

{"testuser@gmail.com":"READ"}

which will result in

{
  "success": true,
  "results": [
    "7cfbdbb50b0682227896f2b416777d4d74906ded4df472db3ace75768962c134:(adminuser):FULL_CONTROL",
    "7cfb11150b0682227896f2b416777d4d74906ded4df472db3ace75769062c134:(testuser):READ"
  ]
}

To add a group, you'll need the group's URI, such as:

{"http://acs.amazonaws.com/groups/s3/LogDelivery":"WRITE"}

resulting in

{
  "success": true,
  "results": [
    "7cfbdbb50b0682227896f2b416777d4d74906ded4df472db3ace75768962c134:(adminuser):FULL_CONTROL",
    "http://acs.amazonaws.com/groups/s3/LogDelivery:(Group):WRITE"
  ]
}

Delete Permissions

Delete PermissionsDELETE /api/repo/s3/acls?id=/test-bucket/archive/testdoc.txt&aclId=7cfb11150b0682227896f2b416777d4d74906ded4df472db3ace75769062c134

The aclId parameter can either be the Canonical ID of a user, or the url of the group.

The return will simply be the aclId, but a follow up GET call will produce

{
  "success": true,
  "results": [
    "7cfbdbb50b0682227896f2b416777d4d74906ded4df472db3ace75768962c134:(adminuser):FULL_CONTROL"
  ]
}

The items before the semicolon is called the canonical ID of the user. It can be used to remove or update permissions for the user.

Groups use a url instead of a Canonical ID. Such as http://acs.amazonaws.com/groups/global/AllUsers. They will appear as <url>:(Group):<Permission>