Rooms - Create

Hizmet:

Communication

API Sürümü:

2025-03-13

Yeni bir oda oluşturur.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (url)	Azure İletişim kaynağının uç noktası.
api-version	query	True	string	Çağrılacak API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
Authorization	True	string	HMAC-SHA256 düzeni kullanılarak oluşturulan imzayı içeren bir kimlik doğrulama dizesi.
Repeatability-Request-ID		string (uuid)	Belirtilirse, istemci isteğin yinelenebilir olduğunu yönlendirir; başka bir ifadeyle istemci aynı Repeatability-Request-ID ile isteği birden çok kez yapabilir ve sunucu isteği birden çok kez yürütmeden uygun yanıtı geri alabilir. Repeatability-Request-ID değeri, istemci tarafından oluşturulan ve tüm zaman için genel olarak benzersiz olan istek tanımlayıcısını temsil eden opak bir dizedir. Sürüm 4 (rastgele) UUID'lerin kullanılması önerilir.
Repeatability-First-Sent		string (date-time-rfc1123)	Repeatability-Request-ID üst bilgisi belirtilirse Repeatability-First-Sent üst bilgisi de belirtilmelidir. Değer, isteğin ilk oluşturulduğu tarih ve saat olmalı ve HTTP-date'in IMF-fixdate biçimi kullanılarak ifade edilmelidir.

İstek Gövdesi

Name	Tür	Description
participants	<string,  ParticipantProperties>	(İsteğe bağlı) Odaya davet edilecek katılımcılar.
pstnDialOutEnabled	boolean	Arama sırasında belirli bir odada PSTN numarası etkinleştirilmişse bu bayrağı true olarak ayarlayın. Varsayılan olarak, bu bayrak false olarak ayarlanır.
validFrom	string (date-time)	Odanın katılma için açık olduğu zaman damgası. Zaman damgası RFC3339 biçimdedir: yyyy-MM-ddTHH:mm:ssZ. Varsayılan değer geçerli tarih saatidir.
validUntil	string (date-time)	Odanın artık birleştirilemeyecek olduğu zaman damgası. Zaman damgası RFC3339 biçimdedir: yyyy-MM-ddTHH:mm:ssZ. Varsayılan değer geçerli tarih saati artı 180 gündür.

Yanıtlar

Name	Tür	Description
201 Created	RoomModel	İstek başarılı oldu. Eylem yeni bir oda döndürür.
Other Status Codes	CommunicationErrorResponse	Hata yanıtı Üst Bilgiler x-ms-error-code: string

Güvenlik

Authorization

HMAC-SHA256 düzeni kullanılarak oluşturulan imzayı içeren bir kimlik doğrulama dizesi.

Tür: apiKey
İçinde: header

Örnekler

Create a new meeting room.

Örnek isteği

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"
    }
  }
}

Örnek yanıt

Durum kodu:

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
}

Tanımlar

Name	Description
CreateRoomRequest	Yeni oda oluşturmak için yük isteyin.
ParticipantProperties
Role	Oda katılımcısının rolü. Varsayılan değer Attendee'dir.
RoomModel	Toplantı odası.

CreateRoomRequest

Object

Yeni oda oluşturmak için yük isteyin.

Name	Tür	Description
participants	<string,  ParticipantProperties>	(İsteğe bağlı) Odaya davet edilecek katılımcılar.
pstnDialOutEnabled	boolean	Arama sırasında belirli bir odada PSTN numarası etkinleştirilmişse bu bayrağı true olarak ayarlayın. Varsayılan olarak, bu bayrak false olarak ayarlanır.
validFrom	string (date-time)	Odanın katılma için açık olduğu zaman damgası. Zaman damgası RFC3339 biçimdedir: yyyy-MM-ddTHH:mm:ssZ. Varsayılan değer geçerli tarih saatidir.
validUntil	string (date-time)	Odanın artık birleştirilemeyecek olduğu zaman damgası. Zaman damgası RFC3339 biçimdedir: yyyy-MM-ddTHH:mm:ssZ. Varsayılan değer geçerli tarih saati artı 180 gündür.

ParticipantProperties

Object

Name	Tür	Description
role	Role	Oda katılımcısının rolü. Varsayılan değer Attendee'dir.

Role

Listeleme

Oda katılımcısının rolü. Varsayılan değer Attendee'dir.

Değer	Description
Presenter
Attendee
Consumer
Collaborator

RoomModel

Object

Toplantı odası.

Name	Tür	Description
createdAt	string (date-time)	Odanın sunucuda oluşturulduğu zaman damgası. Zaman damgası RFC3339 biçimdedir: yyyy-MM-ddTHH:mm:ssZ.
id	string	Bir odanın benzersiz tanımlayıcısı. Bu kimlik, sunucu tarafından oluşturulur.
pstnDialOutEnabled	boolean	Arama sırasında belirli bir odada PSTN numarası etkinleştirilmişse bu bayrağı true olarak ayarlayın. Varsayılan olarak, bu bayrak false olarak ayarlanır.
validFrom	string (date-time)	Odanın katılma için açık olduğu zaman damgası. Zaman damgası RFC3339 biçimdedir: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	Odanın artık birleştirilemeyecek olduğu zaman damgası. Zaman damgası RFC3339 biçimdedir: yyyy-MM-ddTHH:mm:ssZ.