v0.20.0

This version is deprecated. Install the latest release.

Change logs

Use binary archive to upgrade CLI for macOS

Now ibmcloud update command uses binary archive instead of installer to upgrade IBM Cloud CLI for macOS.

Prompt potential break change when upgrade CLI and plug-ins

Starting from this release, if the major number of version increases (e.g. 1.2.3 --> 2.0.0) when upgrading CLI and plug-ins, the user will be prompted for confirmation. -f option can be used to suppress this prompt.

Resource reclamation

A group of commands are added under resource to list, restore and clean permanently the deleted resources.

Show release notes link when upgrading plug-ins

Starting from this release, an optional release note link can be provided when publishing a plugin. If the link is available, it will be shown to the user when the plugin is installed/upgraded.

---

New Commands

• The following commands are added under resource :
  • reclamations: List resource reclamations
  • reclamation-restore: Restore a resource reclamation
  • reclamation-delete: Delete a resource reclamation

Updated Commands

• update:
  • use binary archive for upgrade on macOS
  • prompt if there are potential break changes
• plugin update:
  • show release notes link if it's available
  • prompt if there are potential break changes
• account user-invite: the following options are deprecated
  • -o, --org, --org-role
  • -s, --space, --space-role
  • -r, --region

Defect Fixing

• Input of --region is not validated in the following commands
  • iam user-policy-create, iam user-policy-update
  • iam service-policy-create, iam service-policy-update
  • iam access-policy-create, iam access-policy-update
• Wrong ID value is used in the following commands when specifying access policy of a service instance:
  • iam user-policy-create, iam user-policy-update
  • iam service-policy-create, iam service-policy-update
  • iam access-policy-create, iam access-policy-update

Other Changes

• Upgrade embedded CloudFoundry CLI to 6.46.1
• Upgrade to Go Lang 1.13.3
• Improve performance in loading plug-ins
• Improve performance of iam access-group-user-add

v0.19.0

This version is deprecated. Install the latest release.

Change logs

Support custom attributes in IAM access policy

This release adds --attributes option to access policy commands. This allows user to specify custom attributes in the IAM policy other than the pre-defined ones.

Support authorization policy roles

Now roles specific to authorization policies can be specified in iam authorization-policy-create. iam roles command is also updated to query these roles by specifying the source service.

Support transparent roles

This release supports the query of actions that each IAM role can perform. iam roles command does not show the actions by default, use --roles option instead to specify the roles that you want to see the detailed actions.

Updated Commands

• iam access-group-delete: adds -a option to delete all groups with the same name without confirmation
• --attributes option is added to the following commands to specify custom attributes in IAM policy
  • iam user-policy-create, iam user-policy-update
  • iam service-policy-create, iam service-policy-update
  • iam access-group-policy-create, iam access-group-policy-update
• iam roles: adds --resource-type, --source-service and --roles options
• login: show deprecation message if -o or -s is specified

Bug Fixes

• authorization-policy-create: CRN is displayed for some service instances instead of their GUID
• legacy CLI app name bx is printed in the help message of sl commands

v0.18.2

This version is deprecated. Install the latest release.

Change logs

This release contains a few changes.

Updated Commands

• plugin install: support semantic versioning for -v option. For details, see the command help.

Bug Fixes

• resolve multiple nil pointer exceptions in commands under sl namespace

Other Changes

• upgrade to Go 1.12.9

v0.18.1

This version is deprecated. Install the latest release.

Change logs

This release contains a few bug fixes and minor changes.

Updated Commands

• plugin list: when there is any error during retrieving plugin information, the command exit code will still be 0 (i.e. success). This change is to make it easier to write automation scripts.
• billing enterprise-usage: numbers are rounded off to 2 decimal places

Defect Fixes

• billing enterprise-usage: JSON unmarshal error regarding number types
• sl securitygroup interface-list: nil pointer error

v0.18.0

This version is deprecated. Install the latest release.

Change logs

This release adds a set of new command lines to manage IBM Cloud enterprise account, account groups and accounts in an enterprise, as well as usage/billing of an enterprise.

IBM Cloud enterprises provide a way to centrally manage billing and resource usage across multiple accounts. Within an enterprise, you create a multitiered hierarchy of accounts, with billing and payments for all accounts managed at the enterprise level.

New Commands

• enterprise create: create an enterprise
• enterprise update: update the name of an enterprise
• enterprise show: show the details of an enterprise
• enterprise account-group-create: create an account group under an enterprise or account group
• enterprise account-group-update: update the name of an account group
• enterprise account-group: show the details of an account group
• enterprise account-groups: list the account groups under an enterprise account or account group
• enterprise account-create: create an account under an enterprise or account group
• enterprise account-move: move an account to a different account group or directly under enterprise account
• enterprise account-show: show the details of an account in an account group or enterprise
• enterprise account-import: import a stand-alone account into an account group or enterprise
• billing enterprise-usage: retrieve usage report of an enterprise

v0.17.0

This version is deprecated. Install the latest release.

Change logs

Updated Commands

• account audit-logs: if both --start-date and --end-date are specified, all logs in-between will be printed.
• account update: improves prompt message of how to enable CSE.
• catalog search --output JSON and catalog service --output JSON: only i18n strings of current locale are returned in the json output
• catalog template: adds --output option
• help: updates layout of the help message
• resource service-instance: shows the name of who created the service instance instead of UUID
• improves prompt messages when refresh token expires
• add --output options to the following commands under account namespace
  • audit-logs
  • list
  • org-account
  • org-roles
  • space-roles

Defect Fixing

• iam access-group-user-add returns zero when command partially succeeds
• login inaccurate error message when logging using API key into an account which the current user doesn't belong to anymore
• login fails when deprecated Bluemix API endpoint is targeted and -o is specified
• [y/n] in prompt is translated

Other Changes

• Upgrade to Go 1.12.7

Breaking Changes

• Default resource group will NOT be targeted if -g is not specified in login and target commands. This will have impact on the some commands under resource namespace, because if you don't target a resource group, then they will assume to target at all resource groups. Besides, the following commands will fail if no resource group is targeted.
  • cf-service-instance-migrate
  • service-instance-create

v0.16.3

This version is deprecated. Install the latest release.

Change logs

Removed Commands

• remove all commands under sl cdn namespace, given Softlayer CDN service is sunset

Defect Fixing

• iam access-group-user-add: user ID email should be treated as case insensitive
• commands under sl namespace do not honor language setting
• billing account-usage: non-chargeable costs should have No charge indication

v0.16.2

This version is deprecated. Install the latest release.

Change logs

Updated Commands

• sl order place: support more order types

Defect Fixing

• login, target: failed with 403 when targeting a resource group with name if the user doesn't have admin permission. This is a regression of version 0.16.1.
• sl snapshot list: column name should be user_name
• resource tag-attach, resource tag-detach: incorrect processing of --resource-id value

v0.16.1

This version is deprecated. Install the latest release.

Change logs

Use account owner user ID to target an account

Now account owner user ID (normally an email ) can be used as the value of -c flag of login and target commands. Note that a user can be the owner of multiple accounts. In this case, user will be be prompted for selection. GUID is still recommended in automation script to avoid suspending of the script execution.

Use resource group GUID to target resource group

Resource group GUID now can be used as the value of -g flag of login and target commands. This will help avoid error when the account has multiple resource groups with same name.

Fallback to default auto-completion

If no specific auto-completion is available, the CLI will fallback to default auto-completion logic of the current shell. With his feature, the user will be able to select a local file when specifying the input value of flags.

SoftLayer Infrastructure Rebranding

SoftLayer CLI description is changed from Gen1 Infrastructure to Classic Infrastructure

Updated commands

• sl cdn options: refines message when response is empty
• help: updates help doc link to https://ibm.biz/cli-docs
• resource service-instance-create, resource service-instance-update: adds description of possible values for --service-endpoints flag
• resource service-key-create, resource service-binding-create: adds description of possible values for --service-endpoint flag
• plugin list, plugin show: shows stage information
• cfee:
  • create:
    • NAME LOCATION arguments are changed into -n, --name and --location
    • adds --virtual-dedicated-hardware and --private-access flags
  • create-location: adds --output flag
  • create-permission-get, create-permission-set: changes one target permission from developer role to the current space in the current org for provisioning Compose for PostgreSQL to editor role to the Databases for PostgreSQL service
  • environments: adds Zones output

Defect Fixing

• service-instance-create: erroneous search logic which may result in false errors r
• iam service-key-create, iam service-key: output order is random
• access-group-user-add: fail to add a user to access group if teamDirectory is false

v0.16.0

This version is deprecated. Install the latest release.

Change logs

Automatically change *.bluemix.net API endpoint to cloud.ibm.com for IBM Cloud public

If *.bluemix.net API endpoint is used for public cloud, they will be changed automatically to https://cloud.ibm.com

Customize the installation of bundled Cloud Foundry CLI

Starting from this release, ibmcloud cf install can be used to install a different version of Cloud Foundry CLI than the default bundled one. To restore the originally version, run ibmcloud cf install --restore.

Add "stage" support for namespaces and commands

A stage attribute is added to namespaces and commands, which will be highlighted in the description of the namespace and command. The stage can be "Experimental", "Beta" or "Deprecated".

Support auto-completion delegation to plug-ins

This release supports delegating auto-completion to plug-ins. Refer to plugin example for how to use it.

New commands

• cf install : install a different version of CF CLI to replace the default bundled one.

Updated commands

• iam authorization-poicy-create adds --source-service-account flag to specify a different account than the current account.
• --output JSON flag is added to the following commands under iam namespace:
  • oauth-tokens
  • roles
  • access-groups
  • access-group
  • access-group-create
  • access-group-update
  • access-group-users
  • access-group-service-ids
  • access-group-policies
  • access-group-policy
  • access-group-policy-create
  • access-group-policy-update
  • api-keys
  • api-key-create
  • api-key-update
  • service-api-keys
  • service-api-key
  • service-api-key-create
  • service-api-key-update
  • service-ids
  • service-id
  • service-id-create
  • service-id-update
  • service-policies
  • service-policy
  • service-policy-create
  • service-policy-update
  • user-policies
  • user-policy
  • user-policy-create
  • user-policy-update

Other Change

• Upgrade bundled Cloud Foundry CLI to 6.41.0
• Upgrade Go lang to 1.12.4