Action Provider: Transfer - Set Permission

URL: https://actions.globus.org/transfer/set_permission

Scope: https://auth.globus.org/scopes/actions.globus.org/transfer/set_permission

Synchronous / Asynchronous: Synchronous

The Set Permission action provider uses the Globus Transfer ACL API to set or manage permissions on a folder or file. The body of the request indicates whether the permission rule is to be created, updated or deleted using the operation property. For update or delete, the rule_id of a previously created permission rule must also be provided.

As the Globus Transfer API returns a status directly (rather than a task identifier), the action provider behaves in a synchronous manner, returning the Transfer API result.

Example Input to Create Permissions

{
  "operation": "CREATE",
  "endpoint_id": "ddb59aef-6d04-11e5-ba46-22000b92c6ec",
  "path": "/~/shared/",
  "principal_type": "all_authenticated_users",
  "principal": "",
  "permissions": "r"
}

Example Input to Delete Permissions

{
  "operation": "DELETE",
  "endpoint_id": "ddb59aef-6d04-11e5-ba46-22000b92c6ec",
  "rule_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
}

Example Input to Update Permissions

{
  "operation": "UPDATE",
  "endpoint_id": "ddb59aef-6d04-11e5-ba46-22000b92c6ec",
  "rule_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "permissions": "rw"
}