UIP es conexiones

Sintaxis y opciones para `uip es conexiones`, que gestiona las sesiones OAuth entre un tenant de UiPath y conectores externos.

uip is connections las sesiones OAuth del tenant contra los conectores. Una conexión es el enlace autenticado entre una carpeta de tenant de UiPath y una cuenta externa; lleva los tokens que resources execute y activities utilizan en runtime. Los verbos cubren el descubrimiento (list), la autenticación (create, edit) y las comprobaciones de estado (ping). Tanto create como edit abren la URL OAuth del conector en un navegador y sondean el servidor para comprobar que se ha completado (intervalo de 5 segundos, tiempo de espera total de 5 minutos).

Sinopsis

uip is connections <verb> [options]

Verbos

Verbo	Propósito
list	Enumerar conexiones, opcionalmente en el ámbito de un conector o carpeta.
create	Crea una nueva conexión a través del flujo OAuth del conector.
ping	Comprueba si una conexión está habilitada actualmente y es accesible.
edit	Vuelve a autenticar una conexión existente a través del flujo OAuth.

uip es la lista de conexiones

Enumera las conexiones en el tenant. El <connector-key> posicional opcional filtra el resultado a un conector; los marcadores pueden definir el ámbito por carpeta o ID de conexión único.

Argumentos

Nombre	Obligatorio	Propósito
[connector-key]	No	Clave de conector por la que filtrar (por ejemplo, uipath-zoho-desk). Omitir en la lista en todos los conectores.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--folder-key	Uuid	—	Clave de carpeta por la que filtrar. Debe ser un UUID.
—	--connection-id	id	—	Filtrar a un ID de conexión específico.
-t	--tenant	name	sesión predeterminada	Anula el tenant.
—	--refresh	Marca	Desactivado	Fuerza la nueva recuperación desde la API, ignorando la caché.

Ejemplos

uip is connections list

uip is connections list uipath-zoho-desk

uip is connections list uipath-zoho-desk --refresh \
    --output-filter 'Data[].{id:Id, state:State}'

Forma de datos (--json de salida)

{
  "Code": "ConnectionList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "Name": "Zoho Desk - Prod",
      "ConnectorKey": "uipath-zoho-desk",
      "ConnectorName": "Zoho Desk",
      "State": "Enabled",
      "Owner": "[e-mail]",
      "IsDefault": "No",
      "Folder": "Shared",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Created": "2026-01-10T10:00:00.000Z",
      "Updated": "2026-01-10T10:00:00.000Z"
    }
  ]
}

Si algunas conexiones están deshabilitadas, la respuesta incluye un campo Warning junto a Data. Un --folder-key no válido que no sea un UUID se rechaza por adelantado.

UIP es crear conexiones

Crea una nueva conexión a través del flujo OAuth del conector. La CLI abre la URL de autenticación en tu navegador (a menos que pases --no-browser) y sondea el servidor para que se complete. Intervalo de sondeo: 5 segundos. Tiempo de espera total: 5 minutos.

Argumentos

Nombre	Obligatorio	Propósito
<connector-key>	Sí	Clave del conector, por ejemplo uipath-zoho-desk.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.
—	--no-browser	Marca	Desactivado	No abra automáticamente el navegador; imprime la URL para la navegación manual.

Ejemplos

uip is connections create uipath-zoho-desk

# Headless / CI-friendly — print the URL instead of launching a browser
uip is connections create uipath-zoho-desk --no-browser

Forma de datos (--json de salida)

{
  "Code": "ConnectionCreated",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000010",
    "ConnectionName": "Zoho Desk",
    "Connector": "Zoho Desk",
    "State": "Enabled",
    "Owner": "[e-mail]",
    "Folder": "Shared",
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001"
  }
}

Modos de fallo:

• El usuario rechaza o la autenticación falla: Failure con el mensaje del servidor; salida 1.
• Tiempo de espera de la encuesta (5 minutos): Failure: "Authentication timed out after 5 minutes"; salida 2.
• Error de transporte de sondeo: Failure; salida 1.
• Interrumpido/abortado (Ctrl+C): Failure; salida 1.

uip es ping de conexiones

Comprueba si una conexión está habilitada actualmente y es accesible.

Argumentos

Nombre	Obligatorio	Propósito
<connection-id>	Sí	ID de conexión (UUID) devuelto por connections list o connections create.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.

Ejemplos

uip is connections ping a1b2c3d4-0000-0000-0000-000000000001

Forma de datos (--json de salida)

{
  "Code": "ConnectionPing",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Enabled",
    "Message": "Connection is active."
  }
}

Una conexión deshabilitada o inalcanzable emite Failure con Instructions: "Run 'uip is connections edit <id>' to re-authenticate.".

uip es edición de conexiones

Vuelve a autenticar una conexión existente. El mismo flujo OAuth que create, dirigido a un ID de conexión existente en lugar de emitir uno nuevo. Mismo contrato de sondeo y códigos de salida.

Argumentos

Nombre	Obligatorio	Propósito
<connection-id>	Sí	ID de conexión para volver a autenticar.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.
—	--no-browser	Marca	Desactivado	No abra automáticamente el navegador; imprime la URL para la navegación manual.

Ejemplos

uip is connections edit a1b2c3d4-0000-0000-0000-000000000001

uip is connections edit a1b2c3d4-0000-0000-0000-000000000001 --no-browser

Forma de datos (--json de salida)

{
  "Code": "ConnectionEdited",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "State": "Enabled"
  }
}

Relacionado

• uip is connectors : descubre claves de conector para create.
• uip is resources — Los verbos execute requieren --connection-id de una conexión aquí.
• uip is activities : enumera las operaciones que la conexión puede impulsar.
• uip is triggers : enlaces de eventos activados a través de una conexión.

Ver también

• Descripción general de la herramienta de Integration Service
• Opciones globales
• Códigos de salida