telephony_number_specials
Creates, updates, deletes, gets or lists a telephony_number_specials resource.
Overview​
| Name | telephony_number_specials |
| Type | Resource |
| Id | ovh.order.telephony_number_specials |
Fields​
The following fields are returned by SELECT queries:
- get
successful operation
| Name | Datatype | Description |
|---|---|---|
order_id | integer | Identifier of the order (wire: orderId) |
contracts | array | List of contracts related to the order |
details | array | Details of the order |
prices | object | Prices of the order including with and without taxes |
url | string | URL to download the order |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | billing_account, country, display_universal_directory, legalform, range, retractation, siret, social_nomination, typology | address_extra, ape, cedex, city, description, display_search_reverse, email, firstname, name, organisation, phone, pool, post_box, specific_number, street_name, street_number, street_number_extra, street_type, urban_district, zip | Get prices and contracts information |
create | insert | billing_account, country, display_universal_directory, legalform, range, retractation, siret, social_nomination, typology | Create order |
Parameters​
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
api_host | string | The OVHcloud API host. Selected by OVH_ENDPOINT (ovh-eu, ovh-ca or ovh-us; default ovh-eu). (default: api.eu.ovhcloud.com, x-stackQL-envVarSelector: {"envVar":"OVH_ENDPOINT","default":"ovh-eu","values":{"ovh-eu":"api.eu.ovhcloud.com","ovh-ca":"api.ca.ovhcloud.com","ovh-us":"api.us.ovhcloud.com"}}) |
billing_account | string | The name of your billingAccount (wire: billingAccount) |
country | string | Number country |
display_universal_directory | boolean | Publish informations on directory ? (Yellow Pages...) (wire: displayUniversalDirectory) |
legalform | string | Legal form |
range | string | Special range |
retractation | boolean | Retractation rights if set |
siret | string | Company siret |
social_nomination | string | Company social nomination (wire: socialNomination) |
typology | string | Special range typology |
address_extra | string | Contact address extra (wire: addressExtra) |
ape | string | Company ape |
cedex | string | Contact cedex |
city | string | Contact city |
description | string | Line description |
display_search_reverse | boolean | Publish informations on reversed directory ? (wire: displaySearchReverse) |
email | string | |
firstname | string | Contact firstname |
name | string | Contact name |
organisation | string | Contact organisation |
phone | string | Contact phone |
pool | integer | Number of alias in case of pool |
post_box | string | Contact post box (wire: postBox) |
specific_number | string (phone-number) | Preselected standard number (wire: specificNumber) |
street_name | string | Street name (wire: streetName) |
street_number | string | Street number (wire: streetNumber) |
street_number_extra | string | Street number extra (wire: streetNumberExtra) |
street_type | string | Street type (wire: streetType) |
urban_district | string | Contact urban district (wire: urbanDistrict) |
zip | string | Contact zip |
SELECT examples​
- get
Get prices and contracts information
SELECT
order_id,
contracts,
details,
prices,
url
FROM ovh.order.telephony_number_specials
WHERE billing_account = '{{ billing_account }}' -- required
AND country = '{{ country }}' -- required
AND display_universal_directory = '{{ display_universal_directory }}' -- required
AND legalform = '{{ legalform }}' -- required
AND range = '{{ range }}' -- required
AND retractation = '{{ retractation }}' -- required
AND siret = '{{ siret }}' -- required
AND social_nomination = '{{ social_nomination }}' -- required
AND typology = '{{ typology }}' -- required
AND address_extra = '{{ address_extra }}'
AND ape = '{{ ape }}'
AND cedex = '{{ cedex }}'
AND city = '{{ city }}'
AND description = '{{ description }}'
AND display_search_reverse = '{{ display_search_reverse }}'
AND email = '{{ email }}'
AND firstname = '{{ firstname }}'
AND name = '{{ name }}'
AND organisation = '{{ organisation }}'
AND phone = '{{ phone }}'
AND pool = '{{ pool }}'
AND post_box = '{{ post_box }}'
AND specific_number = '{{ specific_number }}'
AND street_name = '{{ street_name }}'
AND street_number = '{{ street_number }}'
AND street_number_extra = '{{ street_number_extra }}'
AND street_type = '{{ street_type }}'
AND urban_district = '{{ urban_district }}'
AND zip = '{{ zip }}'
;
INSERT examples​
- create
- Manifest
Create order
INSERT INTO ovh.order.telephony_number_specials (
address_extra,
ape,
cedex,
city,
country,
description,
display_search_reverse,
display_universal_directory,
email,
firstname,
legalform,
name,
organisation,
phone,
pool,
post_box,
range,
retractation,
siret,
social_nomination,
specific_number,
street_name,
street_number,
street_number_extra,
street_type,
typology,
urban_district,
zip,
billing_account
)
SELECT
'{{ address_extra }}',
'{{ ape }}',
'{{ cedex }}',
'{{ city }}',
'{{ country }}' /* required */,
'{{ description }}',
{{ display_search_reverse }},
{{ display_universal_directory }} /* required */,
'{{ email }}',
'{{ firstname }}',
'{{ legalform }}' /* required */,
'{{ name }}',
'{{ organisation }}',
'{{ phone }}',
{{ pool }},
'{{ post_box }}',
'{{ range }}' /* required */,
{{ retractation }} /* required */,
'{{ siret }}' /* required */,
'{{ social_nomination }}' /* required */,
'{{ specific_number }}',
'{{ street_name }}',
'{{ street_number }}',
'{{ street_number_extra }}',
'{{ street_type }}',
'{{ typology }}' /* required */,
'{{ urban_district }}',
'{{ zip }}',
'{{ billing_account }}'
RETURNING
order_id,
contracts,
details,
prices,
url
;
# Description fields are for documentation purposes
- name: telephony_number_specials
props:
- name: billing_account
value: "{{ billing_account }}"
description: Required parameter for the telephony_number_specials resource.
- name: address_extra
value: "{{ address_extra }}"
description: |
Contact address extra
- name: ape
value: "{{ ape }}"
description: |
Company ape
- name: cedex
value: "{{ cedex }}"
description: |
Contact cedex
- name: city
value: "{{ city }}"
description: |
Contact city
- name: country
value: "{{ country }}"
description: |
Special number country
valid_values: ['fr']
- name: description
value: "{{ description }}"
description: |
Line description
- name: display_search_reverse
value: {{ display_search_reverse }}
description: |
Publish informations on reversed directory ?
- name: display_universal_directory
value: {{ display_universal_directory }}
description: |
Publish informations on directory ? (Yellow Pages...)
- name: email
value: "{{ email }}"
- name: firstname
value: "{{ firstname }}"
description: |
Contact firstname
- name: legalform
value: "{{ legalform }}"
description: |
Legal forms a nichandle can be registered as
valid_values: ['administration', 'association', 'corporation', 'individual', 'other', 'personalcorporation']
- name: name
value: "{{ name }}"
description: |
Contact name
- name: organisation
value: "{{ organisation }}"
description: |
Contact organisation
- name: phone
value: "{{ phone }}"
description: |
Contact phone
- name: pool
value: {{ pool }}
description: |
Number quantity contained in the pool
valid_values: ['10', '50', '100']
- name: post_box
value: "{{ post_box }}"
description: |
Contact post box
- name: range
value: "{{ range }}"
description: |
Special range
- name: retractation
value: {{ retractation }}
description: |
Retractation rights if set
- name: siret
value: "{{ siret }}"
description: |
Company siret
- name: social_nomination
value: "{{ social_nomination }}"
description: |
Company social nomination
- name: specific_number
value: "{{ specific_number }}"
description: |
Phone number
- name: street_name
value: "{{ street_name }}"
description: |
Street name
- name: street_number
value: "{{ street_number }}"
description: |
Street number
- name: street_number_extra
value: "{{ street_number_extra }}"
description: |
Street number extra
- name: street_type
value: "{{ street_type }}"
description: |
Street type
- name: typology
value: "{{ typology }}"
description: |
Number special typology
valid_values: ['fr_access', 'fr_announced', 'fr_conferencing', 'fr_contentsAuto', 'fr_contentsManual', 'fr_games', 'fr_linking', 'fr_m2m', 'fr_relationship']
- name: urban_district
value: "{{ urban_district }}"
description: |
Contact urban district
- name: zip
value: "{{ zip }}"
description: |
Contact zip