PlcmConferenceRoomV3

PlcmConferenceRoomV3

A Conference Room. Conference Rooms are tied to individual user accounts and will be created during scheduling with start and stop times. Content-Type: application/vnd.plcm.plcm-conference-room-v3+xml. All attributes are used in ETag calculation except for owner-first-name, owner-last-name, not-before, not-after, entity-tag and atom-link.


PlcmConferenceRoomV3 Fields

NameTypeDescriptionAttributes
atomLinkList Array of LinkSee Definition of Link
plcmConferenceRoomAliasList Array of PlcmConferenceRoomAliasSee Definition of PlcmConferenceRoomAlias
plcmDialOutParticipantV2List Array of PlcmDialOutParticipantV2See Definition of PlcmDialOutParticipantV2
ownerFirstNameOwnerFirstName The conference room owner's first name. This is a 'read only' field. Sending it to the API will have no effect.
ownerLastNameOwnerLastName The conference room owner's last name. This is a 'read only' field. Sending it to the API will have no effect.
ownerDomainstring The domain to which the owner of this conference room belongs. Mandatory
ownerUsernamestring Owner's username. Mandatory
durationInMinutesDurationInMinutes The number of minutes a conference is accessible. Duration is measured from the time the conference is started (joined by the first user). Note: 1. Integer value '-1' will set the conference room to be accessible for unlimited duration. 2. To specify the default conference settings, specify integer value '0' or do not include the duration-in-minutes in the request.
conferenceRoomIdentifierConferenceRoomIdentifier The unique identifier of the conference room. If left blank, a conference room identifer will be generated. If supplied, the identifier must be unique, or the room will fail to be created. Can't be edited for an enterprise conference room or calendared meeting conference room.
dialInNumberstring The dial in number of this conference room. Automatically set to the dialing prefix plus room ID. This is a 'read only' field. Sending it to the API will have no effect. Modification of this field is not allowed.
conferenceTemplateNameConferenceTemplateName A meaningful name for the conference template (up to 50 characters).
maxParticipantsMaxParticipants Maximum number (0-99) of callers allowed to join the conference. To specify the MCU's maximum, use -1. To specify the default conference settings, do not include the max-participants in the request.
mcuPoolOrderNamestring Name of the MCU pool order. Mandatory
territoryNamestring The name of the territory to which this conference room is assigned.
chairpersonRequiredboolean True if the chairperson is required for this conference, False otherwise.
chairpersonCodeChairpersonCode The code entered by the chairperson to chair the meeting in this conference room.
chairpersonCodeUseAsAliasboolean True if the chairperson code is to be used as alias, False otherwise. This will be ignored if 'chairperson-code' is empty or null.
conferenceCodeConferenceCode The code required to enter this conference room.
conferenceCodeUseAsAliasboolean True if the conference code is to be used as alias, False otherwise. This will be ignored if 'conference-code' is empty or null.
entityTagEntityTag The unique value generated from the server object instance. This value is the same value that be applied to the HTTP Entity Tag (ETag) header for a single instance of this object. Client modification of this field is not allowed for this instance.
passbackPassback User defined value for that is opaque to the system.
passthruPassthru User defined value that that is opaque to the system. Note: this value is available after the call and/or conference is terminated in the userDataB field in the call and/or conference CDR.
autoDialOutboolean True if the list of dialout participants shall be dialed at conference initialization; False otherwise.
resourcePriorityNamespaceResourcePriorityNamespace Namespace parameter for the SIP Resource Priority header (namespace.value) for any SIP dial outs from the conference room. This is an optional value.
resourcePriorityValueResourcePriorityValue Value parameter for the SIP Resource Priority header (namespace.value) for any SIP dial outs from the conference room. This is an optional value.
firstCallerMcuAffinityboolean If the first caller's site contains MCUs in the designated MCU pool order, start the conference on one of them.
confRoomPublishableboolean Whether this conference room is publishable on Lync systems.
overrideLastDisconnectboolean If true, the conference will terminate at the end of conference duration instead of when the last participant leaves.
focusUriFocusUri The focusURI associated with this conference room (either SkypeForBusiness or Office365)
conferenceRoomTypeConferenceRoomType Distinguish whether this room is an enterprise, calendared (PCO), or scheduled VMR. NOTE: This is a 'read only' field. Sending it to the API will have no effect.
lyncRegisteredDomainLyncRegisteredDomain The registered Lync domain associated with this conference room (either SkypeForBusiness or Office365); the rppContact is built with this domain; the rppContact is built with this domain.
notBeforedateTime
notAfterdateTime


Nested Types/Restrictions


NameTypeRestrictions
LyncRegisteredDomainstring
Length of value must be >=1
Length of value must be <=128
ConferenceRoomTypestring
Value must be one of:
  • LOCAL
  • LOCAL_SCHEDULED
  • ENTERPRISE
  • ENTERPRISE_SCHEDULED
  • PCO_EVENT
FocusUristring
Length of value must be >=1
Length of value must be <=512
ResourcePriorityValuestring
Length of value must be >=1
Length of value must be <=64
ResourcePriorityNamespacestring
Length of value must be >=1
Length of value must be <=64
Passthrustring
Length of value must be >=1
Length of value must be <=512
Passbackstring
Length of value must be >=1
Length of value must be <=512
EntityTagstring
Length of value must be >=1
Length of value must be <=64
ConferenceCode
Length of value must be >=1
Length of value must be <=16
ChairpersonCode
Length of value must be >=1
Length of value must be <=16
MaxParticipantsint
ConferenceTemplateNamestring
Length of value must be >=1
Length of value must be <=50
ConferenceRoomIdentifier
Length of value must be >=0
Length of value must be <=128
DurationInMinutesint
OwnerLastNamestring
Length of value must be >=1
Length of value must be <=256
OwnerFirstNamestring
Length of value must be >=1
Length of value must be <=256
T0string
Pattern of value must match the regular expression \d+
T1string
Pattern of value must match the regular expression \d+
T2string
Pattern of value must match the regular expression (^[a-zA-Z0-9]([0-9a-zA-Z_~!$&,.'=\+\-\*\(\)]|%[0-9a-fA-F][0-9a-fA-F])*[a-zA-Z0-9]$)|(^$)