Help Center/ Cloud Container Engine/ API Reference (Ally Region)/ APIs/ Chart Management/ Obtaining a Release List
Updated on 2026-09-30 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Obtaining a Release List

Function

This API is used to obtain a release list.

Calling Method

For details, see Calling APIs.

URI

GET /cce/cam/v3/clusters/{cluster_id}/releases

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

cluster_id

Yes

String

Details:

Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI.

Constraints:

None

Options:

Cluster IDs

Default value:

N/A
Table 2 Query Parameters

Parameter

Mandatory

Type

Description

chart_id

No

String

Definition:

Chart ID

Constraints:

N/A

Range:

N/A

Default Value:

N/A

namespace

No

String

Definition:

Namespace that a chart belongs to

Constraints:

N/A

Range:

N/A

Default Value:

N/A

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Definition:

Type (or format) of the request body. The default value is application/json. Other values of this field will be provided for specific APIs, if any.

Constraints:

GET requests are not validated.

Range:

N/A

Default Value:

N/A

X-Auth-Token

Yes

String

Details:

Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see Obtaining a User Token.

Constraints:

None

Options:

N/A

Default value:

N/A

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

[items]

Array of ReleaseResp objects

Definition:

Name

Range:

N/A
Table 5 ReleaseResp

Parameter

Type

Description

chart_name

String

Definition:

Name

Range:

N/A

chart_public

Boolean

Definition:

Whether the chart is public

Range:

  • true: The chart is public.

  • false: The chart is not public.

chart_version

String

Definition:

Chart version

Range:

N/A

cluster_id

String

Definition:

Cluster ID

Range:

N/A

cluster_name

String

Definition:

Cluster name

Range:

N/A

create_at

String

Definition:

Creation time

Range:

N/A

description

String

Definition:

Release description

Range:

N/A

name

String

Definition:

Release name

Range:

N/A

namespace

String

Definition:

Namespace that a chart release belongs to

Range:

N/A

parameters

String

Definition:

Release parameters

Range:

N/A

resources

String

Definition:

Resources required by a release

Range:

N/A

status

String

Definition:

Release status

Range:

  • DEPLOYED: The release has been deployed and is normal.

  • DELETED: The release has been deleted.

  • FAILED: The release failed to be deployed.

  • DELETING: The release is being deleted.

  • PENDING_INSTALL: The release is waiting to be installed.

  • PENDING_UPGRADE: The release is waiting to be upgraded.

  • PENDING_ROLLBACK: The release is waiting to be rolled back.

  • UNKNOWN: The release status is unknown, indicating that the release is abnormal. You can manually delete the release and reinstall it.

status_description

String

Definition:

Release status description

Range:

N/A

update_at

String

Definition:

Update time

Range:

N/A

values

String

Definition:

Release value

Range:

N/A

version

Integer

Definition:

Release version

Range:

N/A

Example Requests

None

Example Responses

Status code: 200

[ {
  "chart_name" : "magento-mysql",
  "chart_public" : false,
  "chart_version" : "1.0.0",
  "cluster_id" : "a870253f-5dc7-11ee-bf71-0255ac100b03",
  "cluster_name" : "sfs-turbo-test",
  "create_at" : "2023-11-14T20:30:57+08:00",
  "description" : "Initial install underway",
  "name" : "testwww",
  "namespace" : "monitoring",
  "parameters" : "",
  "resources" : "",
  "status" : "PENDING_INSTALL",
  "status_description" : "Initial install underway",
  "update_at" : "2023-11-14T20:30:57+08:00",
  "values" : "{\"basic\":{\"admin_password\":\"******\",\"admin_username\":\"username\",\"app_name\":\"magento\",\"mysql_database\":\"magento\",\"mysql_name\":\"mysql\",\"mysql_password\":\"******\",\"mysql_port\":3306,\"mysql_root_password\":\"******\",\"mysql_user\":\"magento\",\"storage_class\":\"csi-nas\",\"storage_mode\":\"ReadWriteMany\",\"storage_size\":\"10G\"},\"global\":{\"magento_EIP\":\"100.100.100.100\",\"magento_EPORT\":32080,\"namespace\":\"default\"},\"image\":{\"magento_image\":\"example.com/everest/magento:latest\",\"mysql_image\":\"example.com/everest/mysql:5.7.14\"}}",
  "version" : 1
} ]

Status Codes

Status Code

Description

200

The release list has been obtained.

Error Codes

See Error Codes.

Parent topic: Chart Management