Class: Twilio::REST::Video::V1::RecordingSettingsInstance

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

Instance Method Summary collapse

Constructor Details

#initialize(version, payload) ⇒ RecordingSettingsInstance

Initialize the RecordingSettingsInstance

Parameters:

  • version (Version) —

    Version that contains the resource

  • payload (Hash) —

    payload that contains response from Twilio

  • account_sid (String) —

    The SID of the Account that created this RecordingSettings resource.

  • sid (String) —

    The SID of the Call resource to fetch.



156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 156

def initialize(version, payload )
    super(version)
    
    # Marshaled Properties
    @properties = { 
        'account_sid' => payload['account_sid'],
        'friendly_name' => payload['friendly_name'],
        'aws_credentials_sid' => payload['aws_credentials_sid'],
        'aws_s3_url' => payload['aws_s3_url'],
        'aws_storage_enabled' => payload['aws_storage_enabled'],
        'encryption_key_sid' => payload['encryption_key_sid'],
        'encryption_enabled' => payload['encryption_enabled'],
        'url' => payload['url'],
    }

    # Context
    @instance_context = nil
    @params = {  }
end

Instance Method Details

#account_sid ⇒ String

Returns The SID of the [Account](www.twilio.com/docs/iam/api/account) that created the RecordingSettings resource.

Returns:



189
190
191
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 189

def 
    @properties['account_sid']
end

#aws_credentials_sid ⇒ String

Returns The SID of the stored Credential resource.

Returns:

  • (String) —

    The SID of the stored Credential resource.



201
202
203
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 201

def aws_credentials_sid
    @properties['aws_credentials_sid']
end

#aws_s3_url ⇒ String

Returns The URL of the AWS S3 bucket where the recordings are stored. We only support DNS-compliant URLs like ‘documentation-example-twilio-bucket/recordings`, where `recordings` is the path in which you want the recordings to be stored. This URL accepts only URI-valid characters, as described in the <a href=’tools.ietf.org/html/rfc3986#section-2’>RFC 3986</a>.

Returns:



207
208
209
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 207

def aws_s3_url
    @properties['aws_s3_url']
end

#aws_storage_enabled ⇒ Boolean

Returns Whether all recordings are written to the ‘aws_s3_url`. When `false`, all recordings are stored in our cloud.

Returns:

  • (Boolean) —

    Whether all recordings are written to the ‘aws_s3_url`. When `false`, all recordings are stored in our cloud.



213
214
215
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 213

def aws_storage_enabled
    @properties['aws_storage_enabled']
end

#context ⇒ RecordingSettingsContext

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

Returns:



180
181
182
183
184
185
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 180

def context
    unless @instance_context
        @instance_context = RecordingSettingsContext.new(@version )
    end
    @instance_context
end

#create(friendly_name: nil, aws_credentials_sid: :unset, encryption_key_sid: :unset, aws_s3_url: :unset, aws_storage_enabled: :unset, encryption_enabled: :unset) ⇒ RecordingSettingsInstance

Create the RecordingSettingsInstance

Parameters:

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

    A descriptive string that you create to describe the resource and be shown to users in the console

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

    The SID of the stored Credential resource.

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

    The SID of the Public Key resource to use for encryption.

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

    The URL of the AWS S3 bucket where the recordings should be stored. We only support DNS-compliant URLs like ‘documentation-example-twilio-bucket/recordings`, where `recordings` is the path in which you want the recordings to be stored. This URL accepts only URI-valid characters, as described in the <a href=’tools.ietf.org/html/rfc3986#section-2’>RFC 3986</a>.

  • aws_storage_enabled (Boolean) (defaults to: :unset) —

    Whether all recordings should be written to the ‘aws_s3_url`. When `false`, all recordings are stored in our cloud.

  • encryption_enabled (Boolean) (defaults to: :unset) —

    Whether all recordings should be stored in an encrypted form. The default is ‘false`.

Returns:



244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 244

def create(
    friendly_name: nil, 
    aws_credentials_sid: :unset, 
    encryption_key_sid: :unset, 
    aws_s3_url: :unset, 
    aws_storage_enabled: :unset, 
    encryption_enabled: :unset
)

    context.create(
        friendly_name: friendly_name, 
        aws_credentials_sid: aws_credentials_sid, 
        encryption_key_sid: encryption_key_sid, 
        aws_s3_url: aws_s3_url, 
        aws_storage_enabled: aws_storage_enabled, 
        encryption_enabled: encryption_enabled, 
    )
end

#encryption_enabled ⇒ Boolean

Returns Whether all recordings are stored in an encrypted form. The default is ‘false`.

Returns:

  • (Boolean) —

    Whether all recordings are stored in an encrypted form. The default is ‘false`.



225
226
227
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 225

def encryption_enabled
    @properties['encryption_enabled']
end

#encryption_key_sid ⇒ String

Returns The SID of the Public Key resource used for encryption.

Returns:

  • (String) —

    The SID of the Public Key resource used for encryption.



219
220
221
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 219

def encryption_key_sid
    @properties['encryption_key_sid']
end

#fetch ⇒ RecordingSettingsInstance

Fetch the RecordingSettingsInstance

Returns:



266
267
268
269
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 266

def fetch

    context.fetch
end

#friendly_name ⇒ String

Returns The string that you assigned to describe the resource and show the user in the console.

Returns:

  • (String) —

    The string that you assigned to describe the resource and show the user in the console



195
196
197
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 195

def friendly_name
    @properties['friendly_name']
end

#inspect ⇒ Object

Provide a detailed, user friendly representation



280
281
282
283
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 280

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

#to_s ⇒ Object

Provide a user friendly representation



273
274
275
276
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 273

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

#url ⇒ String

Returns The absolute URL of the resource.

Returns:

  • (String) —

    The absolute URL of the resource.



231
232
233
 
# File 'lib/twilio-ruby/rest/video/v1/recording_settings.rb', line 231

def url
    @properties['url']
end