Creating a VPC in a different region

Logging in to a specific region by using the CLI

When you log in to IBM Cloud®, you can specify a region or choose it later. For example, to log in to the global API endpoint in the Dallas (us-south) region directly, run the following commands. These commands vary according to whether you have a federated account (SSO) or a non-federated account.

For a federated account,

ibmcloud login -a https://cloud.ibm.com -r us-south --sso

For a non-federated account,

ibmcloud login -a https://cloud.ibm.com -r us-south

To choose the region later, do not specify the -r <region> parameter and the CLI prompts you to choose a region.

Example output:

API endpoint: cloud.ibm.com

Get One Time Code from https://identity-2.eu-central.iam.cloud.ibm.com/identity/passcode to proceed.
Open the URL in the default browser? [Y/n]> y
One Time Code >
Authenticating...
OK

Select an account:
1. MyAccount (00a11aa1a11aa11a1111a1111aaa11aa) <-> 1234567
2. TeamAccount (2bb222bb2b22222bbb2b2222bb2bb222) <-> 7654321
Enter a number> 2
Targeted account TeamAccount (2bb222bb2b22222bbb2b2222bb2bb222) <-> 7654321


Targeted resource group Default

Select a region (or press enter to skip):
1. au-syd
2. in-che
3. jp-osa
4. jp-tok
5. kr-seo
6. eu-de
7. eu-es
8. eu-gb
9. ca-tor
10. us-south
11. us-east
12. br-sao

Enter a number> 12

Targeted region us-south


API endpoint:      https://cloud.ibm.com
Region:            us-south
User:              first.last@email.com
Account:           TeamAccount (2bb222bb2b22222bbb2b2222bb2bb222) <-> 7654321
Resource group:    Default
CF API endpoint:
Org:
Space:

...

Switch regions by using the CLI

To get the latest status of the VPC regions, run the following command:

ibmcloud is regions

To switch to a different region, run the ibmcloud target -r <region> command. For example, to switch to the Washington DC region, run the following command:

ibmcloud target -r us-east

To check your current location, run the following command:

ibmcloud target

Switch regions by using the API

To interact with the Regional VPC API by using REST, direct your request to the API endpoint that is associated with the region in which you want to create resources. The region's API endpoint is shown in the previous table. You also can find the endpoints that are associated with the regions by running the following command:

ibmcloud is regions

For example, to get the list of VPCs in the us-south region, run the following command:

curl "https://us-south.iaas.cloud.ibm.com/v1/vpcs?version=$api_version&generation=2" -H "Authorization: $iam_token"

Get zones by using the CLI

To get the list of zones available for each region, run the command ibmcloud is zones in the target region. In the following example, the first command switches the target to us-south region. The second command lists the available zones.

ibmcloud target -r us-east; ibmcloud is zones
Switched to region us-east

API endpoint:      https://cloud.ibm.com
Region:            us-east
User:              test.user@ibm.com
Account:           Test Account (a1234567) <-> 1414935
Resource group:    No resource group targeted, use 'ibmcloud target -g RESOURCE_GROUP'
CF API endpoint:
Org:
Space:
Listing zones in target region us-east under account Test Account as user test.user@ibm.com...
Name         Universal name      Data center    Region      Status
us-south-1   us-south-dal13-a    DAL13          us-south    available
us-south-2   us-south-dal14-a    DAL14          us-south    available
us-south-3   us-south-dal10-a    DAL10          us-south    available

For more information about available command options, see ibmcloud is zones.