Class: Twilio::REST::Sync::V1::ServiceContext::SyncListContext

Inherits:
InstanceContext
  • Object
show all
Defined in:
lib/twilio-ruby/rest/sync/v1/service/sync_list.rb,
lib/twilio-ruby/rest/sync/v1/service/sync_list/sync_list_item.rb,
lib/twilio-ruby/rest/sync/v1/service/sync_list/sync_list_permission.rb

Defined Under Namespace

Classes: SyncListItemContext, SyncListItemInstance, SyncListItemInstanceMetadata, SyncListItemList, SyncListItemListResponse, SyncListItemPage, SyncListItemPageMetadata, SyncListPermissionContext, SyncListPermissionInstance, SyncListPermissionInstanceMetadata, SyncListPermissionList, SyncListPermissionListResponse, SyncListPermissionPage, SyncListPermissionPageMetadata

Instance Method Summary collapse

Constructor Details

#initialize(version, service_sid, sid) ⇒ SyncListContext

Initialize the SyncListContext

Parameters:

  • version (Version) —

    Version that contains the resource

  • service_sid (String) —

    The SID of the [Sync Service](www.twilio.com/docs/sync/api/service) with the Sync List resource to update.

  • sid (String) —

    The SID of the Sync List resource to update. Can be the Sync List resource’s sid or its unique_name.



232
233
234
235
236
237
238
239
240
241
242
243
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 232

def initialize(version, service_sid, sid)
    super(version)
    

    # Path Solution
    @solution = { service_sid: service_sid, sid: sid,  }
    @uri = "/Services/#{@solution[:service_sid]}/Lists/#{@solution[:sid]}"

    # Dependents
    @sync_list_permissions = nil
    @sync_list_items = nil
end

Instance Method Details

#delete ⇒ Boolean

Delete the SyncListInstance

Returns:

  • (Boolean) —

    True if delete succeeds, false otherwise



247
248
249
250
251
252
253
254
255
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 247

def delete

    headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
    
    
    

    @version.delete('DELETE', @uri, headers: headers)
end

#delete_with_metadata ⇒ Boolean

Delete the SyncListInstanceMetadata

Returns:

  • (Boolean) —

    True if delete succeeds, false otherwise



260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 260

def delete_with_metadata

    headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
    
    
    
      response = @version.delete_with_metadata('DELETE', @uri, headers: headers)
      syncList_instance = SyncListInstance.new(
          @version,
          response.body,
          account_sid: @solution[:account_sid],
          sid: @solution[:sid],
      )
      SyncListInstanceMetadata.new(@version, syncList_instance, response.headers, response.status_code)
end

#fetch ⇒ SyncListInstance

Fetch the SyncListInstance

Returns:



279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 279

def fetch

    headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
    
    
    
    
    
    payload = @version.fetch('GET', @uri, headers: headers)
    SyncListInstance.new(
        @version,
        payload,
        service_sid: @solution[:service_sid],
        sid: @solution[:sid],
    )
end

#fetch_with_metadata ⇒ SyncListInstance

Fetch the SyncListInstanceMetadata

Returns:



299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 299

def fetch_with_metadata

    headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
    
    
    
    
    
    response = @version.fetch_with_metadata('GET', @uri, headers: headers)
    sync_list_instance = SyncListInstance.new(
        @version,
        response.body,
        service_sid: @solution[:service_sid],
        sid: @solution[:sid],
    )
    SyncListInstanceMetadata.new(
        @version,
        sync_list_instance,
        response.headers,
        response.status_code
    )
end

#inspect ⇒ Object

Provide a detailed, user friendly representation



436
437
438
439
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 436

def inspect
    context = @solution.map{|k, v| "#{k}: #{v}"}.join(',')
    "#<Twilio.Sync.V1.SyncListContext #{context}>"
end

#sync_list_items(index = :unset) ⇒ SyncListItemList, SyncListItemContext

Access the sync_list_items

Returns:

Raises:

  • (ArgumentError) 


411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 411

def sync_list_items(index=:unset)

    raise ArgumentError, 'index cannot be nil' if index.nil?

    if index != :unset
        return SyncListItemContext.new(@version, @solution[:service_sid], @solution[:sid],index )
    end

    unless @sync_list_items
        @sync_list_items = SyncListItemList.new(
            @version, service_sid: @solution[:service_sid], list_sid: @solution[:sid], )
    end

 @sync_list_items
end

#sync_list_permissions(identity = :unset) ⇒ SyncListPermissionList, SyncListPermissionContext

Access the sync_list_permissions

Returns:

Raises:

  • (ArgumentError) 


392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 392

def sync_list_permissions(identity=:unset)

    raise ArgumentError, 'identity cannot be nil' if identity.nil?

    if identity != :unset
        return SyncListPermissionContext.new(@version, @solution[:service_sid], @solution[:sid],identity )
    end

    unless @sync_list_permissions
        @sync_list_permissions = SyncListPermissionList.new(
            @version, service_sid: @solution[:service_sid], list_sid: @solution[:sid], )
    end

 @sync_list_permissions
end

#to_s ⇒ Object

Provide a user friendly representation



429
430
431
432
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 429

def to_s
    context = @solution.map{|k, v| "#{k}: #{v}"}.join(',')
    "#<Twilio.Sync.V1.SyncListContext #{context}>"
end

#update(ttl: :unset, collection_ttl: :unset) ⇒ SyncListInstance

Update the SyncListInstance

Parameters:

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

    An alias for collection_ttl. If both are provided, this value is ignored.

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

    How long, [in seconds](www.twilio.com/docs/sync/limits#sync-payload-limits), before the Sync List expires (time-to-live) and is deleted.

Returns:



327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 327

def update(
    ttl: :unset, 
    collection_ttl: :unset
)

    data = Twilio::Values.of({
        'Ttl' => ttl,
        'CollectionTtl' => collection_ttl,
    })

    headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
    
    
    
    
    
    payload = @version.update('POST', @uri, data: data, headers: headers)
    SyncListInstance.new(
        @version,
        payload,
        service_sid: @solution[:service_sid],
        sid: @solution[:sid],
    )
end

#update_with_metadata(ttl: :unset, collection_ttl: :unset) ⇒ SyncListInstance

Update the SyncListInstanceMetadata

Parameters:

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

    An alias for collection_ttl. If both are provided, this value is ignored.

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

    How long, [in seconds](www.twilio.com/docs/sync/limits#sync-payload-limits), before the Sync List expires (time-to-live) and is deleted.

Returns:



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/sync/v1/service/sync_list.rb', line 357

def update_with_metadata(
  ttl: :unset, 
  collection_ttl: :unset
)

    data = Twilio::Values.of({
        'Ttl' => ttl,
        'CollectionTtl' => collection_ttl,
    })

    headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
    
    
    
    
    
    response = @version.update_with_metadata('POST', @uri, data: data, headers: headers)
    sync_list_instance = SyncListInstance.new(
        @version,
        response.body,
        service_sid: @solution[:service_sid],
        sid: @solution[:sid],
    )
    SyncListInstanceMetadata.new(
        @version,
        sync_list_instance,
        response.headers,
        response.status_code
    )
end