Alibaba Cloud Model Studio:Renovar asientos

Renueve una suscripción de asientos como un todo.

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.
Period	integer	Sí	Período de suscripción. Valor mínimo: 1.
PeriodUnit	string	Sí	Unidad del período. Valores válidos: Year y Month.
AutoRenew	boolean	No	Indica si se habilita la renovación automática.

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.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=RenewCreditSeat" \
    --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"

Ejemplo de respuesta

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

Códigos de error

Códigos de error comunes para la renovación: INSTANCE_HOLDING_LIMIT_EXCEEDED, MissingParameter y ResourceNotExists.

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.