Skip to main content

Create Seats (New Purchase)

Create one or more Token Plan team edition seats.

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 ProductCode, ProductType, and SubscriptionType by calling QueryProductList. For Token Plan team edition, the example values are sfm, sfm_tokenplanteams_dp_cn, and Subscription.

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: SubscriptionConfigs.1.Seats and SubscriptionConfigs.1.Configs.1.Code, 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.

Period

integer

Yes

Subscription period. Minimum value: 1.

PeriodUnit

string

Yes

Unit of the subscription period. Valid values:
Year
Month

AutoRenew

boolean

No

Specifies whether to enable auto-renewal.

SubscriptionConfigs

Array

Yes

Subscription specifications. You can create multiple specifications in one request.

SubscriptionConfigs.N.Seats

long

Yes

Number of seats. Minimum value: 1.

SubscriptionConfigs.N.Configs

Array

Yes

Module properties.

SubscriptionConfigs.N.Configs.N.Code

string

No

Module property code. Example: plan_type.

SubscriptionConfigs.N.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=CreateCreditSeat" \
    --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 "Period=1" \
    --data-urlencode "PeriodUnit=Month" \
    --data-urlencode "AutoRenew=false" \
    --data-urlencode "SubscriptionConfigs.1.Seats=1" \
    --data-urlencode "SubscriptionConfigs.1.Configs.1.Code=plan_type" \
    --data-urlencode "SubscriptionConfigs.1.Configs.1.Value=standard"

Response example 

{
  "RequestId": "request-id-example",
  "Success": true,
  "Code": "Success",
  "Message": "Successful!",
  "Data": {
    "OrderId": 1234567890123456,
    "InstanceId": ["subs-example0000000001"],
    "HostId": "cn"
  }
}

Error codes

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