MENU
はじめに
Getting Started
ユーザーコンソールの操作
さまざまな機能の使い方
トラブルシューティングとサポート
リファレンス

Soracom

Users

SIM を検索する

ユーザーコンソール上で SIM (subscriber) を検索する方法と、API を用いて SIM を検索する方法について紹介します。

ユーザーコンソール上で SIM を検索する

SIM は名前やグループ以外に、IMSI (SIM を一意に識別する 15 桁の ID) や MSISDN (81+電話番号の頭の 0 をとったもの) などの属性からも検索できます。

ユーザーコンソール SIM 管理画面の検索ボックスの横から検索したい属性を選択します。

属性の選択

各属性は以下の条件に基いて検索します。

属性説明
すべて以下に示すすべての検索可能な属性 (いずれかの属性にヒットしたもの SIM が対象となります)
名前SIM の名前
グループSIM が属するグループの名前
IMSISIM の IMSI
MSISDNSIM の MSISDN
ICCIDSIM の ICCID
製造番号SIM の製造番号
タグSIM に登録されているタグすべての値
オンラインのみオンラインの SIM のみを対象とするチェックボックス
オフラインのみオンラインの SIM のみを対象とするチェックボックス

属性を選択して検索したい文字列をボックスに入力してから、虫眼鏡マークがついているボタンをクリックするか、エンターキーを押下することで SIM が検索できます。

検索した結果、目的の SIM が見つかればその SIM の情報がリスト表示されます。該当する SIM が見つからなければその旨通知されます。

SIM の状態によるフィルタやソート

ある条件に適合する SIM のみを絞り込んで表示したり、表示している SIM の順番を並べ替えることができます。現時点では [状態] カラムのみをサポートしています。 フィルタやソートを行うには、一覧表示のカラムに表示されている [ ▼ ] ボタンをクリックします。

SIMのフィルタとソート

API を用いて SIM を検索する

SORACOM API では SIM 検索 API を提供しています。API の詳細につきましては API ドキュメント をご参照ください。

以下に soracom-cli を利用した SIM 検索 API の利用例を示します。

$ soracom query subscribers --name='mysim'

このコマンドは SIM の名前に mysim が含まれた SIM を検索し、その結果を返却します。

$ soracom query subscribers --name='mysim' --group='mygroup'

このコマンドは SIM の名前に mysim が含まれており、なおかつ SIM の属するグループ名に mygroup が含まれている SIM を検索し、その結果を返却します (AND 検索)。

$ soracom query subscribers --name='mysim' --group='mygroup' --search-type='or'

このコマンドは SIM の名前に mysim が含まれている、もしくは SIM の属するグループ名に mygroup が含まれている SIM を検索し、その結果を返却します (OR 検索)。 --search-typeを指定することにより、AND 検索と OR 検索を切り替えることが可能です。未指定の場合は AND 検索として機能します。

【SAM ユーザーを使用の場合】SIM 検索機能の権限を付与する

SAM ユーザーをご利用の場合、すべての SIM 検索機能をご利用いただくためには SIM 検索機能の権限 Query:searchSubscribers を設定する必要があります。権限が適切に設定されていない場合は SIM 検索機能の一部が制限されます。

SIM検索機能権限管理

なお、Query:searchSubscribers 権限を付与した場合はすべての SIM に対して group も含めた検索/一覧取得を行える権限が与えられます。 例えば、SIM の一覧のみに絞りたい場合は Subscriber:listSubscribers の使用をご検討ください。

SAM ユーザーの権限管理およびパーミッション構文の詳細につきましては、以下のドキュメントも併せてご参照ください。

備考

SIM 検索機能の利用に際しては以下の事項に注意してください。

  • 検索結果は部分一致したものを返します。
  • 検索ワードは最低でも 2 文字必要です。1 文字での検索はできません。
  • 検索ワードのアルファベットの大文字小文字は区別しません。
  • 検索ワードの半角と全角は区別しません。
  • タグ検索についてはタグに登録された値すべてを検索します。いずれかの値に検索ワードが含まれている SIM を結果として返却します。