PlcmExtSipPeerOutboundRegistration

PlcmExtSipPeerOutboundRegistration

Some external SIP peers require peers to register with them as an endpoint does, using a REGISTER message (also known as pilot registration). You can add outbound registration configurations that the system can use to register with the SIP peer that you’re adding or editing, following the rules specified in RFC 3261.


PlcmExtSipPeerOutboundRegistration Fields

NameTypeDescriptionAttributes
idstring A read-only unique identifier for this outbound registration assigned by the system on create.
enabledboolean Allows you to stop using this registration without deleting the registration information. Mandatory
usernamestring The user name to use for the authentication credentials if the external peer challenges the registration request. Note: The authentication credentials specified here are specific to this SIP peer and are not tied to any other authentication configuration values.
passwordstring Passwords are set on Create and may be updated in Update. Passwords are never sent in responses. A missing password element on update of an existing Registration means to leave the password for that Registration unchanged. A password element with no text content on update of an existing Registration means to set that password to an empty string.
addressOfRecordstring The AOR with which the system registers (see registration rules in RFC 3261), such as sip:1000@dma.polycom.com. Mandatory
territoryToPerformRegistrationTerritoryToPerformRegistration Responsibility for registering must be assigned to a territory, thus making the primary or backup DMA cluster for the territory responsible, depending on which is active. Valid values may be obtained by querying the DMA Territories API. Mandatory
contactAddressFormatContactAddressFormat Specify IP or DNS to specify that the contact header should use the virtual IP address or virtual DNS name of the cluster currently managing the territory. If the territory responsibility switches to the other cluster, it re-sends the registration using its IP address or DNS name. Select Free Form to specify that the contact header should use the FQDN you enter. This contact header is mandatory if FREE_FORM is specified. The external peer must be able to resolve this FQDN. Mandatory
freeformAddressstring The free form contact address. This is required if contact-address-format is FREE_FORM.
requestUristring The Request-URI to include when registering with this SIP peer, specified using the variables (#delimited) defined in Free Form Template Variables.
headerArray of Header Additional headers to include when registering with this SIP peer. Click Add to add a header. In the Add Header dialog box, specify the header name and value(s), using the variables (#delimited) defined in Free Form Template Variables. Click Edit or Delete to edit or delete the selected header.

Header Fields

NameTypeDescriptionAttributes
namestring Header name. Mandatory
valuestring Header value. Mandatory


Nested Types/Restrictions


NameTypeRestrictions
ContactAddressFormatstring
Value must be one of:
  • IP
  • DNS
  • FREE_FORM
TerritoryToPerformRegistrationstring
Length of value must be >=1