Scegli e verifica uno spazio di lavoro CLI dosya

La maggior parte dei percorsi CLI è relativa a uno spazio di lavoro. Impostane uno predefinito per i comandi abituali, usa --workspace per sceglierne un altro per un singolo comando oppure anteponi ws_ID: al percorso per indicarne lo spazio di lavoro. Verifica il contesto prima di caricare, spostare, copiare o eliminare.

Procedura

Autenticati prima, poi elenca tutti gli spazi di lavoro visibili alla credenziale:

dosya workspace list

La tabella mostra ID, NAME e STORAGE. Usa il valore che inizia con ws_; i nomi visualizzati non sono accettati come identificativi. Per gli script, dosya workspace list --json restituisce la risposta del server con un array workspaces.

Una chiave API vincolata a uno spazio di lavoro può mostrare solo quello spazio. Una chiave valida per tutto l’account vede solo gli spazi di cui il proprietario è membro. Se manca la riga attesa, controlla Ambito di accesso della chiave API, l’appartenenza corrente e l’indirizzo del servizio prima di impostare un valore predefinito.

Imposta e controlla il valore predefinito

Salva l’ID scelto:

dosya workspace use ws_REPLACE_ME
dosya config get default_workspace
dosya ls

workspace use scrive default_workspace nella configurazione CLI e mostra Default workspace set to …. Non contatta l’API né verifica che l’ID esista. Il successivo dosya ls è il controllo decisivo: confronta una cartella o un file noto nella radice con lo stesso spazio di lavoro nell’app web.

Usa dosya config path per individuare il file di configurazione attivo. Di norma è ~/.dosya/config.json o $XDG_CONFIG_HOME/dosya/config.json. Un nuovo accesso unisce i valori di autenticazione al file e conserva lo spazio di lavoro predefinito.

Cambia il valore predefinito per un comando

Per i comandi che gestiscono percorsi, la precedenza dello spazio di lavoro è:

1. Un prefisso esplicito ws_ID:path/to/item nel riferimento.
2. --workspace ws_ID o -w ws_ID nel comando.
3. Il valore salvato default_workspace.

Esempi:

# Uses the saved default.
dosya info reports/q3.pdf

# Overrides the default for this command.
dosya info reports/q3.pdf --workspace ws_OTHER

# The prefix belongs to the reference and wins over --workspace.
dosya info ws_EXPLICIT:reports/q3.pdf --workspace ws_OTHER

Gli ID file grezzi come file_… identificano i file globalmente e non richiedono uno spazio di lavoro per la ricerca. Gli ID cartella grezzi e i nomi usati da comandi che richiedono uno spazio di lavoro possono invece richiedere un contesto. Se manca, il risolutore segnala No workspace for "PATH". Use ws_id:path, --workspace <id>, or set a default workspace.

dosya ls accetta lo spazio di lavoro come argomento posizionale: in dosya ls ws_ID il primo argomento prevale su --workspace e sul valore predefinito salvato. Usa un solo metodo per indicare il contesto in ogni comando, per evitare valori in conflitto.

Controlla prima di scrivere o eliminare

Esegui una lettura senza modifiche con lo stesso contesto previsto:

TARGET_WORKSPACE='ws_REPLACE_ME'
dosya ls --workspace "$TARGET_WORKSPACE" --json > workspace-check.json

Controlla workspace_id, i nomi delle cartelle note e gli ID file restituiti. Poi usa lo stesso valore --workspace per la scrittura:

dosya upload ./sample.txt --workspace "$TARGET_WORKSPACE" --folder fld_REPLACE_ME

Per l’automazione, è più facile verificare un’opzione esplicita --workspace o un prefisso ws_ID: che un valore predefinito della macchina, che può cambiare. Cambiare il valore predefinito influisce sui successivi comandi basati su percorsi, ma non sposta file esistenti né cambia lo spazio attivo nell’app web.

Risolvi i problemi di contesto

Workspace ID required. Usa dosya ls ws_ID, aggiungi --workspace ws_ID o imposta default_workspace.

Un percorso punta allo spazio di lavoro sbagliato. Controlla prima il prefisso ws_ID:, poi le opzioni del comando e infine dosya config get default_workspace.

Il valore predefinito è stato accettato, ma è impossibile mostrare l’elenco. workspace use salva il testo localmente senza convalidarlo. Copia l’ID attuale da dosya workspace list e impostalo di nuovo.

Lo spazio di lavoro è elencato, ma un’operazione restituisce 403. La selezione è riuscita; controlla i permessi della chiave, l’accesso al protocollo, il ruolo, i vincoli alla cartella, i blocchi e le condizioni di origine per l’operazione tentata.

Due spazi di lavoro contengono lo stesso percorso file. Usa ws_ID:path o un ID file grezzo negli script da ripetere. I soli nomi di cartelle e file non identificano gli elementi in tutto l’account.

Risultato previsto

L’elenco senza modifiche e l’app web mostrano lo stesso spazio di lavoro e gli stessi contenuti noti. I comandi successivi indicano esplicitamente lo spazio desiderato o usano un valore predefinito verificato, senza ricerche ambigue per nome visualizzato.

Guide correlate

• Autenticare la CLI
• Controllare indirizzo e configurazione CLI
• Cambiare spazio di lavoro nell’app web