endpoint-list - Show information about endpoints
endpoint-list [OPTIONS] [PATTERN…]
endpoint-list shows information about endpoints. Each endpoint has one or more servers, represented by a URL and an optional subject DN. Each endpoint may also have a short term security credential which has been assigned by the endpoint-activate command.
By default, endpoint-list displays concise output and only lists the endpoint name (in fully qualified user#name format) and the hours, minutes, and seconds remaining until its security credential expires. If a credential does not exist or has expired, a "-" will be displayed as the time remaining. Use the -v option to display more fields.
The PATTERN may contain asterisk ("
*") characters for wildcard matching of
endpoint names. The default pattern is "
Use the -p option to display public endpoints shared by other users. Without -p, endpoint-list displays endpoints owned by the current user and any public endpoints that have previously been activated by the current user.
See endpoint-modify for advanced options not listed here.
The user specified legacy name (DEPRECATED)
The system-generated, globally-unique UUID
The user specified name
A comma separated list of server URL(s) associated with this endpoint.
A comma separated list of subject DN(s) corresponding to each server URL.
The underlying logical endpoint (for shared endpoints)
The status of the credential. Possible values are:
A credential exists and has not expired
A credential exists and has expired
No credential exists
The date and time the credential expires
The subject DN of the credential
The hours, minutes, and seconds remaining until the credential expires.
For a S3 endpoint, this is "n/a". For a shared endpoint, this is the location of its host endpoint. For other endpoints, this is either "Automatic", meaning it has not been set by the administrator, or a "<latitude>,<longitude>" pair. See endpoint-modify for details.
See the endpoint-modify --network-use option for details.
The max and preferred values show the current computed values for the endpoint, taking into account its number of physical endpoints.
Display public endpoints shared by other users.
Display all fields. Also turns on long output format.
- -f field[,field2]…
Select field(s) to display. If field is "all", all possible fields are selected. If field is "help", all possible field names are printed and the program will exit.
- -O format
Select the output format. Formats are:
A human readable format with one field per line. Records are delimited by a blank line.
CSV format with no headers
CSV format with field headers on the first line
A basic key=value format with one record per line. Characters such as whitespace are url-encoded.
List all public endpoints:
$ endpoint-list -p
List endpoints I own or have recently used:
$ endpoint-list *
List public endpoints of the "teragrid" user:
$ endpoint-list -p teragrid#*
List detailed information about endpoints:
$ endpoint-list -v my_endpoint1 my_endpoint2