Peripheral Gateway API

Use the Peripheral Gateway (PG) API to retrieve peripheral gateway information.

Note

If there are any system validation errors on any configured PGs, API throws 400 error.

URL

https://<server>/unifiedconfig/config/peripheralgateway

Operations

  • list: Retrieves a list of peripheral gateways.

  • get: Returns one peripheral gateway using the URL https://<server>/unifiedconfig/config/peripheralgateway/<id>.

Parameters

  • refURL: The refURL of the peripheral gateway. See Shared Parameters.

  • name: The name of the peripheral gateway. See Shared Parameters.

  • logicalControllerId: The ID of the logical controller.

  • peripherals: A collection of peripheral information, including client type, name, peripheralID, routingClientID, and routingType (see Dialed Number API for routingType values).

    • The client type values are:

      • 13: VRU

      • 30: CUCM

      • 42: Generic PG

      • 47: MediaRouting

  • datacenter: A reference to the data center, including the refURL and name.

Search and Sort Values

The following table shows the parameters that are searched and the parameters that are sortable.

Search Parameters

Sort Parameters

name

  • name (Default)

  • datacenter.name

See Search and Sort.

Advanced search parameters

The Peripheral Gateway API has an advanced search for datacenters.

  • datacenters: (dc1|dc2|dc3...) which returns all peripheral gateways which belong to any of the specified data centers. You can specify up to three data centers. The data center names are fully matched (case-insensitive, no partial matches). Searching for "core" returns all machines in the core data center.

Example Get Response

Code Snippet
Copy<peripheralGateway xsi:type="peripheralGateway">
     <changeStamp>0</changeStamp>
     <refURL>/unifiedconfig/config/peripheralgateway/5001</refURL>
     <name>MR_PG</name>
     <logicalControllerID>5001</logicalControllerID> 
<datacenter>
                <name>Berlin</name>
                <refURL>/unifiedconfig/config/datacenter/5000</refURL>
        </datacenter>
     <peripherals>
         <peripheral>
             <changeStamp>824</changeStamp>
             <clientType>47</clientType>
             <name>Multichannel</name>
             <peripheralID>5005</peripheralID>
             <routingClientID>5005</routingClientID>
             <routingType>3</routingType>
         </peripheral>
         <peripheral>
             <changeStamp>822</changeStamp>
             <clientType>47</clientType>
             <name>Outbound</name>
             <peripheralID>5007</peripheralID>
             <routingClientID>5007</routingClientID>
             <routingType>4</routingType>
         </peripheral>
     </peripherals>
</peripheralGateway>