fichier d’agent uip

Syntaxe et options de `uip agent file`, qui lit et écrase des fichiers individuels dans un projet d'agent Studio Web.

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)

Avec -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.