v0.6.6

This version is deprecated. Install the latest release.

Change logs

Several change in login

• Add -g flag to specify the targeted resource group
• Show detailed message when authentication fails
• Enforce account selection when the user is associated with account(s)
• Target the account automatically when specifying org with -o option
• Deprecate -o and -s flags ( use target to specify CF org and space)

Updated Commands

• For billing commands listed below, remove the restriction of account owner.
  • account-usage, resource-group-usage, resource-instances-usage, org-usage
• service-instance-create command:
  • Prompt for selection if multiple deployments have the same name
  • Add --deployment flag to resolving duplicated deployment names
• bx update -f uses silent install mode ( root privilege is required)

Fixed defects

• login -o does not set org in non-public environment
• iam authorization-policies shows nothing when there is no authorization policy(should show "not found" message)
• cf ssh hangs in windows version
• cf [command] lost color in windows version
• account org lost inlined properties(domain, quota) of an organization
• Incorrect command usage description in iam service-api-key-delete
• Fix a regression which breaks autocomplete on macOS

v0.6.5

This version is deprecated. Install the latest release.

Change logs

Add support for authorization policy

A few IAM policy commands are added to provide service-to-service authorization support.

Add resource group support for billing commands

This release moves to a new version of billing and usage api which enables the capability to query usage summary by resource group and resource instance usage details in a given resource group or organization.

New commands

• iam authorization-policies： list authorization policies under current account
• iam authorization-policy: show details of an authorization policy
• iam authorization-policy-create: create an authorization policy
• iam authorization-policy-delete: delete an authorization policy
• billing resource-group-usage: show monthly usage for a resource group
• billing resource-instances-usage: show monthly resource instances usage
• catalog runtimes: show the list of runtimes
• catalog runtime: show the details of a runtime

Updated commands

• bluemix resource service-instance-update: remove --update-time option

Fixed defects

• Error message for unregistered commands is not translated
• bash: PROGS: readonly variable warning message in bash shell sessions

v0.6.4

This version is deprecated. Install the latest release.

Change logs

Enable parameters when creating resource binding and resource key

-p, --parameters flag is provided in resource service-binding-create and resource service-key-create commands to support custom parameters.

Adopt POSIX sh as the default shell environment for Linux and macOS installers

Some bashisms are removed from install scripts to make installers work under POSIX sh (i.e. #!/bin/sh),

Updated commands

• bluemix update add -f flag to to force update without confirmation
• bluemix api and bluemix login show information regarding how to disable version check

v0.6.3

This version is deprecated. Install the latest release.

Change logs

Move from global catalog API v1-bata to v1

This release moves to v1 API of global catalog, and incorporates several catalog metadata changes in v1 API.

Refresh configurations before running commands

This version now checks the integrity of the configurations, and refresh them if necessary, before running a command.

Rebranding from 'Bluemix' to 'IBM Cloud'

This release changes the word Bluemix in command descriptions, help messages and installers to IBM Cloud. Commands syntax stays unchanged.

Softlayer command line enhancements

This release adds several new commands for Softlayer block storage service, security group and virtual servers.

New commands

• sl block access-password change a password for a volume's access
• sl block volume-count list number of block storage volumes per datacenter
• sl block volume-set-lun-id set the LUN ID on an existing block storage volume
• sl file volume-count list number of file storage volumes per datacenter
• sl securitygroup create create a security group
• sl securitygroup list list security groups
• sl securitygroup delete delete the given security group
• sl securitygroup detail get details about a security group
• sl securitygroup edit edit details of a security group
• sl securitygroup interface-add attach an interface to a security group
• sl securitygroup interface-list list interfaces associated with security group
• sl securitygroup interface-remove detach an interface from a security group
• sl securitygroup rule-add add a security group rule to a security group
• sl securitygroup rule-edit edit a security group rule in a security group
• sl securitygroup rule-list list security group rules
• sl securitygroup rule-remove remove a rule from a security group
• sl vs host-create create a host for dedicated virtual servers
• sl vs host-list list dedicated hosts on your account

Updated commands

• resource service-instance-create changes -r option to LOCATION argument
• plugin show now shows the SDK version
• regions lists public regions if no api endpoint set
• iam service-policy-update and iam user-policy-update resets the policy definition from inputs, instead of applying incremental changes

Defect fixing

• app domain-cert-add doesn't encode password

other changes

• Improve error handling for some commands

v0.6.2

This version is deprecated. Install the latest release.

Change logs

Public IAM support for dedicated environments

This release enables the dedicated environment users to be able to authenticate with public IAM service and connect the IBM ID for public cloud with existing dedicated ID. This allows the dedicated users to be able to use public IAM service for authentication and access policy management.

Identity and access management enhancements

This release incorporates the following changes in identify and access management

• uses service-id as argument to create/update/delete service api key, instead of "bound_to" CRN
• adopts global IAM service endpoint
• adds resource group scope support for IAM policies

NTLM proxy support for Windows

The Windows version now supports NTLM proxy authentication. If environment variable NTLM_PROXY is set, then Bluemix cli uses NTLM protocol to authenticate with the proxy specified by HTTPS_PROXY. The bundled cf will do the same.

Resource control command refactoring

This release has several changes on the resource control command names, argument/option names and help messages for the consistency of terminologies.

• resource instances changes to resource service-instances
• resource instance changes to resource service-instance
• resource instance-create changes to resource service-instance-create
• resource instance-update changes to resource service-instance-update
• resource instance-delete changes to resource service-instance-delete
• resource key-create changes to resource service-key-create
• resource keys changes to resource service-keys
• resource key changes to resource service-key
• resource key-delete changes to resource service-key-delete
• resource bindings changes to resource service-bindings
• resource binding changes to resource service-binding
• resource binding-create changes to resource service-binding-create
• resource binding-delete changes to resource service-binding-delete
• resource aliases changes to resource service-aliases
• resource alias changes to resource service-alias
• resource alias-create changes to resource service-alia-create
• resource alias-update changes to resource service-alia-update
• resource alias-delete changes to resource service-alia-delete

New commands

• resource group-create create a resource group under an account besides the default resource group of the account
• iam dedicated-id-disconnect to tear down the connection between public IBM ID and ID of the dedicated environment
• catalog service shows details of a catalog entry
• catalog locations list deployment environments geolocation
• catalog entry-copy duplicate an existing catalog entry

Updated commands

• login command goes to public IAM service for authentication if the dedicated environment is configured to use pubic IAM service. It fails the login if IBM ID and dedicated ID connection is not established. It also display the ID connections if login is successful
• account spaces adds '-r' and '-o' options to specify a different region and organization
• account org-roles adds '-u' option to specify a different user than the current user
• plugin show removes the preceding tab in the command display
• account users allows any user associated with the account to be able to list the account users, instead of account owner only
• sl init allows two phase authentication
• account user-invite does not require target org/space and roles
• account org-create is disabled for dedicated and local environments

Defect fixing

• EOF error is ignored in prompts
• login goes to interactive mode when specified api key or password is not correct
• Check IAM token as prerequisite for account users, account user-invite, account user-reinvite, account user-delete and account org-roles

other changes

• upgraded to Golang 1.9.2

v0.6.1

This version is deprecated. Install the latest release.

Change logs

This release includes several minor changes for user experience enhancements and defect fixing

Updated commands

• account user-invite adds org/space role description in the command usage
• resource binding-create and resource key-create add role check and tips of valid roles
• resource instance-create shows the region of the instance created

Defect fixing

• typo in resource alias-create when showing message of not being able to create alias in the region
• app push does not allow empty app name
• target --cf always select the first org

v0.6.0

This version is deprecated. Install the latest release.

Change logs

Identity and access management for users and services

This release incorporates a set of command lines to support the service id, service api key management, and access policy management for users and services.

New cloud resource management

This release adds a set of command lines to support resource groups, quota, resource catalog, resource instance, resource key, resource alias and instance binding to CloudFoundry applications.

Move account/org/space/user related commands from namespace 'iam' to 'account'

The command lines to manage accounts, account users, orgs, spaces and org/space roles are moved from 'iam' namespace to 'account' namespace. We still keep a copy under 'iam' as well. But we encourage users to adopt the commands under 'account' namespace.

CLIs for Softlayer load balancer

This release adds command lines to manage Softlayer load balancer service.

Login experience improvement

bx api / bx loginshows current available public api endpoints for users to select, if no API endpoint was set previously.

New commands

• Commands under iam namespace to manage service policies

   service-policies         List all service policies of specified service
   service-policy           Display details of a service policy
   service-policy-create    Create a service policy
   service-policy-update    Update a service policy
   service-policy-delete    Delete a service policy

• Commands under iam namespace to manage user policies

   user-policies            List policies of a user
   user-policy              Display details of a user policy
   user-policy-create       Create a user policy for resources in current account
   user-policy-update       Update a user policy for resources in current account
   user-policy-delete       Delete a user policy

• Commands under iam namespace to manage service IDs

   service-ids              List all service IDs
   service-id               Display details of a service ID
   service-id-create        Create a service ID
   service-id-update        Update a service ID
   service-id-delete        Delete a service ID

• Commands under iam namespace to manage service API keys

   service-api-keys         List all service API keys
   service-api-key          List details of a service API key
   service-api-key-create   Create a service API key
   service-api-key-update   Update a service API key
   service-api-key-delete   Delete a service API key

• Commands under resource namespace to manage resource groups

   groups            List resource groups
   group             Show details of a resource group
   group-update      Update an existing resource group

• Commands under catalog namespace to operate resource catalog

   search                    Search catalog entries
   entry                     Get a catalog entry
   entry-create              Create a new catalog entry(catalog admin of an account only)
   entry-update              Update an existing catalog entry(catalog admin or editor of an account only)
   entry-visibility          Get the visibility for a catalog entry(catalog admin of an account only)
   entry-visibility-set      Update the visibility of an existing catalog entry(catalog admin of an account only)
   entry-delete              Delete a catalog entry(catalog admin of an account only)

• Commands under resource namespace to list resource quotas

   quotas            List all quota definitions
   quota             Show details of a quota definition

• Commands under resource namespace to manage resource instances

   instances         List resource instances
   instance          Show details of a resource instance
   instance-create   Create a resource instance
   instance-update   Update resource instance
   instance-delete   Delete resource instance

• Commands under resource namespace to manage resource keys

   key-create        Create a resource key
   keys              List resource keys of resource instance or resource alias
   key               Show details of a resource key
   key-delete        Delete a resource key

• Commands under resource namespace to manage resource aliases

   aliases           List aliases for a resource instance
   alias             Show details of a resource alias
   alias-create      Create an alias of a resource instance
   alias-update      Update an resource alias
   alias-delete      Delete a resource alias

• Commands under resource namespace to manage resource bindings

   bindings          Show bindings to the resource alias
   binding           Show details of a resource binding
   binding-create    Create a resource binding
   binding-delete    Delete a resource binding

• Commands under sl loadbal namespace to manage Softlayer load balancer

   cancel            Cancel an existing load balancer
   create            Adds a load balancer given the id returned from create-options
   create-options    Get price options to create a load balancer with
   detail            Get Load balancer details
   group-add         Adds a new load_balancer service
   group-delete      Deletes an existing load balancer service group
   group-edit        Edit an existing load balancer service group
   group-reset       Reset connections on a certain service group
   health-checks     List health check types
   list              List active load balancers
   routing-methods   List routing methods
   routing-types     List routing types
   service-add       Adds a new load balancer service
   service-delete    Deletes an existing load balancer service
   service-edit      Edit the properties of a service group
   service-toggle    Toggle the status of an existing load balancer service

Updated commands

• Add prerequisite check for commands under app, account, iam, billing, security, and service namespaces
• bx api shows current public regions and api endpoint if no api is set
• bx login shows current public regions and api endpoint for user to select if api is not set or specified
• iam oauth-tokens falls back to UAA server to refresh token when iam is not available in the targeted Bluemix environment
• Provide public region endpoint as options in login
• Update usage description of iam account-user-invite command, org manager is not allowed to execute this command
• Make plugin name case insensitive when install/remove plugin

Defect fixing

• Wrong description of -p option in app domain-cert-add command

v0.5.6

This version is deprecated. Install the latest release.

Change logs

Remove org and space selection during logging in

Starting from this release, org and space selection is removed from the interactive flow of login command. While the user still can specify the org/space with -o and -s to target the org/space when logging in.

Plugin installation experience improvements

This release incorporates various changes in the plugin management and installation, including being able to install a plugin from Bluemix official repository without specifying the repository, adding progress indicator when downloading a plugin, as well as showing the status of the plugin when listing plugins in the repository.

CLIs for Softlayer file storage, ipsec and CDN

This release adds the command lines to manage Softlayer file storage service, ipsec VPN and CDN service.

New commands

• plugin repo-plugin to show the details of a plugin in the repo
• sl file to manage softlayer file storage

   access-authorize    Authorize hosts to access a given volume
   access-list         List ACLs
   access-revoke       Revoke authorization for hosts accessing a given volume
   replica-failback    Failback a file volume from replica
   replica-failover    Failover a file volume to the given replica volume
   replica-locations   List suitable replication datacenters for the given volume
   replica-order       Order a file storage replica volume
   replica-partners    List existing replicant volumes for a file volume
   snapshot-cancel     Cancel existing snapshot space for a given volume
   snapshot-create     Create a snapshot on a given volume
   snapshot-disable    Disable snapshots on the specified schedule for a given volume
   snapshot-enable     Enable snapshots for a given volume on the specified schedule
   snapshot-delete     Delete a snapshot on a given volume
   snapshot-list       List file storage snapshots
   snapshot-order      Order snapshot space for a file storage volume
   snapshot-restore    Restore file volume using a given snapshot
   volume-cancel       Cancel an existing file storage volume
   volume-list         List file storage
   volume-detail       Display details for a specified volume
   volume-duplicate    Order a file volume by duplicating an existing volume
   volume-order        Order a file storage volume
   volume-options      List all options for ordering a file storage

• sl ipsec to manage softlayer ipsec VPN

   cancel               Cancel a IPSec VPN tunnel context
   config               Request configuration of a tunnel context
   detail               List IPSec VPN tunnel context details
   list                 List IPSec VPN tunnel contexts
   order                Order a IPSec VPN tunnel
   subnet-add           Add a subnet to an IPSec tunnel context
   subnet-remove        Remove a subnet from an IPSEC tunnel context
   translation-add      Add an address translation to an IPSec tunnel
   translation-remove   Remove a translation entry from an IPSec
   translation-update   Update an address translation for an IPSec
   update               Update tunnel context properties

• sl cdn to manage Softlayer CDN service

   cancel          Cancel a CDN account
   detail          Detail a CDN Account
   list            List all CDN accounts
   load            Cache one or more files on all edge nodes
   order           Order a CDN account
   options         Bandwidth and storage options for ordering CDN account
   origin-add      Create an origin pull mapping
   origin-list     List origin pull mappings
   origin-remove   Remove an origin pull mapping
   purge           Purge cached files from all edge nodes

Updated commands

• login does not select and target org / space if '-o' and '-s' are not specified
• login add tips to use bx cf <command> to invoke cf cli with Bluemix cli context
• target adds '--cf' to select org / space interactively
• 'plugin install has the following changes
  • searches the plugin locally and then from the Bluemix official plugin repository if '-r' is not specified
  • displays a progress indicator when downloading a plugin binary
• plugin uninstall resumes uninstallation if it cannot remove the plugin binary
• plugin repo-add now returns with exit code 0 when attempting to add a plugin repo that is already registered
• plugin repo-plugins now displays plugin's status (update available, installed, not installed)
• iam account-user-delete introduces '-c' option to specify a target account and '-f' option to delete without user confirmation
• cf introduces '--quiet' / '-q' option to to turn off message 'Invoking cf ...'
• iam org-create checks whether the user is account owner before creating the org

Defect fixing

• cf help -a does not show all the command help
• iam space-roles: nil pointer error when selecting an invalid org
• app domain-cert-add: incorrect help description regarding the password

v0.5.5

This version is deprecated. Install the latest release.

Change logs

Support global console endpoint

This release starts to use global console endpoint https://console.bluemix.net to access the Bluemix console APIs no matter which region the user is targeting.

Introduce storage-as-a-service in Softlayer block service

This new storage offering gives SoftLayer users more choice, flexibility, and control over their storage type, speed, and durability, to optimize their cloud infrastructure’s performance and cost.

New Commands

• plugin show command shows details of a plugin, including plugin name, plugin version, minimal CLI version, and commands brief.
• sl block volume-duplicate orders a volume by duplicating an existing volume
• sl block replica-locations shows suitable data centers for taking replica of a volume
• sl block replica-partners lists replicant volumes for a block volume

Updated Commands

• info command has the following changes
  • shows Console endpoint
  • uses UAA endpoint instead of Token endpoint
  • uses Authentication endpoint instead of Authorization endpoint. It shows IAM endpoint when IAM service is available, otherwise it shows UAA endpoint.
  • removes VM endpoint and Container endpoint
• sl block volume-order now uses storage-as-a-service
• sl block snapshot-order now supports performance volume
• sl block replica-order now supports performance volume

Removed Commands

• curl command is removed since Bluemix has different API endpoints and type of tokens for different services

Fixed defects

• loggergator endpoint is missing in config( backward compatibility issue)
• panic when collecting version of embedded CF CLI
• incorrect usage description of 'plugin update' command
• NPE in plugin update command
• several i18n issues
• error when there is a trailing slash in API endpoint
• infinite loop issue of iam api-keys command when there are more than 20 API keys.
• regression that 'Accept-Language' header is not set

Upgraded dependencies

• upgrade embedded CF CLI to version 6.26.0
• upgrade to Go 1.8.3

v0.5.4

This version is deprecated. Install the latest release.

Change logs

Fixed defects

• Command line parsing error under Windows Powershell
• Error in fetching account list under some Bluemix environments