ModifyInstancesRenewFlag

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

1. Interface Description

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

This API (ModifyInstancesRenewFlag) is used to modify a renewal flag of a monthly subscription instance.

Once an instance is marked as auto-renewal, the instance will be automatically renewed for 1 month each time it expires.
Batch operations are supported. A maximum of 100 batch instances per request are allowed.

Default interface request rate limit: 10 times per second.

Interface update time: 2018-04-04 09:23:06.

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: ModifyInstancesRenewFlag
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
InstanceIds	Yes	No	Array of String	One or more instance IDs to be operated. You can obtain the instance ID through the `InstanceId` in the returned value from the API DescribeInstances. A maximum of 100 batch instances per request are allowed. Example: ["ins-r8hr2upy","ins-5d8a23rs"]
RenewFlag	Yes	No	String	Auto-renewal flag. Value range: NOTIFY_AND_AUTO_RENEW: Notifies of expiration and performs auto-renewal NOTIFY_AND_MANUAL_RENEW: Notifies of expiration but does not perform auto-renewal DISABLE_NOTIFY_AND_MANUAL_RENEW: Does not notify of expiration nor perform auto-renewal If this parameter is specified to NOTIFY_AND_AUTO_RENEW, the instance will be automatically renewed on a monthly basis after it expires if there is sufficient account balance. Example: NOTIFY_AND_AUTO_RENEW

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
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.
InvalidParameterValue.LimitExceeded	The parameter value is out of range
InvalidInstanceId.Malformed	Invalid Instance ID. The format of the specified instance ID is incorrect, for example, an instance ID length error `ins-1122`.