Documentos y archivosYandex Disk

Solución de problemas de la CLI de Yandex Disk

Arregla un token de Yandex rechazado, una carpeta que no se copia o una búsqueda sin resultados.

Un inicio de sesión que falla, una sincronización que se detiene, una búsqueda que no encuentra nada: busca aquí tu síntoma y arréglalo en uno o dos minutos. Cada error dice en su mensaje qué hacer, y su código de salida le indica a un script qué tipo de fallo fue.

En esta página:

  1. Primera comprobación
  2. Por síntoma
  3. Códigos de salida
  4. Si sigue fallando

Primera comprobación

ydisk doctor
ydisk personal doctor --online

doctor no lee el llavero ni usa la red. Muestra qué está configurado y cualquier problema del archivo de ajustes. doctor --online además pregunta a Yandex si el token del perfil funciona.

Por síntoma

SíntomaQué hacer
No se encuentra ydiskAbre una terminal nueva y comprueba que la carpeta global de npm está en PATH.
"name a profile"Pon el perfil primero, como en ydisk personal status, o define YDISK_PROFILE.
"refused the token", código de salida 4El token es incorrecto, se revocó o caducó. Consigue un token nuevo y vuelve a ejecutar ydisk personal session start.
Un cambio falla con el código de salida 5El token no tiene el permiso cloud_api:disk.write, o lo rechazan los permisos del perfil o YDISK_READ_ONLY. Revisa los ajustes. Para el permiso, registra la aplicación de nuevo con él y consigue un token nuevo.
"the OS keyring did not answer" en LinuxEl bus de sesión se reinició. Cierra la sesión y vuelve a entrar, o inicia sesión con session start --credential-storage file.
"no such item, or this token cannot see it", código de salida 6Comprueba la ruta con files list --folder en su carpeta superior. Una ruta del Disk empieza por /, como en /Documents/plan.pdf.
"asked to slow down", código de salida 8Yandex recibió demasiadas peticiones de esta cuenta. Espera un minuto y vuelve a ejecutar el comando.
Una sincronización se detiene antes del finalUna sincronización lee hasta 200 archivos. Ejecuta sync otra vez hasta que status no muestre trabajo pendiente.
Faltan los documentos de una carpeta elegidaLa carpeta se renombró o se movió en el Disk. Añádela de nuevo con su ruta nueva con folders add.
La búsqueda no encuentra un archivo que sabes que estáMira cuando la búsqueda no encuentra nada.
Un PDF se encuentra por el nombre pero no por su textoEs un escaneo sin capa de texto, o pesa más de 50 MB. status lista esos archivos con el motivo.
Una subida falla porque el Disk está llenoLibera espacio en el Disk o vacía su papelera. Reintentar no sirve hasta que haya sitio.
Se rechaza una subida grandeYandex limita el tamaño de un archivo según el plan: 1 GB sin un plan de Yandex 360, más con uno (límites de Yandex).
Un cambio terminó con "outcome_unknown", código de salida 14Yandex falló durante el cambio, así que puede que se hiciera o puede que no. Comprueba con files show antes de volver a ejecutarlo.
Un agente cambió un archivo que no querías que cambiaraPor MCP el nivel ask deja que un comando se ejecute. Deniega files.delete y files.share, o define YDISK_READ_ONLY=1. Mira la conexión del agente. Un archivo borrado está en la papelera del Disk: files restore.
El archivo de ajustes no se leedoctor lista cada problema del archivo en config.issues. Ejecuta el config unset que da cada uno, config repair, o corrige el archivo a mano.
doctor lista files.problemsOtros usuarios del ordenador pueden leer config.json o entrar en su carpeta. Ejecuta cada chmod que doctor imprime después de "to make it private:".

Códigos de salida

CódigoSignificado
2El comando se escribió mal: falta un perfil, un argumento o una opción.
3Los ajustes o el llavero no se pueden usar.
4Yandex rechazó el token.
5No permitido: los permisos del token o los del perfil.
6No existe ese archivo o carpeta, o el token no lo ve.
7Un cambio necesita tu confirmación y no había terminal para preguntarla.
8Yandex pidió ir más despacio.
14Puede que un cambio se hiciera o puede que no.

Todos los códigos están en la referencia de comandos.

Si sigue fallando

ydisk runs list muestra las ejecuciones recientes, y ydisk runs show una de ellas con cada paso que dio. Los secretos están ocultos. ydisk doctor reports create escribe un archivo de informe para un reporte de error y dice qué contiene. Abre una incidencia en github.com/WireCatLabs/ydisk-cli/issues con el código de error y el comando. No pegues nunca un token ni contenido privado en una incidencia.