uip admin robot-accounts

Sintaxis y opciones para `cuentas de robot de administración de UIP`, `pat de administrador de UIP` y `ámbitos de administración de UIP`: identidades no humanas, tokens de acceso personal y la referencia de ámbito OAuth2.

Tres grupos de comandos independientes relacionados: robot-accounts (identidades de directorio no humanas utilizadas para la automatización unattended), pat (tokens de acceso personal para la autenticación de API) y scopes (una referencia de solo lectura de cada ámbito OAuth2 disponible para aplicaciones externas y PAT).

Sinopsis

uip admin robot-accounts list [--search <term>] [--sort-by <field>] [--sort-order asc|desc] [--limit <n>] [--offset <n>]
uip admin robot-accounts get <robot-account-id>
uip admin robot-accounts create <name> [--display-name <name>]
uip admin robot-accounts update <robot-account-id> --display-name <name>
uip admin robot-accounts delete <robot-account-id>

uip admin pat list [--scope all] [--search <term>] [--limit <n>] [--offset <n>]
uip admin pat create --description <text> --expiration <date> --scope <scopes>
uip admin pat revoke <id>
uip admin pat regenerate <id> --expiration <date>

uip admin scopes list

Verbos

Grupo	Verbo	Propósito
robot-accounts	list	Enumera las cuentas de robot en la partición.
robot-accounts	get	Obtener los detalles de una cuenta de robot por ID.
robot-accounts	create	Crea una nueva cuenta de robot.
robot-accounts	update	Actualizar el nombre para mostrar de una cuenta de robot.
robot-accounts	delete	Eliminar una cuenta de robot por ID.
pat	list	Enumera los tokens de acceso personal (los tuyos o los de la organización con --scope all).
pat	create	Crea un nuevo token de acceso personal.
pat	revoke	Revocar un token.
pat	regenerate	Regenerar un token con una nueva caducidad.
scopes	list	Enumera todos los ámbitos de OAuth2 disponibles, agrupados por recurso.

lista de cuentas de robot de administración de UIP

Enumera las cuentas de robot en la partición. Devuelve el ID de la cuenta, el nombre, el nombre para mostrar y la hora de creación.

Opciones

Largo	Corto	Valor	Predeterminado	Descripción
--search <term>	-s	String	—	Buscar por nombre.
--sort-by <field>		String	—	Ordenar campo, por ejemplo Name.
--sort-order <direction>		asc|desc	asc	Ordenar dirección.
--limit <number>	-l	Entero	50	Número de elementos que se van a devolver.
--offset <number>		Entero	0	Número de elementos que omitir.

Ejemplo

uip admin robot-accounts list --limit 5

Forma de datos (--json de salida)

{
  "Code": "RobotAccountList",
  "Data": [
    { "id": "a1b2c3d4-0000-0000-0000-000000000001", "name": "automation-bot", "displayName": "Automation Bot", "creationTime": "2026-01-15T10:00:00.000Z" }
  ]
}

uip admin robot-accounts get

Obtener detalles de la cuenta del robot por ID.

Argumentos

Nombre	Obligatorio	Propósito
<robot-account-id>	Sí	ID de cuenta de robot (UUID).

Ejemplo

uip admin robot-accounts get a1b2c3d4-0000-0000-0000-000000000001

Forma de datos (--json de salida)

{ "Code": "RobotAccountDetails", "Data": { "id": "a1b2c3d4-0000-0000-0000-000000000001", "name": "automation-bot", "displayName": "Automation Bot", "creationTime": "2026-01-15T10:00:00.000Z", "groupIds": [] } }

uip admin robot-accounts create

Crea una nueva cuenta de robot en la partición.

Argumentos

Nombre	Obligatorio	Propósito
<name>	Sí	Nombre de la cuenta del robot.

Opciones

Largo	Valor	Descripción
--display-name <name>	String	Nombre para mostrar. El valor predeterminado es <name> cuando se omite.

Ejemplo

uip admin robot-accounts create "automation-bot" --display-name "Automation Bot"

Forma de datos (--json de salida)

{ "Code": "RobotAccountCreated", "Data": { "id": "a1b2c3d4-0000-0000-0000-000000000002", "name": "automation-bot", "displayName": "Automation Bot" } }

actualización de cuentas de robot de administrador de UIP

Actualizar el nombre para mostrar de una cuenta de robot. --display-name es el único campo y es efectivamente obligatorio; omitirlo falla en el lado del cliente ("No fields to update").

Argumentos

Nombre	Obligatorio	Propósito
<robot-account-id>	Sí	ID de cuenta de robot (UUID).

Opciones

Largo	Valor	Obligatorio	Descripción
--display-name <name>	String	Sí	Nuevo nombre para mostrar.

Ejemplo

uip admin robot-accounts update a1b2c3d4-0000-0000-0000-000000000001 --display-name "Updated Bot"

Forma de datos (--json de salida)

{ "Code": "RobotAccountUpdated" }

UIP admin robot-accounts eliminar

Eliminar una cuenta de robot por ID.

Argumentos

Nombre	Obligatorio	Propósito
<robot-account-id>	Sí	ID de cuenta de robot (UUID).

Ejemplo

uip admin robot-accounts delete a1b2c3d4-0000-0000-0000-000000000001

Forma de datos (--json de salida)

{ "Code": "RobotAccountDeleted", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Status": "Deleted successfully" } }

lista de contactos del administrador de UIP

Enumera los tokens de acceso personal. Por defecto, solo enumera los tuyos propios; --scope all (solo administrador) enumera todos los tokens de la organización.

Opciones

Largo	Valor	Descripción
--scope <scope>	all	Solo se acepta "all": cualquier otro valor falla en el lado del cliente con un error explícito. Omita enumerar solo sus propios tokens.
--search <term>	String	Filtrar por término de búsqueda del usuario. Implica --scope all incluso si no se pasa --scope .
--limit <number> (-l).	Entero	Predeterminado 50. Número de elementos que se van a devolver.
--offset <number>	Entero	Predeterminado 0. Número de elementos a omitir.

Ejemplo

uip admin pat list

Forma de datos (--json de salida)

{
  "Code": "PatList",
  "Data": [
    { "id": "a1b2c3d4-0000-0000-0000-000000000001", "description": "CI/CD token", "expiration": "2027-01-15T00:00:00.000Z", "scopes": ["OR.Folders.Read"] }
  ]
}

crear de pat de administrador de UIP

Crea un nuevo token de acceso personal. El valor del token se devuelve solo una vez: no se puede recuperar más tarde.

Opciones

Largo	Valor	Obligatorio	Descripción
--description <text>	String	Sí	Descripción del token.
--expiration <date>	YYYY-MM-DD	Sí	Fecha de vencimiento. Estrictamente validado: rechaza fechas con formato incorrecto y transferencias de calendario (p. ej. 2027-02-30).
--scope <scopes>	separados por comas	Sí	Uno o más ámbitos, por ejemplo OR.Folders.Read,OR.Jobs.Read. Consulta scopes list para ver el catálogo completo.

Ejemplo

uip admin pat create --description "CI/CD token" --expiration 2027-01-15 --scope "OR.Folders.Read,OR.Jobs.Read"

Forma de datos (--json de salida)

{ "Code": "PatCreated", "Data": { "Token": "...", "Warning": "Save this token now. It will not be shown again." } }

revocación de la palmadita del administrador de UIP

Revocar un token de acceso personal.

Argumentos

Nombre	Obligatorio	Propósito
<id>	Sí	ID de token (UUID). Encuéntralo con pat list.

Ejemplo

uip admin pat revoke a1b2c3d4-0000-0000-0000-000000000001

Forma de datos (--json de salida)

{ "Code": "PatRevoked", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Status": "Revoked successfully" } }

regeneración de pat de administrador de uip

Regenera un token de acceso personal con una nueva caducidad. Al igual que create, el nuevo valor del token solo se muestra una vez.

Argumentos

Nombre	Obligatorio	Propósito
<id>	Sí	ID de token (UUID).

Opciones

Largo	Valor	Obligatorio	Descripción
--expiration <date>	YYYY-MM-DD	Sí	Nueva fecha de vencimiento. La misma validación estricta que create.

Ejemplo

uip admin pat regenerate a1b2c3d4-0000-0000-0000-000000000001 --expiration 2028-01-15

Forma de datos (--json de salida)

{ "Code": "PatRegenerated", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Token": "...", "Warning": "Save this token now. It will not be shown again." } }

lista de ámbitos de administración de uip

Enumera cada ámbito OAuth2 disponible para aplicaciones externas y tokens de acceso personal, agrupados por recurso. Solo lectura, sin opciones más allá de las globales.

Ejemplo

uip admin scopes list

Forma de datos (--json de salida)

{
  "Code": "ScopesList",
  "Data": [
    {
      "name": "UiPath.Orchestrator",
      "displayName": "Orchestrator API Access",
      "scopes": [
        { "name": "OR.Folders", "displayName": "OR.Folders", "type": "user" }
      ]
    }
  ]
}

type en cada entrada de ámbito es "user" (delegado, requiere un usuario que haya iniciado sesión) o "application" (solo aplicación): la misma distinción external-apps create de los marcadores --user-scope/--app-scope y pat create del que se extrae el marcador --scope de }.

Relacionado

• uip admin users : usuarios y grupos del directorio.
• uip admin external-apps : registros de clientes OAuth2, que utilizan el mismo catálogo de ámbito.
• uip admin smtp — configuración del correo electrónico de la organización.

Ver también

• Opciones globales
• Códigos de salida