Class: Telnyx::Resources::PortingOrders

Inherits:
Object
  • Object
show all
Defined in:
lib/telnyx/resources/porting_orders.rb,
lib/telnyx/resources/porting_orders/actions.rb,
lib/telnyx/resources/porting_orders/comments.rb,
lib/telnyx/resources/porting_orders/activation_jobs.rb,
lib/telnyx/resources/porting_orders/verification_codes.rb,
lib/telnyx/resources/porting_orders/action_requirements.rb,
lib/telnyx/resources/porting_orders/phone_number_blocks.rb,
lib/telnyx/resources/porting_orders/additional_documents.rb,
lib/telnyx/resources/porting_orders/phone_number_extensions.rb,
lib/telnyx/resources/porting_orders/associated_phone_numbers.rb,
lib/telnyx/resources/porting_orders/phone_number_configurations.rb

Defined Under Namespace

Classes: ActionRequirements, Actions, ActivationJobs, AdditionalDocuments, AssociatedPhoneNumbers, Comments, PhoneNumberBlocks, PhoneNumberConfigurations, PhoneNumberExtensions, VerificationCodes

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(client:) ⇒ PortingOrders

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of PortingOrders.

Parameters:



315
316
317
318
319
320
321
322
323
324
325
326
327
328
 
# File 'lib/telnyx/resources/porting_orders.rb', line 315

def initialize(client:)
  @client = client
  @phone_number_configurations =
    Telnyx::Resources::PortingOrders::PhoneNumberConfigurations.new(client: client)
  @actions = Telnyx::Resources::PortingOrders::Actions.new(client: client)
  @activation_jobs = Telnyx::Resources::PortingOrders::ActivationJobs.new(client: client)
  @additional_documents = Telnyx::Resources::PortingOrders::AdditionalDocuments.new(client: client)
  @comments = Telnyx::Resources::PortingOrders::Comments.new(client: client)
  @verification_codes = Telnyx::Resources::PortingOrders::VerificationCodes.new(client: client)
  @action_requirements = Telnyx::Resources::PortingOrders::ActionRequirements.new(client: client)
  @associated_phone_numbers = Telnyx::Resources::PortingOrders::AssociatedPhoneNumbers.new(client: client)
  @phone_number_blocks = Telnyx::Resources::PortingOrders::PhoneNumberBlocks.new(client: client)
  @phone_number_extensions = Telnyx::Resources::PortingOrders::PhoneNumberExtensions.new(client: client)
end

Instance Attribute Details

#action_requirements ⇒ Telnyx::Resources::PortingOrders::ActionRequirements (readonly)

Returns:



25
26
27
 
# File 'lib/telnyx/resources/porting_orders.rb', line 25

def action_requirements
  @action_requirements
end

#actions ⇒ Telnyx::Resources::PortingOrders::Actions (readonly)

Returns:



10
11
12
 
# File 'lib/telnyx/resources/porting_orders.rb', line 10

def actions
  @actions
end

#activation_jobs ⇒ Telnyx::Resources::PortingOrders::ActivationJobs (readonly)

Returns:



13
14
15
 
# File 'lib/telnyx/resources/porting_orders.rb', line 13

def activation_jobs
  @activation_jobs
end

#additional_documents ⇒ Telnyx::Resources::PortingOrders::AdditionalDocuments (readonly)

Returns:



16
17
18
 
# File 'lib/telnyx/resources/porting_orders.rb', line 16

def additional_documents
  @additional_documents
end

#associated_phone_numbers ⇒ Telnyx::Resources::PortingOrders::AssociatedPhoneNumbers (readonly)

Returns:



28
29
30
 
# File 'lib/telnyx/resources/porting_orders.rb', line 28

def associated_phone_numbers
  @associated_phone_numbers
end

#comments ⇒ Telnyx::Resources::PortingOrders::Comments (readonly)

Returns:



19
20
21
 
# File 'lib/telnyx/resources/porting_orders.rb', line 19

def comments
  @comments
end

#phone_number_blocks ⇒ Telnyx::Resources::PortingOrders::PhoneNumberBlocks (readonly)

Returns:



31
32
33
 
# File 'lib/telnyx/resources/porting_orders.rb', line 31

def phone_number_blocks
  @phone_number_blocks
end

#phone_number_configurations ⇒ Telnyx::Resources::PortingOrders::PhoneNumberConfigurations (readonly)

Returns:



7
8
9
 
# File 'lib/telnyx/resources/porting_orders.rb', line 7

def phone_number_configurations
  @phone_number_configurations
end

#phone_number_extensions ⇒ Telnyx::Resources::PortingOrders::PhoneNumberExtensions (readonly)

Returns:



34
35
36
 
# File 'lib/telnyx/resources/porting_orders.rb', line 34

def phone_number_extensions
  @phone_number_extensions
end

#verification_codes ⇒ Telnyx::Resources::PortingOrders::VerificationCodes (readonly)

Returns:



22
23
24
 
# File 'lib/telnyx/resources/porting_orders.rb', line 22

def verification_codes
  @verification_codes
end

Instance Method Details

#create(phone_numbers:, customer_group_reference: nil, customer_reference: nil, request_options: {}) ⇒ Telnyx::Models::PortingOrderCreateResponse

Creates a new porting order object.

Parameters:

  • phone_numbers (Array<String>) —

    The list of +E.164 formatted phone numbers

  • customer_group_reference (String) —

    A customer-specified group reference for customer bookkeeping purposes

  • customer_reference (String, nil) —

    A customer-specified reference number for customer bookkeeping purposes

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



51
52
53
54
55
56
57
58
59
60
 
# File 'lib/telnyx/resources/porting_orders.rb', line 51

def create(params)
  parsed, options = Telnyx::PortingOrderCreateParams.dump_request(params)
  @client.request(
    method: :post,
    path: "porting_orders",
    body: parsed,
    model: Telnyx::Models::PortingOrderCreateResponse,
    options: options
  )
end

#delete(id, request_options: {}) ⇒ nil

Deletes an existing porting order. This operation is restrict to porting orders in draft state.

Parameters:

Returns:

  • (nil)

See Also:



189
190
191
192
193
194
195
196
 
# File 'lib/telnyx/resources/porting_orders.rb', line 189

def delete(id, params = {})
  @client.request(
    method: :delete,
    path: ["porting_orders/%1$s", id],
    model: NilClass,
    options: params[:request_options]
  )
end

#list(filter: nil, include_phone_numbers: nil, page_number: nil, page_size: nil, sort: nil, request_options: {}) ⇒ Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::PortingOrder>

Some parameter documentations has been truncated, see Models::PortingOrderListParams for more details.

Returns a list of your porting order.

Parameters:

Returns:

See Also:



165
166
167
168
169
170
171
172
173
174
175
 
# File 'lib/telnyx/resources/porting_orders.rb', line 165

def list(params = {})
  parsed, options = Telnyx::PortingOrderListParams.dump_request(params)
  @client.request(
    method: :get,
    path: "porting_orders",
    query: parsed.transform_keys(page_number: "page[number]", page_size: "page[size]"),
    page: Telnyx::Internal::DefaultFlatPagination,
    model: Telnyx::PortingOrder,
    options: options
  )
end

#retrieve(id, include_phone_numbers: nil, request_options: {}) ⇒ Telnyx::Models::PortingOrderRetrieveResponse

Retrieves the details of an existing porting order.

Parameters:

  • id (String) —

    Porting Order id

  • include_phone_numbers (Boolean) —

    Include the first 50 phone number objects in the results

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



75
76
77
78
79
80
81
82
83
84
 
# File 'lib/telnyx/resources/porting_orders.rb', line 75

def retrieve(id, params = {})
  parsed, options = Telnyx::PortingOrderRetrieveParams.dump_request(params)
  @client.request(
    method: :get,
    path: ["porting_orders/%1$s", id],
    query: parsed,
    model: Telnyx::Models::PortingOrderRetrieveResponse,
    options: options
  )
end

#retrieve_allowed_foc_windows(id, request_options: {}) ⇒ Telnyx::Models::PortingOrderRetrieveAllowedFocWindowsResponse

Returns a list of allowed FOC dates for a porting order.

Parameters:

Returns:

See Also:



209
210
211
212
213
214
215
216
 
# File 'lib/telnyx/resources/porting_orders.rb', line 209

def retrieve_allowed_foc_windows(id, params = {})
  @client.request(
    method: :get,
    path: ["porting_orders/%1$s/allowed_foc_windows", id],
    model: Telnyx::Models::PortingOrderRetrieveAllowedFocWindowsResponse,
    options: params[:request_options]
  )
end

#retrieve_exception_types(request_options: {}) ⇒ Telnyx::Models::PortingOrderRetrieveExceptionTypesResponse

Returns a list of all possible exception types for a porting order.

Parameters:

Returns:

See Also:



227
228
229
230
231
232
233
234
 
# File 'lib/telnyx/resources/porting_orders.rb', line 227

def retrieve_exception_types(params = {})
  @client.request(
    method: :get,
    path: "porting_orders/exception_types",
    model: Telnyx::Models::PortingOrderRetrieveExceptionTypesResponse,
    options: params[:request_options]
  )
end

#retrieve_loa_template(id, loa_configuration_id: nil, request_options: {}) ⇒ StringIO

Some parameter documentations has been truncated, see Models::PortingOrderRetrieveLoaTemplateParams for more details.

Download a porting order loa template

Parameters:

  • id (String) —

    Porting Order id

  • loa_configuration_id (String) —

    The identifier of the LOA configuration to use for the template. If not provided

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

  • (StringIO)

See Also:



252
253
254
255
256
257
258
259
260
261
262
 
# File 'lib/telnyx/resources/porting_orders.rb', line 252

def retrieve_loa_template(id, params = {})
  parsed, options = Telnyx::PortingOrderRetrieveLoaTemplateParams.dump_request(params)
  @client.request(
    method: :get,
    path: ["porting_orders/%1$s/loa_template", id],
    query: parsed,
    headers: {"accept" => "application/pdf"},
    model: StringIO,
    options: options
  )
end

#retrieve_requirements(id, page_number: nil, page_size: nil, request_options: {}) ⇒ Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::PortingOrderRetrieveRequirementsResponse>

Returns a list of all requirements based on country/number type for this porting order.

Parameters:

  • id (String) —

    Porting Order id

  • page_number (Integer)
  • page_size (Integer)
  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



280
281
282
283
284
285
286
287
288
289
290
 
# File 'lib/telnyx/resources/porting_orders.rb', line 280

def retrieve_requirements(id, params = {})
  parsed, options = Telnyx::PortingOrderRetrieveRequirementsParams.dump_request(params)
  @client.request(
    method: :get,
    path: ["porting_orders/%1$s/requirements", id],
    query: parsed.transform_keys(page_number: "page[number]", page_size: "page[size]"),
    page: Telnyx::Internal::DefaultFlatPagination,
    model: Telnyx::Models::PortingOrderRetrieveRequirementsResponse,
    options: options
  )
end

#retrieve_sub_request(id, request_options: {}) ⇒ Telnyx::Models::PortingOrderRetrieveSubRequestResponse

Retrieve the associated V1 sub_request_id and port_request_id

Parameters:

Returns:

See Also:



303
304
305
306
307
308
309
310
 
# File 'lib/telnyx/resources/porting_orders.rb', line 303

def retrieve_sub_request(id, params = {})
  @client.request(
    method: :get,
    path: ["porting_orders/%1$s/sub_request", id],
    model: Telnyx::Models::PortingOrderRetrieveSubRequestResponse,
    options: params[:request_options]
  )
end

#update(id, activation_settings: nil, customer_group_reference: nil, customer_reference: nil, documents: nil, end_user: nil, messaging: nil, misc: nil, phone_number_configuration: nil, requirement_group_id: nil, requirements: nil, user_feedback: nil, webhook_url: nil, request_options: {}) ⇒ Telnyx::Models::PortingOrderUpdateResponse

Some parameter documentations has been truncated, see Models::PortingOrderUpdateParams for more details.

Edits the details of an existing porting order.

Any or all of a porting orders attributes may be included in the resource object included in a PATCH request.

If a request does not include all of the attributes for a resource, the system will interpret the missing attributes as if they were included with their current values. To explicitly set something to null, it must be included in the request with a null value.

Parameters:

Returns:

See Also:



132
133
134
135
136
137
138
139
140
141
 
# File 'lib/telnyx/resources/porting_orders.rb', line 132

def update(id, params = {})
  parsed, options = Telnyx::PortingOrderUpdateParams.dump_request(params)
  @client.request(
    method: :patch,
    path: ["porting_orders/%1$s", id],
    body: parsed,
    model: Telnyx::Models::PortingOrderUpdateResponse,
    options: options
  )
end