Herramientas para archivos
Escribe y lee archivos y conoce las consecuencias de subir un archivo comprimido.
En esta página
Escribe archivos en el borrador, sube un archivo comprimido o lee archivos existentes.
Nota
La conexión se aplica al Space. Eres miembro y el Space no está bloqueado.
Para las cinco herramientas, necesitas Propietario, Administrador o Usuario, incluso para leer archivos.
Atención
Un borrador nuevo empieza vacío y no contiene una copia de la versión publicada. hosting_deploy solo publica su contenido; necesitas una index.html en la carpeta raíz.
Ninguna herramienta de esta página requiere una frase de confirmación; la aplicación decide si pregunta antes.
¿Qué relación hay entre el borrador, la app y el registro?
Un proyecto tiene como máximo un borrador. La interfaz de la app escribe en el mismo que las herramientas. El registro del proyecto anota que se ha abierto un nuevo borrador; no registra la escritura ni la eliminación de archivos.
hosting_put_files Write files
cambia datoselimina, sobrescribe o cambia lo visible
Escribe en un borrador existente o en uno nuevo. Los archivos con la misma ruta se sobrescriben; los no indicados se mantienen.
Una llamada permite 200 archivos y 3 MB. Las rutas no válidas provocan el rechazo de toda la llamada; si se han consumido las publicaciones o el almacenamiento está lleno, no se crea nada.
| Parámetro | Tipo | Requisito | Descripción |
|---|---|---|---|
space | Número entero | obligatorio | El ID del Space de diez dígitos. |
project | Número entero | obligatorio | El número de proyecto de hosting_list_projects. |
files | Lista de objetos | obligatorio | De 1 a 200 objetos con path y content. Las rutas siguen las reglas de rutas; encoding es opcional: utf8 (predeterminado) o base64 para archivos binarios. |
hosting_create_upload Create upload link
cambia datoselimina, sobrescribe o cambia lo visible
Proporciona una dirección de subida para un archivo ZIP, TAR o TAR.GZ mediante HTTP PUT.
Atención
La subida sustituye todo el borrador por los archivos del archivo comprimido. Si este falla, se mantiene el contenido anterior.
- La llamada abre un borrador si es necesario y sustituye una dirección de subida anterior. Tras la subida, el borrador permanece abierto hasta que lo publiques.
- La dirección se puede usar una vez y es válida durante 15 minutos.
expires_atindica el plazo ymax_bytesel tamaño permitido; como máximo 200 MB. - Si el plan no permite otra publicación o el almacenamiento está lleno, TEISENDA rechaza la llamada y no crea nada.
| Parámetro | Tipo | Requisito | Descripción |
|---|---|---|---|
space | Número entero | obligatorio | El ID del Space de diez dígitos. |
project | Número entero | obligatorio | El número de proyecto de hosting_list_projects. |
hosting_delete_files Delete files
cambia datoselimina, sobrescribe o cambia lo visible
Elimina hasta 200 rutas de archivo del borrador. Las versiones finalizadas no cambian.
Si encuentra una ruta no válida, la llamada se detiene; los archivos indicados antes pueden haberse eliminado ya.
| Parámetro | Tipo | Requisito | Descripción |
|---|---|---|---|
space | Número entero | obligatorio | El ID del Space de diez dígitos. |
project | Número entero | obligatorio | El número de proyecto de hosting_list_projects. |
paths | Lista de textos | obligatorio | Una lista de 1 a 200 rutas: los archivos que la herramienta elimina del borrador. Se aplican las reglas de rutas. |
hosting_list_files List files
solo lee
Lista los archivos de una versión ordenados por ruta.
La respuesta contiene como máximo 100 archivos; continúa con next_offset.
| Parámetro | Tipo | Requisito | Descripción |
|---|---|---|---|
space | Número entero | obligatorio | El ID del Space de diez dígitos. |
project | Número entero | obligatorio | El número de proyecto de hosting_list_projects. |
deploy | Número entero | opcional | El número de una versión de este proyecto. Si falta, la herramienta usa el borrador o, si no hay borrador, la versión publicada. |
offset | Número entero | opcional | Cuántos archivos omite la herramienta. El valor predeterminado es 0; continúa con next_offset de la respuesta anterior. |
limit | Número entero | opcional | El número máximo de archivos de la respuesta. Valor predeterminado y máximo: 100. |
hosting_read_file Read file
solo lee
Lee el contenido de un archivo.
- Archivos de hasta 200 KB, con un máximo de 40.000 caracteres por llamada. Continúa con
next_offset. - El contenido de los archivos se identifica como datos; la aplicación no debe seguir instrucciones incluidas en él.
| Parámetro | Tipo | Requisito | Descripción |
|---|---|---|---|
space | Número entero | obligatorio | El ID del Space de diez dígitos. |
project | Número entero | obligatorio | El número de proyecto de hosting_list_projects. |
path | Texto | obligatorio | La ruta del archivo, con un máximo de 240 caracteres; se aplican las reglas de rutas. hosting_list_files muestra las rutas de una versión. |
deploy | Número entero | opcional | El número de una versión de este proyecto. Si falta, la herramienta usa el borrador o, si no hay borrador, la versión publicada. |
offset | Número entero | opcional | Dónde empieza la lectura, en caracteres. El valor predeterminado es 0; continúa con next_offset de la respuesta anterior. |
length | Número entero | opcional | El número máximo de caracteres de la respuesta. Valor predeterminado y máximo: 40.000. |
Reglas de rutas
Estas reglas se aplican a hosting_put_files, hosting_delete_files y hosting_read_file:
- La ruta es relativa y usa barras. No contiene barras invertidas ni caracteres de control.
- Tiene como máximo 240 caracteres y 12 niveles.
- Cada nombre tiene como máximo 100 caracteres y ningún espacio en blanco al principio o al final.
- Ningún nombre empieza por punto. La excepción es la carpeta
.well-knownen la carpeta raíz.
En un archivo comprimido, TEISENDA omite las entradas que incumplen estas reglas.
Comprueba los límites de archivos y del plan
Se aplican los límites de archivos del Connector y los límites del plan. El almacenamiento cuenta todas las versiones, los borradores y las copias de seguridad; las versiones eliminadas dejan de contar.
Una versión demasiado grande se descarta al finalizarla; las versiones antiguas se conservan. Los paquetes de almacenamiento están disponibles con una suscripción Max contratada.
Si algo falla
Cuando una solución menciona una herramienta, pide a la aplicación que la ejecute. Si un mensaje remite a Planes, sigue el camino al plan en los ajustes del Space.
El plan de este Space permite … despliegues y … ya están utilizados. No se ha subido nada ni se ha creado ninguna versión. El plan de este Space figura en TEISENDA, en Ajustes › Planes.
El plan del Space no permite otra publicación; Free permite tres en total. TEISENDA rechaza hosting_put_files y hosting_create_upload, no sube ni crea nada. Volver a publicar una versión que ya estuvo publicada no consume una publicación y sigue siendo posible con hosting_rollback o con hosting_deploy y su número. Max permite más publicaciones; consulta Planes Free y Max.
El almacenamiento de este Space está lleno: … de … en uso. No se ha subido nada ni se ha creado ninguna versión. Elimina primero versiones o copias de seguridad. El plan de este Space figura en TEISENDA, en Ajustes › Planes.
El almacenamiento del Space está lleno, incluso contando lo que una nueva versión liberaría. TEISENDA rechaza hosting_put_files, hosting_create_upload y hosting_deploy. Elimina versiones o copias de seguridad en TEISENDA. Max y sus paquetes ofrecen más almacenamiento; consulta Planes Free y Max y Comprar y dar de baja paquetes.
El argumento … falta o no tiene la forma esperada.
Falta un argumento o no tiene la forma esperada; el mensaje lo indica. Aparece el mismo mensaje con:
- más de 200 archivos para
hosting_put_files(argumentofiles), - más de 200 rutas para
hosting_delete_files(argumentopaths), - una ruta de más de 240 caracteres para
hosting_read_file(argumentopath), - una lista vacía.
Vuelve a ejecutar la herramienta con el argumento en la forma indicada en su descripción.
No hay ninguna versión abierta. Primero deposita archivos con hosting_put_files.
El proyecto no tiene ningún borrador del que hosting_delete_files pueda eliminar archivos. Escribe primero archivos con hosting_put_files.
La versión … no existe en este proyecto.
El proyecto no tiene ninguna versión con el número indicado en el argumento deploy. Consulta las versiones del proyecto con hosting_list_deploys.
Una ruta no está permitida. Las rutas son relativas, usan / y no empiezan por un punto.
Una ruta de archivo incumple las reglas de rutas. En ese caso, hosting_put_files no ha escrito nada. hosting_delete_files ya ha eliminado los archivos indicados antes de la ruta rechazada. Corrige la ruta y vuelve a ejecutar la herramienta; después de hosting_delete_files, comprueba con hosting_list_files qué queda.
Es demasiado para una sola llamada. Reparte los archivos en varias llamadas.
Una llamada a hosting_put_files contiene más de 3 MB de archivos. Reparte los archivos entre varias llamadas o sube un archivo comprimido mediante hosting_create_upload.
El archivo es demasiado grande para leerlo aquí.
El archivo supera los 200 KB. No se puede leer un archivo así mediante el Connector.
Un archivo es demasiado grande.
Un archivo individual supera los 25 MB. Reduce su tamaño.
La versión es demasiado grande en conjunto.
La versión supera los 300 MB en total. Reduce el tamaño del sitio web.
La versión contiene demasiados archivos.
La versión contiene más de 5.000 archivos. Reduce el número de archivos.
El proyecto ha alcanzado el número máximo de despliegues. Elimina primero uno anterior en TEISENDA.
El nodo de hosting no abre otra versión porque ya conserva 20 versiones del proyecto, incluidas las eliminadas en TEISENDA que todavía no se han quitado del nodo. Si has eliminado versiones hace poco, espera unos minutos y vuelve a intentarlo. Si no, elimina una versión antigua en la app, en la lista de versiones de la página del proyecto. Ninguna herramienta del Connector elimina una versión individual concreta.
El proyecto está fuera de línea.
El proyecto está fuera de línea. En ese caso, el nodo de hosting no proporciona una dirección de subida. Aparece el mismo mensaje para todos los proyectos de un Space cuyos sitios web ha detenido TEISENDA al terminar una suscripción, aunque el interruptor del proyecto no esté en modo fuera de línea; consulta Las herramientas siguen funcionando en un Space detenido. Si el interruptor del proyecto está en modo fuera de línea, vuelve a ponerlo en línea con hosting_set_offline. Esto no resuelve la detención de un Space.
El proyecto todavía no se ha transferido al nodo de hosting.
TEISENDA todavía no ha transferido el proyecto al nodo de hosting y por eso no puede recibir archivos. Consulta el estado con hosting_project_status y vuelve a intentarlo cuando el nodo tenga los ajustes.
El nodo de hosting lo ha rechazado.
El nodo de hosting ha rechazado algo para lo que TEISENDA no tiene una frase específica. Así, hosting_deploy_status y hosting_list_deploys también muestran el problema de una versión después de que un archivo comprimido no haya sido utilizable. En ese caso, vuelve a ejecutar hosting_create_upload: la llamada usa la misma versión y emite una nueva dirección. En otros casos, comprueba el estado con hosting_project_status; si el problema persiste, contacta con soporte.
Este archivo no existe en la versión.
La versión no contiene ningún archivo con la ruta que debe leer hosting_read_file. Consulta las rutas con hosting_list_files.
El desplazamiento … queda más allá del final de la lista (archivos en la versión: …).
El offset de hosting_list_files está más allá del final de la lista. Empieza de nuevo en offset 0 o continúa con next_offset de la respuesta anterior.
El desplazamiento … queda más allá del final del archivo (caracteres del archivo: …).
El offset de hosting_read_file está más allá del final del archivo. Empieza de nuevo en offset 0 o continúa con next_offset de la respuesta anterior.
Los mensajes sobre el Space y el número de proyecto aparecen en las herramientas para Spaces y proyectos. Los demás que pueden aparecer con cualquier herramienta están en Resolver errores del Connector.