SORACOM CLI 利用ガイド
SORACOM では SORACOM API をコマンドラインから簡単に呼び出せるツールとして SORACOM CLI を提供しています。このガイドでは SORACOM CLI のインストール方法や基本的な使い方を解説します。
インストール方法
macOS をお使いで、homebrew によりインストールする、または Linuxbrew をお使いの場合
以下のコマンドよりインストールできます。
brew tap soracom/soracom-cli
brew install soracom-cli
それ以外の場合
Releases のページ からターゲットの環境に合ったパッケージファイルをダウンロードして展開し、実行形式ファイルを PATH の通ったディレクトリに配置します。
(例 :) Linux OS の場合
以下のコマンドよりインストールできます。
wget https://github.com/soracom/soracom-cli/releases/download/v0.5.0/soracom_0.5.0_linux_amd64.tar.gz
tar xvf ./soracom_0.5.0_linux_amd64.tar.gz
cp ./soracom_0.5.0_linux_amd64/soracom /usr/local/bin/.
- 例として 0.5.0 をインストールしていますが、最新のバージョンは Releases のページでご確認ください
- 例として amd64 をインストールしていますが、i386, arm 用のパッケージファイルもご用意しています。環境に合ったパッケージファイルをご利用ください
- 例として /usr/local/bin に配置していますが、環境や用途に合わせて PATH の通ったディレクトリに配置してください
(例 :) Windows OS の場合
- https://github.com/soracom/soracom-cli/releases/ へアクセスし、
soracom_[バージョン]_windows_amd64.zip
をクリック、ダウンロードしてください。 - ダウンロードした zip ファイルを解凍してください。
- exe ファイルを PATH の通っているディレクトリ (%SystemRoot%\system32 など) に配置してください。
- コマンドプロンプトから
soracom
コマンドが利用できます。
Windows のコマンドプロンプト (cmd.exe) から CLI を利用する場合、リクエストボディに JSON を指定する時に注意が必要です。コマンドプロンプトでは、"“ (ダブルクォーテーション)で囲まれた文字列は ”“ の中の文字列だけが意味を持ち、文字列を囲んでいるダブルクォーテーションは削除されます。また、” 単体ではダブルクォーテーションの文字そのものとして解釈されます。 たとえば、JSON {“key”:“value”} を Windows のコマンドプロンプトで指定するには “{”“"key”“”:“”“value”“”}“ と書きます。
基本的な使い方 - 認証
まずはコンソールでログインするのと同様に認証します。
soracom configure
を実行すると、以下のように選択肢が示されます。
$ soracom configure
--- SORACOM CLI setup ---
This will create a directory /home/mick/.soracom if it does not exist yet and place 'default.json' in it.
Please select which coverage type to use.
1. Global
2. Japan
select (1-2) >
上記では、plan01s などグローバルカバレッジをご利用であれば 1
を、plan-D など日本カバレッジをご利用であれば 2
を入力して Enter を押します。
Please select which authentication method to use.
1. Input AuthKeyId and AuthKey * Recommended *
2. Input Operator credentials (Operator Email and Password)
3. Input SAM credentials (OperatorId, User name and Password)
select (1-3) >
上記では認証方式を選びます。推奨は AuthKeyId と AuthKey を用いる 1
です。オペレーターのメールアドレス・パスワードを用いる 2
や SAM ユーザーのオペレーター ID・ユーザー名・パスワードを用いる 3
もあります。希望する番号を入力して Enter を押します。
SAM ユーザーを作成して AuthKeyId と AuthKey を発行する方法はSORACOM Access Management を使用して操作権限を管理する をご参照ください。
authKeyId: AuthKeyId
authKey: AuthKey
Profile default already exists. Overwrite it? (Y/n)
1
を選択して AuthKeyId と AuthKey を入力した後、過去にログインしたことがあれば設定を上書きしてよいか確認されます。上書きして良ければ Y
を入力して Enter を押します。
以上で認証は完了です。
基本的な使い方 - command を使って SIM 一覧を取得する
SORACOM CLI は soracom [command] [flag]
といった形式で使用します。
command は subscriber
, vpg
など呼び出したい SORACOM API の詳細で、flag は --imsi
--limit
など呼び出す際の条件を指定します。
たとえば soracom subscribers list
と入力して SIM 一覧を表示しましょう。(下の表示例では一部情報をマスクしています)
$ soracom subscribers list
[
{
"apn": "soracom.io",
"imsi": "44010xxxxxxxxxx",
(中略)
"speedClass": "s1.minimum"
},
{
"apn": "soracom.io",
"imsi": "44010yyyyyyyyyy",
(中略)
"speedClass": "s1.standard"
},
... (以下略)
]
基本的な使い方 - flag を使って速度クラスを変更する
command によって flag は必須のものと任意のものとがあります。たとえば subscribers list
には必須の flag はありませんが、subscribers update-speed-class
の場合は IMSI や速度クラスの指定が --imsi "IMSI" --speed-class "速度クラス"
の flag で必須になります。
subscribers list
で確認できた IMSI を flag に指定して、soracom subscribers update-speed-class --imsi "IMSI" --speed-class "速度クラス"
で速度クラスを変更してみましょう。(下の表示例では一部情報をマスクしています)
$ soracom subscribers update-speed-class --imsi "44010xxxxxxxxxx" --speed-class "s1.fast"
{
"apn": "soracom.io",
"imsi": "44010xxxxxxxxxx",
"ipAddress": "10.zzz.zzz.zzz",
"moduleType": "nano",
(中略)
"speedClass": "s1.fast"
}
なお必須の引数を指定しなかった場合、以下のようにその旨が指摘されます。
$ soracom subscribers update-speed-class
Error: required flag(s) "imsi", "speed-class" not set
Usage:
soracom subscribers update-speed-class [flags]
基本的な使い方 - ヘルプの見方
soracom --help
または soracom -h
と実行するとヘルプが表示されます。
soracom subscribers --help
と実行すると soracom subscribers
配下で実行できる command 一覧が確認でき、
soracom subscribers update-speed-class --help
と実行すると soracom subscribers update-speed-class
に指定できる flag の一覧が確認できます。
SORACOM ではユーザーコンソールでできることはほぼすべて API ででき、その API は SORACOM CLI から呼び出せます。ぜひいろいろな CLI を試してみてください。
$ soracom subscribers update-speed-class --help
Changes the speed class of the specified subscriber.
Usage:
soracom subscribers update-speed-class [flags]
Flags:
--body string JSON string or @filename for API request body.
-h, --help help for update-speed-class
--imsi string IMSI of the target subscriber.
--speed-class string
Global Flags:
--api-key string Specify API key otherwise soracom-cli performs authentication on behalf of you
--api-token string Specify API token otherwise soracom-cli performs authentication on behalf of you
--coverage-type string Specify coverage type, 'g' for Global, 'jp' for Japan
--profile string Specify profile name
アップデート方法
homebrew/Linuxbrew によりアップデートする場合
以下のコマンドよりアップデートできます。
brew upgrade soracom-cli
それ以外の場合
Releases のページ からターゲットの環境に合ったパッケージファイルをダウンロードして展開し、既存の実行形式ファイルと置き換えます。
アンインストール方法
homebrew/Linuxbrew によりアンインストールする場合
以下のコマンドよりアンインストールできます。
brew uninstall soracom-cli
$HOME/.soracom
ディレクトリには SORACOM に接続するための認証情報が残っています。こちらについても不要であれば削除します。
それ以外の場合
実行形式ファイルを削除してください。
$HOME/.soracom
(Windows の場合 %homepath%\.soracom
) ディレクトリには SORACOM に接続するための認証情報が残っています。こちらについても不要であれば削除します。
リファレンス
SORACOM CLI のソースコードや最新パッケージ、使い方の詳細は GitHub のリポジトリに公開されています。引数補完やプロキシ経由での使い方なども記載されていますのでご参照ください。
また、直接 API を利用することも可能です。SORACOM API 利用ガイドをご参照ください。