Cree uno o más asientos de Token Plan edición equipo.
Requisitos previos
Ha obtenido el AccessKey de una cuenta de Alibaba Cloud o de un usuario RAM, y a la identidad se le han concedido los permisos RAM necesarios para llamar a BssOpenApi. Le recomendamos configurar el AccessKey como las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET en lugar de codificarlo directamente.
Ha obtenido ProductCode, ProductType y SubscriptionType llamando a QueryProductList. Para Token Plan edición equipo, los valores de ejemplo son sfm, sfm_tokenplanteams_dp_intl y Subscription.
Descripción de la solicitud
-
Método HTTP:POST
-
URL de la solicitud
Región
Endpoint
Singapur
-
Autenticación
Esta operación pertenece a BssOpenApi (versión
2023-09-30) y usa firmas RPC de AccessKey (HMAC-SHA1). No se admite el esquemaAuthorization: Bearer {API_KEY}. Le recomendamos llamar a esta operación con la claseCommonRequestde un SDK de Alibaba Cloud. El SDK genera los parámetros comunes y calcula la firma automáticamente.
Parámetros de la solicitud
Todos los parámetros se pasan como datos de formulario o en la cadena de consulta. Los parámetros de matriz usan el formato Flat: Configs.1.Code y Configs.1.Value, donde el índice comienza en 1.
Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
ProductCode | string | Sí | Código de producto. Obténgalo llamando a |
ProductType | string | Sí | Tipo de producto. Obténgalo llamando a |
SubscriptionType | string | Sí | Tipo de suscripción. Obténgalo llamando a |
ClientToken | string | Sí | Token de idempotencia. Genérelo en el cliente y manténgalo único entre solicitudes. Longitud máxima: 64 caracteres ASCII. |
Period | integer | Sí | Período de suscripción. Valor mínimo: 1. |
PeriodUnit | string | Sí | Unidad del período. Valores válidos: |
AutoRenew | boolean | No | Indica si se habilita la renovación automática. |
SubscriptionConfigs | Array | Sí | Lista de especificaciones de suscripción. Puede crear varias especificaciones en una sola solicitud. |
SubscriptionConfigs.N.Seats | long | Sí | Número de asientos. Valor mínimo: 1. |
SubscriptionConfigs.N.Configs | Array | Sí | Propiedades del módulo. |
SubscriptionConfigs.N.Configs.N.Code | string | No | Código de la propiedad del módulo. Ejemplo: |
SubscriptionConfigs.N.Configs.N.Value | string | No | Valor de la propiedad del módulo. Ejemplos: |
NotaCode y Value en Configs deben especificarse como un par. Los valores admitidos dependen del producto.
Parámetros de respuesta
Parámetro | Tipo | Descripción |
|---|---|---|
RequestId | string | ID de la solicitud. |
Success | boolean | Indica si la solicitud se realizó correctamente. |
Code | string | Código de resultado. El valor es |
Message | string | Mensaje de resultado. |
Data | object | Datos del negocio. |
Data.OrderId | long | ID del pedido. |
Data.InstanceId | Array[string] | ID de instancia. |
Data.HostId | string | Identificador del sitio. Este campo puede omitirse en algunas respuestas. |
AccessDeniedDetail | string | Información detallada del error devuelta cuando se deniegan los permisos RAM. |
Ejemplo de solicitud
Esta operación usa firmas RPC de BssOpenApi. En el siguiente ejemplo, ${SIGNATURE} debe calcularse con el algoritmo de firma, y SignatureNonce y Timestamp deben reemplazarse con valores reales. Un SDK de Alibaba Cloud maneja los parámetros comunes y la firma automáticamente.
curl -X POST "https://business.ap-southeast-1.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_intl" \
--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"
Ejemplo de respuesta
{
"RequestId": "request-id-example",
"Success": true,
"Code": "Success",
"Message": "Successful!",
"Data": {
"OrderId": 1234567890123456,
"InstanceId": [
"subs-example0000000001"
]
}
}
Códigos de error
Si la llamada falla, se devuelve un mensaje de error. Para obtener más códigos de error y soluciones, consulte Códigos de error de BssOpenApi.