uip-Agent-Datei

uip agent file arbeitet mit den einzelnen Dateien innerhalb eines Studio Web-Projekts – der granulare Version von uip agent pull / push, die ganze .uis -Archive verschieben. Verwenden Sie file wenn Sie eine bestimmte Datei lesen oder überschreiben möchten (z. B. Patch agent.json vorhanden), ohne die gesamte Lösung zu ziehen und neu zu packen.

Jeder Unterbefehl erfordert eine aktive CLI-Sitzung (uip login). Alle Unterbefehle berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

Zusammenfassung

uip agent file list <projectId>                                    [--login-validity <minutes>]
uip agent file get  <projectId> <fileId> [-d <path>]               [--login-validity <minutes>]
uip agent file put  <projectId> <fileId> <localPath>               [--login-validity <minutes>]

<projectId> ist eine Studio Web Projekt UUID – das innere Projekt innerhalb einer Lösung, nicht die Lösung selbst. Rufen Sie eines aus dem CloudProjectId -Feld von uip agent push, aus dem projects[] -Array in uip agent list oder von SolutionStorage.json in einem gepushten Projekt ab.

Dateiliste des UIP-Agents

Listen Sie die Dateien in einem Studio Web-Projekt als flache Struktur auf.

Argumente

• <projectId> (erforderlich) – UUID des Studio Web-Projekts.

Optionen

Markieren	Standard	Zweck
--login-validity <minutes>	10	Mindestlaufzeit des Tokens in Minuten erforderlich.

Beispiel

uip agent file list a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{
  "Code": "AgentFileList",
  "Data": [
    {
      "Path": "Agent/agent.json",
      "Id": "a1b2c3d4-0000-0000-0000-000000000201",
      "Name": "agent.json",
      "FileType": "json",
      "IsMain": "true",
      "IsEntryPoint": "true"
    }
  ]
}

Path ist der vollständige, durch Schrägstrich getrennte Pfad vom Projektstamm, einschließlich der Namen der geschachtelten Ordner. IsMain und IsEntryPoint sind stringifizierte Boolesche Werte ("true" / "false"). Leere Projekte geben Data: { "Message": "No files found in project" } zurück.

UIP-Agent-Datei abrufen

Laden Sie eine einzelne Datei herunter. Schreiben Sie sie entweder auf den Datenträger oder mit Base64-Codierung in die Antwort.

Argumente

• <projectId> (erforderlich) – Projekt-UUID.
• <fileId> (erforderlich) – Datei-UUID (von file list).

Optionen

Markieren	Standard	Zweck
-d, --destination <path>	– (In Antwort schreiben)	Lokaler Pfad, in den die Datei geschrieben werden soll. Das übergeordnete Verzeichnis wird automatisch erstellt.
--login-validity <minutes>	10	Mindestlaufzeit des Tokens in Minuten erforderlich.

Beispiele

# Download to a specific file path
uip agent file get \
  a1b2c3d4-0000-0000-0000-000000000001 \
  a1b2c3d4-0000-0000-0000-000000000201 \
  -d ./agent.json

# Fetch without writing to disk (content is inlined base64)
uip agent file get \
  a1b2c3d4-0000-0000-0000-000000000001 \
  a1b2c3d4-0000-0000-0000-000000000201

Datenform (--output json)

With -d

{
  "Code": "AgentFileGet",
  "Data": {
    "Status": "File downloaded",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "FileId": "a1b2c3d4-0000-0000-0000-000000000201",
    "Output": "/abs/path/agent.json"
  }
}

Ohne -d (inline):

{
  "Code": "AgentFileGet",
  "Data": {
    "Status": "File downloaded",
    "ProjectId": "…",
    "FileId": "…",
    "Content": "<base64>",
    "Encoding": "base64"
  }
}

UIP-Agent-Datei zugewiesen

Hochladen/Überschreiben einer Datei in einem Studio Web-Projekt. Die Datei wird als mehrteilige Formulardaten an PUT /api/Project/<projectId>/FileOperations/File/<fileId> gesendet.

Argumente

• <projectId> (erforderlich) – Projekt-UUID.
• <fileId> (erforderlich) – Zu überschreibende Datei-UUID.
• <localPath> (erforderlich) – Lokaler Dateipfad zum Hochladen.

Optionen

Markieren	Standard	Zweck
--login-validity <minutes>	10	Mindestlaufzeit des Tokens in Minuten erforderlich.

Beispiel

uip agent file put \
  a1b2c3d4-0000-0000-0000-000000000001 \
  a1b2c3d4-0000-0000-0000-000000000201 \
  ./agent.json

Datenform (--output json)

{
  "Code": "AgentFilePut",
  "Data": {
    "Status": "File uploaded",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "FileId": "a1b2c3d4-0000-0000-0000-000000000201",
    "LocalPath": "/abs/path/agent.json"
  }
}

Zugehörig

• uip agent pull – Laden Sie die gesamte Lösung als .uis -Archiv herunter.
• uip agent push – Ein Projekt importieren (neu oder überschreiben).
• uip agent list – Aufzählung von Lösungen (und deren Projekte).

Siehe auch

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