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

IoT SIM に付加情報 (タグ) を設定する

IoT SIM のタグは、IoT SIM に任意のデータをリンクさせるための Key-Value ストア (保存領域) です。1 つの IoT SIM に対して、任意の名前 (キー) と任意の値をペアで、20 個まで設定できます。

名前と値に保存可能なバイト数は以下のとおりです。

IoT SIM のタグの利用例

ソラコムでは、以下のような付加情報を IoT SIM のタグに設定することを想定しています。

IoT SIM のタグを設定する

IoT SIM のタグに付加情報を設定することを、「IoT SIM のタグを設定する」といいます。

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

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

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

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

3. タグを設定する IoT SIM にチェックを入れ、[詳細] → [タグ] の順にクリックします。

   

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

   「タグの編集」画面が表示されます。

5. [名前] と [値] を入力して、[保存] をクリックします。

SORACOM CLI / SORACOM API の場合

$ soracom sims put-tags --sim-id {sim_id} \
--body '[
  {
    "tagName": "tagName",
    "tagValue": "tagValue"
  }
]'

$ soracom sims delete-tag --sim-id {sim_id} --tag-name {tag_name}

$ curl -v -X PUT https://api.soracom.io/v1/sims/{sim_id}/tags \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN" \
-H "Content-Type: application/json" \
-d '[
  {
    "tagName": "tagName",
    "tagValue": "tagValue"
  }
]'

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

IoT SIM に設定したタグを SIM 管理画面に表示する

IoT SIM に設定したタグを、SORACOM ユーザーコンソールの SIM 管理画面で表示できます。

1. SIM 管理画面で [] → [追加] の順にクリックします。

   

2. [タグ] に表示するタグの名前を入力して、[タグの表示列を追加] をクリックします。