Updated on 2024-08-20 GMT+08:00

What's New

The following tables describe the features released in each KooCLI version and corresponding documentation updates.

July 2024

No.

Feature

Description

Phase

Document

1

SSO login configuration

KooCLI version: 5.3.4

To simplify SSO login, you can set --cli-sso-account-name and --cli-sso-permission-set-name in the configuration file.

Commercial use

Configuring the Account Name and Permission Set Name

May 2024

No.

Feature

Description

Phase

Document

1

Storing authentication information in plaintext

KooCLI version: 5.2.7

hcloud configure set --cli-auth-encrypt=false allows you to configure not encrypting authentication information in the configuration file before storage. By default, the authentication information is encrypted before storage.

Commercial use

Configuring Encryption of Authentication Information

2

SSO login

KooCLI version: 5.2.7

You can use hcloud configure sso to log in to KooCLI via single sign-on (SSO), storing your authentication information in the configuration file.

Commercial use

Logging In via SSO

December 2023

No.

Feature

Description

Phase

Document

1

Result polling

KooCLI version: 4.4.8

By adding the --cli-waiter option in an API calling command, you can poll the calling result.

Commercial use

Polling Results

November 2023

No.

Feature

Description

Phase

Document

1

Generating an API input parameter skeleton in JSON format

KooCLI version: 4.4.5

You can add the --skeleton option to an API command to generate an input parameter skeleton in JSON format. Then you can use "--cli-jsonInput=${JSON file name}" to pass parameters for calling the API.

Commercial use

Generating API Input Parameter Skeleton in JSON Format

April 2023

No.

Feature

Description

Phase

Document

1

Disabling warning display during command execution

KooCLI version: 4.2.4

To prevent warnings from interfering with result resolution during command execution with automation scripts, run hcloud configure set --cli-warning=false to disable warning display.

Commercial use

Disabling Warning Display

February 2023

No.

Feature

Description

Phase

Document

1

Agreeing to privacy statement in non-interactive mode

KooCLI version: 4.1.6

In some special scenarios such as KooCLI command execution with automation scripts, you can run hcloud configure set --cli-agree-privacy-statement=true to agree to the privacy statement:

Commercial use

Configuring Consent to the Privacy Statement

December 2022

No.

Feature

Description

Phase

Document

1

Custom request domain name

KooCLI version: 3.4.12

Cloud service APIs can be called using a custom domain name.

Commercial use

Defining a Custom Domain Name

November 2022

No.

Feature

Description

Phase

Document

1

Integrating with OBS's obsutil tool

KooCLI version: 3.4.6

KooCLI has integrated the obsutil tool of Object Storage Service (OBS). You can run hcloud obs to manage your data in OBS.

Commercial use

Managing Data in OBS

2

Empty body parameters at any level

KooCLI version: 3.4.5

KooCLI allows you to leave the body parameters of cloud service APIs empty at any level.

Commercial use

Can I Leave a Body Parameter Empty for Cloud Service APIs?

June 2022

No.

Feature

Description

Phase

Document

1

New feature

KooCLI version: 3.2.13

KooCLI can stay in online/offline modes. By default, it is offline. You can run hcloud configure set --cli-offline=false to switch KooCLI to online mode.

Commercial use

What Are the Application Scenarios of Online/Offline Modes?

May 2022

No.

Feature

Description

Phase

Document

1

New feature

KooCLI version: 3.2.8

When using KooCLI for the first time, you need to confirm whether to connect it to the Internet and whether to accept the Privacy Statement.

Commercial use

Privacy Statement

November 2021

No.

Feature

Description

Phase

Document

1

New feature

KooCLI version: 2.4.8

The cli-output option allows you to specify the output format. You can use cli-query to specify a JMESPath expression for filtering the output content.

Commercial use

Specifying the Output Format

2

New feature

KooCLI version: 2.4.8

The hcloud configure clear command allows you to delete all profiles.

Commercial use

Deleting All Profiles

October 2021

No.

Feature

Description

Phase

Document

1

New feature

KooCLI version: 2.4.5

The cli-skip-secure-verify option allows you to skip HTTPS request certificate verification (not recommended).

Commercial use

Skipping HTTPS Request Certificate Verification

2

New feature

KooCLI version: 2.4.4

You can create an IAM agency and use KooCLI on an Elastic Cloud Server (ECS) through agency authentication.

Commercial use

ecsAgency Delegation

September 2021

No.

Feature

Description

Phase

Document

1

New feature

KooCLI version: 2.3.14

Custom parameters can be set and used.

Commercial use

Setting and Using Custom Parameters

2

Function optimization

KooCLI version: 2.3.14

The error that only the minimum value is provided for the parameter value range has been rectified.

Commercial use

-

August 2021

No.

Feature

Description

Phase

Document

1

Function optimization

KooCLI version: 2.3.7

You can use cli-json-filter to perform JMESPath query on command results that are output in JSON format.

Commercial use

Using cli-json-filter to Perform JMESPath Query on JSON Results

2

Experience optimization

KooCLI version: 2.3.7

A unified interactive prompt exiting method is used for different systems.

Commercial use

Using Interactive Prompts

July 2021

No.

Feature

Description

Phase

Document

1

Function optimization

KooCLI version: 2.3.5

KooCLI can be used in non-configuration mode.

Commercial use

Using KooCLI in Non-configuration Mode

2

New feature

KooCLI version: 2.3.3

KooCLI can be quickly installed using simple commands in Linux and macOS.

Commercial use

Install CLI

June 2021

No.

Feature

Description

Phase

Document

1

Availability for commercial use

KooCLI version: 2.2.12

Availability for commercial use

Commercial use

-

May 2021

No.

Feature

Description

Phase

Document

1

New feature

KooCLI version: 2.2.9

  • Interactive prompts are supported in multiple systems.
  • System command invocation logs can be recorded.

OBT

2

Function optimization

KooCLI version: 2.2.9

The secret access key (SK) is anonymized during configuration initialization.

OBT

Initializing Configurations

3

Experience optimization

KooCLI version: 2.2.7

More parameter types are supported for cloud service APIs.

OBT

-

March 2021

No.

Feature

Description

Phase

Document

1

New feature

KooCLI version: 2.1.13

The system automatically obtains the required parameter project_id from the user authentication information in commands for calling cloud service APIs. If a user does not have a project ID in a specific region, the system automatically creates one for the user.

OBT

-

2

Experience optimization

KooCLI version: 2.1.13

By default, the latest version of a multi-version service API is called if no version is specified.

OBT

Specifying a Cloud Service API and Version

3

New feature

KooCLI version: 2.1.10

The system automatically obtains the required parameter domain_id from the user authentication information in commands for calling cloud service APIs.

OBT

-

February 2021

No.

Feature

Description

Phase

Document

1

Experience optimization

KooCLI version: 2.1.6

The array type parameter specified by cli-output-rows can use a colon (:) to concatenate the start and end indexes. Error messages related to table output are optimized.

OBT

Using cli-output-rows, cli-output-cols, and cli-output-num to Configure Table Output

December 2020

No.

Feature

Description

Phase

Document

1

Experience optimization

KooCLI version: 1.2.10

  • In the start position of an error message, the error type is declared as [OPENAPI_ERROR], [CLI_ERROR], or [USE_ERROR].
  • If an error occurs when a cloud service API is called, a link of the Error Code Center is displayed based on the returned error code.

OBT

Error Classification and Locating

November 2020

No.

Feature

Description

Phase

Document

1

New feature

KooCLI version: 1.2.9

Cloud service API invocation can now be logged.

OBT

Managing Logs

2

New feature

KooCLI version: 1.2.8

  • The --dryrun option is added for command check. Commands containing this option will only be verified with the request message printed and will not be run.
  • The hcloud configure test command is added to check the configuration file format.
  • The --cli-retry-count option is added to implement a retry mechanism for network connection timeout that occurs during cloud service API calling.

OBT

October 2020

No.

Feature

Description

Phase

Document

1

New feature

KooCLI version: 1.2.4

You can set a network connection timeout for calling cloud service APIs.

OBT

Setting Network Connection Timeout

2

Experience optimization

KooCLI version: 1.2.4

New system parameters are prefixed with cli- to distinguish from Huawei Cloud API parameters that have the same names.

OBT

System Parameters

September 2020

No.

Feature

Description

Phase

Document

1

Experience optimization

KooCLI version: 1.1.11

KooCLI now has a unified output style. Different types of information are displayed in different colors.

OBT

-

July 2020

No.

Feature

Description

Phase

Document

1

New feature

KooCLI version: 1.1.1

  • Autocomplete is supported in the Bash environment.
  • Multi-version cloud service APIs are supported.
  • Invocation results can be output in a table.

OBT

May 2020

No.

Feature

Description

Phase

Document

1

First release

KooCLI version: 1.0

KooCLI is now available, allowing you to call cloud service APIs through a command line interface.

OBT

-