ListChatSessions - Resource Orchestration Service - Centro de documentación de Alibaba Cloud

Consulta las sesiones de ROS Agent V2 del usuario actual mediante paginación.

Descripción de la operación

Descripción de la solicitud

Al llamar al servicio V2, establezca AgentVersion en V2.
Esta operación solo devuelve las sesiones del usuario actual. De forma predeterminada, las sesiones se ordenan en orden descendente según UpdatedAt.
Puede utilizar el parámetro Mode para filtrar las sesiones por modo. Valores válidos: IaCCodeNormal y IaCCodePipeline.
No reutilice el NextToken anterior después de cambiar Mode.
Utilice los campos CreatedAt y UpdatedAt para la información de tiempo. El campo UpdatedTime en los metadatos es un campo de compatibilidad y no se devuelve en la respuesta actual.
El número de entradas solicitadas está sujeto al parámetro de solicitud MaxResults. Valores válidos: 1 a 100.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ros:ListChatSessions

list

*Todos los recursos.

*

Ninguna

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
MaxResults	integer	No	El número de sesiones que se devuelven por página. Valores válidos: 1 a 100. Valor predeterminado: 20.	20
NextToken	string	No	El token de paginación devuelto en la respuesta anterior. No especifique este parámetro para la primera solicitud. No reutilice el token anterior después de cambiar el modo.	CAES...
AgentVersion	string	No	Enruta la solicitud al backend de ROS Agent V2 cuando el valor se establece en V2.	V2
Mode	string	No	Filtra las sesiones por modo. Valores válidos: IaCCodeNormal y IaCCodePipeline. Valores válidos: IaCCodePipeline : El modo de sesión de pipeline. IaCCodeNormal : El modo de sesión normal.	IaCCodePipeline

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
MaxResults	integer	Un campo de compatibilidad. Este campo no se devuelve en la respuesta V2 actual. Consulte el parámetro de solicitud MaxResults para conocer el tamaño de página real.	20
NextToken	string	El token para la página siguiente. Este campo puede no devolverse o puede ser nulo en la última página.	CAES...
RequestId	string	El ID de solicitud de OpenAPI.	4C68F7A5-2D16-5C8F-A4B1-01E9C6A9B0D2
Sessions	array<object>	La lista de sesiones del usuario actual, ordenada en orden descendente según la hora de actualización.	[]
	object	El objeto de sesión.	{}
ClientReferenceId	string	El identificador de sesión personalizado definido por el cliente. Este identificador solo lo utiliza el cliente para identificar sus propias sesiones. El servidor no proporciona capacidades como la verificación de unicidad o el filtrado de listas basado en este identificador.	07484e4b81708f7586
FirstCursor	string	El valor del cursor del primer evento de Server-Sent Events (SSE) en el flujo SSE reproducible de la llamada a StartChat más reciente para la sesión actual. Puede utilizar este valor para reproducir el flujo SSE completo de la llamada a StartChat más reciente desde el principio.	v1.xsssaa.0
HistoryReadiness	string	El estado de preparación de los mensajes del historial de la sesión. El historial solo se puede cargar cuando el estado es READY. El historial no se puede cargar cuando el estado es STARTING, RUNNING, STOPPING o FINALIZING (en proceso), NOT_READY (no preparado), RECOVERY_REQUIRED (recuperación requerida) o UNKNOWN (desconocido).	STARTING
Mode	string	El modo de sesión. Valores válidos: IaCCodeNormal y IaCCodePipeline.	IaCCodePipeline
PipelineName	string	El nombre del pipeline al que pertenece la sesión. Valores válidos: EvaluationFirstSelling y SolutionFirstSelling. Este campo está vacío para las sesiones que no son de pipeline.	SolutionFirstSelling
SessionId	string	El ID de sesión. Puede utilizar este ID para volver a ingresar a StartChat, detener un chat llamando a StopChat y enumerar los mensajes del chat llamando a ListChatMessages.	7f4e2a8c6d9b4a1f8e3c5b7d2a6f9012
Summary	string	El resumen de la sesión. Actualmente, este campo comparte el mismo origen que Title y puede estar vacío.	Create a VPC template
Title	string	El título de la sesión. Este campo puede estar vacío.	Create a VPC template
UpdatedTime	string	Un campo de compatibilidad. Este campo no se devuelve en la respuesta V2 actual. Utilice UpdatedAt en su lugar. La hora está en formato ISO 8601, con precisión de segundos y termina con Z.	2026-08-26T10:00:00Z

Ejemplos

Respuesta exitosa

JSON Formato

{
  "MaxResults": 20,
  "NextToken": "CAES...",
  "RequestId": "4C68F7A5-2D16-5C8F-A4B1-01E9C6A9B0D2",
  "Sessions": [
    {
      "ClientReferenceId": "07484e4b81708f7586",
      "FirstCursor": "v1.xsssaa.0",
      "HistoryReadiness": "STARTING",
      "Mode": "IaCCodePipeline",
      "PipelineName": "SolutionFirstSelling",
      "SessionId": "7f4e2a8c6d9b4a1f8e3c5b7d2a6f9012",
      "Summary": "Create a VPC template",
      "Title": "Create a VPC template",
      "UpdatedTime": "2026-08-26T10:00:00Z"
    }
  ]
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.