Rooms - Update

Služba:

Communication

Verze rozhraní API:

2025-03-13

Aktualizujte místnost s danými změnami.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string (url)	Koncový bod prostředku komunikace Azure.
roomId	path	True	string	ID požadované místnosti.
api-version	query	True	string	Verze rozhraní API k vyvolání

Hlavička požadavku

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

Name	Vyžadováno	Typ	Description
Authorization	True	string	Ověřovací řetězec obsahující podpis vygenerovaný pomocí schématu HMAC-SHA256.

Text požadavku

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

Name	Typ	Description
pstnDialOutEnabled	boolean	(Volitelné) Tento příznak nastavte na hodnotu true, pokud je v době hovoru povolené vytáčení na číslo veřejné telefonní sítě v konkrétní místnosti. Ve výchozím nastavení je tento příznak nastavený na false.
validFrom	string (date-time)	(Volitelné) Časové razítko z doby, kdy je místnost otevřená pro připojení. Časové razítko je ve formátu RFC3339: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	(Volitelné) Časové razítko od chvíle, kdy se místnost už nemůže připojit. Časové razítko je ve formátu RFC3339: yyyy-MM-ddTHH:mm:ssZ.

Odpovědi

Name	Typ	Description
200 OK	RoomModel	Žádost byla úspěšná. Akce vrátí aktualizovanou místnost.
Other Status Codes	CommunicationErrorResponse	Chybová odpověď Hlavičky x-ms-error-code: string

Zabezpečení

Authorization

Ověřovací řetězec obsahující podpis vygenerovaný pomocí schématu HMAC-SHA256.

Typ: apiKey
V: header

Příklady

Update meeting room's properties.

Ukázkový požadavek

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
}

Ukázková odpověď

Stavový kód:

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
}

Definice

Name	Description
RoomModel	Místnost pro schůzky.
UpdateRoomRequest	Žádost o datovou část pro aktualizaci místnosti

RoomModel

Objekt

Místnost pro schůzky.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko, kdy byla místnost vytvořena na serveru. Časové razítko je ve formátu RFC3339: yyyy-MM-ddTHH:mm:ssZ.
id	string	Jedinečný identifikátor místnosti. Toto ID je vygenerováno serverem.
pstnDialOutEnabled	boolean	Tento příznak nastavte na hodnotu true, pokud je v době hovoru povolené vytáčení na číslo veřejné telefonní sítě v konkrétní místnosti. Ve výchozím nastavení je tento příznak nastavený na false.
validFrom	string (date-time)	Časové razítko z doby, kdy je místnost otevřená pro připojení. Časové razítko je ve formátu RFC3339: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	Časové razítko od chvíle, kdy se místnost už nemůže připojit. Časové razítko je ve formátu RFC3339: yyyy-MM-ddTHH:mm:ssZ.

UpdateRoomRequest

Objekt

Žádost o datovou část pro aktualizaci místnosti

Name	Typ	Description
pstnDialOutEnabled	boolean	(Volitelné) Tento příznak nastavte na hodnotu true, pokud je v době hovoru povolené vytáčení na číslo veřejné telefonní sítě v konkrétní místnosti. Ve výchozím nastavení je tento příznak nastavený na false.
validFrom	string (date-time)	(Volitelné) Časové razítko z doby, kdy je místnost otevřená pro připojení. Časové razítko je ve formátu RFC3339: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	(Volitelné) Časové razítko od chvíle, kdy se místnost už nemůže připojit. Časové razítko je ve formátu RFC3339: yyyy-MM-ddTHH:mm:ssZ.