fichier d’agent uip

uip agent file fonctionne sur les fichiers individuels d’un projet Studio Web, le versions granulaire de uip agent pull / push, qui déplacent l’ensemble des archives .uis . Utilisez file lorsque vous souhaitez lire ou écraser un fichier spécifique (par exemple, correctif agent.json en place) sans extraire et reformuler l'ensemble de la solution.

Chaque sous-commande nécessite une session CLI active (uip login). Toutes les sous-commandes respectent les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard.

Synthèse

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> est un UUID de projet Studio Web — le projet interne à l'intérieur d'une solution, pas la solution elle-même. Obtenez-en un à partir du champ CloudProjectId de uip agent push, du tableau projects[] dans uip agent list ou de SolutionStorage.json dans un projet transmis.

liste des fichiers d’agent uip

Répertoriez les fichiers à l'intérieur d'un projet Studio Web sous la forme d'une arborescence plate.

Arguments

• <projectId> (requis) : UUID du projet Studio Web.

Options

Drapeau	Default	Objectif
--login-validity <minutes>	10	Nombre minimum de minutes de validité du jeton requis.

Exemple

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

Format des données (--sortie json)

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

Path est le chemin complet séparé par des barres obliques à partir de la racine du projet, y compris les noms de dossiers imbriqués. IsMain et IsEntryPoint sont des booléens ("true" / "false"). Les projets vides renvoient Data: { "Message": "No files found in project" }.

Obtenir le fichier d’agent uip

Téléchargez un fichier unique. Écrivez-le sur le disque ou encodez-le en base64 dans la réponse.

Arguments

• <projectId> (requis) : UUID du projet.
• <fileId> (obligatoire) — UUID du fichier (depuis file list).

Options

Drapeau	Default	Objectif
-d, --destination <path>	— (écrire dans la réponse)	Chemin local dans lequel écrire le fichier. Le répertoire parent est créé automatiquement.
--login-validity <minutes>	10	Nombre minimum de minutes de validité du jeton requis.

Exemples

# 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

Format des données (--sortie 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"
  }
}

Sans -d (intégré):

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

fichier d'agent uip

Télécharger/écraser un fichier dans un projet Studio Web. Le fichier est envoyé en tant que données de formulaire multipart à PUT /api/Project/<projectId>/FileOperations/File/<fileId>.

Arguments

• <projectId> (requis) : UUID du projet.
• <fileId> (requis) — UUID du fichier à écraser.
• <localPath> (requis) : Chemin du fichier local à télécharger.

Options

Drapeau	Default	Objectif
--login-validity <minutes>	10	Nombre minimum de minutes de validité du jeton requis.

Exemple

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

Format des données (--sortie json)

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

Associé

• uip agent pull — télécharger la solution entière sous forme d'archive .uis .
• uip agent push — importe un projet (nouveau ou écraser).
• uip agent list — énumérer des solutions (et leurs projets).

Voir également

• Authentification — sessions et --login-validity.
• Options globales, codes de sortie.