Soracom

Users

ドキュメント
Home ドキュメント SORACOM Air for セルラー IoT SIM を管理する

SIM 管理画面で IoT SIM の情報を確認 / 検索する

ユーザーコンソールの SIM 管理画面を利用すると、SORACOM に登録した IoT SIM の情報を確認したり、IoT SIM を検索したりできます。また、IoT SIM のステータスの変更や速度クラス (通信速度の上限) の変更などが行えます。

SAM ユーザーで SIM 管理画面が表示されないときは

SIM 管理画面に 要求された操作を行う権限がありません。( COM0017 ) と表示された場合は、SAM ユーザーに SIM 管理画面を表示するための権限が設定されていません。詳しくは、SORACOM ユーザーコンソールの主な機能と権限設定について を参照してください。

ソラカメ専用セルラーパックのデータ通信 SIM は SIM 管理画面には表示されません

ソラカメ専用セルラーパックに付属するデータ通信 SIM は、SORACOM Air for セルラーの IoT SIM ではありません。そのため、ソラカメ専用セルラーパックのデータ通信 SIM は、SIM 管理画面には表示されません。

IoT SIM の情報を確認する

SORACOM に登録した IoT SIM の情報は、SIM 管理画面の一覧表示または詳細表示で確認できます。

一覧表示

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

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

  2. [メニュー][SORACOM AIR FOR セルラー][SIM 管理] の順にクリックします。

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

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

    項目表示 (*1)説明
    チェックボックスIoT SIM を操作するときに、チェックを入れて [詳細][操作] をクリックします。
    SIM ID(*2)SIM ID
    名前IoT SIM の名前。任意の名前を設定できます。詳しくは、IoT SIM の名前を設定する を参照してください。
    グループIoT SIM が所属しているグループ。詳しくは、グループ設定 を参照してください。
    ICCID(*2)Integrated Circuit Card ID。IoT SIM やバーチャル SIM/Subscriber を識別するための識別子です。
    IMSIIMSI (International Mobile Subscriber Identity)
    MSISDN-MSISDN (Mobile Station International Subscriber Directory Number)
    製造番号 (*3)-特定地域向け IoT SIM の裏面に記載された製造番号。
    IP アドレス-SORACOM より割り当てられたプライベート IP アドレス。セッションが「オンライン」のときにのみ表示されます。IP アドレスを利用してデバイスにアクセスする方法について詳しくは、FAQ: IoT SIM で通信しているデバイスに対して外部からアクセスできますか? を参照してください。
    状態IoT SIM のステータス (「準備完了」、「使用中」、「休止中」など)、およびセッションの状態 (オンライン、オフライン)。IoT SIM のステータスについて詳しくは、IoT SIM のステータスを変更する を参照してください。セッションについて詳しくは、IoT SIM の通信状況 (セッション) を確認する を参照してください。
    最終オンライン日時-セッションが「オフライン」の場合に、最後にオンラインだった日時。セッションが「オンライン」の場合は、日時は表示されません。
    国または地域 (*4)IoT SIM が所在する国または地域。
    プラン : データ通信のみ。 : データ通信+SMS。
    バンドルデータ通信料金に関する契約。一部のサブスクリプションには、バンドルを選択できます。たとえば、plan-D では D-300MB、plan-DU では DU-10GB、DU-50GB、または DU-100GB を選択できます。
    サブスクリプションサブスクリプション
    モジュールタイプ-IoT SIM のサイズ。eSIM の場合は「エンベデッド」と表示されます。
    速度クラス速度クラス。詳しくは、IoT SIM の速度クラスを変更する を参照してください。
    有効期限有効期限。詳しくは、IoT SIM の有効期限とアクションを設定する を参照してください。
    IMEI ロックIMEI ロックの有効/無効。有効の場合は 紐づけた IMEI も表示されます。詳しくは、IoT SIM に IMEI ロックを設定する を参照してください。
    TP解約プロテクションの有効/無効。解約プロテクションを解除するには、解約プロテクションを解除 / 設定する を参照してください。
    (任意のタグ)-IoT SIM に設定した付加情報 (タグ)。タグについて詳しくは、IoT SIM に付加情報 (タグ) を設定する を参照してください。
    • (*1) デフォルトの表示有無です。「✓」の項目はデフォルトで表示されています。「-」の項目はデフォルトで非表示です。表示する項目を変更する操作については、一覧表示の表示項目を設定する を参照してください。
    • (*2) 日本カバレッジでは、デフォルトで非表示です。グローバルカバレッジでは、デフォルトで表示されています。
    • (*3) 日本カバレッジでのみ表示される項目です。
    • (*4) グローバルカバレッジでのみ表示される項目です。
操作する IoT SIM が見つからないときは
  • カバレッジタイプが異なる IoT SIM は表示されません。たとえば、plan01s の IoT SIM を操作する場合は、グローバルカバレッジの表示に変更します。plan-D の IoT SIM を操作する場合は、日本カバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

  • デフォルトでは最大 10 件の IoT SIM が表示されています。操作する IoT SIM がその中に見つからない場合は、以下のいずれかの方法で IoT SIM を探してください。

    • [表示件数] で「25」/「50」/「100」を選択して、一覧に表示する IoT SIM の数を増やす。
    • [←] (前へ) / [→] (次へ) をクリックして、前のページ / 次のページを表示する。
    • IoT SIM を検索する
SORACOM CLI / SORACOM API の場合

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

  • SORACOM CLI を利用する場合は、soracom sims list を使用します。
  • SORACOM API を利用する場合は、Sim:listSims API を使用します。

一覧表示の表示項目を設定する

一覧表示の表示項目を変更したり、表示順序を変更したりできます。

  1. SIM 管理画面の [歯車] をクリックします。

  2. 一覧表示の表示項目を設定します。

    • 表示する項目を変更するには、スイッチをオン / オフします。
    • 項目の表示順序を入れ替えるには、[] を上下にドラッグします。
    • タグ に設定した値を表示するには、[タグ名] にタグの名前 (キー) を入力して、[+カラム追加] をクリックします。なお、この操作で追加した項目は、[] をクリックすると、削除できます。
  3. [閉じる] をクリックします。

詳細表示

SIM 管理画面でチェックを入れた IoT SIM の詳細情報を確認します。

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

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

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

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

  2. [メニュー][SORACOM AIR FOR セルラー][SIM 管理] の順にクリックします。

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

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

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

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

    項目説明
    [詳細情報][更新料の起算日]

    更新料の起算日。

    • [更新料の起算日] が表示されている場合は、更新料の起算日から一定期間が経過すると更新料が発生します。
    • [更新料の起算日] が表示されていない場合は、更新料は発生しません。
    サブスクリプションおよび IoT SIM のステータスによっては更新料が発生します

    利用料金や更新料については、SORACOM IoT SIM のご利用料金 または ご利用料金 – 特定地域向け IoT SIM (plan-KM1) を参照してください。

    変更前のステータスと変更後のステータスの組み合わせによっては [更新日の起算日] は更新されません

    ステータスを変更しても基本料金が変わらないとき (例: 「利用開始待ち (standby)」から「利用中断中 (suspended)」に変更したとき) は、更新料の起算日は更新されません。

    [詳細情報][期限切れ時のアクション]IoT SIM の有効期限が切れたときのアクション。詳しくは、IoT SIM の有効期限とアクションを設定する を参照してください。
    [詳細情報][IMEI]IMEI (International Mobile Equipment Identity)
    [通信量履歴]IoT SIM ごとにデータ通信量を確認する を参照してください。
    [タグ]IoT SIM に付加情報 (タグ) を設定する を参照してください。
    [セッション詳細]セッション履歴を確認する を参照してください。
    [パケットキャプチャ]IoT SIM のパケットをキャプチャする (Peek for SIM) を参照してください。
    [SIM ローカル情報]SIM ローカル情報レポートを確認する を参照してください。
    [バーチャル SIM]バーチャル SIM/Subscriber のセッションを再確立するバーチャル SIM/Subscriber を解約する などを参照してください。
SORACOM CLI / SORACOM API の場合

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

  • SORACOM CLI を利用する場合は、soracom sims get を使用します。
  • SORACOM API を利用する場合は、Sim:getSim API を使用します。
SIM 詳細画面の URL は IoT SIM ごとに異なります
  • SIM 詳細画面の URL は、IoT SIM ごと、およびタブごとに異なります。ブックマークに登録したり、ほかのユーザーにシェアしたりできます。

    SIM ID が「8900001234567890123」の SIM 詳細画面の URL の例:

    • [詳細情報] タブ: https://console.soracom.io/sims/8900001234567890123?coverage_type=jp&tab=description
    • [タグ] タブ: https://console.soracom.io/sims/8900001234567890123?coverage_type=jp&tab=tags
  • SAM ユーザーの権限を以下のように設定すると、任意の IoT SIM の SIM 詳細画面だけを確認できる SAM ユーザーを作成できます。SAM ユーザーについて詳しくは、アクセス管理 (SORACOM Access Management: SAM) を参照してください。

    {
      "statements": [
        {
          "api": [
            "Sim:getSim"
          ],
          "effect": "allow",
          "condition": "pathVariable('sim_id') == '8900001234567890123'"
        }
      ]
    }
    

IoT SIM を検索する

ユーザーコンソールで IoT SIM を検索 (フィルタリング) できます。

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

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

  2. [メニュー][SORACOM AIR FOR セルラー][SIM 管理] の順にクリックします。

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

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

    検索条件の指定 検索条件の指定


    [文字列で検索]

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

    属性検索対象
    [すべて]名前グループSIM IDIMSIMSISDNICCID製造番号タグ のすべて。
    [名前]IoT SIM の名前。
    [グループ]IoT SIM が所属する グループ の名前。
    [SIM ID]SIM ID
    [IMSI]IMSI (International Mobile Subscriber Identity)
    [MSISDN]MSISDN (Mobile Station International Subscriber Directory Number)
    [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 のステータス追加サブスクリプションのステータス
    利用開始待ち利用開始待ち (standby)-
    準備完了準備完了 (ready)ready
    使用中使用中 (active)非表示 (active)
    休止中休止中 (inactive)-
    利用中断中利用中断中 (suspended)-
    解約済み解約済み (terminated)-
    出荷済み-shipped

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

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

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

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

    • 複数のサブスクリプションを対象にした場合は、いずれかのサブスクリプションの IoT SIM が表示されます (OR 検索)。
    • サブスクリプションについて詳しくは、サブスクリプションの種類 を参照してください。
    • planArc01 は、IoT SIM にバーチャル SIM/Subscriber をセカンダリサブスクライバーとして追加したことを示すサブスクリプションです。詳しくは、バーチャル SIM/Subscriber を作成する を参照してください。
    • plan-NA1-package は、United States および Canada でのみ契約できるサブスクリプションです。

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

    IoT SIM の形状や、バーチャル SIM/Subscriber の有無で絞り込みます。

    「バーチャル」を選択した場合は、セカンダリサブスクリプション にバーチャル SIM/Subscriber を追加した IoT SIM も一覧表示されます。

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

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

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、IoT SIM のを検索できます。

  • SORACOM CLI を利用する場合は、soracom query sims を使用します。

    • 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 を利用する場合は、Query:searchSims API を使用します。

IoT SIM の情報を CSV ファイルでダウンロードする

選択したカバレッジタイプのすべての IoT SIM の情報を CSV ファイル (IoT SIM 情報 CSV) でダウンロードできます。

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

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

  2. [メニュー][SORACOM AIR FOR セルラー][SIM 管理] の順にクリックします。

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

  3. [ダウンロード] をクリックします。

    確認画面が表示されます。

  4. [ダウンロード] をクリックします。

    IoT SIM 情報 CSV ファイルがダウンロードされます。Microsoft Excel でインポートするときは、CSV ファイルを Microsoft Excel へインポートするときのヒント を参照してください。

すべての IoT SIM の情報がダウンロードされます

購入日などでフィルタリングすることはできません。以下の画面で IoT SIM の情報をダウンロードすることもできます。

IoT SIM 情報 CSV リファレンス

IoT SIM 情報 CSV のファイル名は、以下のとおりです。

{年月日時分秒 (UTC)}-{オペレーター ID}-subscribers.csv

例: 20230725015946-OP1234567890-subscribers.csv

CSV ファイルに出力される各項目の意味は、以下のとおりです。

項目説明
simIdSIM ID
iccidICCID (Integrated Circuit Card ID)。IoT SIM やバーチャル SIM/Subscriber を識別するための識別子です。
imsiIMSI (International Mobile Subscriber Identity)
msisdnMSISDN (Mobile Station International Subscriber Directory Number)。バーチャル SIM/Subscriber は MSISDN はありません。
serialNumber製造番号。IoT SIM の裏面に記載されています。バーチャル SIM/Subscriber は製造番号はありません。
ipAddressSORACOM より割り当てられたプライベート IP アドレス。セッションが「オンライン」のときにのみ出力されます。IP アドレスを利用してデバイスにアクセスする方法について詳しくは、FAQ: IoT SIM で通信しているデバイスに対して外部からアクセスできますか? を参照してください。
status

IoT SIM のステータス。IoT SIM のステータスについて詳しくは、IoT SIM のステータスを変更する を参照してください。

  • ready: 準備完了 (ready)
  • active: 使用中 (active)
  • inactive: 休止中 (inactive)
  • standby: 利用開始待ち (standby)
  • suspended: 利用中断中 (suspended)
  • terminated: 解約済み (terminated)
lastSeenセッションが「オフライン」の場合に、最後にオンラインだった日時。セッションが「オンライン」の場合は、日時は出力されません。
session

IoT SIM のセッションの状態。IoT SIM のセッションについて詳しくは、IoT SIM の通信状況 (セッション) を確認する を参照してください。

  • true: オンライン
  • false: オフライン
plan
  • 0: データ通信のみ。
  • 1: データ通信+SMS。
bundlesデータ通信料金に関する契約。一部のサブスクリプションには、バンドルを選択できます。たとえば、plan-D では D-300MB、plan-DU では DU-10GB、DU-50GB、または DU-100GB を選択できます。
subscriptionサブスクリプション
moduleTypeIoT SIM のサイズ。eSIM の場合は embedded が出力されます。
speedClass速度クラス。詳しくは、IoT SIM の速度クラスを変更する を参照してください。
expiryTime有効期限 (UNIX 時間 (ミリ秒)。詳しくは、IoT SIM の有効期限とアクションを設定する を参照してください。
imeiLockIMEI ロックを有効化している場合は、紐づけた IMEI が出力されます。詳しくは、IoT SIM に IMEI ロックを設定する を参照してください。
terminationEnabled

解約プロテクション。解約プロテクションを解除するには、解約プロテクションを解除 / 設定する を参照してください。

  • true: 解約プロテクション ON。解約できません。
  • false: 解約プロテクション OFF。解約できます。
renewalFeeStatusSetTime更新料の起算日 (UNIX 時間 (ミリ秒))。出力されている場合は、更新料の起算日から一定期間が経過すると更新料が発生します。出力されていない場合は、更新料は発生しません。
currentMCC現在接続している MCC。(*1)
currentMNC現在接続している MNC。(*2)
previousMCC前回接続していた MCC。(*1)
previousMNC前回接続していた MNC。(*2)
(任意のタグ)IoT SIM に設定した付加情報 (タグ)。タグについて詳しくは、IoT SIM に付加情報 (タグ) を設定する を参照してください。
group:groupIdIoT SIM が所属しているグループの ID。詳しくは、グループ設定 を参照してください。
(グループの任意のタグ)IoT SIM が所属しているグループに設定した付加情報 (タグ)。グループにタグを設定する操作については、グループの設定を変更する を参照してください。
  • (*1) MCC (Mobile Country Code) は、国・地域の識別コードです。3 桁の数字が入ります。
  • (*2) MNC (Mobile Network Code) は、電気通信事業者の識別コードです。1 ~ 3 桁の数字が入ります。1 桁の場合は、先頭に 0 を追加すると正式な MNC になります。
currentMCC、currentMNC、previousMCC、previousMNC がすべて空欄の場合

currentMCCcurrentMNCpreviousMCCpreviousMNC が 4 つとも空欄の場合は、この IoT SIM を利用してネットワークに接続できたことがないことを示します。デバイスの電源が入っていることや、デバイスの APN 設定やローミング設定を確認してください。

IoT SIM の情報をダウンロードして Google Spreadsheet に取り込む

SIM 一覧 CSV ダウンロード(SIM 一覧の取得) は、IoT SIM の一覧を取得する Google Spreadsheet です。当ツールの詳細は SIM 一覧 CSV ダウンロード(SIM 一覧の取得) を参照してください。