Skip to content

GroupCollaborateBridgeConsolidatedModifyInstanceRequest

Bases: OCIRequest

Request to modify a Collaborate bridge. The request fails when the collaborateOwnerUserIdList is included in the request for the default collaborate bridge. The request fails when the supportOutdial is included in the request and the system-level collaborate supportOutdial setting is disabled. When phone numbers are un-assigned from the user, the unused numbers may be un-assigned from the group and service provider. If UnassignPhoneNumbersLevel is set to 'Group', the user's primary phone number, fax number and any alternate numbers, will be un-assigned from the group if the command is executed by a service provider administrator or above. When set to 'Service Provider', they will be un-assigned from the group and service provider if the command is executed by a provisioning administrator or above. When omitted, the number(s) will be left assigned to the group. An ErrorResponse will be returned if any number cannot be unassigned because of insufficient privilege.

If the phoneNumber has not been assigned to the group and addPhoneNumberToGroup is set to true, it will be added to group if needed if the command is executed by a service provider administrator and above. The command will fail otherwise.

The response is either SuccessResponse or ErrorResponse.

Attributes:

service_user_id (str):

unassign_phone_numbers (Optional[str]):

add_phone_number_to_group (Optional[bool]):

service_instance_profile (Optional[ServiceInstanceModifyProfile]):

maximum_bridge_participants (Optional[CollaborateBridgeMaximumParticipants]):

network_class_of_service (Optional[str]):

max_collaborate_room_participants (Optional[int]):

support_outdial (Optional[bool]):

collaborate_owner_user_id_list (Optional[Nillable[ReplacementUserIdList]]):

service_list (Optional[Nillable[ReplacementConsolidatedUserServiceAssignmentList]]):
Source code in src/mercury_ocip/commands/commands.py
@dataclass(kw_only=True)
class GroupCollaborateBridgeConsolidatedModifyInstanceRequest(OCIRequest):
    """Request to modify a Collaborate bridge.
        The request fails when the collaborateOwnerUserIdList is included in the request for the default collaborate bridge.
        The request fails when the supportOutdial is included in the request and the system-level collaborate supportOutdial setting is disabled.
        When phone numbers are un-assigned from the user, the unused numbers may be un-assigned from the group and service provider. If UnassignPhoneNumbersLevel is set to 'Group', the user's primary phone number, fax number and any alternate numbers, will be un-assigned from the group if the command is executed by a service provider administrator or above.
        When set to 'Service Provider', they will be un-assigned from the group and service provider if the command is executed by a provisioning administrator or above.
        When omitted, the number(s) will be left assigned to the group.
        An ErrorResponse will be returned if any number cannot be unassigned because of insufficient privilege.

        If the phoneNumber has not been assigned to the group and addPhoneNumberToGroup is set to true, it will be added to group if needed if the command is executed by a service provider administrator and above. The command will fail otherwise.

        The response is either SuccessResponse or ErrorResponse.

    Attributes:

        service_user_id (str):

        unassign_phone_numbers (Optional[str]):

        add_phone_number_to_group (Optional[bool]):

        service_instance_profile (Optional[ServiceInstanceModifyProfile]):

        maximum_bridge_participants (Optional[CollaborateBridgeMaximumParticipants]):

        network_class_of_service (Optional[str]):

        max_collaborate_room_participants (Optional[int]):

        support_outdial (Optional[bool]):

        collaborate_owner_user_id_list (Optional[Nillable[ReplacementUserIdList]]):

        service_list (Optional[Nillable[ReplacementConsolidatedUserServiceAssignmentList]]):

    """

    service_user_id: str = field(metadata={"alias": "serviceUserId"})

    unassign_phone_numbers: Optional[str] = field(
        default=None, metadata={"alias": "unassignPhoneNumbers"}
    )

    add_phone_number_to_group: Optional[bool] = field(
        default=None, metadata={"alias": "addPhoneNumberToGroup"}
    )

    service_instance_profile: Optional[ServiceInstanceModifyProfile] = field(
        default=None, metadata={"alias": "serviceInstanceProfile"}
    )

    maximum_bridge_participants: Optional[CollaborateBridgeMaximumParticipants] = field(
        default=None, metadata={"alias": "maximumBridgeParticipants"}
    )

    network_class_of_service: Optional[str] = field(
        default=None, metadata={"alias": "networkClassOfService"}
    )

    max_collaborate_room_participants: Optional[int] = field(
        default=None, metadata={"alias": "maxCollaborateRoomParticipants"}
    )

    support_outdial: Optional[bool] = field(
        default=None, metadata={"alias": "supportOutdial"}
    )

    collaborate_owner_user_id_list: Optional[Nillable[ReplacementUserIdList]] = field(
        default=None, metadata={"alias": "collaborateOwnerUserIdList"}
    )

    service_list: Optional[
        Nillable[ReplacementConsolidatedUserServiceAssignmentList]
    ] = field(default=None, metadata={"alias": "serviceList"})

    def __post_init__(self):
        nillable_fields = ["collaborate_owner_user_id_list", "service_list"]
        for field_name in nillable_fields:
            value = getattr(self, field_name)
            if value == "" or value == "None":
                object.__setattr__(self, field_name, OCINil)

Responses

Bases: OCIResponse

Source code in src/mercury_ocip/commands/base_command.py
class ErrorResponse(OCIResponse):
    errorCode: Optional[int] = None
    summary: str
    summaryEnglish: str
    detail: Optional[str] = None

Bases: OCIResponse

Source code in src/mercury_ocip/commands/base_command.py
class SuccessResponse(OCIResponse):
    pass

Bases: OCIResponse

Source code in src/mercury_ocip/commands/base_command.py
class ErrorResponse(OCIResponse):
    errorCode: Optional[int] = None
    summary: str
    summaryEnglish: str
    detail: Optional[str] = None

Example Usage

from mercury_ocip.client import Client
from mercury_ocip.commands import GroupCollaborateBridgeConsolidatedModifyInstanceRequest

client = Client()

command = GroupCollaborateBridgeConsolidatedModifyInstanceRequest(
    service_user_id=...,
    unassign_phone_numbers=...,
    add_phone_number_to_group=...,
    service_instance_profile=...,
    maximum_bridge_participants=...,
    network_class_of_service=...,
    max_collaborate_room_participants=...,
    support_outdial=...,
    collaborate_owner_user_id_list=...,
    service_list=...,
)

response = client.command(command)

print(response)

Example 2 with Raw Command

from mercury_ocip.client import Client

client = Client()

response = client.raw_command("GroupCollaborateBridgeConsolidatedModifyInstanceRequest",
    service_user_id=...,
    unassign_phone_numbers=...,
    add_phone_number_to_group=...,
    service_instance_profile=...,
    maximum_bridge_participants=...,
    network_class_of_service=...,
    max_collaborate_room_participants=...,
    support_outdial=...,
    collaborate_owner_user_id_list=...,
    service_list=...,
)

print(response)