Rooms - Update

Служба:

Communication

Версия API:

2025-03-13

Обновите комнату с заданными изменениями.

PATCH {endpoint}/rooms/{roomId}?api-version=2025-03-13

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string (url)	Конечная точка ресурса связи Azure.
roomId	path	True	string	Идентификатор запрошенной комнаты.
api-version	query	True	string	Версия API для вызова.

Заголовок запроса

Media Types: "application/merge-patch+json"

Имя	Обязательно	Тип	Описание
Authorization	True	string	Строка проверки подлинности, содержащая сигнатуру, созданную с помощью схемы HMAC-SHA256.

Текст запроса

Media Types: "application/merge-patch+json"

Имя	Тип	Описание
pstnDialOutEnabled	boolean	(Необязательно) Установите для этого флага значение true, если во время вызова в определенной комнате включен номер ТСОП. По умолчанию этот флаг имеет значение false.
validFrom	string (date-time)	(Необязательно) Метка времени, начиная с момента открытия комнаты для присоединения. Метка времени находится в формате RFC3339: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	(Необязательно) Метка времени от момента, когда комната больше не может быть присоединена. Метка времени находится в формате RFC3339: yyyy-MM-ddTHH:mm:ssZ.

Ответы

Имя	Тип	Описание
200 OK	RoomModel	Запрос успешно выполнен. Действие возвращает обновленную комнату.
Other Status Codes	CommunicationErrorResponse	Ответ на ошибку Заголовки x-ms-error-code: string

Безопасность

Authorization

Строка проверки подлинности, содержащая сигнатуру, созданную с помощью схемы HMAC-SHA256.

Тип: apiKey
В: header

Примеры

Update meeting room's properties.

Образец запроса

HTTP

PATCH https://contoso.communication.azure.com//rooms/99199690362660524?api-version=2025-03-13

{
  "validFrom": "2023-06-30T00:00:00Z",
  "validUntil": "2023-07-30T00:00:00Z",
  "pstnDialOutEnabled": true
}

Пример ответа

Код состояния:

200

{
  "id": "99199690362660524",
  "createdAt": "2025-06-26T01:37:00.659722+00:00",
  "validFrom": "2025-06-30T00:00:00+00:00",
  "validUntil": "2025-07-30T00:00:00+00:00",
  "pstnDialOutEnabled": true
}

Определения

Имя	Описание
RoomModel	Комната собраний.
UpdateRoomRequest	Запрос полезных данных для обновления комнаты.

RoomModel

Object

Комната собраний.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания комнаты на сервере. Метка времени находится в формате RFC3339: yyyy-MM-ddTHH:mm:ssZ.
id	string	Уникальный идентификатор комнаты. Этот идентификатор создается на сервере.
pstnDialOutEnabled	boolean	Установите для этого флага значение true, если во время вызова в определенной комнате включен номер ТСОП. По умолчанию этот флаг имеет значение false.
validFrom	string (date-time)	Метка времени, начиная с момента открытия комнаты для присоединения. Метка времени находится в формате RFC3339: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	Метка времени от момента, когда комната больше не может быть присоединена. Метка времени находится в формате RFC3339: yyyy-MM-ddTHH:mm:ssZ.

UpdateRoomRequest

Object

Запрос полезных данных для обновления комнаты.

Имя	Тип	Описание
pstnDialOutEnabled	boolean	(Необязательно) Установите для этого флага значение true, если во время вызова в определенной комнате включен номер ТСОП. По умолчанию этот флаг имеет значение false.
validFrom	string (date-time)	(Необязательно) Метка времени, начиная с момента открытия комнаты для присоединения. Метка времени находится в формате RFC3339: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	(Необязательно) Метка времени от момента, когда комната больше не может быть присоединена. Метка времени находится в формате RFC3339: yyyy-MM-ddTHH:mm:ssZ.