dosya CLIのワークスペースを選択して確認する

CLIのほとんどのパスはワークスペースを基準にします。通常のコマンド用に既定値を設定するか、1回だけ上書きするには--workspaceを指定してください。参照自体でワークスペースを指定する必要がある場合は、パスの先頭にws_ID:を付けてください。アップロード、移動、コピー、削除の前に、使用されるコンテキストを確認してください。

手順

まず認証し、認証情報から見えるすべてのワークスペースを一覧表示してください。

dosya workspace list

表にはID、NAME、STORAGEが表示されます。ws_で始まる値を使用してください。表示名はワークスペースの識別子として使用できません。スクリプトでは、dosya workspace list --jsonがworkspaces配列を含むサーバーの応答を返します。

ワークスペースに固定されたAPIキーからは、そのワークスペースだけが見えます。アカウント全体のキーでも、オーナーがメンバーであるワークスペースだけが見えます。目的の行がない場合は、既定値を設定する前にAPIキーのアクセス範囲、現在のメンバーシップ、エンドポイントを確認してください。

既定値を設定して確認する

選択したIDを保存してください。

dosya workspace use ws_REPLACE_ME
dosya config get default_workspace
dosya ls

workspace useはCLIの設定にdefault_workspaceを書き込み、Default workspace set to …を表示します。APIには接続せず、IDの存在も検証しません。続くdosya lsで確認してください。既知のルートフォルダーまたはファイルを、ウェブアプリの同じワークスペースと比較します。

dosya config pathで使用中の設定ファイルの場所を確認してください。通常は~/.dosya/config.jsonまたは$XDG_CONFIG_HOME/dosya/config.jsonです。再度サインインすると認証情報がこのファイルに統合され、既定のワークスペースは保持されます。

既定値を明示的に上書きする

パスを扱うコマンドでは、ワークスペースは次の順に優先されます。

1. 参照に明示されたws_ID:path/to/itemプレフィックス。
2. コマンドの--workspace ws_IDまたは-w ws_ID。
3. 保存されたdefault_workspace。

例：

# 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

file_…のようなファイルIDはグローバルに指定でき、検索にワークスペースは不要です。ワークスペースを必要とするコマンドで使うフォルダーIDや名前には、コンテキストが必要な場合があります。パスにコンテキストがない場合、次のエラーが表示されます。No workspace for "PATH". Use ws_id:path, --workspace <id>, or set a default workspace.

dosya lsには独自の位置引数形式があります。dosya ls ws_IDは--workspaceと保存された既定値より先に最初の引数を選びます。競合する値を確認する必要がないよう、1つのコマンドにつき1つのコンテキスト指定方法を使用してください。

書き込みや削除の前に確認する

使用予定と同じコンテキストで安全な読み取りを実行してください。

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

workspace_id、既知のフォルダー名、返されたファイルIDを確認してください。その後、書き込み時に同じ--workspace値を指定してください。

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

自動化では、変更される可能性があるマシンの既定値を引き継ぐより、明示的な--workspaceまたはws_ID:プレフィックスの方が確認しやすくなります。既定値の変更は以降のパスを使うコマンドに影響しますが、既存ファイルの移動やウェブアプリのアクティブなワークスペースの変更は行いません。

想定外のコンテキストを解決する

Workspace ID required. dosya ls ws_IDを指定するか、--workspace ws_IDを追加するか、default_workspaceを設定してください。

パスが別のワークスペースに解決される。 まずws_ID:プレフィックス、次にコマンドのフラグ、最後にdosya config get default_workspaceを確認してください。

既定値は受け入れられたが、一覧表示できない。 workspace useは検証せずにテキストをローカルに保存します。dosya workspace listから現在のIDをコピーして再設定してください。

ワークスペースは一覧にあるが、操作が403を返す。 選択は成功しています。対象の操作について、キーの権限、プロトコルへのアクセス、ワークスペースのロール、フォルダーの制限、ロック、元の条件を確認してください。

2つのワークスペースに同じファイルパスがある。 繰り返し使うスクリプトではws_ID:pathまたはファイルIDを使用してください。フォルダー名やファイル名だけではアカウント全体で識別できません。

期待される結果

安全な一覧表示とウェブアプリで、同じワークスペースと既知のコンテンツを確認できます。以降のコマンドは目的のワークスペースを明示的に指定するか、確認済みの既定値を引き継ぎます。曖昧な表示名での検索は行いません。

関連ガイド

• CLIを認証する
• CLIのエンドポイントと設定を確認する
• ウェブアプリでワークスペースを切り替える