lista de agentes de uip/compartir

uip agent list y uip agent share operan en soluciones de Studio Web: la representación en la nube de un proyecto de agente. list enumera las soluciones visibles para el usuario actual; share gestiona el acceso de usuarios y grupos a una única solución. Se agrupan aquí porque ambos son verbos de gestión de Studio Web puros, distintos de las operaciones a nivel de archivo en uip agent file y de las operaciones del lado de Orchestrator en deploy / run.

Ambos verbos requieren una sesión CLI activa (uip login).

Todos los subcomandos respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

---

lista de agentes de uip

Enumerar soluciones de Studio Web, opcionalmente filtradas por una palabra clave.

Sinopsis

uip agent list [-s <query>] [-l <n>] [--login-validity <minutes>]

Argumentos

Nada.

Opciones

Marca	Predeterminado	Propósito
-s, --search <query>	—	Filtro de palabras clave aplicado al punto final de Studio Web SearchSolutionsAndProjects .
-l, --limit <n>	20	Número máximo de resultados. Enviado como el parámetro de consulta pagingOptions.limit .
--login-validity <minutes>	10	Minutos mínimos de validez del token requeridos.

Ejemplos

# Simplest — list up to 20 solutions
uip agent list

# Filter by keyword
uip agent list --search invoice

# Page through larger result sets
uip agent list --limit 100

Forma de datos (--json de salida)

{
  "Code": "AgentList",
  "Data": [
    {
      "Name": "Email Triage",
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "Status": "Completed",
      "PublishStatus": "Published",
      "LastModified": "2025-04-10T14:30:00Z",
      "Projects": 2
    }
  ]
}

Los conjuntos de resultados vacíos producen Data: { "Message": "No solutions found" } en lugar de una matriz vacía. Projects es el recuento de proyectos anidados dentro de la solución, no un listado.

---

recurso compartido de agente de uip

Gestionar el acceso de usuarios y grupos a una solución de Studio Web. Tres subcomandos: add, list y remove.

Sinopsis

uip agent share add    <solutionId> <entityId> [--permission <perm>] [--group] [--login-validity <minutes>]
uip agent share list   <solutionId>                                   [--login-validity <minutes>]
uip agent share remove <solutionId> <entityId>                        [--group] [--login-validity <minutes>]

Agregar recurso compartido de agente de UIP

Concede acceso a un usuario o grupo.

Argumentos

• <solutionId> (obligatorio) : UUID de la solución.
• <entityId> obligatorio) : UUID de usuario o grupo.

Opciones

Marca	Predeterminado	Propósito
--permission <perm>	write	Nivel de permiso. Uno de: none, read, write, publish, readWritePublish. No distingue entre mayúsculas y minúsculas; los valores no válidos fallan con un error de validación.
--group	desactivado (usuario)	Trata <entityId> como un grupo en lugar de como un usuario.
--login-validity <minutes>	10	Minutos mínimos de validez del token requeridos.

Ejemplos

# Grant write access to a user
uip agent share add \
  a1b2c3d4-0000-0000-0000-000000000001 \
  a1b2c3d4-0000-0000-0000-000000000501 \
  --permission write

# Grant read-only access to a group
uip agent share add <solutionId> <groupId> --permission read --group

# Full access (read + write + publish)
uip agent share add <solutionId> <userId> --permission readWritePublish

Forma de datos (--output json)

{
  "Code": "AgentShare",
  "Data": {
    "Status": "Solution shared successfully",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "SharedWith": "a1b2c3d4-0000-0000-0000-000000000501",
    "IsGroup": false,
    "Permission": "write"
  }
}

lista compartida de agente de uip

Enumerar usuarios y grupos con acceso a una solución.

Argumentos

• <solutionId> (obligatorio) : UUID de la solución.

Opciones

Solo --login-validity.

Ejemplo

uip agent share list a1b2c3d4-0000-0000-0000-000000000001

Forma de datos (--output json)

{
  "Code": "AgentShareList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000501",
      "Name": "Jane Doe",
      "Email": "[e-mail]",
      "IsGroup": false,
      "Permission": "write"
    }
  ]
}

Una respuesta vacía devuelve Data: { "Message": "No sharing permissions found for this solution" }.

agente de uip compartir eliminar

Revocar el acceso de un usuario o grupo.

Argumentos

• <solutionId> (obligatorio) : UUID de la solución.
• <entityId> obligatorio) : UUID de usuario o grupo.

Opciones

Marca	Predeterminado	Propósito
--group	desactivado (usuario)	Trata <entityId> como un grupo en lugar de como un usuario.
--login-validity <minutes>	10	Minutos mínimos de validez del token requeridos.

Ejemplo

uip agent share remove a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000501

Forma de datos (--output json)

{
  "Code": "AgentShareRemove",
  "Data": {
    "Status": "Access removed successfully",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "RemovedEntity": "a1b2c3d4-0000-0000-0000-000000000501"
  }
}

---

Relacionado

• uip agent push : importa un proyecto y obtiene el SolutionId que utilizas aquí.
• uip agent pull : descarga una solución enumerada por list.
• uip agent file : enumera, descarga y carga archivos dentro de los proyectos de una solución.

Ver también

• Autenticación : sesiones, tenants y --login-validity.
• Opciones globales, códigos de salida.