Last modified January 26, 2018
gsctl list endpoints
gsctl list endpoints command shows all endpoints you have logged in to so far with additional information.
An endpoint is the Giant Swarm API URL for an installation you access using gsctl. If you have only one installation, you have only one endpoint. But if you are using, for example, one installation on-premises and one in the cloud, you have two endpoints.
Usage and Output
The command has no specific flags. Simply run it like this:
$ gsctl list endpoints
If you have ever logged in to an endpoint before, you will get a table like the one below as a result:
ALIAS ENDPOINT URL EMAIL SELECTED LOGGED IN cloudy https://api.g8s.cloudy.eu-central-1.aws.gigantic.io email@example.com yes yes onpremy https://api.g8s.onpremy.my-datacenter.gigantic.io firstname.lastname@example.org no yes
- The first column shows the endpoint alias which you can use as a shorthand to
select this endpoint. See
gsctl select endpointfor details.
Note: If the column shows
n/a, the endpoint has been added with a
gsctl version before 0.10.0. You can manually edit the configuration file to
remove the according endpoint and then re-login.
Column two shows the full endpoint URL.
SELECTEDcolumn informs you which one of the endpoints listed is currently selected. This means that you will work with this endpoint, unless you specify a different endpoint using the
--endpointcommand line flag.
LOGGED INindicates whether you are currently logged in with the endpoint.