Soracom

Users

ドキュメント
フィードバック
Home ドキュメント SORACOM Air for セルラー Connectivity Hypervisor

Connectivity Hypervisor 対応 IoT SIM を管理する

このページでは、Connectivity Hypervisor 対応 IoT SIM を一覧し、プロファイルの追加、有効化、解約、イベント履歴の確認、タグの設定を行う方法を説明します。

Connectivity Hypervisor を利用するには事前の申請が必要です

Connectivity Hypervisor は一般提供の機能ですが、利用を開始するには事前の申請が必要です。詳しくは、セールスチーム にお問い合わせください。機能の概要については、Connectivity Hypervisor とは を参照してください。

Connectivity Hypervisor 対応 IoT SIM を一覧する

Connectivity Hypervisor 対応 IoT SIM は、Connectivity Hypervisor 画面で一覧できます。Connectivity Hypervisor を利用できるオペレーターでログインしてください。

  1. ユーザーコンソール にログインして、グローバルカバレッジが選択されていることを確認します。

    詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

  2. [メニュー] → [Connectivity Hypervisor] の順にクリックします。

    Connectivity Hypervisor 画面が表示されます。

    Connectivity Hypervisor 対応 IoT SIM の一覧画面 Connectivity Hypervisor 対応 IoT SIM の一覧画面

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、Connectivity Hypervisor 対応 IoT SIM を一覧できます。

  • SORACOM CLI を利用する場合は、soracom euiccs list を使用します。
  • SORACOM API を利用する場合は、Euicc:listEuiccs API を使用します。

SIM ハイパーバイザー画面を表示する

Connectivity Hypervisor 対応 IoT SIM の詳細情報を確認するには、SIM ハイパーバイザー画面を表示します。

  1. Connectivity Hypervisor 画面で、詳細情報を確認する Connectivity Hypervisor 対応 IoT SIM にチェックを入れ、[詳細] をクリックします。

    選択した Connectivity Hypervisor 対応 IoT SIM の SIM ハイパーバイザー画面が表示されます。

    SIM ハイパーバイザー画面 SIM ハイパーバイザー画面

    SIM ハイパーバイザー画面では、以下の項目を確認できます。

    項目説明
    [最新の Polling 履歴]IPAe から SORACOM への Polling 履歴のうち、最新の数件を表示します。Connectivity Hypervisor 対応 IoT SIM の状態を確認する際に参考にしてください。
    [Polling 設定]IPAe から SORACOM への Polling の間隔を表示します。デフォルトでは 24 時間に 1 回の Polling が行われます。Polling の間隔を短くすると、プロファイルの状態をよりリアルタイムに近い形で確認できます。ただし、Polling のたびに IPAe と SORACOM の間で制御通信が発生し、その都度データ通信料金が発生します。

    IPAe について詳しくは、Connectivity Hypervisor の技術的な仕組み を参照してください。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、Connectivity Hypervisor 対応 IoT SIM の詳細情報や状態を取得できます。

  • SORACOM CLI を利用する場合:
    • 詳細情報を取得するには、soracom euiccs get を使用します。
    • Polling 履歴やオンライン状態を取得するには、soracom euiccs status get を使用します。
  • SORACOM API を利用する場合:

以降では、SIM ハイパーバイザー画面の各タブで確認・操作できる内容を説明します。

プロファイルを追加する

Connectivity Hypervisor 対応 IoT SIM には、プロファイルを購入して追加できます。プロファイルを購入すると初期費用が発生します。また、追加済みプロファイルには、プロファイルの状態に応じた基本料金が発生します。料金について詳しくは、Connectivity Hypervisor の料金 を参照してください。

  1. SIM ハイパーバイザー画面で、[プロファイル購入] タブをクリックします。

  2. 追加するプロファイルの [購入] をクリックします。

    プロファイルの購入 プロファイルの購入

  3. 確認画面で購入情報と注意事項を確認し、[上記の注意事項に同意します。] にチェックを入れて、[購入] をクリックします。

    プロファイルの購入確認 プロファイルの購入確認

    購入すると、[イベント履歴] タブが表示され、プロファイルの追加が開始されます。

    購入したプロファイルが Connectivity Hypervisor 対応 IoT SIM にダウンロードされるまでには、数分から数日程度かかる場合があります。進捗は SIM ハイパーバイザー画面の [イベント履歴] タブで確認できます。詳しくは、IoT SIM のプロファイル関連イベントやオペレーションの履歴を確認する を参照してください。

  4. プロファイルの追加が完了したら、SIM ハイパーバイザー画面の [プロファイル管理] タブで追加済みのプロファイルを確認し、対象のプロファイルの [有効化] をクリックします。

    プロファイルの有効化 プロファイルの有効化

プロファイルの有効化についても、Connectivity Hypervisor 対応 IoT SIM に反映されるまでには数分から数日程度かかる場合があります。進捗は SIM ハイパーバイザー画面の [イベント履歴] タブで確認できます。詳しくは、IoT SIM のプロファイル関連イベントやオペレーションの履歴を確認する を参照してください。

プロファイルの追加や有効化には、デバイスが通信できる状態である必要があります

プロファイルの追加 (ダウンロード) や有効化は、IPAe が SORACOM と通信 (Polling) したときに IoT SIM に反映されます。反映させるには、対象の IoT SIM を挿入したデバイスの電源が入っていて、データ通信ができる状態にしてください。デバイスが通信できない状態の間は、操作が [リクエスト済み] のままになり、反映されません。IPAe の Polling については、Connectivity Hypervisor とは を参照してください。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、プロファイルの注文とダウンロードの要求ができます。

  • SORACOM CLI を利用する場合:
    • プロファイルを注文するには、soracom euiccs profile order を使用します。
    • プロファイルのダウンロードを要求するには、soracom euiccs profile request-download を使用します。
  • SORACOM API を利用する場合:

プロファイルを手動でダウンロードする

Connectivity Hypervisor 対応 IoT SIM にプロファイルを追加すると、プロファイルのダウンロードが開始されます。通常、プロファイルのダウンロードは自動的に行われますが、ダウンロードが失敗したり、キャンセルされた場合は、SIM ハイパーバイザー画面の [プロファイル管理] タブで対象のプロファイルの [ダウンロード] をクリックして、手動でダウンロードを要求できます。なお、[ダウンロード] は、プロファイルが「追加済」で、かつダウンロードの状態が「ダウンロード失敗」または「ダウンロードキャンセル」の場合に表示されます。いちどダウンロードが完了したプロファイルは、再度ダウンロードできません。ダウンロードに使用するアクティベーションコードはプロファイルごとに 1 つだけ発行され、ダウンロードすると失効するためです。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、プロファイルのダウンロードを要求できます。

  • SORACOM CLI を利用する場合は、soracom euiccs profile request-download を使用します。
  • SORACOM API を利用する場合は、Euicc:requestEuiccProfileDownload API を使用します。

プロファイルを有効化する / 解約する

Connectivity Hypervisor 対応 IoT SIM に追加済みのプロファイルの一覧を、SIM ハイパーバイザー画面の [プロファイル管理] タブで確認できます。通信に利用するプロファイルを切り替えるには、対象のプロファイルを有効化します。有効化すると、それまで有効だったプロファイルは自動的に無効になり、有効化したプロファイルに含まれるサブスクリプションで通信します。

プロファイル管理 プロファイル管理

実行できる操作は、以下のとおりです。

  • [有効化]: Connectivity Hypervisor 対応 IoT SIM に追加済みのプロファイルを有効化します。有効化したプロファイルが、通信に利用するプロファイルになります。
  • [解約]: Connectivity Hypervisor 対応 IoT SIM に追加済みのプロファイルを解約します。プロファイルに含まれるサブスクリプションも解約されます。
    • デフォルトプロファイルは解約できません。
    • 現在有効なプロファイルは解約できません。ほかのプロファイルを有効化してから解約してください。
    • 解約したプロファイルと同じサブスクリプションを含むプロファイルを、再度追加できます。
SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、プロファイルの有効化や解約を要求できます。

  • SORACOM CLI を利用する場合:
    • プロファイルの有効化を要求するには、soracom euiccs profile request-activate を使用します。
    • プロファイルの解約を要求するには、soracom euiccs profile request-delete を使用します。
  • SORACOM API を利用する場合:

SIM 管理画面との使い分け

プロファイルの追加・有効化・解約は、Connectivity Hypervisor 管理画面 (SIM ハイパーバイザー画面) で行います。追加したプロファイルは、SIM 管理 画面にもそれぞれ 1 つの回線として表示され、速度クラスやグループ、タグ、セッションの確認などの回線の設定は SIM 管理画面で行います。プロファイル管理タブの各プロファイルの [回線の管理へ] をクリックすると、対応する回線の SIM 管理画面へ移動できます。

プロファイルの解約は Connectivity Hypervisor 管理画面から行います

追加したプロファイル (プロファイルに含まれるサブスクリプション) を解約するには、SIM 管理画面ではなく、Connectivity Hypervisor 管理画面の [プロファイル管理] タブで [解約] をクリックします。デフォルトプロファイルは解約できません。

SIM 管理画面でサブスクリプションを解約すると通信できなくなります

Connectivity Hypervisor で追加したプロファイルのサブスクリプションを SIM 管理画面で解約すると、そのサブスクリプションで通信できなくなります。プロファイルを解約する場合は、Connectivity Hypervisor 管理画面の [プロファイル管理] タブで操作してください。なお、SIM 管理画面での誤った解約を防ぐためのガードは、今後実装を予定しています。

プロファイルの有効/無効とサブスクリプションの状態は連動しません

プロファイルの有効化・無効化は、そのプロファイルに含まれるサブスクリプションの状態 (「使用中 (active)」「休止中 (inactive)」など) とは連動しません。たとえば、プロファイルを無効化しても、そのサブスクリプションが自動的に「休止中 (inactive)」になるわけではありません。サブスクリプションの状態は SIM 管理画面で個別に管理します。プロファイルを解約した場合は、プロファイルに含まれるサブスクリプションも解約されます。

アクティブプロファイルの詳細を確認する

現在有効化されているプロファイルの ICCID、サブスクリプション、回線ステータスを、SIM ハイパーバイザー画面の [アクティブプロファイルの詳細] タブで確認できます。

アクティブプロファイルの詳細 アクティブプロファイルの詳細

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、プロファイルの詳細を取得できます。

  • SORACOM CLI を利用する場合は、soracom euiccs profile get を使用します。
  • SORACOM API を利用する場合は、Euicc:getEuiccProfile API を使用します。

IoT SIM のプロファイル関連イベントやオペレーションの履歴を確認する

Connectivity Hypervisor 対応 IoT SIM のプロファイル関連イベントやオペレーションの履歴を、SIM ハイパーバイザー画面の [イベント履歴] タブで確認できます。

イベント履歴 イベント履歴

イベントには、以下の種類があります。

イベント説明
プロファイル注文Connectivity Hypervisor 対応 IoT SIM にプロファイルが購入されたことを示すイベントです。
プロファイルダウンロードConnectivity Hypervisor 対応 IoT SIM にプロファイルがダウンロードされたことを示すイベントです。
プロファイル有効化Connectivity Hypervisor 対応 IoT SIM に追加済みのプロファイルが有効化されたことを示すイベントです。
プロファイル解約Connectivity Hypervisor 対応 IoT SIM に追加済みのプロファイルが解約されたことを示すイベントです。

ステータスには、以下の種類があります。

ステータス説明
成功イベントが正常に完了したことを示します。
失敗イベントが正常に完了しなかったことを示します。
リクエスト済み多くのオペレーションは非同期に実施されます。要求が SORACOM にリクエストされ、処理が完了するのを待っている状態を示します。
SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、プロファイル関連イベントやオペレーションの履歴を確認し、リクエスト済みのオペレーションをキャンセルできます。

  • SORACOM CLI を利用する場合:
    • 履歴を取得するには、soracom euiccs profile list-operations を使用します。
    • リクエスト済みのオペレーションをキャンセルするには、soracom euiccs profile cancel-operation を使用します。
  • SORACOM API を利用する場合:

Connectivity Hypervisor 対応 IoT SIM のタグを設定する

Connectivity Hypervisor 対応 IoT SIM のタグに付加情報を設定できます。タグを設定すると、管理や検索が容易になります。

タグの設定 タグの設定

  1. SIM ハイパーバイザー画面で、[タグ] タブをクリックします。
  2. [＋追加] をクリックします。
  3. [名前] と [値] を入力して、[保存] をクリックします。
タグを変更するには

修正するタグの [名前] または [値] を編集して、[保存] をクリックします。

タグを削除するには

削除するタグの [] をクリックします。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、タグの設定や削除ができます。

  • SORACOM CLI を利用する場合:
    • タグを設定するには、soracom euiccs put-tags を使用します。
    • タグを削除するには、soracom euiccs delete-tag を使用します。
  • SORACOM API を利用する場合:
© 2015-2026 SORACOM
最終更新日: 2026-07-06
Connectivity Hypervisor : Connectivity Hypervisor とは
そのほかの機能 : 基地局 / デバイスの位置情報を取得する
会社概要 プレスルーム お問い合わせ プライバシー 商標 特定商取引法 契約約款
Facebook Twitter Speaker Deck YouTube Blog