- Información general
- Comience ya
- Conceptos
- Uso de UiPath CLI
- UiPath para agentes de codificación
- Guías prácticas
- Recetas de CI/CD
- Referencia de los comandos
- Información general
- Códigos de salida
- Opciones globales
- agente de código UIP
- UIP Docsai
- añadir-entidad-de-datos-de-prueba
- añadir-cola-de-datos-de-prueba
- añadir-variación-de-datos-de-prueba
- Analizar
- Crear
- Crear proyecto
- Diferencia
- Buscar actividades
- obtener-reglas-del-analizador
- obtener-predeterminado-actividad-xaml
- obtener-errores
- obtener-casos-de-prueba-manual
- obtener-pasos-de-prueba-manual
- obtener versiones
- get-workflow-example
- indicar-aplicación
- indicar-elemento
- inspeccionar-paquete
- install-data-fabric-entities
- instalar-o-actualizar-paquetes
- enumerar-data-fabric-entities
- ejemplos-de-flujo-de-trabajo-de-lista
- Paquete
- restore
- archivo de ejecución
- plantillas-de-búsqueda
- iniciar-studio
- detener la ejecución
- UIA
- Seguimientos de UIP
- Migración
- Referencia y soporte
Guía del usuario de UiPath CLI
uip is resources con los objetos de runtime que direcciona un conector: tickets, contactos, registros, archivos. list enumera los objetos del conector, describe devuelve el esquema de campo y las operaciones para un objeto, y execute llama al plano de datos del conector (Crear/Enumerar/Obtener/Actualizar/Reemplazar/Eliminar) contra una conexión. Cada verbo execute requiere --connection-id; las lecturas de metadatos en caché (list, describe) lo aceptan opcionalmente para mostrar objetos/campos personalizados.
Sinopsis
uip is resources <verb> [options]
uip is resources <verb> [options]
Verbos
| Verbo | Propósito |
|---|---|
list | Enumerar objetos disponibles en un conector; filtrar opcionalmente por operación. |
describe | Describir las operaciones y el esquema de campo de un objeto. |
execute | Llama al plano de datos del conector (Crear/Enumerar/Obtener/Actualizar/Reemplazar/Eliminar). |
uip es una lista de recursos
Enumera los objetos disponibles en un conector. Los resultados dependen de si se proporciona --connection-id : los listados de ámbito de conexión incluyen objetos personalizados; los listados sin ámbito no (la CLI muestra un Warning en ese caso).
Argumentos
| Nombre | Obligatorio | Propósito |
|---|---|---|
<connector-key> | Sí | Clave del conector, por ejemplo uipath-zoho-desk. |
Opciones
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --operation | ENUM | — | Filtrar por operación: List, Retrieve, Create, Update, Delete, Replace. |
| — | --connection-id | id | — | Ámbito a una conexión específica (habilita objetos personalizados). |
-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 resources list uipath-zoho-desk
# Only objects that support a Create operation
uip is resources list uipath-zoho-desk --operation Create
# Connection-scoped listing — includes custom objects
uip is resources list uipath-zoho-desk \
--connection-id a1b2c3d4-0000-0000-0000-000000000001
uip is resources list uipath-zoho-desk
# Only objects that support a Create operation
uip is resources list uipath-zoho-desk --operation Create
# Connection-scoped listing — includes custom objects
uip is resources list uipath-zoho-desk \
--connection-id a1b2c3d4-0000-0000-0000-000000000001
Forma de datos (--json de salida)
{
"Code": "ResourceList",
"Data": [
{
"Name": "tickets",
"DisplayName": "Tickets",
"Path": "/tickets",
"Type": "standard",
"SubType": "standard",
"Custom": "no",
"ElementKey": "uipath-zoho-desk"
}
]
}
{
"Code": "ResourceList",
"Data": [
{
"Name": "tickets",
"DisplayName": "Tickets",
"Path": "/tickets",
"Type": "standard",
"SubType": "standard",
"Custom": "no",
"ElementKey": "uipath-zoho-desk"
}
]
}
UIP es descripción de recursos
Describir los campos y operaciones de un objeto. --operation, devuelve la lista de operaciones disponibles y una sugerencia. Con --operation, se limita a una operación y devuelve sus parámetros, campos de solicitud y campos de respuesta.
Argumentos
| Nombre | Obligatorio | Propósito |
|---|---|---|
<connector-key> | Sí | Clave del conector. |
<object-name> | Sí | Nombre del objeto (por ejemplo, tickets). Buscar nombres con resources list. |
Opciones
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --connection-id | id | — | Ámbito a una conexión (habilita campos personalizados). |
-t | --tenant | name | sesión predeterminada | Anula el tenant. |
| — | --operation | ENUM | — | List, Retrieve, Create, Update, Delete o Replace. |
| — | --refresh | Marca | Desactivado | Fuerza la nueva recuperación desde la API, ignorando la caché. |
Ejemplos
# List operations available on this object
uip is resources describe uipath-zoho-desk tickets
# Field schema for the Create operation
uip is resources describe uipath-zoho-desk tickets --operation Create
# Required request fields, scripting-friendly
uip is resources describe uipath-zoho-desk tickets --operation Create \
--output-filter 'Data.requestFields[?required].name'
# List operations available on this object
uip is resources describe uipath-zoho-desk tickets
# Field schema for the Create operation
uip is resources describe uipath-zoho-desk tickets --operation Create
# Required request fields, scripting-friendly
uip is resources describe uipath-zoho-desk tickets --operation Create \
--output-filter 'Data.requestFields[?required].name'
Forma de datos (--json de salida)
Sin --operation:
{
"Code": "ResourceMetadata",
"Data": {
"name": "tickets",
"displayName": "Tickets",
"elementKey": "uipath-zoho-desk",
"availableOperations": [
{ "method": "GET", "name": "List", "description": "Search for Tickets", "path": "/tickets" },
{ "method": "POST", "name": "Create", "description": "Create a Tickets", "path": "/tickets" }
],
"hint": "Use --operation <Create|List|Retrieve|Update|Delete|Replace> to see fields for a specific operation."
}
}
{
"Code": "ResourceMetadata",
"Data": {
"name": "tickets",
"displayName": "Tickets",
"elementKey": "uipath-zoho-desk",
"availableOperations": [
{ "method": "GET", "name": "List", "description": "Search for Tickets", "path": "/tickets" },
{ "method": "POST", "name": "Create", "description": "Create a Tickets", "path": "/tickets" }
],
"hint": "Use --operation <Create|List|Retrieve|Update|Delete|Replace> to see fields for a specific operation."
}
}
Con --operation Create, se devuelve el mismo Code: "ResourceMetadata" , pero en lugar de availableOperations la carga útil lleva operation, parameters, requestFields y responseFields.
UIP es ejecución de recursos
Llama al plano de datos del conector. execute en sí mismo es un grupo; los verbos reales son create, list, get, update, replace y delete. Cada verbo requiere --connection-id; create, update y replace requieren además --body con un cuerpo de solicitud JSON.
uip is resources execute create <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute list <connector-key> <object-name> --connection-id <id>
uip is resources execute get <connector-key> <object-name> --connection-id <id> [--query <params>]
uip is resources execute update <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute replace <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute delete <connector-key> <object-name> --connection-id <id> [--query <params>]
uip is resources execute create <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute list <connector-key> <object-name> --connection-id <id>
uip is resources execute get <connector-key> <object-name> --connection-id <id> [--query <params>]
uip is resources execute update <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute replace <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute delete <connector-key> <object-name> --connection-id <id> [--query <params>]
Asignación de métodos HTTP: create → POST, list → GET (colección), get → GET-by-id, update → PATCH, replace → PUT, delete → DELETE.
Argumentos
| Nombre | Obligatorio | Propósito |
|---|---|---|
<connector-key> | Sí | Clave del conector. |
<object-name> | Sí | Nombre del objeto (por ejemplo, tickets). |
Opciones compartidas
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --connection-id | id | obligatorio | Conexión utilizada para autorizar la llamada del plano de datos. |
-t | --tenant | name | sesión predeterminada | Anula el tenant. |
| — | --query | Parámetros | — | Parámetros de consulta. Acepta key=value&key=value o un objeto JSON. |
| — | --body | JSON | — | Cuerpo de la solicitud. Obligatorio para create, update, replace. |
Ejemplos
# Create a ticket
uip is resources execute create uipath-zoho-desk tickets \
--connection-id a1b2c3d4-0000-0000-0000-000000000001 \
--body '{"subject":"New issue","departmentId":"DEP-1"}'
# List tickets — first page
uip is resources execute list uipath-zoho-desk tickets \
--connection-id a1b2c3d4-0000-0000-0000-000000000001
# Delete a ticket by ID
uip is resources execute delete uipath-zoho-desk tickets \
--connection-id a1b2c3d4-0000-0000-0000-000000000001 \
--query 'id=TK-1001'
# Create a ticket
uip is resources execute create uipath-zoho-desk tickets \
--connection-id a1b2c3d4-0000-0000-0000-000000000001 \
--body '{"subject":"New issue","departmentId":"DEP-1"}'
# List tickets — first page
uip is resources execute list uipath-zoho-desk tickets \
--connection-id a1b2c3d4-0000-0000-0000-000000000001
# Delete a ticket by ID
uip is resources execute delete uipath-zoho-desk tickets \
--connection-id a1b2c3d4-0000-0000-0000-000000000001 \
--query 'id=TK-1001'
Forma de datos (--json de salida)
{
"Code": "ExecuteOperation",
"Data": { "id": "TK-1001", "subject": "New issue", "status": "Open" }
}
{
"Code": "ExecuteOperation",
"Data": { "id": "TK-1001", "subject": "New issue", "status": "Open" }
}
Las operaciones list devuelven { "items": [...] } y, cuando el backend señala más páginas a través de encabezados Elements-Has-More / Elements-Next-Page-Token , incluye un objeto Pagination con HasMore y NextPageToken.
Las llamadas fallidas emergen con Failure, el estado HTTP como Message y el cuerpo del servidor como Instructions.
Relacionado
uip is connections— Los valores--connection-idprovienen deconnections list/connections create.uip is connectors: descubre primero la clave del conector.uip is activities: consulta las operaciones con nombre que expone un conector.uip is triggers: contrapartes impulsadas por eventos de los verbos del plano de datos aquí.
Ver también
- Sinopsis
- Verbos
- uip es una lista de recursos
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- UIP es descripción de recursos
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- UIP es ejecución de recursos
- Argumentos
- Opciones compartidas
- Ejemplos
- Forma de datos (--json de salida)
- Relacionado
- Ver también