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