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`.



240
241
242
243
244
245
246
247
248
249
250
251
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 240

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



255
256
257
258
259
260
261
262
263
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 255

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



268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 268

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:



287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 287

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:



307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 307

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



444
445
446
447
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 444

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) 


419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 419

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) 


400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 400

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



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

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:



335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 335

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:



365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
 
# File 'lib/twilio-ruby/rest/sync/v1/service/sync_list.rb', line 365

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