Adding Existing CVMs to the Clusters

Last updated: 2020-06-04 16:47:35


    This is a legacy API which has been hidden and will no longer be updated. We recommend using the new TKE API 3.0 which is standardized and faster.

    1. API Description

    This API (AddClusterInstancesFromExistedCvm) is used to add existing CVMs to a cluster.

    Domain for API request:

    • This API can be called only when "status" of cluster is "Running".
    • This API can be called only when the status of current CVM is "Normal" or "Shut down". For more information, please see the list of instance statuses in DescribeInstances API.
    • The current CVM will be reinstalled, and the system is the same as the one specified when the cluster is created. Please ensure that there is no important file in the system disk.
    • The added CVMs and the current cluster must locate in the same VPC.
    • The added CVMs must belong to the default project.

    2. Input Parameters

    The following request parameter list only provides API request parameters. For other parameters, please see Common Request Parameters.

    Parameter Name Required Type Description
    clusterId Yes String Cluster ID. You can obtain this ID from the clusterId returned by the DescribeCluster API.
    instanceIds Yes String Enter the unInstanceId (instance ID) field returned via DescribeInstances API .
    password No String Instance password. It will be generated randomly if not set, and be sent via internal message. Linux instance's password should be a combination of 8-16 characters comprised of at least two of the following types: letters [a-z, A-Z], numbers [0-9], and special characters [( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' < > , . ? / ]. Windows instance's password should be a combination of 12-16 characters comprised of at least three of the following types: lowercase letters [a-z], uppercase letters [A-Z], numbers [0-9] and special characters [( ) ` ~ ! @ # $ % ^ & * - + = { } [ ] : ; ' , . ? /].
    keyId No String Key ID. You can use the key to log in to the instance after the key is associated. "keyId" can be obtained through DescribeKeyPairs API. Key and password cannot both be specified, and specifying key is not supported by Windows operating systems.

    3. Output Parameters

    Parameter Name Type Description
    code Int Common error code. 0: Successful. Other values: Failed
    message String Module error message description depending on API. For more information, please see Module Error Codes on Error Codes page.
    succInstanceIds Obj Array List of CVMs added to the cluster successfully
    faliInstanceIds Obj Array List of CVMs failed to be added to the cluster

    Details of "faliInstanceIds" field

    Parameter Name Type Description
    instanceId String Instance ID
    message String Reason for failure

    4. Example




          "code" : 0,
          "message" : "ok",

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback