Class: Twilio::REST::Wireless::V1::SimInstance

Inherits:
InstanceResource show all
Defined in:
lib/twilio-ruby/rest/wireless/v1/sim.rb

Instance Method Summary collapse

Constructor Details

#initialize(version, payload, sid: nil) ⇒ SimInstance

Initialize the SimInstance

Parameters:

  • version (Version) —

    Version that contains the resource

  • payload (Hash) —

    payload that contains response from Twilio

  • sid (String) (defaults to: nil) —

    The SID or the ‘unique_name` of the Sim resource to fetch.



352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 352

def initialize(version, payload, sid: nil)
  super(version)

  # Marshaled Properties
  @properties = {
      'sid' => payload['sid'],
      'unique_name' => payload['unique_name'],
      'account_sid' => payload['account_sid'],
      'rate_plan_sid' => payload['rate_plan_sid'],
      'friendly_name' => payload['friendly_name'],
      'iccid' => payload['iccid'],
      'e_id' => payload['e_id'],
      'status' => payload['status'],
      'reset_status' => payload['reset_status'],
      'commands_callback_url' => payload['commands_callback_url'],
      'commands_callback_method' => payload['commands_callback_method'],
      'sms_fallback_method' => payload['sms_fallback_method'],
      'sms_fallback_url' => payload['sms_fallback_url'],
      'sms_method' => payload['sms_method'],
      'sms_url' => payload['sms_url'],
      'voice_fallback_method' => payload['voice_fallback_method'],
      'voice_fallback_url' => payload['voice_fallback_url'],
      'voice_method' => payload['voice_method'],
      'voice_url' => payload['voice_url'],
      'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
      'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
      'url' => payload['url'],
      'links' => payload['links'],
      'ip_address' => payload['ip_address'],
  }

  # Context
  @instance_context = nil
  @params = {'sid' => sid || @properties['sid'], }
end

Instance Method Details

#account_sid ⇒ String

Returns The SID of the Account to which the Sim resource belongs.

Returns:

  • (String) —

    The SID of the Account to which the Sim resource belongs



413
414
415
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 413

def 
  @properties['account_sid']
end

#commands_callback_method ⇒ String

Returns The HTTP method we use to call commands_callback_url.

Returns:

  • (String) —

    The HTTP method we use to call commands_callback_url



461
462
463
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 461

def commands_callback_method
  @properties['commands_callback_method']
end

#commands_callback_url ⇒ String

Returns The URL we call when the SIM originates a machine-to-machine Command.

Returns:

  • (String) —

    The URL we call when the SIM originates a machine-to-machine Command



455
456
457
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 455

def commands_callback_url
  @properties['commands_callback_url']
end

#context ⇒ SimContext

Generate an instance context for the instance, the context is capable of performing various actions. All instance actions are proxied to the context

Returns:

  • (SimContext) —

    SimContext for this SimInstance



392
393
394
395
396
397
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 392

def context
  unless @instance_context
    @instance_context = SimContext.new(@version, @params['sid'], )
  end
  @instance_context
end

#data_sessions ⇒ data_sessions

Access the data_sessions

Returns:



646
647
648
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 646

def data_sessions
  context.data_sessions
end

#date_created ⇒ Time

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

Returns:

  • (Time) —

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



515
516
517
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 515

def date_created
  @properties['date_created']
end

#date_updated ⇒ Time

Returns The ISO 8601 date and time in GMT when the Sim resource was last updated.

Returns:

  • (Time) —

    The ISO 8601 date and time in GMT when the Sim resource was last updated



521
522
523
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 521

def date_updated
  @properties['date_updated']
end

#delete ⇒ Boolean

Delete the SimInstance

Returns:

  • (Boolean) —

    true if delete succeeds, false otherwise



632
633
634
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 632

def delete
  context.delete
end

#e_id ⇒ String

Returns Deprecated.

Returns:

  • (String) —

    Deprecated



437
438
439
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 437

def e_id
  @properties['e_id']
end

#fetch ⇒ SimInstance

Fetch the SimInstance

Returns:



546
547
548
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 546

def fetch
  context.fetch
end

#friendly_name ⇒ String

Returns The string that you assigned to describe the Sim resource.

Returns:

  • (String) —

    The string that you assigned to describe the Sim resource



425
426
427
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 425

def friendly_name
  @properties['friendly_name']
end

#iccid ⇒ String

Returns The ICCID associated with the SIM.

Returns:

  • (String) —

    The ICCID associated with the SIM



431
432
433
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 431

def iccid
  @properties['iccid']
end

#inspect ⇒ Object

Provide a detailed, user friendly representation



659
660
661
662
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 659

def inspect
  values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
  "<Twilio.Wireless.V1.SimInstance #{values}>"
end

#ip_address ⇒ String

Returns Deprecated.

Returns:

  • (String) —

    Deprecated



539
540
541
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 539

def ip_address
  @properties['ip_address']
end

#links ⇒ String

Returns The URLs of related subresources.

Returns:

  • (String) —

    The URLs of related subresources



533
534
535
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 533

def links
  @properties['links']
end

#rate_plan_sid ⇒ String

Returns The SID of the RatePlan resource to which the Sim resource is assigned.

Returns:

  • (String) —

    The SID of the RatePlan resource to which the Sim resource is assigned.



419
420
421
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 419

def rate_plan_sid
  @properties['rate_plan_sid']
end

#reset_status ⇒ sim.ResetStatus

Returns The connectivity reset status of the SIM.

Returns:

  • (sim.ResetStatus) —

    The connectivity reset status of the SIM



449
450
451
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 449

def reset_status
  @properties['reset_status']
end

#sid ⇒ String

Returns The unique string that identifies the Sim resource.

Returns:

  • (String) —

    The unique string that identifies the Sim resource



401
402
403
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 401

def sid
  @properties['sid']
end

#sms_fallback_method ⇒ String

Returns The HTTP method we use to call sms_fallback_url.

Returns:

  • (String) —

    The HTTP method we use to call sms_fallback_url



467
468
469
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 467

def sms_fallback_method
  @properties['sms_fallback_method']
end

#sms_fallback_url ⇒ String

Returns The URL we call when an error occurs while retrieving or executing the TwiML requested from the sms_url.

Returns:

  • (String) —

    The URL we call when an error occurs while retrieving or executing the TwiML requested from the sms_url



473
474
475
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 473

def sms_fallback_url
  @properties['sms_fallback_url']
end

#sms_method ⇒ String

Returns The HTTP method we use to call sms_url.

Returns:

  • (String) —

    The HTTP method we use to call sms_url



479
480
481
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 479

def sms_method
  @properties['sms_method']
end

#sms_url ⇒ String

Returns The URL we call when the SIM-connected device sends an SMS message that is not a Command.

Returns:

  • (String) —

    The URL we call when the SIM-connected device sends an SMS message that is not a Command



485
486
487
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 485

def sms_url
  @properties['sms_url']
end

#status ⇒ sim.Status

Returns The status of the Sim resource.

Returns:

  • (sim.Status) —

    The status of the Sim resource



443
444
445
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 443

def status
  @properties['status']
end

#to_s ⇒ Object

Provide a user friendly representation



652
653
654
655
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 652

def to_s
  values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
  "<Twilio.Wireless.V1.SimInstance #{values}>"
end

#unique_name ⇒ String

Returns An application-defined string that uniquely identifies the resource.

Returns:

  • (String) —

    An application-defined string that uniquely identifies the resource



407
408
409
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 407

def unique_name
  @properties['unique_name']
end

#update(unique_name: :unset, callback_method: :unset, callback_url: :unset, friendly_name: :unset, rate_plan: :unset, status: :unset, commands_callback_method: :unset, commands_callback_url: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset, reset_status: :unset, account_sid: :unset) ⇒ SimInstance

Update the SimInstance

Parameters:

  • unique_name (String) (defaults to: :unset) —

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

  • callback_method (String) (defaults to: :unset) —

    The HTTP method we should use to call ‘callback_url`. Can be: `POST` or `GET`. The default is `POST`.

  • callback_url (String) (defaults to: :unset) —

    The URL we should call using the ‘callback_url` when the SIM has finished updating. When the SIM transitions from `new` to `ready` or from any status to `deactivated`, we call this URL when the status changes to an intermediate status (`ready` or `deactivated`) and again when the status changes to its final status (`active` or `canceled`).

  • friendly_name (String) (defaults to: :unset) —

    A descriptive string that you create to describe the Sim resource. It does not need to be unique.

  • rate_plan (String) (defaults to: :unset) —

    The SID or unique name of the RatePlan resource to which the Sim resource should be assigned.

  • status (sim.Status) (defaults to: :unset) —

    The new status of the Sim resource. Can be: ‘ready`, `active`, `suspended`, or `deactivated`.

  • commands_callback_method (String) (defaults to: :unset) —

    The HTTP method we should use to call ‘commands_callback_url`. Can be: `POST` or `GET`. The default is `POST`.

  • commands_callback_url (String) (defaults to: :unset) —

    The URL we should call using the ‘commands_callback_method` when the SIM sends a Command. Your server should respond with an HTTP status code in the 200 range; any response body is ignored.

  • sms_fallback_method (String) (defaults to: :unset) —

    The HTTP method we should use to call ‘sms_fallback_url`. Can be: `GET` or `POST`. Default is `POST`.

  • sms_fallback_url (String) (defaults to: :unset) —

    The URL we should call using the ‘sms_fallback_method` when an error occurs while retrieving or executing the TwiML requested from `sms_url`.

  • sms_method (String) (defaults to: :unset) —

    The HTTP method we should use to call ‘sms_url`. Can be: `GET` or `POST`. Default is `POST`.

  • sms_url (String) (defaults to: :unset) —

    The URL we should call using the ‘sms_method` when the SIM-connected device sends an SMS message that is not a Command.

  • voice_fallback_method (String) (defaults to: :unset) —

    The HTTP method we should use to call ‘voice_fallback_url`. Can be: `GET` or `POST`.

  • voice_fallback_url (String) (defaults to: :unset) —

    The URL we should call using the ‘voice_fallback_method` when an error occurs while retrieving or executing the TwiML requested from `voice_url`.

  • voice_method (String) (defaults to: :unset) —

    The HTTP method we should use when we call ‘voice_url`. Can be: `GET` or `POST`.

  • voice_url (String) (defaults to: :unset) —

    The URL we should call using the ‘voice_method` when the SIM-connected device makes a voice call.

  • reset_status (sim.ResetStatus) (defaults to: :unset) —

    Initiate a connectivity reset on the SIM. Set to ‘resetting` to initiate a connectivity reset on the SIM. No other value is valid.

  • account_sid (String) (defaults to: :unset) —

    The SID of the Account to which the Sim resource should belong. The Account SID can only be that of the requesting Account or that of a Subaccount of the requesting Account. Only valid when the Sim resource’s status is ‘new`. For more information, see the Move SIMs between Subaccounts documentation.

Returns:



606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 606

def update(unique_name: :unset, callback_method: :unset, callback_url: :unset, friendly_name: :unset, rate_plan: :unset, status: :unset, commands_callback_method: :unset, commands_callback_url: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset, reset_status: :unset, account_sid: :unset)
  context.update(
      unique_name: unique_name,
      callback_method: callback_method,
      callback_url: callback_url,
      friendly_name: friendly_name,
      rate_plan: rate_plan,
      status: status,
      commands_callback_method: commands_callback_method,
      commands_callback_url: commands_callback_url,
      sms_fallback_method: sms_fallback_method,
      sms_fallback_url: sms_fallback_url,
      sms_method: sms_method,
      sms_url: sms_url,
      voice_fallback_method: voice_fallback_method,
      voice_fallback_url: voice_fallback_url,
      voice_method: voice_method,
      voice_url: voice_url,
      reset_status: reset_status,
      account_sid: ,
  )
end

#url ⇒ String

Returns The absolute URL of the resource.

Returns:

  • (String) —

    The absolute URL of the resource



527
528
529
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 527

def url
  @properties['url']
end

#usage_records ⇒ usage_records

Access the usage_records

Returns:



639
640
641
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 639

def usage_records
  context.usage_records
end

#voice_fallback_method ⇒ String

Returns The HTTP method we use to call voice_fallback_url.

Returns:

  • (String) —

    The HTTP method we use to call voice_fallback_url



491
492
493
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 491

def voice_fallback_method
  @properties['voice_fallback_method']
end

#voice_fallback_url ⇒ String

Returns The URL we call when an error occurs while retrieving or executing the TwiML requested from voice_url.

Returns:

  • (String) —

    The URL we call when an error occurs while retrieving or executing the TwiML requested from voice_url



497
498
499
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 497

def voice_fallback_url
  @properties['voice_fallback_url']
end

#voice_method ⇒ String

Returns The HTTP method we use to call voice_url.

Returns:

  • (String) —

    The HTTP method we use to call voice_url



503
504
505
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 503

def voice_method
  @properties['voice_method']
end

#voice_url ⇒ String

Returns The URL we call when the SIM-connected device makes a voice call.

Returns:

  • (String) —

    The URL we call when the SIM-connected device makes a voice call



509
510
511
 
# File 'lib/twilio-ruby/rest/wireless/v1/sim.rb', line 509

def voice_url
  @properties['voice_url']
end