UIP-Agent-Liste/Freigeben

uip agent list und uip agent share arbeiten beide mit Studio Web solutions — der cloudseitigen Darstellung eines Agent-Projekts. list listet Lösungen auf, die für den aktuellen Benutzer sichtbar sind; share verwaltet den Benutzer- und Gruppenzugriff auf eine einzige Lösung. Sie sind hier gruppiert, da es sich bei beiden um reine Studio Web-Verwaltungsverbesserungen handelt, die sich von den Vorgängen auf Dateiebene in uip agent file und von den Vorgängen auf Orchestrator-Seite in deploy / run unterscheiden.

Beide Verben erfordern eine aktive CLI-Sitzung (uip login).

Alle Unterbefehle berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

---

UIP-Agent-Liste

Listen Sie Lösungen aus Studio Web auf, optional gefiltert nach einem Schlüsselwort.

Zusammenfassung

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

Argumente

Keine.

Optionen

Markieren	Standard	Zweck
-s, --search <query>	–	Schlüsselwortfilter, der auf den SearchSolutionsAndProjects -Endpunkt von Studio Web angewendet wird.
-l, --limit <n>	20	Maximale Anzahl von Ergebnissen. Als Abfrageparameter pagingOptions.limit gesendet.
--login-validity <minutes>	10	Mindestlaufzeit des Tokens in Minuten erforderlich.

Beispiele

# 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

Datenform (--output json)

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

Leere Ergebnissätze erzeugen Data: { "Message": "No solutions found" } anstelle eines leeren Arrays. Projects ist die Anzahl der Projekte, die innerhalb der Lösung verschachtelt sind, keine Auflistung.

---

UIP-Agent-Freigabe

Verwalten Sie den Benutzer- und Gruppenzugriff auf eine Studio Web-Lösung. Drei Unterbefehle: add, list und remove.

Zusammenfassung

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>]

UIP-Agent-Freigabe hinzufügen

Gewähren Sie Zugriff auf einen Benutzer oder eine Gruppe.

Argumente

• <solutionId> (erforderlich) – Lösungs-UUID.
• <entityId> (erforderlich) – Benutzer- oder Gruppen-UUID.

Optionen

Markieren	Standard	Zweck
--permission <perm>	write	Berechtigungsstufe. Einer von: none, read, write, publish, readWritePublish. Groß-/Kleinschreibung wird nicht beachtet; Ungültige Werte schlagen mit einem Validierungsfehler fehl.
--group	aus (Benutzer)	Behandeln Sie <entityId> als Gruppe anstelle eines Benutzers.
--login-validity <minutes>	10	Mindestlaufzeit des Tokens in Minuten erforderlich.

Beispiele

# 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

Data shape (--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"
  }
}

UIP-Agent-Freigabeliste

Listen Sie Benutzer und Gruppen mit Zugriff auf eine Lösung auf.

Argumente

• <solutionId> (erforderlich) – Lösungs-UUID.

Optionen

Only --login-validity.

Beispiel

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

Data shape (--output json)

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

Eine leere Antwort gibt Data: { "Message": "No sharing permissions found for this solution" } zurück.

UIP Agent-Freigabe entfernen

Widerrufen Sie den Zugriff eines Benutzers oder einer Gruppe.

Argumente

• <solutionId> (erforderlich) – Lösungs-UUID.
• <entityId> (erforderlich) – Benutzer- oder Gruppen-UUID.

Optionen

Markieren	Standard	Zweck
--group	aus (Benutzer)	Behandeln Sie <entityId> als Gruppe anstelle eines Benutzers.
--login-validity <minutes>	10	Mindestlaufzeit des Tokens in Minuten erforderlich.

Beispiel

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

Data shape (--output json)

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

---

Zugehörig

• uip agent push – Importieren Sie ein Projekt und rufen Sie das SolutionId ab, das Sie hier verwenden.
• uip agent pull – Laden Sie eine von list aufgeführte Lösung herunter.
• uip agent file – Dateien innerhalb der Projekte einer Lösung auflisten, herunterladen und hochladen.

Siehe auch

• Authentifizierung – Sitzungen, Mandanten und --login-validity.
• Globale Optionen, Exitcodes.