ReleaseInstance - BSS OpenAPI - Alibaba Cloud Documentation Center

Releases instances by Virtual Network Operators (VNOs).

Operation description

This operation is provided for only VNOs to release instances. If a non-specific VNO calls this operation, the request is blocked.

Debugging

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

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
ProductCode	string	Yes	The code of the service.	ecs
SubscriptionType	string	Yes	The billing method. Valid values: Subscription: the subscription billing method. PayAsYouGo: the pay-as-you-go billing method.	PayAsYouGo
InstanceIds	string	Yes	The ID of the instance. Separate multiple IDs with commas (,). A maximum of 100 IDs can be specified.	rm-xxxxxxxxxxxx
RenewStatus	string	No	The method that is used to renew the instance. Valid values: AutoRenewal: automatically renews the instance. ManualRenewal: manually renews the instance. NotRenewal: does not renew the instance.	AutoRenewal
Region	string	No	The region in which the instance resides.	cn-hangzhou
ProductType	string	No	The type of the service.	ecs

Response parameters

Parameter	Type	Description	Example
	object	The return result.
Message	string	The description of the execution result.	successful
RequestId	string	The ID of the request, which can be used for troubleshooting.	UUID
Data	object	data
ReleaseResult	boolean	Indicates whether the instance is released.	true
HostId	string	The site of the execution host.	cn
Code	string	The HTTP status code.	Invalid_Product_Code
Success	boolean	A value of true indicates that the execution is complete. A value of false indicates that an error occurs during the execution.	true

Examples

Sample success responses

JSONformat

{
  "Message": "successful",
  "RequestId": "UUID",
  "Data": {
    "ReleaseResult": true,
    "HostId": "cn"
  },
  "Code": "Invalid_Product_Code",
  "Success": true
}

Error codes

HTTP status code	Error code	Error message
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

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