Über die Befehlszeilenschnittstelle bei einer bestimmten Region anmelden

Wenn Sie sich bei IBM Cloud®anmelden, können Sie eine Region angeben oder sie später auswählen. Wenn Sie sich beispielsweise direkt beim globalen API-Endpunkt in der Region Dallas (us-south) anmelden wollen, führen Sie die folgenden Befehle aus. Diese Befehle variieren abhängig davon, Sie ein föderiertes Konto (SSO) oder ein nicht föderiertes Konto besitzen.

Geben Sie für ein föderiertes Konto den folgenden Befehl an:

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

Geben Sie für ein nicht föderiertes Konto den folgenden Befehl an:

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

Um die Region später auszuwählen, geben Sie den -r <region>-Parameter nicht an und die Befehlszeilenschnittstelle fordert Sie auf, eine Region auszuwählen.

Beispielausgabe:

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:

...

Über die Befehlszeilenschnittstelle zwischen Regionen wechseln

Führen Sie den folgenden Befehl aus, um den aktuellen Status der VPC-Regionen abzurufen:

ibmcloud is regions

Führen Sie den Befehl ibmcloud target -r <region> aus, um zu einer anderen Region zu wechseln. Führen Sie beispielsweise den folgenden Befehl aus, um in die Region 'Washington DC' zu wechseln:

ibmcloud target -r us-east

Führen Sie den folgenden Befehl aus, um den aktuellen Standort zu prüfen:

ibmcloud target

Über die API zwischen Regionen wechseln

Wenn Sie über REST mit der regionalen API für VPC interagieren wollen, richten Sie Ihre Anforderung an denjenigen API-Endpunkt, der der Region zugeordnet ist, in der Sie Ressourcen erstellen möchten. Der API-Endpunkt der jeweiligen Region ist in der vorherigen Tabelle angegeben. Die Endpunkte, die den Regionen zugeordnet sind, können Sie auch mit dem folgenden Befehl ermitteln:

ibmcloud is regions

Führen Sie zum Beispiel den folgenden Befehl aus, um die Liste der VPCs in der Region us-south abzurufen:

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

Zonen über die Befehlszeilenschnittstelle abrufen

Um die Liste der für jede Region verfügbaren Zonen zu erhalten, führen Sie den Befehl ibmcloud is zones in der Zielregion aus. Im folgenden Beispiel schaltet der erste Befehl das Ziel in die us-south-Region um. Der zweite Befehl listet die verfügbaren Zonen auf.

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

Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter ibmcloud is zones.