All Products
Search
Document Center

ENS:ModifyInstanceAutoRenewAttribute

Last Updated:Apr 09, 2024

Configures auto-renewal for instances.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
InstanceIdsstringYes

The IDs of the instances. Separate IDs with semicolons (;).

instance-test
AutoRenewstringYes

Specifies whether to enable the auto-renewal feature. Valid values: True and False. Default value: False.

false
DurationstringNo

The auto-renewal period of the instance. Unit: months. Valid values: 1 to 9 and 12. This parameter is required if the AutoRenew parameter is set to true.

12
RenewalStatusstringNo

Specifies whether to renew the instance. The RenewalStatus parameter has a higher priority than the AutoRenew parameter. If you do not specify RenewalStatus, the AutoRenew parameter is used by default.

  • AutoRenewal: Auto-renewal is enabled for the instance.
  • Normal: Auto-renewal is disabled for the instance.
  • NotRenewal: The instance is not renewed.

The system no longer sends an expiration notification but sends only a renewal notification three days before the instance expires. To renew the instance, you can change the value of this parameter from NotRenewal to Normal and then manually renew the instance, or change the value of this parameter from NotRenewal to AutoRenewal.

Normal

Response parameters

ParameterTypeDescriptionExample
object
Codeinteger

The returned service code. 0 indicates that the request was successful.

0
RequestIdstring

The ID of the request.

4DD66F05-3116-4BAA-B588-52EB2E7F431D

Examples

Sample success responses

JSONformat

{
  "Code": 0,
  "RequestId": "4DD66F05-3116-4BAA-B588-52EB2E7F431D"
}

Error codes

HTTP status codeError codeError messageDescription
400MissingParameterThe input parameters that is mandatory for processing this request is not supplied.-
400InstanceNotExistsThe user have no instances.-
400CallInterfaceCall Interface Happen Error.An error occurred when you call the operation.
400NoPermissionPermission denied.-
400InvalidParameter.%sThe specified field %s invalid. Please check it again.-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-03-12The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change