Alibaba Cloud Model Studio:Cancelar asientos

Cancele un solo asiento sin usar.

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 el InstanceId del asiento que desea cancelar. Puede obtenerlo del InstanceCode devuelto por Obtener detalles de asientos de la suscripción. Solo se pueden cancelar los asientos que no han usado Credits.

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.
InstanceId	string	Sí	ID de la instancia de asiento que se cancelará. Solo se admiten asientos que no han usado Credits.

El Success externo indica si la solicitud se aceptó. Use Data.Success para determinar el resultado del reembolso. Si falla, consulte Data.ErrorInfo y Data.ErrorCode.

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.InstanceId	string	ID de instancia.
Data.Success	boolean	Indica si el reembolso se realizó correctamente.
Data.ErrorInfo	string	Información de error devuelta cuando el reembolso falla.
Data.ErrorCode	string	Código de error devuelto cuando el reembolso falla.
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=ReduceCreditSeats" \
    --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 "InstanceId=subs-example0000000004"

Ejemplo de respuesta

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

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.