CLI Menu

Command Line Interface (CLI)
Installation
Installation PrerequisitesInstall in Virtualenv
CLI QuickStart GuideCommand Line Interface (CLI) ExamplesUsing the CLI with High Assurance Resources
Reference
CLI ChangelogGLOBUS BOOKMARK CREATE(1)GLOBUS BOOKMARK DELETE(1)GLOBUS BOOKMARK LIST(1)GLOBUS BOOKMARK RENAME(1)GLOBUS BOOKMARK SHOW(1)GLOBUS DELETE(1)GLOBUS ENDPOINT ACTIVATE(1)GLOBUS ENDPOINT CREATE(1)GLOBUS ENDPOINT DEACTIVATE(1)GLOBUS ENDPOINT DELETE(1)GLOBUS ENDPOINT IS-ACTIVATED(1)GLOBUS ENDPOINT LOCAL-ID(1)GLOBUS ENDPOINT MY-SHARED-ENDPOINT-LIST(1)GLOBUS ENDPOINT PERMISSION CREATE(1)GLOBUS ENDPOINT PERMISSION DELETE(1)GLOBUS ENDPOINT PERMISSION LIST(1)GLOBUS ENDPOINT PERMISSION SHOW(1)GLOBUS ENDPOINT PERMISSION UPDATE(1)GLOBUS ENDPOINT ROLE CREATE(1)GLOBUS ENDPOINT ROLE DELETE(1)GLOBUS ENDPOINT ROLE LIST(1)GLOBUS ENDPOINT ROLE SHOW(1)GLOBUS ENDPOINT SEARCH(1)GLOBUS ENDPOINT SERVER ADD(1)GLOBUS ENDPOINT SERVER DELETE(1)GLOBUS ENDPOINT SERVER LIST(1)GLOBUS ENDPOINT SERVER SHOW(1)GLOBUS ENDPOINT SERVER UPDATE(1)GLOBUS ENDPOINT SHOW(1)GLOBUS ENDPOINT UPDATE(1)GLOBUS GET-IDENTITIES(1)GLOBUS LIST-COMMANDS(1)GLOBUS LOGIN(1)GLOBUS LOGOUT(1)GLOBUS LS(1)GLOBUS MKDIR(1)GLOBUS RENAME(1)GLOBUS RM(1)GLOBUS SESSION SHOW(1)GLOBUS SESSION UPDATE(1)GLOBUS TASK CANCEL(1)GLOBUS TASK EVENT-LIST(1)GLOBUS TASK GENERATE-SUBMISSION-ID(1)GLOBUS TASK LIST(1)GLOBUS TASK PAUSE-INFO(1)GLOBUS TASK SHOW(1)GLOBUS TASK UPDATE(1)GLOBUS TASK WAIT(1)GLOBUS TRANSFER(1)GLOBUS UPDATE(1)GLOBUS VERSION(1)GLOBUS WHOAMI(1)
  1. Home
  2. Command Line Interface (CLI)
  3. Reference

GLOBUS ENDPOINT CREATE(1)

NAME

globus endpoint create - Create a new endpoint

SYNOPSIS

globus endpoint create 'OPTIONS' 'DISPLAY_NAME'

DESCRIPTION

The globus endpoint create command creates a new endpoint. A display name and exactly one of --personal, --server, or --shared is required to make a Globus Connect Personal, Globus Connect Server, or shared endpoint respectively.

OPTIONS

--personal

Create a Globus Connect Personal endpoint. The Setup Key printed will need to be given to Globus Connect Personal to make the endpoint functional. Mutually exclusive with --server and --shared.

--server

Create a Globus Connect Server endpoint. Additional server documents will need to be added with 'globus endpoint server add' to make the endpoint functional. Mutually exclusive with --server and --shared.

--shared 'HOST_ENDPOINT_ID:HOST_PATH'

Create a shared endpoint hosted on the given endpoint and path. Note that many of the options below cannot be set on shared endpoints as they are determined by the endpoint the shared endpoint is hosted on. Mutually exclusive with --personal and --server.

--description 'TEXT'

A description of this endpoint.

--info-link 'TEXT'

A link to info about this endpoint.

--contact-info 'TEXT'

Contact info for this endpoint.

--contact-email 'TEXT'

Contact email for this endpoint.

--organization 'TEXT'

Organization that runs this endpoint.

--department 'TEXT'

Department that operates this endpoint.

--keywords 'TEXT,…​'

Comma seperated list of keywords to help searches for this endpoint.

--default-directory 'PATH'

Default directory to use on this endpoint.

--force-encryption / --no-force-encryption

(Un)Set this endpoint to force encryption of transfer data channels to and from itself.

--disable-verify/--no-disable-verify

(Un)Set this endpoint to not use checksum verification of transfered data.

--public / --private

Set this endpoint to be (in)visible to other users searching for endpoints. (Globus Connect Server endpoints only, all Globus Connect Personal endpoints are private and all shared endpoints are public)

--myproxy-dn 'DOMAIN_NAME'

Set the MyProxy Server domain name for this endpoint. (Globus Connect Server endpoints only)

--myproxy-server 'URI'

Set the MyProxy Server URI for this endpoint. (Globus Connect Server endpoints only)

--oauth-server 'URI'

Set the OAuth Server URI for this endpoint (Globus Connect Server endpoints only)

--location 'LATTITUDE,LONGITUDE'

Manually set this endpoint’s latitude and longitude with two comma separated floats. Overrides automatic location approximation. (Globus Connect Server endpoints only)

--managed/--no-managed

(Un)set this endpoint as a managed endpoint. If setting, the user must be a subscription manager, and the user’s default subscription ID will be used. If the user has more than one subscription ID, --subscription-id must be used instead to specify one of them. --no-managed is mutually exclusive with --subscription-id.

--subscription-id 'SUBSCRIPTION_ID'

Set the endpoint as managed with the given subscription ID. Mutually exclusive with --no-managed.

--network-use '[ normal | minimal | aggressive | custom ]'

Set this endpoint’s network use level. If using custom, this endpoint’s max and preferred concurrency and parallelism must be set. (Managed endpoints only) (Globus Connect Server endpoints only)

--max-concurrency 'INT'

Set this endpoint’s max concurrency; requires --network-use=custom (Managed endpoints only) (Globus Connect Server endpoints only)

--preferred-concurrency 'INT'

Set this endpoint’s preferred concurrency; requires --network-use=custom (Managed endpoints only) (Globus Connect Server endpoints only)

--max-parallelism 'INT'

Set this endpoint’s max parallelism; requires --network-use=custom (Managed endpoints only) (Globus Connect Server endpoints only)

--preferred-parallelism 'INT'

Set this endpoint’s preferred parallelism; requires --network-use=custom (Managed endpoints only) (Globus Connect Server endpoints only)

--map-http-status 'TEXT'

Map non success HTTP response codes to exit codes other than 1. e.g. "--map-http-satus 403=0,404=0" would exit with 0 even if a 403 or 404 http error code was received. Valid exit codes are 0,1,50-99.

-F, --format '[json|text]'

Set the output format for stdout. Defaults to "text".

--jq, --jmespath 'EXPR'

Supply a JMESPath expression to apply to json output. Takes precedence over any specified '--format' and forces the format to be json processed by this expression.

A full specification of the JMESPath language for querying JSON structures may be found at https://jmespath.org/

-h, --help

Show help text for this command.

-v, --verbose

Control the level of output.

Use -v or --verbose to show warnings and any additional text output.

Use -vv to add informative logging.

Use -vvv to add debug logging and full stack on any errors. (equivalent to -v --debug)

EXAMPLES

Create a Globus Connect Personal endpoint:

$ globus endpoint create --personal my_gcp_endpoint

Create a Globus Connect Server endpoint:

$ globus endpoint create --server my_gcs_endpoint

Create a shared endpoint hosted on another endpoint:

$ host_ep=ddb59aef-6d04-11e5-ba46-22000b92c6ec
$ globus endpoint create --shared host_ep:~/ my_shared_endpoint

EXIT STATUS

0 on success.

1 if a network or server error occurred, unless --map-http-status has been used to change exit behavior on http error codes.

2 if the command was used improperly.

© 2010- The University of Chicago Legal