Globus Connect Server Collection List
Description
The globus-connect-server collection list command displays a summary of the collections that exist on an endpoint.
By default, this command displays a table of data that includes the collection
id, name, owner, type (mapped
or guest
), and storage gateway id.
Alternatively, it can display a JSON document containing the list results. Use
the -F json command-line option to enable this output format.
The default output only includes the public configuration data for the collections. To request the private configuration data as well, you must have an administrator role on the collection assigned to one of your identities and use the --include-private-policies flag. For high-assurance endpoints this data is only visible if the request is done with an administrator id that is valid in the session and meets the authentication requirements of the storage gateway that the collection is providing access to.
You can filter the list of collections that are queried and displayed in two different ways. You can filter Guest collections by the ID of the mapped collection that they are sharing data from by using the --mapped-collection-id COLLECTION_ID parameter. You can also use the --filter FILTER_LIST parameter to apply one or more of the following filters to the results:
- mapped-collections
-
Filter out collections which do not have the
collection_type
property set to "mapped". - guest-collections
-
Filter out collections which do not have the
collection_type
property set to "guest". - managed-by-me
-
Filter out collections where none of the caller’s identities have a role association for the collection.
- created-by-me
-
Filter out collections where none of the callers identities match the
identity_id
property of the collection.
Options
- -h, --help
-
Show help message and exit.
- --version
-
Show the version and exit.
- --include-private-policies
-
Flag to include the private policies. See above for information about requirements to view private policies.
- -F, --format "text"|"json"
-
Output format for this command. If the format is json, then the collection document is displayed.
- --mapped-collection-id UUID
-
Filter results to Guest Collections on a specific Mapped Collection. This is the ID of the Mapped Collection.
- --use-explicit-host IP_ADDRESS (new in 5.4.23)
-
IP address of the GCS node to use for this request. If not specified, any available GCS node in the endpoint will be used.
- --filter "mapped-collections"|"guest_collections"|"managed-by-me"|"created-by-me"
-
Filter output as described above. This may be passed multiple times to apply several filters to the results.
Example
This example lists the collections on an endpoint with a single collection:
globus-connect-server collection list
ID | Display Name | Owner | Collection Type | Storage Gateway ID ------------------------------------ | ----------------------- | ---------------- | --------------- | ------------------------------------ 0ad549ce-f6cb-4c6e-a597-eabee476aa69 | Example Data Collection | user@example.org | mapped | 69d165fa-6977-4c3b-91db-00b943d84d2a