SORACOM Developers

Getting Started

SIM (subscriber) を検索する

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

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

ユーザーコンソールを開き、SIM管理を開きます。

SIM管理

検索ボックスの横から検索したい属性を選択します。

属性の選択

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

属性 説明
すべて 以下に示すすべての検索可能な属性 (いずれかの属性にヒットしたものSIMが対象となります)
名前 SIMの名前
グループ SIMが属するグループの名前
IMSI SIMのIMSI
MSISDN SIMのMSISDN
ICCID SIMのICCID
製造番号 SIMの製造番号
タグ SIMに登録されているタグすべての値

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

APIを用いてSIMを検索する

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

https://dev.soracom.io/jp/docs/api/#!/Query/searchSubscribers

以下に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検索機能の利用に際しましては以下の事項に注意してください。

Getting Started

SORACOM Air for セルラー

SORACOM Air for LoRaWAN

SORACOM Air for Sigfox

SORACOM Beam

SORACOM Canal/Direct/Door

SORACOM Endorse

SORACOM Funnel

SORACOM Gate

SORACOM Harvest

SORACOM Inventory

SORACOM Junction

サービス機能詳細

Developer Tools

pagetop