Skip to main content

Reduce Seats

Unsubscribe a single unused seat.

Prerequisites

You have obtained the AccessKey of an Alibaba Cloud account or a RAM user, and the identity has been granted the RAM permissions required to call BssOpenApi. We recommend that you set the AccessKey as the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET instead of hard-coding it. You have obtained the InstanceId of the seat to unsubscribe. You can obtain it from the InstanceCode returned by Get subscription seat details. Only seats that have not used Credits can be unsubscribed.

Request description

  • HTTP method：POST
  • Request URL

    Region

    Endpoint

    China site

    POST https://business.aliyuncs.com/

  • Authentication This operation belongs to BssOpenApi (version 2023-09-30) and uses AccessKey-based RPC signatures (HMAC-SHA1). The Authorization: Bearer {API_KEY} scheme is not supported. We recommend that you call this operation with the CommonRequest class of an Alibaba Cloud SDK. The SDK generates the common parameters and calculates the signature automatically.

Request parameters

All parameters are passed as form data or in the query string.

Parameter

Type

Required

Description

ProductCode

string

Yes

Product code. Obtain it by calling QueryProductList. Example: sfm.

ProductType

string

Yes

Product type. Obtain it by calling QueryProductList. Example: sfm_tokenplanteams_dp_cn.

SubscriptionType

string

Yes

Subscription type. Obtain it by calling QueryProductList. Example: Subscription.

ClientToken

string

Yes

Idempotency token. Generate it on the client and keep it unique across requests. Maximum length: 64 ASCII characters.

InstanceId

string

Yes

ID of the seat instance to unsubscribe. Only seats that have not used Credits are supported.

Response parameters

Parameter

Type

Description

RequestId

string

Request ID.

Success

boolean

Whether the request was successful.

Code

string

Result code. The value is Success when the request succeeds.

Message

string

Result message.

Data

object

Business data.

Data.InstanceId

string

Instance ID.

Data.Success

boolean

Whether the refund was successful.

Data.ErrorInfo

string

Error information returned when the refund fails.

Data.ErrorCode

string

Error code returned when the refund fails.

Data.HostId

string

Site identifier. The China site returns cn. This field may be omitted in some responses.

AccessDeniedDetail

string

Detailed error information returned when RAM permissions are denied.

The outer Success indicates whether the request was accepted. Use Data.Success to determine the refund result. If the refund fails, check Data.ErrorInfo and Data.ErrorCode.

Request example

This operation uses BssOpenApi RPC signatures. In the following example, ${SIGNATURE} must be calculated with the signature algorithm, and SignatureNonce and Timestamp must be replaced with actual values. An Alibaba Cloud SDK handles the common parameters and signature automatically. 
curl -X POST "https://business.aliyuncs.com/" \
    --data-urlencode "Action=ReduceCreditSeats" \
    --data-urlencode "Version=2023-09-30" \
    --data-urlencode "Format=JSON" \
    --data-urlencode "AccessKeyId=${ALIBABA_CLOUD_ACCESS_KEY_ID}" \
    --data-urlencode "SignatureMethod=HMAC-SHA1" \
    --data-urlencode "SignatureVersion=1.0" \
    --data-urlencode "SignatureNonce=${SIGNATURE_NONCE}" \
    --data-urlencode "Timestamp=2026-01-01T12:00:00Z" \
    --data-urlencode "Signature=${SIGNATURE}" \
    --data-urlencode "ProductCode=sfm" \
    --data-urlencode "ProductType=sfm_tokenplanteams_dp_cn" \
    --data-urlencode "SubscriptionType=Subscription" \
    --data-urlencode "ClientToken=example-client-token-001" \
    --data-urlencode "InstanceId=subs-example0000000004"

Response example 

{
  "RequestId": "request-id-example",
  "Success": true,
  "Code": "Success",
  "Message": "Successful!",
  "Data": {
    "Success": true
  }
}

Error codes

If the call fails, an error message is returned. For more error codes and solutions, see BssOpenApi error codes.