Rooms - Update

서비스:

Communication

API 버전:

2025-03-13

지정된 변경 내용으로 회의실을 업데이트합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (url)	Azure Communication 리소스의 엔드포인트입니다.
roomId	path	True	string	요청된 회의실의 ID입니다.
api-version	query	True	string	호출할 API의 버전입니다.

요청 헤더

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

Name	필수	형식	Description
Authorization	True	string	HMAC-SHA256 체계를 사용하여 생성된 서명을 포함하는 인증 문자열입니다.

요청 본문

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

Name	형식	Description
pstnDialOutEnabled	boolean	(선택 사항) 통화 시 특정 회의실에서 PSTN 번호로 전화를 걸면 이 플래그를 true로 설정합니다. 기본적으로 이 플래그는 false로 설정됩니다.
validFrom	string (date-time)	(선택 사항) 회의실이 조인을 위해 열려 있는 시점의 타임스탬프입니다. 타임스탬프의 형식은 yyyy-MM-ddTHH:mm:ssZRFC3339.
validUntil	string (date-time)	(선택 사항) 회의실을 더 이상 조인할 수 없는 시점의 타임스탬프입니다. 타임스탬프의 형식은 yyyy-MM-ddTHH:mm:ssZRFC3339.

응답

Name	형식	Description
200 OK	RoomModel	요청이 성공했습니다. 이 작업은 업데이트된 회의실을 반환합니다.
Other Status Codes	CommunicationErrorResponse	오류 응답 헤더 x-ms-error-code: string

보안

Authorization

HMAC-SHA256 체계를 사용하여 생성된 서명을 포함하는 인증 문자열입니다.

형식: apiKey
In(다음 안에): 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
}

정의

Name	Description
RoomModel	회의실입니다.
UpdateRoomRequest	회의실 업데이트에 대한 페이로드를 요청합니다.

RoomModel

Object

회의실입니다.

Name	형식	Description
createdAt	string (date-time)	서버에서 회의실을 만든 타임스탬프입니다. 타임스탬프의 형식은 yyyy-MM-ddTHH:mm:ssZRFC3339.
id	string	회의실의 고유 식별자입니다. 이 ID는 서버가 생성됩니다.
pstnDialOutEnabled	boolean	통화 시 특정 회의실에서 PSTN 번호로 전화를 걸면 이 플래그를 true로 설정합니다. 기본적으로 이 플래그는 false로 설정됩니다.
validFrom	string (date-time)	회의실이 조인을 위해 열려 있는 시점의 타임스탬프입니다. 타임스탬프의 형식은 yyyy-MM-ddTHH:mm:ssZRFC3339.
validUntil	string (date-time)	회의실을 더 이상 조인할 수 없는 시점의 타임스탬프입니다. 타임스탬프의 형식은 yyyy-MM-ddTHH:mm:ssZRFC3339.

UpdateRoomRequest

Object

회의실 업데이트에 대한 페이로드를 요청합니다.

Name	형식	Description
pstnDialOutEnabled	boolean	(선택 사항) 통화 시 특정 회의실에서 PSTN 번호로 전화를 걸면 이 플래그를 true로 설정합니다. 기본적으로 이 플래그는 false로 설정됩니다.
validFrom	string (date-time)	(선택 사항) 회의실이 조인을 위해 열려 있는 시점의 타임스탬프입니다. 타임스탬프의 형식은 yyyy-MM-ddTHH:mm:ssZRFC3339.
validUntil	string (date-time)	(선택 사항) 회의실을 더 이상 조인할 수 없는 시점의 타임스탬프입니다. 타임스탬프의 형식은 yyyy-MM-ddTHH:mm:ssZRFC3339.