コンテンツにスキップ

クエリ / 出力の加工


JMESPathまたはjqで出力の加工が行えます。

クエリの使い方

以下の書式で実行します。

$ usacloud <リソース名> <コマンド> --query="<query>" [--query-driver=<"jmespath"|"jq">] [ID or Name or Tags]
  • --query: JMESPathまたはjqに渡すクエリ(expression)
  • --query-driver: --queryを処理するドライバーの指定、jmespath(デフォルト)またはjqが指定可能

デフォルトのドライバーの切り替え

プロファイルのDefaultQueryDriverを指定することで--query-driverを省略した場合に利用するドライバーを指定可能です。
詳細はリファレンス/プロファイルを参照してください。

利用例

# 環境変数経由でデフォルトドライバーを切り替え
$ export SAKURACLOUD_DEFAULT_QUERY_DRIVER=jq

$ usacloud server list --query ".[].Name"
"server1"
"server2"
"server3"

--query以外の出力関連オプションとの併用

  • --quiet/-qまたは--formatを指定した場合、--queryの指定は無視されます
  • --queryを指定した場合、--output-typeの指定は無視されます