Rooms - Create

서비스:

Communication

API 버전:

2025-03-13

새 회의실을 만듭니다.

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

URI 매개 변수

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

요청 헤더

Name	필수	형식	Description
Authorization	True	string	HMAC-SHA256 체계를 사용하여 생성된 서명을 포함하는 인증 문자열입니다.
Repeatability-Request-ID		string (uuid)	지정된 경우 클라이언트는 요청을 반복할 수 있도록 지시합니다. 즉, 클라이언트가 동일한 반복성Request-ID 요청을 여러 번 수행하고 서버에서 요청을 여러 번 실행하지 않고 적절한 응답을 다시 가져올 수 있습니다. Repeatability-Request-ID 값은 요청의 모든 시간 동안 전역적으로 고유한 클라이언트 생성 식별자를 나타내는 불투명 문자열입니다. 버전 4(임의) UUID를 사용하는 것이 좋습니다.
Repeatability-First-Sent		string (date-time-rfc1123)	Repeatability-Request-ID 헤더가 지정된 경우 Repeatability-First-Sent 헤더도 지정해야 합니다. 값은 요청이 처음 생성된 날짜 및 시간이어야 하며, HTTP 날짜의 IMF 수정 형식을 사용하여 표현됩니다.

요청 본문

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

응답

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

보안

Authorization

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

형식: apiKey
In(다음 안에): header

예제

Create a new meeting room.

샘플 요청

HTTP

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

{
  "validFrom": "2025-06-30T00:00:00Z",
  "validUntil": "2025-07-30T00:00:00Z",
  "pstnDialOutEnabled": true,
  "participants": {
    "8:acs:db75ed0c-e801-41a3-99a4-66a0a119a06c_00000010-ce28-064a-83fe-084822000666": {
      "role": "Attendee"
    },
    "8:acs:db75ed0c-e801-41a3-99a4-66a0a119a06c_00000010-ce28-064a-83fe-084822000777": {
      "role": "Presenter"
    },
    "8:acs:db75ed0c-e801-41a3-99a4-66a0a119a06c_00000010-ce28-064a-83fe-084822000888": {
      "role": "Collaborator"
    }
  }
}

샘플 응답

상태 코드:

201

{
  "id": "99117812428622880",
  "createdAt": "2025-06-26T05:46:17.8159131+00:00",
  "validFrom": "2025-06-30T00:00:00+00:00",
  "validUntil": "2025-07-30T00:00:00+00:00",
  "pstnDialOutEnabled": true
}

정의

Name	Description
CreateRoomRequest	새 회의실을 만들기 위한 페이로드를 요청합니다.
ParticipantProperties
Role	회의실 참가자의 역할입니다. 기본값은 Attendee입니다.
RoomModel	회의실입니다.

CreateRoomRequest

Object

새 회의실을 만들기 위한 페이로드를 요청합니다.

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

ParticipantProperties

Object

Name	형식	Description
role	Role	회의실 참가자의 역할입니다. 기본값은 Attendee입니다.

Role

열거형

회의실 참가자의 역할입니다. 기본값은 Attendee입니다.

값	Description
Presenter
Attendee
Consumer
Collaborator

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.