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. Endpoint

Globus Connect Server Endpoint Set Subscription ID

Name

globus-connect-server endpoint set-subscription-id - Update the subscription ID on the endpoint

Synopsis

globus-connect-server endpoint set-subscription-id [UUID|DEFAULT|null] [OPTIONS]…​

Description

The globus-connect-server endpoint set-subscription-id command sets, updates or removes the subscription ID associated with the endpoint. Only a subscription manager may set a new subscription ID on an endpoint. Only an endpoint administrator may remove a subscription from an endpoint.

The subscription can be given in one of three forms:

UUID

The ID of the subscription you wish to use to manage this endpoint.

DEFAULT

If the subscription manager only manages a single subscription, you can use the keyword DEFAULT as a convenience and the subscription ID will be looked up internally.

null

Using this value will remove the current subscription from the endpoint.

Unlike setting the subscription ID via the endpoint update command, this operation allows for subscription managers who do not have admin roles on the endpoint to set the subscription ID.

The current endpoint subscription ID can be viewed with the endpoint show command.

Options

-h, --help

Show help message and exit.

--version

Show the version and exit.

-F, --format "text"|"json"

Output format for this command. If the format is json, then the full response from the GCS Manager is displayed.

--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.

Example

Example of a subscription manager setting the endpoint’s subscription id:

[centos@ip-172-31-31-2 ~]$ globus-connect-server endpoint set-subscription-id e759ad3b-37c2-4699-aba6-ce4f760243ee
Message: Updated Endpoint d4e44529-0ad8-41b6-9509-72bc42cf0732

Example of a subscription manager setting the endpoint’s subscription id using the DEFAULT keyword:

[centos@ip-172-31-31-2 ~]$ globus-connect-server endpoint set-subscription-id DEFAULT
Message: Updated Endpoint d4e44529-0ad8-41b6-9509-72bc42cf0732

In this example, the subscription ID is removed from the endpoint:

[centos@ip-172-31-31-2 ~]$ globus-connect-server endpoint set-subscription-id null
Message: Updated Endpoint d4e44529-0ad8-41b6-9509-72bc42cf0732
  • 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