You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -175,4 +175,4 @@ Run a non-binary development version by executing the [`./tw`](tw) script in the
175
175
176
176
## License
177
177
178
-
[Mozilla Public License v2.0](https://github.com/seqeralabs/tower-cli/blob/master/LICENSE.txt)
Run `tw workspaces -h` to view supported workspace operations.
414
414
Run `tw workspaces add -h` to view the required and optional fields for adding your workspace.
415
415
416
-
Workspaces provide the context in which a user launches workflow executions, defines the available resources, and manages who can access those resources. Workspaces contain pipelines, runs, actions, datasets, compute environments, credentials, and secrets. Access permissions are controlled with participants, collaborators, and teams.
416
+
Workspaces provide the context in which a user launches workflow executions, defines the available resources, and manages who can access those resources. Workspaces contain pipelines, runs, actions, compute environments, credentials, datasets, data links, and secrets. Access permissions are controlled with participants, collaborators, and teams.
417
417
418
418
See [User workspaces][user-workspaces] for more information.
Participant '[email protected]' has now role 'maintain' for workspace 'shared-workspace'
485
485
```
486
486
487
+
## Data Links
488
+
489
+
Run `tw data-links -h` to view supported data link operations.
490
+
491
+
Data links allow you to work with public and private cloud storage buckets in Data Explorer in the specified workspace. See [Data Explorer][data-explorer] for more information. AWS S3, Azure Blob Storage, and Google Cloud Storage are supported. The full list of operations are:
492
+
493
+
-`list`: List data links in a workspace
494
+
-`add`: Add a custom data link to a workspace
495
+
-`update`: Update a custom data link in a workspace
496
+
-`delete`: Delete a custom data link from a workspace
497
+
-`browse`: Browse the contents of a data link in a workspace
498
+
499
+
### List data links
500
+
501
+
Run `tw data-links list -h` to view all the optional fields for listing data links in a workspace. If a workspace is not defined, the `TOWER_WORKSPACE_ID` workspace is used by default. Data links can be one of two types:
502
+
503
+
-`v1-cloud-<id>`: **cloud** data links auto-discovered using credentials attached to the workspace
504
+
-`v1-user-<id>`: **custom** data links created by users
Run `tw data-links add -h` to view all the required and optional fields for adding a custom data link to a workspace. Users with the `MAINTAIN` role and above for a workspace can add custom data links. The data link `name`, `uri` and `provider` (one of `aws`, `azure`, or `google`) fields are required. If adding a custom data link for a private bucket, the `credentials` identifier field is also required. Adding a custom data link for a public bucket doesn't require credentials.
Run `tw data-links update -h` to view all the required and optional fields for updating a custom data link in a workspace. Users with the `MAINTAIN` role and above for a workspace can update custom data links.
544
+
545
+
```console
546
+
$ tw data-links update -w seqeralabs/showcase -i v1-user-152116183ee325463901430bb9efb8c9 -n BAR
v1-user-152116183ee325463901430bb9efb8c9 | azure | BAR | az://seqeralabs.azure-benchmarking |
553
+
```
554
+
555
+
### Delete a custom data link
556
+
557
+
Run `tw data-links delete -h` to view all the required and optional fields for deleting a custom data link from a workspace. Users with the `MAINTAIN` role and above for a workspace can delete custom data links.
Data link 'v1-user-152116183ee325463901430bb9efb8c9' deleted at '138659136604200' workspace.
563
+
```
564
+
565
+
### Browse the contents of a data link
566
+
567
+
Run `tw data-links browse -h` to view all the required and optional fields for browsing a data link in a workspace. Define the data link id using the required `-i` or `--id` argument, which can be found by first using the `list` operation for a workspace. In the example below, a `name` is optionally defined to only retrieve data links with names that start with the given word:
568
+
569
+
```console
570
+
$ tw data-links list -w seqeralabs/showcase -n 1000genomes
0 commit comments