SIM Management

The SIM Management screen is where you'll find most SIM management functions.

You can view the details of IoT SIMs registered to your Soracom account, search for SIMs, change their status, adjust their speed class (maximum communication speed), and more.

To access the SIM Management screen:

Sign in to the User Console . From the Menu, open the SIM Management screen.

SAM users need the Query:searchSims and Group:listGroups permissions to access the SIM Management screen. Ask your administrator to grant these privileges if needed. !!!

Common Actions

1. Register SIM

Displays the SIM Registration dialog for manual registration. For further information on registering Soracom IoT SIM cards, refer to the Registration page.

2. Details

Display the SIM Details dialog of a selected SIM. To show additional details for a SIM, first click the next to a SIM, then click the Details button. Alternatively, you can access the same information by clicking the SIM ID or Name of a SIM.

Note that if you have hidden the SIM ID and Name columns in the table, you can display them again via the Table Settings.

3. Actions

Show actions for the selected SIM(s). - Session - On-demand Remote Access - Initiates a Napter on-demand remote access connection - Connect using web terminal - Initiates a Napter Web Terminal connection - Send ping - Sends a ping test to a device - Send SMS - Send an SMS to a device - Packet capture - Initiates a Peek packet capture - Delete session - Deletes an existing cellular connection session - SIM - Activate or Deactivate - Sets the Subscriber Status to Active or Inactive for the selected SIM(s) - Standby - Sets the Subscriber Status to Standby for the selected SIM(s) - Suspend - Sets the Subscriber Status to Suspended for the selected SIM(s) - Terminate - Terminates the selected SIM(s) - Add Subscription - Adds an additional subscription to an IoT SIM - Add Virtual SIM - Opens the Add subscription to SIM dialog for adding a virtual SIM subscription to the selected SIM - Change bundle - Changes data bundles for certain subscription plans - Transfer to another operator or Cancel transfer - Initiates or cancels a SIM transfer request - Settings - Change group - Adds, changes, or removes the selected SIM(s) from a group - Change expiration - Adds, changes, or removes the IoT SIM Expiration function for the selected SIM(s) - Change speed class - Changes the speed class for the selected SIM(s) - Enable IMEI lock or Remove IMEI lock - Adds, changes, or removes IMEI lock for the selected SIM(s) - Change termination protection - Sets or removes termination protection for the selected SIM(s) - Logs & Diagnostics - Run diagnostics - Runs connectivity diagnostics for a SIM - View Harvest Data - Shows the data in Harvest Data for the selected SIM(s) - View logs - Shows error logs for the selected SIM(s) - View data usage - Opens the SIM Details dialog on the Usage tab displaying data usage for your device

Certain actions are only available when a single SIM is selected. If you need to use one of these functions, select only one SIM.

4. Download

Download your IoT SIM data to a CSV file.

5. Search Filter

Show search and filtering options.

6. Items per Page

Set the number of items to display on a page.

7. Table Settings

Allows you to customize which columns are visible in the list.

Note that if your Soracom account has over 100 SIMs, the ability to sort columns will be disabled.

List View

The list view is the main view that is displayed when you open the SIM Management screen.

The data displayed on the SIM management screen can be sorted when there are two or more items listed.

Clicking a header on the SIM Management screen, such as Name, will sort the data in ascending or descending order.

The sorting function will be disabled if the number of SIMs exceeds 100. If the limit is exceeded, sorting will not be enabled even if you reduce the number of items displayed on one page.

Display IoT SIMs

If you don't see SIMs registered to your Soracom account on the SIM Management screen, check the details below.

• Select the correct Coverage Type:

  Ensure that you have selected the correct Coverage Type for the SIMs you want to view. If the incorrect Coverage Type has been selected for a SIM, it won't appear in the SIM Management table.

  Example: For plan01s SIMs, choose Global coverage; for plan-D SIMs, choose Japan coverage.

• Adjust your display limit and navigate pages:

  By default, 10 SIMs are shown per page. Increase the items per page to 50 or 100 using the items per page selector if you need to see more. If the number of items exceeds the limit for one page, use the and buttons to navigate between pages.

• Use the Search Filter:

  The Search Filter lets you quickly find IoT SIMs by name, ID, tag, and other attributes.

Table Items

Items marked with are displayed by default, while those marked with are hidden by default. To manage which items appear in the table, click the to open Table Settings.

List Actions

You can perform the following common tasks directly by clicking items on the list:

Change a SIM's Name

1. Hover your mouse over the Name column for a particular SIM.
2. A icon will appear. Click the icon.
3. Press Enter to save the changes.

Change a SIM's Speed Class

1. Find the Speed class column for a particular SIM.
2. Click the dropdown menu, then select the new speed class for the SIM.

Change a SIM's Expiration

1. Hover your mouse over the Expiry Date / Time column for a particular SIM.
2. A icon will appear. Click the icon.
3. A dialog will appear, allowing you to add, change, or remove expiration settings for the selected SIM.

For more information about the Expiry function, refer to the Expiration page.

Edit Group Settings

1. Find the Group column for a particular SIM that belongs to a group.
2. Click the name of the group to open its settings page.

Downloading SIM Data

You can download a CSV file containing a list of all SIMs registered to your account.

1. Sign in to the User Console . From the Menu, open the SIM Management screen.

2. Click the Download button on the upper right side of the screen.

The data items in the downloadable CSV file are described below:

You can obtain a list of IoT SIMs using the Soracom CLI or Soracom API. !

• If you are using the Soracom CLI, use soracom sims list.
• If you are using the Soracom API, use Sim:listSims API. ! For more information on this functionality, see the API Reference.

You can also download a CSV file containing a list of SIMs that belong to a specific order.

1. Sign in to the User Console . From the Menu, open the Orders screen.

2. From the list of orders, find the order that contains the SIMs you want to download, and click the List SIMs in order button.

   

3. In the dialog window pop up, click the Download CSV button.

   The columns of the downloadable CSV file are explained below:

Searching for SIMs

In addition to performing SIM management tasks, Soracom provides several methods to quickly locate a SIM (subscriber), simplifying the management of a large number of SIMs.

When searching using the User Console, API, or CLI, be aware of the following behavior:

• String searches include partial matches.
• Search terms must contain at least two characters.
• Searches are case-insensitive.
• When searching by tag, the search API will examine all the tag values and return IoT SIMs where any tag contains the specified string.

When using the Soracom CLI or Soracom API: !

• If you are using the Soracom CLI, use soracom query sims.
• If you are using the Soracom API, use the Query
  API.

1. Sign in to the User Console . From the Menu, open the SIM Management screen.

2. Click the button. This will bring up the following dialog.

   

Searching by Attributes

By default, the search will match any of the SIM attributes below. To target a specific attribute, click the button next to the search box and select the desired attribute.

Attributes:

• Any - Matches any of the fields below. When using Any, you can enter multiple comma-separated search terms to find SIMs that match any of the terms (OR search)
• Name - The name of the SIM
• Group - The name of the group that the SIM belongs to (if any)
• SIM ID - The ID of the SIM
• IMSI - The IMSI of the SIM
• MSISDN - The MSISDN of the SIM
• ICCID - The ICCID of the SIM
• Serial Number - The Serial Number of the SIM
• Tag - The value of any tags assigned to the SIM

Filtering by Session Status

Filter the list according to Session Status of either Online or Offline by clicking the next to Filter by session status and selecting Online or Offline.

Filtering by Status

Filter the list according to Subscriber Status. Click the next to Filter by status, then select statuses to show SIMs as needed.

Filtering by Subscription

Filter the list according to Subscription. Click the next to Filter by subscription, then select subscriptions to show SIMs as needed.

When filtering by subscription:

• If you have a custom subscription, you can search for it by typing the subscription name in the text box. This performs a case-insensitive, exact-match search.
• Selecting multiple subscriptions will show SIMs that match any of the selected subscriptions (OR search).

Filtering by Module Type

Filter the list according to Module Type. Click the next to Filter by module type, then select modules to show SIMs as needed.