Globus Connect Server Administration Guides
  • Quickstart Guide
  • Installation Guide
  • Data Access Admin Guide
  • Domain Guide
  • HTTPS Access to Collections
  • Identity Mapping Admin Guide
  • Globus OIDC Installation Guide
  • Troubleshooting Guide
  • Command-Line Reference
    • Audit
      • Load
      • Query
      • Dump
    • Endpoint
      • Setup
      • Show
      • Update
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Set Owner
      • Set Subscription ID
      • Migrate53
      • Cleanup
      • Domain
      • Role
      • Upgrade
    • OIDC
      • Create
      • Delete
      • Register
      • Show
      • Update
    • Node
      • Create
      • Setup
      • List
      • Show
      • Update
      • Cleanup
      • Delete
    • Login
    • Session
      • Consent
      • Show
      • Update
    • Whoami
    • Logout
    • Storage Gateway
      • Create
      • List
      • Show
      • Update
      • Delete
    • Collection
      • Create
      • List
      • Show
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Update
      • Delete
      • Domain
      • Role
    • Auth Policy
      • Create
      • List
      • Show
      • Update
      • Delete
    • Sharing Policy
      • Create
      • List
      • Show
      • Delete
    • User Credentials
      • Activescale Create
      • Box Create
      • Delete
      • List
      • S3 Create
    • Self Diagnostic
  • Globus Connect Server Manager API
    • Authorization
    • Versioning
    • Endpoint
    • Roles
    • Nodes
    • Storage Gateways
    • Collections
    • User Credentials
    • Domains
    • Sharing Policies
  • API Access for Portals
  • Data Access Application Guide
  • Application Migration Guide
  • Change Log
Skip to main content
Globus Docs
  • APIs
    Auth Flows Groups Search Transfer Python SDK Helper Pages
  • How To
  • Guides
    Globus Connect Server High Assurance Collections for Protected Data Command Line Interface Premium Storage Connectors Security Modern Research Data Portal
  • Support
    FAQs Mailing Lists Contact Us Check Support Tickets
  1. Home
  2. Globus Connect Server
  3. Installation Guide
  4. Command-Line Reference
  5. Collection

Globus Connect Server Collection List

Name

globus-connect-server collection list - List collections on an endpoint

Synopsis

globus-connect-server collection list [OPTIONS]…​

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.

Note

Multiple filters may be specified on the command-line, but certain combinations (such as filtering only mapped collections and only guest collections) will always yield an empty result.

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
Example 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
  • Quickstart Guide
  • Installation Guide
  • Data Access Admin Guide
  • Domain Guide
  • HTTPS Access to Collections
  • Identity Mapping Admin Guide
  • Globus OIDC Installation Guide
  • Troubleshooting Guide
  • Command-Line Reference
    • Audit
      • Load
      • Query
      • Dump
    • Endpoint
      • Setup
      • Show
      • Update
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Set Owner
      • Set Subscription ID
      • Migrate53
      • Cleanup
      • Domain
      • Role
      • Upgrade
    • OIDC
      • Create
      • Delete
      • Register
      • Show
      • Update
    • Node
      • Create
      • Setup
      • List
      • Show
      • Update
      • Cleanup
      • Delete
    • Login
    • Session
      • Consent
      • Show
      • Update
    • Whoami
    • Logout
    • Storage Gateway
      • Create
      • List
      • Show
      • Update
      • Delete
    • Collection
      • Create
      • List
      • Show
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Update
      • Delete
      • Domain
      • Role
    • Auth Policy
      • Create
      • List
      • Show
      • Update
      • Delete
    • Sharing Policy
      • Create
      • List
      • Show
      • Delete
    • User Credentials
      • Activescale Create
      • Box Create
      • Delete
      • List
      • S3 Create
    • Self Diagnostic
  • Globus Connect Server Manager API
    • Authorization
    • Versioning
    • Endpoint
    • Roles
    • Nodes
    • Storage Gateways
    • Collections
    • User Credentials
    • Domains
    • Sharing Policies
  • API Access for Portals
  • Data Access Application Guide
  • Application Migration Guide
  • Change Log
© 2010- The University of Chicago Legal Privacy Accessibility