Skip to main content

Add Seats

Add seats to an existing subscription.

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 an existing Token Plan team edition seat subscription, and you have obtained ProductCode, ProductType, and SubscriptionType by calling QueryProductList.

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. Array parameters use the Flat format: Configs.1.Code and Configs.1.Value, where the index starts from 1.

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.

Seats

long

Yes

Number of seats to add. Minimum value: 1.

Configs

Array

Yes

Module properties.

Configs.N.Code

string

No

Module property code. Example: plan_type.

Configs.N.Value

string

No

Module property value. Examples: standard, pro, and max.

Code and Value in Configs must be specified as a pair. The supported values depend on the product.

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.OrderId

long

Order ID.

Data.InstanceId

Array[string]

Instance IDs.

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.

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=AddCreditSeats" \
    --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 "Seats=1" \
    --data-urlencode "Configs.1.Code=plan_type" \
    --data-urlencode "Configs.1.Value=standard"

Response example 

{
  "RequestId": "request-id-example",
  "Success": true,
  "Code": "Success",
  "Message": "Successful!",
  "Data": {
    "OrderId": 1234567890123457,
    "InstanceId": ["subs-example0000000002"]
  }
}

Error codes

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