Actualice un solo asiento.
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 actualizar. Puede obtenerlo del InstanceCode devuelto por Obtener detalles de asientos de la suscripción.
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. |
InstanceId | string | Sí | ID de la instancia de asiento que se actualizará. |
Configs | Array | Sí | Propiedades del módulo. |
Configs.N.Code | string | No | Código de la propiedad del módulo. Ejemplo: |
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. Para una actualización, especifique el nivel de destino en Configs, por ejemplo, plan_type=pro.
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=UpgradeCreditSeat" \
--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-example0000000003" \
--data-urlencode "Configs.1.Code=plan_type" \
--data-urlencode "Configs.1.Value=pro"
Ejemplo de respuesta
{
"RequestId": "request-id-example",
"Success": true,
"Code": "Success",
"Message": "Successful!",
"Data": {
"OrderId": 1234567890123458
}
}
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.