Tenant Cloud Compute Cloud Virtual Machine Instance APIs InquiryPriceResetInstance

InquiryPriceResetInstance

Last Updated At: 2026-08-03 00:05:04

1. Interface Description

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

This API (InquiryPriceResetInstance) is used to inquire about the price for reinstalling an instance. * If you have specified the parameter ImageId, inquire about the price for reinstallation by using the specified image. Otherwise, inquire about the price for reinstallation based on the image currently used by the instance. * Currently, only instances with System Disk Type of CLOUD_BASIC, CLOUD_PREMIUM, or CLOUD_SSD are supported for inquiring about the price for reinstallation caused by switching between Linux and Windows operating systems through this API. * Currently, instances in overseas regions are not supported for inquiring about the price for reinstallation caused by switching between the Linux and Windows operating systems through this API.

Specify a valid Image ID, in the format of img-xxx. There are four types of images:

  • Public Image
  • Custom Image
  • Shared Image

  • You can obtain available image IDs in the following ways:
  • The image IDs for the Public Image, Custom Image, and Shared Image can be queried by logging in to the Console;
  • Through the ImageId field in the returned information by calling the API DescribeImages.

    • Default interface request rate limit: 10 times per second.

    Interface update time: 2022-04-23 09:45:08.

    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: InquiryPriceResetInstance
    Version Yes No String Public parameter, The value of this interface: 2017-03-12
    Region No No String Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface
    InstanceId Yes No String Instance ID. Can be obtained through the InstanceId in the returned value from the API DescribeInstances.
    Example: ins-fd8spnmq
    ImageId No No String Specify a valid Image ID, in the format of img-xxx. There are three types of images:
  • Public Image
  • Custom Image
  • Shared Image

    • You can obtain available image IDs in the following ways:
  • The image IDs for the Public Image, Custom Image, and Shared Image can be queried by logging in to the Console;
  • Through the ImageId field in the returned information by calling the API DescribeImages.

    • Example: img-8toqc6s3
    SystemDisk No No SystemDisk Instance system disk configuration information. Instances whose system disk is a CBS can specify the system disk size after reinstallation through this parameter to perform expansion on the system disk. If not specified, the default system disk size retains unchanged. Only expanding the system disk size is supported, but reducing the system disk size is not supported. Reinstallation only supports modifying the system disk size but the system disk type. For example, "SystemDisk":{"DiskSize":xxx}.
    Example:View
    LoginSettings No No LoginSettings Instance login settings. You can set login method, password, or key of the instance or retain the original login settings of the image. By default, a password will be randomly generated and notified to the user through Message Center.
    Example:View
    EnhancedService No No EnhancedService Enhanced services. You can specify whether to enable services such as Cloud Security and Cloud Monitor through this parameter. If this parameter is not specified, the Cloud Monitor and Cloud Security is enabled by default.
    Example:View

    3. Output Parameters

    Parameter name Type Description
    Price Price This parameter indicates the price for reinstalling to the corresponding configuration instance.
    Example:View
    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
    InvalidInstanceId.NotFound No corresponding instance was found.
    InvalidInstance.NotSupported Unsupported instance.
    InvalidParameterValue Invalid parameter value. The format of the parameter value is incorrect or not supported, etc.
    InternalServerError Internal operation error.
    InvalidInstanceId.Malformed Invalid Instance ID. The format of the specified instance ID is incorrect, for example, an instance ID length error ins-1122.
    MissingParameter Parameters are missing. The request did not include mandatory parameters.