Managing the device shadow

Using AWS IoT Core, you can add shadows to AWS IoT things. Shadows provide a shared data store for devices, apps, and other cloud services to access and control the current state of a device. This information is available in the cloud when the device itself is offline. AWS things can have multiple shadows to enable devices to connect to other apps and services. For more information, see: AWS IoT Device Shadow service.

Use the AWS device shadow to check AnyNet Secure SIM data for a specific thing, including status, location, usage, and details about the certificate delivery.

For more information, see Viewing Device Shadow metadata.

The shadow details the following attributes:

Attribute Sub-attribute (if any) Description
status

 

SIM state, either:

  • available
  • pendingProvision
  • suspended
  • pendingTermination
  • terminated

For more information, see Understanding the SIM lifecycle.

msisdn

 

The SIM card Mobile Station International Subscriber Directory Number
package_id

 

The SIM payment details numerical code, enclosed in quotation marks
message

allowance

The total free messages provided on the SIM
 

remaining

The remaining number of free messages
certificate_update

allowance

The total free certificate updates provided on the SIM

 

remaining

The remaining number of free certificate updates

location

lat

The geographic latitude of the most recent cell tower to which the SIM connected

 

lon

The geographic longitude of the most recent cell tower to which the SIM connected

 

mcc

The Mobile Country Code of the most recent cell tower to which the SIM connected. For more information, see:

Mobile country codes.

 

mnc

The Mobile Network Code of the most recent cell tower to which the SIM connected. For more information, see:

Mobile network codes listed by country

log

 

Displays the most recent updates made to the SIM, in the following format per log entry:

DateTime: MessageType: Description

certificate delivery

Certificate Delivery attributes are not returned when the Shadow is requested manually. For more information, see Manually update the Device Shadow metadata.

 

status

The certificate delivery state, either:

  • Sending – the certificate was sent but the device has not received it yet
  • Delivered – the certificate was received by the device
  • Error – the certificate delivery failed

 

when sent

The campaign delivery request date and time, in the format:

YYYY-MM-DD hh:mm:ss

 

when delivered

Only displayed if the certificate delivery status is Delivered, in the format:

YYYY-MM-DD hh:mm:ss

 

campaign_progress

Only displayed if the certificate delivery status is Sending, as a percentage, where 0% is not started and 100% is completed.