Skip to content

Latest commit

 

History

History
169 lines (127 loc) · 5.56 KB

cs_regions.md

File metadata and controls

169 lines (127 loc) · 5.56 KB
copyright lastupdated
years
2014, 2017
2017-10-18

{:new_window: target="_blank"} {:shortdesc: .shortdesc} {:screen: .screen} {:pre: .pre} {:table: .aria-labeledby="caption"} {:codeblock: .codeblock} {:tip: .tip} {:download: .download}

Regions and locations

{{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

{{site.data.keyword.Bluemix_notm}} region API endpoints

{: #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}


{{site.data.keyword.containershort_notm}} region API endpoints and locations

{: #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.

Logging in to a different container service region

{: #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}

Creating lite clusters in container service regions

{: #lite_regions}

You can create Kubernetes lite clusters in the following regions:

  • AP South
  • EU Central
  • UK South
  • US South

Locations available for the container service

{: #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

Using container service API commands

{: #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.