コマンドの作成とヘルプ機能

CLIコマンドの全一覧は、GitHubリポジトリを参照してください。

必要なエンドポイント用のコマンドが表示されない場合は、カスタムリクエストを作成できます。

helpを使用したフォルダの作成

どのCLIコマンドもboxで始まります。任意のコマンドにオプション--helpを追加すると、そのコマンドを作成するためのヘルプが表示されます。たとえば、box --helpを実行すると、使用可能なすべてのオブジェクトコマンドのリストが表示されます。オプションの詳細については、手順4で説明します。

次に、例として、フォルダオブジェクトを使用してコマンドbox folders --helpを実行します。その結果、このオブジェクトに実行できるすべてのアクションのリストが表示されます。

フォルダの作成に必要な引数を調べるためのコマンド: box folders:create --help

コマンドbox folders:create 0 "My CLI Folder"を実行し、レスポンスで返されたフォルダIDを書き留めておきます。

自分のBoxアカウントにログインします。このフォルダが自分のフォルダツリーに表示されているでしょうか?

このフォルダは、自分のBoxアカウントに表示されません。なぜなら、このフォルダを所有していないか、このフォルダにコラボレータとして追加されていないからです。サービスアカウントとしてコマンドを実行しているため、作成されたフォルダは、自分のアカウントではなくサービスアカウントのフォルダツリーに存在します。

ここで、次のコマンドを実行します: box folders:collaborations:add folder_id_created_above --role=editor --user-id=YOUR_USER_ID

[すべてのファイル] ページに戻ります。これでフォルダが表示されるようになったでしょうか?

2番目のコマンドでは、このフォルダを所有するサービスアカウントを使用し、自分のユーザーIDを編集者レベルのコラボレータとしてフォルダに追加しました。これで、このフォルダが自分のフォルダツリーに表示されます。

まとめ

• ヘルプ機能を使用してフォルダを作成しました。
• 作成したフォルダにコラボレーションを追加し、Boxで表示しました。