ibmcloud-{api,config,logout,regions,target}: add pages

pages/common/ibmcloud-api.md

@@ -0,0 +1,28 @@
+# ibmcloud api
+
+> Set or view the IBM Cloud API endpoint.
+> More information: <https://cloud.ibm.com/docs/cli?topic=cli-ibmcloud_cli#ibmcloud_api>.
+
+- View the current API endpoint:
+
+`ibmcloud api`
+
+- Set the API endpoint to `cloud.ibm.com`:
+
+`ibmcloud api cloud.ibm.com`
+
+- Set a private API endpoint:
+
+`ibmcloud api private.cloud.ibm.com`
+
+- Use a VPC connection for a private endpoint:
+
+`ibmcloud api private.cloud.ibm.com --vpc`
+
+- Bypass SSL validation of HTTP requests:
+
+`ibmcloud api https://cloud.ibm.com --skip-ssl-validation`
+
+- Remove the API endpoint setting:
+
+`ibmcloud api --unset`

pages/common/ibmcloud-config.md

@@ -0,0 +1,28 @@
+# ibmcloud config
+
+> Modify or read out values in the IBM Cloud CLI configuration.
+> More information: <https://cloud.ibm.com/docs/cli?topic=cli-ibmcloud_cli#ibmcloud_config>.
+
+- Set HTTP request timeout to 30 seconds:
+
+`ibmcloud config --http-timeout 30`
+
+- Enable trace output for HTTP requests:
+
+`ibmcloud config --trace true`
+
+- Trace HTTP requests to a specific file:
+
+`ibmcloud config --trace {{path/to/trace_file}}`
+
+- Disable color output:
+
+`ibmcloud config --color false`
+
+- Set the locale to a specific language:
+
+`ibmcloud config --locale {{zh_Hans}}`
+
+- Enable automatic SSO one-time passcode acceptance:
+
+`ibmcloud config --sso-otp auto`

pages/common/ibmcloud-logout.md

@@ -0,0 +1,8 @@
+# ibmcloud logout
+
+> Log out of the IBM Cloud CLI.
+> More information: <https://cloud.ibm.com/docs/cli?topic=cli-ibmcloud_cli#ibmcloud_logout>.
+
+- Log out of the current session:
+
+`ibmcloud logout`

pages/common/ibmcloud-regions.md

@@ -0,0 +1,8 @@
+# ibmcloud regions
+
+> List all available regions on IBM Cloud.
+> More information: <https://cloud.ibm.com/docs/cli?topic=cli-ibmcloud_cli#ibmcloud_regions>.
+
+- View information for all regions:
+
+`ibmcloud regions`

pages/common/ibmcloud-target.md

@@ -0,0 +1,28 @@
+# ibmcloud target
+
+> Set or view the target account, region, or resource group.
+> More information: <https://cloud.ibm.com/docs/cli?topic=cli-ibmcloud_cli#ibmcloud_target>.
+
+- View the current target account and region:
+
+`ibmcloud target`
+
+- Set the target account:
+
+`ibmcloud target -c {{account_id}}`
+
+- Switch to a specific region:
+
+`ibmcloud target -r {{region_name}}`
+
+- Set the target resource group:
+
+`ibmcloud target -g {{resource_group_name}}`
+
+- Clear the targeted region:
+
+`ibmcloud target --unset-region`
+
+- Clear the targeted resource group:
+
+`ibmcloud target --unset-resource-group`