You can call this operation to release all nodes in a cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description 
Action String Yes ReleaseCluster

The operation that you want to perform. Set the value to ReleaseCluster.

Id String Yes C-D7958B72E59BAB88

The ID of the cluster.

RegionId String Yes cn-hangzhou

The ID of the region where your cluster resides.

AccessKeyId String No LTAI8ljWyu7y****

The AccessKey ID provided to you by Alibaba Cloud, which specifies the ID of the user.

ForceRelease Boolean No true

Specifies whether you forcibly release the nodes. If you do not specify this parameter and enable the log storage feature, the system will save the job logs to your OSS bucket. The log storage process takes a few minutes.

You can also set this parameter to true. In this case, the nodes are released immediately and the job logs are not saved.

Response parameters

Parameter Type Example Description
RequestId String BF4FBAC6-B03E-4BFB-B6DB-EB53C34F2E22

The ID of the request.

Examples

Sample requests


http(s)://[Endpoint]/? Action=ReleaseCluster
&Id=C-D7958B72E59BAB88
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<ReleaseClusterResponse>
	  <RequestId>1BD8FE28-82AC-4433-848A-37B4928430C4</RequestId>
</ReleaseClusterResponse>

JSON format

{
	"RequestId":"1BD8FE28-82AC-4433-848A-37B4928430C4"
}

Error codes

HTTP status code Error code Error message Description 
403 Params.Illegal The specified parameters are wrongly formed.. The error message returned because the format of the specified parameters is invalid.
500 InternalError The request processing has failed due to some unknown error. The error message returned because an internal error has occurred. Submit a ticket.
404 ClusterId.NotFound The ClusterId provided does not exist in our records. The error message returned because the ID of the specified cluster does not exist. Check the ID of the cluster.
500 InternalError The request processing has failed due to some unknown error. The error message returned because an internal error has occurred. Submit a ticket.
403 User.OtherUserResource.NotAllow It is not allowed to operate other user's resource The error message returned because you are not allowed to manage resources of other users.
403 User.Account.Abnormal The User Account maybe is out of service! The error message returned because the Alibaba Cloud account is invalid.
403 Cluster. Role. NotConfirm The Role for EMR service to operate is Not confirmed! The error message returned because the Resource Access Management (RAM) role you created for the EMR service is not granted the required permissions. Grant the required permissions and try again.
404 ClusterId.NotFound ClusterId [%s] does not exist. The error message returned because the ID of the specified cluster does not exist. Check the ID of the cluster.
400 Prepaid.Cluster.Cannot.Release Prepaid cluster do not support release operation! The error message returned because the nodes in a subscription cluster cannot be released.
400 Cluster.Cannot.Release Cluster has been release or did not start normal! The error message returned because the cluster is invalid. Select a valid cluster.
400 Cluster.RegionId.NotMatch Cluster does not exist in region [%s]! The error message returned because the cluster does not belong to the region. Switch to the region to which the cluster belongs.

For a list of error codes, visit the API Error Center.