Tenant Cloud Compute Auto Scaling Launch Configuration APIs ModifyLaunchConfigurationAttributes

ModifyLaunchConfigurationAttributes

Last Updated At: 2026-08-02 00:05:29

1. Interface Description

Interface request domain name: as.api3.convergecloud.com.

This API (ModifyLaunchConfigurationAttributes) is used to modify specific attributes of a launch configuration.

  • The changes in the launch configuration do not affect the existing instances. New instances will be created based on the new launch configuration.
  • This API supports modifying certain simple types of attributes.

Default interface request rate limit: 20 times per second.

Interface update time: 2022-11-04 17:56:13.

The interface only verifies the signature but does not authenticate.

2. Input Parameters

The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.

Parameter name Required Allow NULL Type Description
Action Yes No String Public parameter, The value of this interface: ModifyLaunchConfigurationAttributes
Version Yes No String Public parameter, The value of this interface: 2018-04-19
Region No No String Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface
LaunchConfigurationId Yes No String Launch Configuration ID
Example: asc-aaaabbbb
ImageId No No String Specify a valid image ID, in the format of img-8toqc6s3. There are four image types:
  • Public Image
  • Custom Image
  • Shared Image
  • Service Market Image

    • You can obtain available image IDs in the following ways:
  • Image IDs for the public iImage, custom image, and shared image can be queried by logging in to the console.
  • By calling the ImageId field in the return information from the DescribeImages interface.

    • Example: img-8toqc6s3
    InstanceTypes No No Array of String List of instance types. Each type specifies different resource specifications. You can specify up to 10 instance types.
    The launch configuration uses InstanceType to indicate one single instance type and InstanceTypes to indicate multiple instance types. If you specify the InstanceTypes parameter, the original InstanceType parameter automatically becomes invalid.
    Example: S5.SMALL2
    InstanceTypesCheckPolicy No No String Instance type verification policy, which works when the instance types are actually modified. Valid values: ALL and ANY. Default value: ANY.

  •  ALL: the verification is successful only if all instance types are available. Otherwise, the verification fails.

  •  ANY: the verification is successful if one of the instance types is available. Otherwise, the verification fails.

    Common reasons for instance type unavailability include: the instance type is sold out and the corresponding cloud disks are sold out.
    If one of the models specified in the InstanceTypes parameter does not exist or is no longer available, the verification fails regardless of the value of the InstanceTypesCheckPolicy parameter.
    Example: ALL
    		•
    LaunchConfigurationName No No String Display name of the launch configuration. The name can contain only letters, digits, underscores (_), hyphens (-), and decimal points (.) and must be up to 60 bytes in length.
    Example: myascname
    UserData No No String Custom Base64-encoded data. The length must be up to 16 KB. If you want to clear custom data, set the UserData parameter to an empty string.
    Example: ""

    3. Output Parameters

    Parameter name Type Description
    RequestId String Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem.

    4. Error Code

    The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.

    Error Code Description
    AccountQualificationRestrictions The requesting account failed to pass the qualification review.
    InvalidParameterValue.LaunchConfigurationNameDuplicated The launch configuration name already exists.
    InvalidParameterValue.CvmConfigurationError Exception with CVM parameter validation.
    InvalidImageId.NotFound The image cannot be found.
    CallCvmError CVM API call failed.
    InvalidParameterValue.InstanceTypeNotSupported Unsupported instance type