メニュー

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

NetworkAccessProfile Resource

Network Access Profile resources control which public land mobile networks (PLMNs) your Super SIMs can connect to:

https://supersim.twilio.com/v1/NetworkAccessProfiles

A Network Access Profile resource can be referenced in the API by either by its unique Sid or UniqueName:

https://supersim.twilio.com/v1/NetworkAccessProfiles/{Sid}
https://supersim.twilio.com/v1/NetworkAccessProfiles/{UniqueName}

Each Network Access Profile resource has a Networks subresource (NAP Networks).

https://supersim.twilio.com/v1/NetworkAccessProfiles/{Sid}/Networks

Each NAP Network resource represents a cellular network that Super SIMs can connect to - an allowed Network.

The NAP Network resources in the NAP Networks subresource will be a subset of all of the Network resources available from the Networks resource. You can add or remove NAP Network resources from the NAP Networks subresource at any time to change which cellular networks your Super SIMs can access.

The Super SIM Networks resource is a read-only resource which lists all of the cellular networks to which it is possible for Super SIMs can potentially connect; it is a catalog of available networks for you to choose from. Once you’ve identified a cellular network you want to allow your Super SIMs to connect to, use its sid to add it to a Network Access Profile resource’s Networks subresource. See these examples to learn how to add or remove NAP Network resources.

If your Super SIM has already attached to a network, authentication and authorization information may be cached in that network to allow devices to continue to use that network without re-authenticating. When you disable a network in a NAP, it may not take immediate effect for that Super SIM. The cached information for that Super SIM will need to expire before the Super SIM can no longer use that network. This may take up to a week, but varies by network.

To make use of a Network Access Profile resource, it needs to be referenced by a Fleet resource. All of the Sim resources assigned to that Fleet resource will then be able to attach to the cellular networks allowed by the Network Access Profile resource’s Networks subresource. A Network Access Profile resource can be used by multiple Fleet resources.

See Forbidden Networks for details on what happens when a device tries to attach to a mobile operator network not allowed by a Network Access Profile resource.

Forbidden networks

The Networks subresource serves as an allow list of the cellular networks to which Super SIMs can connect. Network resources not present in the Networks subresource are therefore blocked (ie. forbidden).

When your device scans for available cellular networks to try to attach to, it may find a number of cellular networks. Super SIMs can only attach to a cellular network if the Network resource that represents the network is present in the Networks subresource. If your device explicitly tries to attach to a cellular network that has not been allowed, the network will return the error 5004 / ROAMING_NOT_ALLOWED.

There will be some cellular networks for which there is no Network resource available. As such there is no way to add it to the list of allowed cellular networks in your Network Access Profile resource. No Super SIMs will be able to attach to these cellular networks.

NetworkAccessProfile properties

Resource Properties in REST API format
sid
sid<HA> Not PII

The unique string that identifies the Network Access Profile resource.

unique_name
文字列 PII MTL: 30 DAYS

An application-defined string that uniquely identifies the resource. It can be used in place of the resource's sid in the URL to address the resource.

account_sid
sid<AC> Not PII

The SID of the Account that the Network Access Profile belongs to.

date_created
date_time<iso8601> Not PII

The date and time in GMT when the resource was created specified in ISO 8601 format.

date_updated
date_time<iso8601> Not PII

The date and time in GMT when the resource was last updated specified in ISO 8601 format.

url
url Not PII

The absolute URL of the Network Access Profile resource.

links
uri_map Not PII

Create a NetworkAccessProfile resource

post
https://supersim.twilio.com/v1/NetworkAccessProfiles
パラメーター
Parameters in REST API format
unique_name
オプション
post 文字列 PII MTL: 30 DAYS

An application-defined string that uniquely identifies the resource. It can be used in place of the resource's sid in the URL to address the resource.

networks
オプション
post sid_like<HW>[] Not PII

List of Network SIDs that this Network Access Profile will allow connections to.

例 1
        
        
        
        

        Fetch a NetworkAccessProfile resource

        GET
        https://supersim.twilio.com/v1/NetworkAccessProfiles/{Sid}
        パラメーター
        Parameters in REST API format
        sid
        Path
        GET sid_like<HA> Not PII

        The SID of the Network Access Profile resource to fetch.

        例 1
              
              
              
              

              Read multiple NetworkAccessProfile resources

              GET
              https://supersim.twilio.com/v1/NetworkAccessProfiles
              例 1
                    
                    
                    
                    

                    Update a NetworkAccessProfile resource

                    post
                    https://supersim.twilio.com/v1/NetworkAccessProfiles/{Sid}
                    パラメーター
                    Parameters in REST API format
                    sid
                    Path
                    post sid_like<HA> Not PII

                    The SID of the Network Access Profile to update.

                    unique_name
                    オプション
                    post 文字列 PII MTL: 30 DAYS

                    The new unique name of the Network Access Profile.

                    例 1
                          
                          
                          
                          
                          Rate this page:

                          ヘルプが必要ですか?

                          誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。