Updating an Add-on Instance

Function

This API is used to update an add-on instance.

Calling Method

For details, see Calling APIs.

URI

PUT /api/v3/addons/{id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
id	Yes	String	Definition: Add-on pod ID Constraints: N/A Range: The value is in UUID format and contains 1 to 255 characters. Default Value: N/A

Request Parameters

**Table 2** 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

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
kind	Yes	String	Definition: API type. The value is fixed at Addon and cannot be changed. A specified value does not take effect. Constraints: The value cannot be changed. Range: Addon Default Value: Addon
apiVersion	Yes	String	Definition: API version. The value is fixed at v3 and cannot be changed. A specified value does not take effect. Constraints: The value cannot be changed. Range: v3 Default Value: v3
metadata	Yes	AddonMetadata object	Definition: Basic information about an add-on. Metadata is a collection of attributes. Constraints: N/A Range: N/A Default Value: N/A
spec	Yes	InstanceRequestSpec object	Definition: Detailed description of an add-on installation or upgrade Constraints: N/A Range: N/A Default Value: N/A

**Table 4** AddonMetadata
Parameter	Mandatory	Type	Description
uid	No	String	Definition: Unique ID of an add-on pod, which is automatically generated by the system after the add-on pod is created Constraints: N/A Range: N/A Default Value: N/A
name	No	String	Definition: Add-on name Constraints: N/A Range: N/A Default Value: N/A
alias	No	String	Definition: Add-on alias Constraints: N/A Range: N/A Default Value: N/A
labels	No	Map<String,String>	Definition: Add-on labels in key-value pairs. This is a reserved field. A specified value is invalid. Constraints: N/A Range: N/A Default Value: N/A
annotations	No	Map<String,String>	Definition: Add-on annotations in the format of key-value pairs Constraints: N/A Range: The value is fixed at {"addon.install/type":"install"} during installation. The value is fixed at {"addon.upgrade/type":"upgrade"} during an upgrade. Default Value: N/A
updateTimestamp	No	String	Definition: Update time Constraints: N/A Range: N/A Default Value: N/A
creationTimestamp	No	String	Definition: Creation time, which is automatically generated after creation. A specified value does not take effect. Constraints: N/A Range: N/A Default Value: N/A

**Table 5** InstanceRequestSpec
Parameter	Mandatory	Type	Description
version	No	String	Definition: Version of the add-on to be installed or upgraded, for example, 1.0.0 Constraints: During installation, this parameter is optional. If not specified, the latest version supported by the cluster is used. During an upgrade, this parameter is mandatory and the version must be specified. Range: N/A Default Value: N/A
clusterID	Yes	String	Definition: Cluster ID Constraints: N/A Range: N/A Default Value: N/A
values	Yes	Map<String,Object>	Definition: Add-on template installation parameters (varying depending on the add-on). During the add-on upgrade, you need to specify all the installation parameters. If the parameters are not specified, the default values in the add-on template are used. The current add-on installation parameters can be obtained through the API for querying add-on pods. Constraints: N/A Range: N/A Default Value: N/A
addonTemplateName	Yes	String	Definition: Name of the add-on template to be installed, for example, coredns Constraints: N/A Range: N/A Default Value: N/A

Response Parameters

Status code: 200

**Table 6** Response body parameters
Parameter	Type	Description
kind	String	Definition: API type. The value is fixed at Addon and cannot be changed. Range: Addon
apiVersion	String	Definition: API version. The value is fixed at v3 and cannot be changed. Range: v3
metadata	AddonMetadata object	Definition: Basic information. Metadata is a collection of attributes. Range: N/A
spec	InstanceSpec object	Definition: Details about an add-on pod Range: N/A
status	AddonInstanceStatus object	Definition: Add-on pod status Range: N/A

**Table 7** AddonMetadata
Parameter	Type	Description
uid	String	Definition: Unique ID of an add-on pod, which is automatically generated by the system after the add-on pod is created Range: N/A
name	String	Definition: Add-on name Range: N/A
alias	String	Definition: Add-on alias Range: N/A
labels	Map<String,String>	Definition: Add-on labels in key-value pairs. This is a reserved field. A specified value is invalid. Range: N/A
annotations	Map<String,String>	Definition: Add-on annotations in the format of key-value pairs Range: The value is fixed at {"addon.install/type":"install"} during installation. The value is fixed at {"addon.upgrade/type":"upgrade"} during an upgrade.
updateTimestamp	String	Definition: Update time Range: N/A
creationTimestamp	String	Definition: Creation time, which is automatically generated after creation. A specified value does not take effect. Range: N/A

**Table 8** InstanceSpec
Parameter	Type	Description
clusterID	String	Definition: Cluster ID Range: N/A
version	String	Definition: Add-on template version, for example, 1.0.0 Range: N/A
addonTemplateName	String	Definition: Add-on template name, for example, coredns Range: N/A
addonTemplateType	String	Definition: Add-on template type Range: helm: Helm packages static: static templates
addonTemplateLogo	String	Definition: URL for obtaining an add-on template logo Range: N/A
addonTemplateLabels	Array of strings	Definition: Add-on template type Range: N/A
description	String	Definition: Add-on template description Range: N/A
values	Map<String,Object>	Definition: Add-on template installation parameters (varying depending on the add-on). Configure the parameters based on the add-on template. Range: N/A

**Table 9** AddonInstanceStatus
Parameter	Type	Description
status	String	Definition: Add-on pod status Range: running: All of the add-on pods are running. This specifies that the add-on runs properly. abnormal: The add-on is abnormal and cannot be used. You can click the add-on name to view exceptions. installing: The add-on is being installed. installFailed: The add-on installation failed. You need to uninstall the add-on and install it again. upgrading: The add-on is being upgraded. upgradeFailed: The add-on upgrade failed. You can retry the upgrade or uninstall the add-on and install it again. deleting: The add-on is being deleted. deleteFailed: The add-on failed to be deleted. You can retry the uninstallation. deleteSuccess: The add-on was deleted. available: Only some instances of the add-on are running. This specifies that some functions of the add-on are available. rollbacking: The add-on is being rolled back. rollbackFailed: The add-on failed to be rolled back. You can retry the rollback or uninstall and reinstall the add-on. unknown: The add-on template instance does not exist.
Reason	String	Definition: Cause of an add-on installation failure Range: N/A
message	String	Definition: Installation error details Range: N/A
targetVersions	Array of strings	Definition: Cluster versions that support the add-on upgrade Range: N/A
currentVersion	Versions object	Definition: Information about the current add-on version Range: N/A
isRollbackable	Boolean	Definition: Whether the add-on version can be rolled back to the source version Range: true: Rollback is supported. false: Rollback is not supported.
previousVersion	String	Definition: The add-on version before an upgrade or rollback Range: N/A

**Table 10** Versions
Parameter	Type	Description
version	String	Definition: Add-on version Range: N/A
input	Object	Definition: Add-on installation parameters Range: N/A
stable	Boolean	Definition: Whether the version is stable Range: true: The version is stable. false: The version is unstable.
translate	Object	Definition: Translation information used by the GUI Range: N/A
supportVersions	Array of SupportVersions objects	Definition: Supported cluster versions Range: N/A
creationTimestamp	String	Definition: Creation time Range: N/A
updateTimestamp	String	Definition: Update time Range: N/A

**Table 11** SupportVersions
Parameter	Type	Description
clusterType	String	Definition: Supported cluster type VirtualMachine is supported. Range: VirtualMachine: CCE cluster, where master nodes are x86 servers BareMetal: bare metal cluster, where master nodes are BMSs
clusterVersion	Array of strings	Definition: Supported cluster version (regular expression) Range: N/A
category	Array of strings	Definition: The cluster type to which the configurations apply Range: CCE: CCE standard clusters Turbo: CCE Turbo clusters

Example Requests

Update the Everest add-on to v2.1.30.

{
  "kind" : "Addon",
  "apiVersion" : "v3",
  "metadata" : {
    "annotations" : {
      "addon.upgrade/type" : "upgrade"
    }
  },
  "spec" : {
    "clusterID" : "*****",
    "version" : "2.1.30",
    "addonTemplateName" : "everest",
    "values" : {
      "basic" : {
        "bms_url" : "*****",
        "driver_init_image_version" : "2.1.30",
        "ecsEndpoint" : "*****",
        "everest_image_version" : "2.1.30",
        "evs_url" : "*****",
        "iam_url" : "*****",
        "ims_url" : "*****",
        "obs_url" : "*****",
        "platform" : "linux-amd64",
        "sfs30_url" : "*****",
        "sfs_turbo_url" : "*****",
        "sfs_url" : "*****",
        "supportHcs" : false,
        "swr_addr" : "*****",
        "swr_user" : "hwofficial",
        "rbac_enabled" : true,
        "cluster_version" : "v1.23"
      },
      "flavor" : {
        "description" : "High available",
        "name" : "HA",
        "replicas" : 2,
        "resources" : [ {
          "limitsCpu" : "250m",
          "limitsMem" : "2000Mi",
          "name" : "everest-csi-controller",
          "requestsCpu" : "250m",
          "requestsMem" : "1500Mi"
        }, {
          "limitsCpu" : "500m",
          "limitsMem" : "300Mi",
          "name" : "everest-csi-driver",
          "requestsCpu" : "100m",
          "requestsMem" : "300Mi"
        } ],
        "category" : [ "CCE", "Turbo" ]
      },
      "custom" : {
        "cluster_id" : "*****",
        "csi_attacher_detach_worker_threads" : "60",
        "csi_attacher_worker_threads" : "60",
        "default_vpc_id" : "*****",
        "disable_auto_mount_secret" : false,
        "enable_node_attacher" : true,
        "flow_control" : { },
        "multiAZEnabled" : false,
        "over_subscription" : "80",
        "project_id" : "*****",
        "volume_attaching_flow_ctrl" : "0"
      }
    }
  }
}

Example Responses

Status code: 200

{
  "kind" : "Addon",
  "apiVersion" : "v3",
  "metadata" : {
    "uid" : "******",
    "name" : "everest",
    "alias" : "everest",
    "creationTimestamp" : "2023-07-03T10:57:43Z",
    "updateTimestamp" : "2023-07-03T11:24:05Z"
  },
  "spec" : {
    "clusterID" : "******",
    "version" : "2.1.30",
    "addonTemplateName" : "everest",
    "addonTemplateType" : "helm",
    "addonTemplateLogo" : "******",
    "addonTemplateLabels" : [ "Storage" ],
    "description" : "",
    "values" : {
      "basic" : {
        "bms_url" : "******",
        "cluster_version" : "v1.23",
        "driver_init_image_version" : "2.1.30",
        "ecsEndpoint" : "******",
        "everest_image_version" : "2.1.30",
        "evs_url" : "******",
        "iam_url" : "******",
        "ims_url" : "******",
        "obs_url" : "******",
        "platform" : "linux-amd64",
        "rbac_enabled" : true,
        "sfs30_url" : "******",
        "sfs_turbo_url" : "******",
        "sfs_url" : "******",
        "supportHcs" : false,
        "swr_addr" : "******",
        "swr_user" : "hwofficial"
      },
      "custom" : {
        "cluster_id" : "******",
        "cluster_version" : "v1.23.8-r0",
        "csi_attacher_detach_worker_threads" : "60",
        "csi_attacher_worker_threads" : "60",
        "default_vpc_id" : "******",
        "disable_auto_mount_secret" : false,
        "enable_node_attacher" : false,
        "flow_control" : { },
        "multiAZEnabled" : false,
        "over_subscription" : "80",
        "project_id" : "******",
        "volume_attaching_flow_ctrl" : "0"
      },
      "flavor" : {
        "category" : [ "CCE", "Turbo" ],
        "description" : "Has only one instance",
        "name" : "Single",
        "replicas" : 1,
        "resources" : [ {
          "limitsCpu" : "250m",
          "limitsMem" : "600Mi",
          "name" : "everest-csi-controller",
          "requestsCpu" : "250m",
          "requestsMem" : "600Mi"
        }, {
          "limitsCpu" : "100m",
          "limitsMem" : "300Mi",
          "name" : "everest-csi-driver",
          "requestsCpu" : "100m",
          "requestsMem" : "300Mi"
        } ]
      },
      "systemAutoInject" : {
        "cluster" : {
          "clusterID" : "******",
          "clusterNetworkMode" : "vpc-router",
          "clusterVersion" : "v1.23.8-r0"
        },
        "user" : {
          "projectID" : "******"
        }
      }
    }
  },
  "status" : {
    "status" : "upgrading",
    "Reason" : "addon upgrading",
    "message" : "",
    "targetVersions" : null,
    "isRollbackable" : false,
    "currentVersion" : {
      "version" : "2.1.30",
      "input" : {
        "basic" : {
          "bms_url" : "******",
          "driver_init_image_version" : "2.1.30",
          "ecsEndpoint" : "******",
          "everest_image_version" : "2.1.30",
          "evs_url" : "******",
          "iam_url" : "******",
          "ims_url" : "******",
          "obs_url" : "******",
          "platform" : "******",
          "sfs30_url" : "******",
          "sfs_turbo_url" : "******",
          "sfs_url" : "******",
          "supportHcs" : false,
          "swr_addr" : "******",
          "swr_user" : "hwofficial"
        },
        "parameters" : {
          "common" : {
            "defaultVPCId" : 1234567
          },
          "custom" : {
            "cluster_id" : "",
            "csi_attacher_detach_worker_threads" : "60",
            "csi_attacher_worker_threads" : "60",
            "default_vpc_id" : "",
            "disable_auto_mount_secret" : false,
            "enable_node_attacher" : false,
            "flow_control" : { },
            "multiAZEnabled" : false,
            "over_subscription" : "80",
            "project_id" : "",
            "volume_attaching_flow_ctrl" : "0"
          },
          "flavor1" : {
            "description" : "High available",
            "name" : "HA",
            "replicas" : 2,
            "resources" : [ {
              "limitsCpu" : "250m",
              "limitsMem" : "1500Mi",
              "name" : "everest-csi-controller",
              "requestsCpu" : "250m",
              "requestsMem" : "600Mi"
            }, {
              "limitsCpu" : "500m",
              "limitsMem" : "300Mi",
              "name" : "everest-csi-driver",
              "requestsCpu" : "100m",
              "requestsMem" : "300Mi"
            } ]
          },
          "flavor2" : {
            "description" : "Has only one instance",
            "name" : "Single",
            "replicas" : 1,
            "resources" : [ {
              "limitsCpu" : "250m",
              "limitsMem" : "600Mi",
              "name" : "everest-csi-controller",
              "requestsCpu" : "250m",
              "requestsMem" : "600Mi"
            }, {
              "limitsCpu" : "100m",
              "limitsMem" : "300Mi",
              "name" : "everest-csi-driver",
              "requestsCpu" : "100m",
              "requestsMem" : "300Mi"
            } ]
          },
          "flavor3" : {
            "description" : "custom resources",
            "name" : "custom-resources",
            "replicas" : 2,
            "resources" : [ {
              "limitsCpu" : "250m",
              "limitsMem" : "2000Mi",
              "name" : "everest-csi-controller",
              "requestsCpu" : "250m",
              "requestsMem" : "1500Mi"
            }, {
              "limitsCpu" : "500m",
              "limitsMem" : "300Mi",
              "name" : "everest-csi-driver",
              "requestsCpu" : "100m",
              "requestsMem" : "300Mi"
            } ]
          }
        }
      },
      "stable" : true,
      "translate" : {
        "en_US" : {
          "addon" : {
            "changeLog" : "",
            "description" : ""
          },
          "description" : {
            "Parameters.flavor1.description" : "Deploy the add-on with two instances, delivering high availability but requiring more compute resources.",
            "Parameters.flavor1.name" : "HA",
            "Parameters.flavor2.description" : "Deploy the add-on with one instance.",
            "Parameters.flavor2.name" : "Standalone",
            "Parameters.flavor3.name" : "Custom"
          }
        },
        "fr_FR" : {
          "addon" : {
            "changeLog" : "",
            "description" : ""
          },
          "description" : {
            "Parameters.flavor1.description" : "Déployez avec deux instances, haute disponibilité.",
            "Parameters.flavor1.name" : "HA",
            "Parameters.flavor2.description" : "Déployez avec une seule instance.",
            "Parameters.flavor2.name" : "Célibataire",
            "Parameters.flavor3.name" : "Douane"
          }
        },
        "zh_CN" : {
          "addon" : {
            "changeLog" : "",
            "description" : ""
          },
          "description" : {
            "Parameters.flavor1.description" : "Dual-instance deployment features high availability but requires more compute resources.",
            "Parameters.flavor1.name" : "High availability",
            "Parameters.flavor2.description" : "Single-instance deployment",
            "Parameters.flavor2.name" : "Single instance",
            "Parameters.flavor3.description" : "Custom resource specifications for deployment",
            "Parameters.flavor3.name" : "Custom"
          }
        }
      },
      "supportVersions" : null,
      "creationTimestamp" : "2023-05-12T16:10:05Z",
      "updateTimestamp" : "2023-05-12T16:10:05Z"
    }
  }
}

Status Codes

Status Code	Description
200	The add-on pod has been updated.

Error Codes

See Error Codes.

Parent topic: Add-on Management

Previous topic: Listing Add-on Templates

Next topic: Rolling Back an Add-on Instance