Alibaba Cloud Model Studio:Agregar asientos

Agregue asientos a una suscripción existente.

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.

Tiene una suscripción de asientos de Token Plan edición equipo válida y ha obtenido ProductCode, ProductType y SubscriptionType llamando a QueryProductList.

Descripción de la solicitud

• Método HTTP：POST

• URL de la solicitud

  Región	Endpoint
  Singapur	POST https://business.ap-southeast-1.aliyuncs.com/

• 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 esquema Authorization: Bearer {API_KEY}. Le recomendamos llamar a esta operación con la clase CommonRequest de 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 QueryProductList. Ejemplo: sfm.
ProductType	string	Sí	Tipo de producto. Obténgalo llamando a QueryProductList. Ejemplo: sfm_tokenplanteams_dp_intl.
SubscriptionType	string	Sí	Tipo de suscripción. Obténgalo llamando a QueryProductList. Ejemplo: Subscription.
ClientToken	string	Sí	Token de idempotencia. Genérelo en el cliente y manténgalo único entre solicitudes. Longitud máxima: 64 caracteres ASCII.
Seats	long	Sí	Número de asientos que se agregarán. Valor mínimo: 1.
Configs	Array	Sí	Propiedades del módulo.
Configs.N.Code	string	No	Código de la propiedad del módulo. Ejemplo: plan_type.
Configs.N.Value	string	No	Valor de la propiedad del módulo. Ejemplos: standard, pro y max.

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 Success cuando la solicitud se realiza correctamente.
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=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_intl" \
    --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"

Ejemplo de respuesta

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

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.