Class: Kaltura::KalturaUploadTokenService

Inherits:
KalturaServiceBase show all
Defined in:
lib/kaltura_client.rb

Instance Attribute Summary

Attributes inherited from KalturaServiceBase

#client

Instance Method Summary collapse

Constructor Details

#initialize(client) ⇒ KalturaUploadTokenService

Returns a new instance of KalturaUploadTokenService.



5284
5285
5286
# File 'lib/kaltura_client.rb', line 5284

def initialize(client)
  super(client)
end

Instance Method Details

#add(upload_token = KalturaNotImplemented) ⇒ KalturaUploadToken

Adds new upload token to upload a file

Returns:



5290
5291
5292
5293
5294
5295
5296
5297
5298
# File 'lib/kaltura_client.rb', line 5290

def add(upload_token=KalturaNotImplemented)
  kparams = {}
  client.add_param(kparams, 'uploadToken', upload_token)
  client.queue_service_action_call('uploadtoken', 'add', 'KalturaUploadToken', kparams)
  if (client.is_multirequest)
    return nil
  end
  return client.do_queue()
end

#delete(upload_token_id) ⇒ Object

Deletes the upload token by upload token id

Returns:



5302
5303
5304
5305
5306
5307
5308
5309
5310
# File 'lib/kaltura_client.rb', line 5302

def delete(upload_token_id)
  kparams = {}
  client.add_param(kparams, 'uploadTokenId', upload_token_id)
  client.queue_service_action_call('uploadtoken', 'delete', '', kparams)
  if (client.is_multirequest)
    return nil
  end
  return client.do_queue()
end

#get(upload_token_id) ⇒ KalturaUploadToken

Get upload token by id

Returns:



5314
5315
5316
5317
5318
5319
5320
5321
5322
# File 'lib/kaltura_client.rb', line 5314

def get(upload_token_id)
  kparams = {}
  client.add_param(kparams, 'uploadTokenId', upload_token_id)
  client.queue_service_action_call('uploadtoken', 'get', 'KalturaUploadToken', kparams)
  if (client.is_multirequest)
    return nil
  end
  return client.do_queue()
end

#list(filter = KalturaNotImplemented, pager = KalturaNotImplemented) ⇒ KalturaUploadTokenListResponse

List upload token by filter with pager support. When using a user session the service will be restricted to users objects only.



5327
5328
5329
5330
5331
5332
5333
5334
5335
5336
# File 'lib/kaltura_client.rb', line 5327

def list(filter=KalturaNotImplemented, pager=KalturaNotImplemented)
  kparams = {}
  client.add_param(kparams, 'filter', filter)
  client.add_param(kparams, 'pager', pager)
  client.queue_service_action_call('uploadtoken', 'list', 'KalturaUploadTokenListResponse', kparams)
  if (client.is_multirequest)
    return nil
  end
  return client.do_queue()
end

#upload(upload_token_id, file_data, resume = false, final_chunk = true, resume_at = -1)) ⇒ KalturaUploadToken

Upload a file using the upload token id, returns an error on failure (an exception will be thrown when using one of the Kaltura clients) Chunks can be uploaded in parallel and they will be appended according to their resumeAt position. A parallel upload session should have three stages: 1. A single upload with resume=false and finalChunk=false 2. Parallel upload requests each with resume=true,finalChunk=false and the expected resumetAt position. If a chunk fails to upload it can be re-uploaded. 3. After all of the chunks have been uploaded a final chunk (can be of zero size) should be uploaded with resume=true, finalChunk=true and the expected resumeAt position. In case an UPLOAD_TOKEN_CANNOT_MATCH_EXPECTED_SIZE exception has been returned (indicating not all of the chunks were appended yet) the final request can be retried.

Returns:



5348
5349
5350
5351
5352
5353
5354
5355
5356
5357
5358
5359
5360
5361
# File 'lib/kaltura_client.rb', line 5348

def upload(upload_token_id, file_data, resume=false, final_chunk=true, resume_at=-1)
  kparams = {}
  kfiles = {}
  client.add_param(kparams, 'uploadTokenId', upload_token_id)
  client.add_param(kfiles, 'fileData', file_data)
  client.add_param(kparams, 'resume', resume)
  client.add_param(kparams, 'finalChunk', final_chunk)
  client.add_param(kparams, 'resumeAt', resume_at)
  client.queue_service_action_call('uploadtoken', 'upload', 'KalturaUploadToken', kparams, kfiles)
  if (client.is_multirequest)
    return nil
  end
  return client.do_queue()
end