archivo de agente de uip

uip agent file opera en los archivos individuales dentro de un proyecto de Studio Web: el primo granular de uip agent pull / push, que mueve archivos .uis completos. Usa file cuando quieras leer o sobrescribir un archivo específico (por ejemplo, parche agent.json en su lugar) sin extraer y volver a empaquetar toda la solución.

Cada subcomando requiere una sesión CLI activa (uip login). Todos los subcomandos respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

Sinopsis

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> un UUID de proyecto de Studio Web : el proyecto interno dentro de una solución, no la solución en sí. Obtén uno del campo CloudProjectId de uip agent push, de la matriz projects[] en uip agent list, o de SolutionStorage.json en un proyecto enviado.

lista de archivos de agente de uip

Enumera los archivos dentro de un proyecto de Studio Web como un árbol plano.

Argumentos

• <projectId> obligatorio) : UUID del proyecto de Studio Web.

Opciones

Marca	Predeterminado	Propósito
--login-validity <minutes>	10	Minutos mínimos de validez del token requeridos.

Ejemplo

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

Forma de datos (--json de salida)

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

Path es la ruta completa separada por barras desde la raíz del proyecto, incluidos los nombres de las carpetas anidadas. IsMain y IsEntryPoint son booleanos en cadena ("true" / "false"). Los proyectos vacíos devuelven Data: { "Message": "No files found in project" }.

obtención de archivo de agente de uip

Descarga un único archivo. Escríbalo en el disco o codifíquelo en base64 en la respuesta.

Argumentos

• <projectId> (obligatorio) : UUID del proyecto.
• <fileId> obligatorio) : UUID de archivo (de file list).

Opciones

Marca	Predeterminado	Propósito
-d, --destination <path>	— (escribir en la respuesta)	Ruta local en la que escribir el archivo. El directorio principal se crea automáticamente.
--login-validity <minutes>	10	Minutos mínimos de validez del token requeridos.

Ejemplos

# 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

Forma de datos (--json de salida)

Con -d

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

Sin -d (en línea):

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

Colocación del archivo del agente uip

Cargar/sobrescribir un archivo en un proyecto de Studio Web. El archivo se envía como datos de formulario de varias partes a PUT /api/Project/<projectId>/FileOperations/File/<fileId>.

Argumentos

• <projectId> (obligatorio) : UUID del proyecto.
• <fileId> obligatorio) : UUID de archivo a sobrescribir.
• <localPath> obligatorio) : ruta del archivo local a cargar.

Opciones

Marca	Predeterminado	Propósito
--login-validity <minutes>	10	Minutos mínimos de validez del token requeridos.

Ejemplo

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

Forma de datos (--json de salida)

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

Relacionado

• uip agent pull : descarga la solución completa como un archivo .uis .
• uip agent push : importa un proyecto (nuevo o sobrescribir).
• uip agent list : enumerar soluciones (y sus proyectos).

Ver también

• Autenticación : sesiones y --login-validity.
• Opciones globales, códigos de salida.