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