Rooms - Update

Servicio:

Communication

Versión de la API:

2025-03-13

Actualizar una sala con cambios dados.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (url)	Punto de conexión del recurso de Comunicación de Azure.
roomId	path	True	string	Identificador de la sala solicitada.
api-version	query	True	string	Versión de la API que se va a invocar.

Encabezado de la solicitud

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

Nombre	Requerido	Tipo	Description
Authorization	True	string	Cadena de autenticación que contiene una firma generada mediante HMAC-SHA256 esquema.

Cuerpo de la solicitud

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

Nombre	Tipo	Description
pstnDialOutEnabled	boolean	(Opcional) Establezca esta marca en true si, en el momento de la llamada, la marcación se habilita en un número RTC en una sala determinada. De forma predeterminada, esta marca se establece en false.
validFrom	string (date-time)	(Opcional) Marca de tiempo de cuando la sala está abierta para unirse. La marca de tiempo está en formato RFC3339: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	(Opcional) Marca de tiempo de cuando la sala ya no se puede unir. La marca de tiempo está en formato RFC3339: yyyy-MM-ddTHH:mm:ssZ.

Respuestas

Nombre	Tipo	Description
200 OK	RoomModel	Solicitud correcta. La acción devuelve una sala actualizada.
Other Status Codes	CommunicationErrorResponse	Respuesta de error Encabezados x-ms-error-code: string

Seguridad

Authorization

Cadena de autenticación que contiene una firma generada mediante HMAC-SHA256 esquema.

Tipo: apiKey
En: header

Ejemplos

Update meeting room's properties.

Solicitud de ejemplo

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
}

Respuesta de muestra

status code:

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
}

Definiciones

Nombre	Description
RoomModel	Sala de reuniones.
UpdateRoomRequest	Solicitar carga útil para actualizar una sala.

RoomModel

Object

Sala de reuniones.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo cuando se creó la sala en el servidor. La marca de tiempo está en formato RFC3339: yyyy-MM-ddTHH:mm:ssZ.
id	string	Identificador único de una sala. Este identificador es el servidor generado.
pstnDialOutEnabled	boolean	Establezca esta marca en true si, en el momento de la llamada, la marcación se habilita en un número RTC en una sala determinada. De forma predeterminada, esta marca se establece en false.
validFrom	string (date-time)	Marca de tiempo de cuando la sala está abierta para unirse. La marca de tiempo está en formato RFC3339: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	Marca de tiempo de cuando la sala ya no se puede unir. La marca de tiempo está en formato RFC3339: yyyy-MM-ddTHH:mm:ssZ.

UpdateRoomRequest

Object

Solicitar carga útil para actualizar una sala.

Nombre	Tipo	Description
pstnDialOutEnabled	boolean	(Opcional) Establezca esta marca en true si, en el momento de la llamada, la marcación se habilita en un número RTC en una sala determinada. De forma predeterminada, esta marca se establece en false.
validFrom	string (date-time)	(Opcional) Marca de tiempo de cuando la sala está abierta para unirse. La marca de tiempo está en formato RFC3339: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	(Opcional) Marca de tiempo de cuando la sala ya no se puede unir. La marca de tiempo está en formato RFC3339: yyyy-MM-ddTHH:mm:ssZ.