copyright | lastupdated | ||
---|---|---|---|
|
2017-10-18 |
{:new_window: target="_blank"} {:shortdesc: .shortdesc} {:screen: .screen} {:pre: .pre} {:table: .aria-labeledby="caption"} {:codeblock: .codeblock} {:tip: .tip} {:download: .download}
{{site.data.keyword.Bluemix}} is hosted worldwide. A region is a geographic area that is accessed by an endpoint. Locations are data centers within the region. Services within {{site.data.keyword.Bluemix_notm}} might be available globally, or within a specific region. {:shortdesc}
{{site.data.keyword.Bluemix_notm}} regions differ from {{site.data.keyword.containershort_notm}} regions.
Supported {{site.data.keyword.containershort_notm}} regions:
- AP South
- EU Central
- UK South
- US East
- US South
{: #bluemix_regions}
You can organize your resources across {{site.data.keyword.Bluemix_notm}} services by using {{site.data.keyword.Bluemix_notm}} regions. For example, you can create a Kubernetes cluster by using a private Docker image that is stored in your {{site.data.keyword.registryshort_notm}} of the same region. {:shortdesc}
To check which {{site.data.keyword.Bluemix_notm}} region you are currently in, run bx info
and review the Region field.
{{site.data.keyword.Bluemix_notm}} regions can be accessed by specifying the API endpoint when you log in. If you do not specify a region, you are automatically logged in to the region that is closest to you.
{{site.data.keyword.Bluemix_notm}} region API endpoints with example log in commands:
-
US South and US East
bx login -a api.ng.bluemix.net
{: pre}
-
Sydney
bx login -a api.au-syd.bluemix.net
{: pre}
-
Germany
bx login -a api.eu-de.bluemix.net
{: pre}
-
United Kingdom
bx login -a api.eu-gb.bluemix.net
{: pre}
{: #container_regions}
By using {{site.data.keyword.containershort_notm}} regions, you can create or access Kubernetes clusters in a region other than the {{site.data.keyword.Bluemix_notm}} region that you are logged in to. {{site.data.keyword.containershort_notm}} region endpoints refer specifically to the {{site.data.keyword.containershort_notm}}, not {{site.data.keyword.Bluemix_notm}} as a whole. {:shortdesc}
{{site.data.keyword.containershort_notm}} region API endpoints:
- AP South:
https://ap-south.containers.bluemix.net
- EU Central:
https://eu-central.containers.bluemix.net
- UK South:
https://uk-south.containers.bluemix.net
- US East:
https://us-east.containers.bluemix.net
- US South:
https://us-south.containers.bluemix.net
Note: US East is available for use with CLI commands only.
To check which {{site.data.keyword.containershort_notm}} region you are currently in, run bx cs api
and review the Region field.
{: #container_login_endpoints}
You might want to log in to another {{site.data.keyword.containershort_notm}} region for the following reasons:
- You created {{site.data.keyword.Bluemix_notm}} services or private Docker images in one region and want to use them with {{site.data.keyword.containershort_notm}} in another region.
- You want to access a cluster in a region that is different from the default {{site.data.keyword.Bluemix_notm}} region you are logged in to.
Example commands to log in to an {{site.data.keyword.containershort_notm}} region:
-
AP South:
bx cs init --host https://ap-south.containers.bluemix.net
{: pre}
-
EU Central:
bx cs init --host https://eu-central.containers.bluemix.net
{: pre}
-
UK South:
bx cs init --host https://uk-south.containers.bluemix.net
{: pre}
-
US East:
bx cs init --host https://us-east.containers.bluemix.net
{: pre}
-
US South:
bx cs init --host https://us-south.containers.bluemix.net
{: pre}
{: #lite_regions}
You can create Kubernetes lite clusters in the following regions:
- AP South
- EU Central
- UK South
- US South
{: #locations}
Locations are data centers that are available within a region.
Region | Location | City |
---|---|---|
AP South | mel01, syd01, syd04 | Melbourne, Sydney |
EU Central | ams03, fra02 | Amsterdam, Frankfurt |
UK South | lon02, lon04 | London |
US East | wdc06, wdc07 | Washington, DC |
US South | dal10, dal12, dal13 | Dallas |
{: #container_api}
To interact with the {{site.data.keyword.containershort_notm}} API, enter the command type and append /v1/command
to the endpoint.
Example of GET /clusters
API in US South:
GET https://us-south.containers.bluemix.net/v1/clusters
{: codeblock}
To view documentation on the API commands, append swagger-api
to the endpoint for the region to view.
- AP South: https://ap-south.containers.bluemix.net/swagger-api/
- EU Central: https://eu-central.containers.bluemix.net/swagger-api/
- UK South: https://uk-south.containers.bluemix.net/swagger-api/
- US East: https://us-east.containers.bluemix.net/swagger-api/
- US South: https://us-south.containers.bluemix.net/swagger-api/