Soracom

Users

ドキュメント

IoT SIM の情報を確認する

SORACOM プラットフォームに登録した IoT SIM の情報を確認します。SIM 管理画面で IoT SIM を検索することもできます。

IoT SIM の情報を確認する 

SORACOM プラットフォームに登録した IoT SIM の情報は、SORACOM ユーザーコンソールの SIM 管理画面 (一覧表示または詳細表示) で確認できます。

一覧表示 

  1. SORACOM ユーザーコンソール にログインし、詳細情報を確認する IoT SIM にあわせてカバレッジタイプを変更します。

    たとえば、plan01s の IoT SIM の詳細情報を確認する場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

    SIM 管理画面が表示されます。

  2. IoT SIM の情報を確認します。

    SIM 管理画面 (一覧表示) で確認できる各項目の意味は以下のとおりです。

    項目説明
    SIM IDSIM ID
    名前IoT SIM の名前。任意の名前を設定できます。詳しくは、IoT SIM の名前を設定する を参照してください。
    グループIoT SIM が所属しているグループ。詳しくは、グループ設定 を参照してください。
    ICCIDIntegrated Circuit Card ID。IoT SIM やバーチャル SIM/Subscriber を識別するための識別子
    IMSIIMSI (International Mobile Subscriber Identity)
    MSISDNMobile Station International Subscriber Directory Number。IoT SIM に割り当てられた電話番号 (国番号に電話番号を追加したもの。日本の場合は、81+電話番号の頭の 0 をとったものです)。
    ただし、IoT SIM では音声通話はできません。また、サブスクリプションによっては SMS の利用が制限されています。SMS について詳しくは、SORACOM プラットフォームと SMS を送受信する および 他社の SIM と SMS を送受信する を参照してください。
    製造番号特定地域向け IoT SIM の裏面に記載された製造番号。グローバルカバレッジの IoT SIM には設定されていません。
    IP アドレスSORACOM プラットフォームより割り当てられたプライベート IPv4 アドレス。セッションが「オンライン」のときにのみ表示されます。IPv4 アドレスを利用してデバイスにアクセスする方法について詳しくは、Air SIM で通信しているデバイスに対して外部からアクセスできますか? を参照してください。
    状態 (ステータス)IoT SIM のステータス (「準備完了」、「使用中」、「休止中」など)、およびセッションの状態 (オンライン、オフライン)。IoT SIM のステータスについて詳しくは、IoT SIM のステータスを変更する を参照してください。セッションについて詳しくは、IoT SIM の通信状況 (セッション) を確認する を参照してください。
    最終オンライン日時セッションが「オフライン」の場合に、最後にオンラインだった日時。セッション状態が「オンライン」の場合は、日時は表示されません。
    プラン: データ通信のみ。: データ通信+SMS。
    サブスクリプションサブスクリプション
    バンドルデータ通信料金に関する契約。一部のサブスクリプションには、バンドルを選択できます。たとえば、plan-D には D-300MB、plan-DU には DU-10GB や DU-50GB を選択できます。
    モジュールタイプIoT SIM のサイズ。eSIM の場合は「エンベデッド」と表示されます。
    速度クラス速度クラス。詳しくは、SIM の速度クラスを変更する を参照してください。
    有効期限有効期限。詳しくは、SIM の有効期限とアクションを設定する を参照してください。
    IMEI ロックIMEI ロックの有効/無効。有効の場合は 紐づけた IMEI も表示されます。詳しくは、SIM の IMEI ロック を設定する を参照してください。
    TP解約プロテクションの有効/無効。解約プロテクションを解除するには、解約プロテクションを解除する を参照してください。
    表示する項目は、歯車アイコンをクリックすると変更できます。

詳細表示 

SIM 管理画面で選択した IoT SIM の詳細情報を確認します。

SIM 管理画面で表示される情報でも SIM 詳細画面に表示されない場合があります

SIM 詳細画面では、以下の情報は表示されません。

  • ICCID
  • 最終オンライン日時 (ただし、セッション履歴の最新の Deleted イベントの日時で確認できます)
  • サブスクリプション
  • バンドル
  • IMEI ロック
  • TP
  1. SORACOM ユーザーコンソール にログインし、詳細情報を確認する IoT SIM にあわせてカバレッジタイプを変更します。

    たとえば、plan01s の IoT SIM の詳細情報を確認する場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

  2. 詳細情報を確認する IoT SIM にチェックを入れ、[詳細] をクリックします。

    選択した IoT SIM の SIM 詳細画面が表示されます。

    SIM 詳細画面では、SIM 管理画面に加えて以下の情報が表示されます。

    項目説明
    詳細情報 → IMEIIMEI (International Mobile Equipment Identifier)。IoT SIM が取り付けられたデバイスを識別するための識別番号です。
    通信量履歴IoT SIM ごとにデータ通信量を確認する を参照してください。
    タグIoT SIM に付加情報を設定する (タグ) を参照してください。
    監視 (*1)任意の IoT SIM の監視内容を設定する を参照してください。
    セッション詳細セッション履歴を確認する を参照してください。
    パケットキャプチャIoT SIM のパケットをキャプチャする を参照してください。
    バーチャル SIMバーチャル SIM/Subscriber で接続するバーチャル SIM/Subscriber を解約する などを参照してください
    • (*1) 従来の SIM 管理画面から SIM 詳細画面を表示した場合のみ表示されます。

SORACOM CLI / SORACOM API の場合 

SORACOM CLI または SORACOM API を利用しても、IoT SIM の情報を取得できます。

  • SORACOM CLI を利用するには、あらかじめ SORACOM CLI をインストールし、認証情報を保存してください。詳しくは、SORACOM CLI をインストールする を参照してください。
  • SIM ID は、soracom sims list (Sim:listSims) で取得できます。

一覧表示 

soracom sims list (Sim:listSims) を使用します。

$ soracom sims list

詳細表示 

soracom sims get (Sim:getSim) を使用します。

$ soracom sims get --sim-id ${sim_id}
  • SORACOM API を利用するには、API キーと API トークンが必要です。詳しくは、API キーと API トークン を参照してください。
  • SIM ID は、Sim:listSims で取得できます。

一覧表示 

Sim:listSims を使用します。

$ curl -v -X GET https://api.soracom.io/v1/sims \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"

詳細表示 

Sim:getSim を使用します。

$ curl -v -X GET https://api.soracom.io/v1/sims/${sim_id} \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"

IoT SIM を検索する 

SORACOM ユーザーコンソールで検索する場合は、サブスクリプションコンテナに対応した新しい SIM 管理画面を利用する方法と、従来の SIM 管理画面を利用する方法があります。

検索条件について
  • 文字列で指定する場合は、以下の点に注意してください。
    • 部分一致検索です。指定した文字列が含まれる場合に一致します。
    • 1 文字では検索できません。最低 2 文字入力してください。
    • アルファベットの大文字小文字、および半角と全角は区別されません。
  • タグを検索対象にした場合は、すべてのタグに登録された値を検索します。指定した文字列がいずれかのタグの値に含まれている IoT SIM が返されます。

サブスクリプションコンテナに対応した新しい SIM 管理画面を利用して検索する 

  1. SORACOM ユーザーコンソール にログインし、検索対象の IoT SIM にあわせてカバレッジタイプを変更します。

    たとえば、plan01s の IoT SIM を検索する場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

  2. 従来の SIM 管理画面が表示されている場合は、[切り替える] をクリックします。

  3. SIM 管理画面の虫眼鏡マークが表示されているボタンをクリックし、検索条件を指定します。

    検索条件の指定


    [文字列で検索]

    属性を選択し、文字列を入力します。入力した文字列が各属性に含まれた IoT SIM が一覧表示されます。部分一致で検索できます。大文字と小文字は区別されません。 各属性の検索対象は以下のとおりです。検索対象の詳細については、IoT SIM の情報を確認する を参照してください。

    属性検索対象
    [すべて]名前グループSIM IDIMSIMSISDNICCID製造番号タグ のすべて
    [名前]IoT SIM の名前
    [グループ]IoT SIM が所属するグループの名前
    [SIM ID]SIM カードを物理的に識別するための識別子
    [IMSI]International Mobile Subscriber Identity。ネットワークオペレーターが各契約者を一意に識別するための識別子。SORACOM プラットフォームでは各 IoT SIM を操作するときのキーになったり各種サービスでも識別子として用いられるので非常に重要なパラメータです
    [MSISDN]Mobile Station International Subscriber Directory Number。IoT SIM に割り当てられた電話番号 (国番号に電話番号を追加したもの。日本の場合は、81+電話番号の頭の 0 をとったものです)。ただし、IoT SIM では音声通話はサポートしておらず、SMS が利用できない IoT SIM もあります
    [ICCID]Integrated Circuit Card ID。SIM カードや仮想的な IoT SIM (バーチャル SIM/Subscriber) を識別するための識別子
    [製造番号]IoT SIM の裏面に記載された製造番号。特定地域向け IoT SIM にのみ設定されています
    [タグ]IoT SIM のタグ。詳しくは、IoT SIM に付加情報を設定する (タグ) を参照してください

    [通信状態で絞り込む]

    IoT SIM のセッション状態 (オンライン、オフライン) で絞り込みます。


    [状態で絞り込む]

    IoT SIM のステータスと、追加サブスクリプションのステータスで、絞り込みます。

    検索条件で選択した「状態」と、IoT SIM のステータス、追加サブスクリプションのステータスの関係は以下のとおりです。

    検索条件の表示IoT SIM のステータス追加サブスクリプションのステータス
    利用開始待ち利用開始待ち-
    準備完了準備完了ready
    使用中使用中active (表示なし)
    休止中休止中-
    利用中断中利用中断中-
    解約済み解約済み-

    たとえば、「準備完了」を選択した場合は、以下の 2 種類の IoT SIM が表示されます。

    • IoT SIM のステータスが「準備完了」の IoT SIM
    • 追加サブスクリプションのステータスが「ready」の IoT SIM

    [サブスクリプションで絞り込む]

    サブスクリプションで絞り込みます。詳しくは、サブスクリプションの種類 を参照してください。

    サブスクリプションのボタンが表示されない場合は、テキストボックスに入力してください。完全一致で検索されます。大文字と小文字は区別されません。

    • planArc01 は、IoT SIM にバーチャル SIM/Subscriber をセカンダリーサブスクライバーとして追加したことを示すサブスクリプションです。詳しくは、バーチャル SIM/Subscriber を作成する を参照してください。
    • plan-NA1-package は、United States および Canada でのみ契約できるサブスクリプションです。

    [モジュールタイプで絞り込む]

    IoT SIM の種類で絞り込みます。

  4. [検索]をクリックします。

    設定した条件を満たす IoT SIM が一覧表示されます。

従来の SIM 管理画面を利用して検索する 

  1. SORACOM ユーザーコンソール にログインし、検索対象の IoT SIM にあわせてカバレッジタイプを変更します。

    たとえば、plan01s の IoT SIM を検索する場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

  2. サブスクリプションコンテナに対応した新しい SIM 管理画面が表示されている場合は、[従来のバージョンに戻す] をクリックします。

  3. SIM 管理画面の検索ボックスの [▼] をクリックし、検索対象の属性を選択します。

    属性の選択

    各属性の検索対象は以下のとおりです。属性の詳細については、IoT SIM の情報を確認する を参照してください。

    属性検索対象
    [すべて]名前グループIMSIMSISDNICCID製造番号タグ のすべて
    オンラインのみオフラインのみ は検索対象になりません。
    [名前]IoT SIM の名前
    [グループ]IoT SIM が所属するグループの名前
    [IMSI]International Mobile Subscriber Identity。ネットワークオペレーターが各契約者を一意に識別するための識別子。SORACOM プラットフォームでは各 IoT SIM を操作するときのキーになったり各種サービスでも識別子として用いられるので非常に重要なパラメータです
    [MSISDN]Mobile Station International Subscriber Directory Number。IoT SIM に割り当てられた電話番号 (国番号に電話番号を追加したもの。日本の場合は、81+電話番号の頭の 0 をとったものです)。ただし、IoT SIM では音声通話はサポートしておらず、SMS が利用できない IoT SIM もあります
    [ICCID]Integrated Circuit Card ID。SIM カードや仮想的な IoT SIM (バーチャル SIM/Subscriber) を識別するための識別子
    [製造番号]IoT SIM の裏面に記載された製造番号。特定地域向け IoT SIM にのみ設定されています
    [タグ]IoT SIM のタグ。詳しくは、IoT SIM に付加情報を設定する (タグ) を参照してください
  4. オンラインまたはオフラインの IoT SIM のみを表示する場合は、[オンラインのみ] または [オフラインのみ] のチェックを入れます。

  5. 検索する文字列を検索ボックスに入力し、虫眼鏡マークが表示されているボタンをクリックするか、Enter キーを押します。

    設定した条件を満たす IoT SIM が一覧表示されます。

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

従来の SIM 管理画面では、一覧表示の [状態] に表示されている [▼] をクリックすると、条件に適合する IoT SIM のみを絞り込んで表示したり、表示している IoT SIM の順番を並べ替えることができます。

SIMのフィルタとソート

SORACOM CLI / SORACOM API の場合 

SORACOM CLI または SORACOM API を利用しても、IoT SIM の情報を取得できます。

SORACOM CLI を利用するには、あらかじめ SORACOM CLI をインストールし、認証情報を保存してください。詳しくは、SORACOM CLI をインストールする を参照してください。

soracom query sims (Query:searchSims) を使用します。

  • IoT SIM の名前に mysim が含まれた IoT SIM を検索します。

    $ soracom query sims --name='mysim'
    

  • IoT SIM の名前に mysim が含まれており、なおかつ IoT SIM が所属するグループ名に mygroup が含まれている IoT SIM を検索します (AND 検索)。

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

  • IoT SIM の名前に mysim が含まれている、または IoT SIM が所属するグループ名に mygroup が含まれている IoT SIM を検索します (OR 検索)。

    --search-type='or' を指定すると、OR 検索として機能します。未指定の場合、および --search-type='and' を指定すると、AND 検索として機能します。

    $ soracom query sims --name='mysim' --group='mygroup' --search-type='or'
    
SORACOM API を利用するには、API キーと API トークンが必要です。詳しくは、API キーと API トークン を参照してください。

Query:searchSims を使用します。

  • IoT SIM の名前に mysim が含まれた IoT SIM を検索します。

    $ curl -v -X GET "https://api.soracom.io/v1/query/sims?name=mysim" \
    -H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
    -H "X-Soracom-Token: $X_SORACOM_TOKEN"
    

  • IoT SIM の名前に mysim が含まれており、なおかつ IoT SIM が所属するグループ名に mygroup が含まれている IoT SIM を検索します (AND 検索)。

    $ curl -v -X GET "https://api.soracom.io/v1/query/sims?name=mysim&group=mygroup" \
    -H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
    -H "X-Soracom-Token: $X_SORACOM_TOKEN"
    

  • IoT SIM の名前に mysim が含まれている、または IoT SIM が所属するグループ名に mygroup が含まれている IoT SIM を検索します (OR 検索)。

    --search-type='or' を指定すると、OR 検索として機能します。未指定の場合、および --search-type='and' を指定すると、AND 検索として機能します。

    $ curl -v -X GET "https://api.soracom.io/v1/query/sims?name=mysim&group=mygroup&search_type=or" \
    -H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
    -H "X-Soracom-Token: $X_SORACOM_TOKEN"