Rooms - Create

Service:

Communication

API-versie:

2025-03-13

Hiermee maakt u een nieuwe ruimte.

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

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string (url)	Het eindpunt van de Azure Communication-resource.
api-version	query	True	string	De versie van de API die moet worden aangeroepen.

Aanvraagkoptekst

Name	Vereist	Type	Description
Authorization	True	string	Een verificatietekenreeks die een handtekening bevat die is gegenereerd met behulp van HMAC-SHA256 schema.
Repeatability-Request-ID		string (uuid)	Indien opgegeven, stuurt de client aan dat de aanvraag herhaalbaar is; dat wil gezegd dat de client de aanvraag meerdere keren kan indienen met dezelfde herhaalbaarheid-Request-ID en een geschikt antwoord kan krijgen zonder dat de server de aanvraag meerdere keren uitvoert. De waarde van de herhaalbaarheid-Request-ID is een ondoorzichtige tekenreeks die een door de client gegenereerde, wereldwijd unieke id voor de aanvraag vertegenwoordigt. Het wordt aanbevolen versie 4 (willekeurige) UUID's te gebruiken.
Repeatability-First-Sent		string (date-time-rfc1123)	Als herhaalbaarheid-Request-ID koptekst is opgegeven, moet ookFirst-Sent header worden opgegeven. De waarde moet de datum en tijd zijn waarop de aanvraag voor het eerst is gemaakt, uitgedrukt in de vorm van de IMF-fixdate van HTTP-datum.

Aanvraagbody

Name	Type	Description
participants	<string,  ParticipantProperties>	(Optioneel) Deelnemers die moeten worden uitgenodigd voor de ruimte.
pstnDialOutEnabled	boolean	Stel deze vlag in op waar als op het moment van het gesprek bellen naar een PSTN-nummer is ingeschakeld in een bepaalde ruimte. Deze vlag is standaard ingesteld op false.
validFrom	string (date-time)	De tijdstempel vanaf het moment dat de ruimte is geopend voor deelname. De tijdstempel heeft RFC3339 indeling: yyyy-MM-ddTHH:mm:ssZ. De standaardwaarde is de huidige datum/tijd.
validUntil	string (date-time)	De tijdstempel vanaf het moment dat de ruimte niet meer kan worden samengevoegd. De tijdstempel heeft RFC3339 indeling: yyyy-MM-ddTHH:mm:ssZ. De standaardwaarde is de huidige datum/tijd plus 180 dagen.

Antwoorden

Name	Type	Description
201 Created	RoomModel	Aanvraag is voltooid. De actie retourneert een nieuwe ruimte.
Other Status Codes	CommunicationErrorResponse	Foutreactie Kopteksten x-ms-error-code: string

Beveiliging

Authorization

Een verificatietekenreeks die een handtekening bevat die is gegenereerd met behulp van HMAC-SHA256 schema.

Type: apiKey
In: header

Voorbeelden

Create a new meeting room.

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

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
}

Definities

Name	Description
CreateRoomRequest	Nettolading aanvragen voor het maken van een nieuwe ruimte.
ParticipantProperties
Role	De rol van een deelnemer aan de ruimte. De standaardwaarde is Attendee.
RoomModel	De vergaderruimte.

CreateRoomRequest

Object

Nettolading aanvragen voor het maken van een nieuwe ruimte.

Name	Type	Description
participants	<string,  ParticipantProperties>	(Optioneel) Deelnemers die moeten worden uitgenodigd voor de ruimte.
pstnDialOutEnabled	boolean	Stel deze vlag in op waar als op het moment van het gesprek bellen naar een PSTN-nummer is ingeschakeld in een bepaalde ruimte. Deze vlag is standaard ingesteld op false.
validFrom	string (date-time)	De tijdstempel vanaf het moment dat de ruimte is geopend voor deelname. De tijdstempel heeft RFC3339 indeling: yyyy-MM-ddTHH:mm:ssZ. De standaardwaarde is de huidige datum/tijd.
validUntil	string (date-time)	De tijdstempel vanaf het moment dat de ruimte niet meer kan worden samengevoegd. De tijdstempel heeft RFC3339 indeling: yyyy-MM-ddTHH:mm:ssZ. De standaardwaarde is de huidige datum/tijd plus 180 dagen.

ParticipantProperties

Object

Name	Type	Description
role	Role	De rol van een deelnemer aan de ruimte. De standaardwaarde is Attendee.

Role

Inventarisatie

De rol van een deelnemer aan de ruimte. De standaardwaarde is Attendee.

Waarde	Description
Presenter
Attendee
Consumer
Collaborator

RoomModel

Object

De vergaderruimte.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel waarop de ruimte is gemaakt op de server. De tijdstempel heeft RFC3339 indeling: yyyy-MM-ddTHH:mm:ssZ.
id	string	Unieke id van een kamer. Deze id wordt gegenereerd door de server.
pstnDialOutEnabled	boolean	Stel deze vlag in op waar als op het moment van het gesprek bellen naar een PSTN-nummer is ingeschakeld in een bepaalde ruimte. Deze vlag is standaard ingesteld op false.
validFrom	string (date-time)	De tijdstempel vanaf het moment dat de ruimte is geopend voor deelname. De tijdstempel heeft RFC3339 indeling: yyyy-MM-ddTHH:mm:ssZ.
validUntil	string (date-time)	De tijdstempel vanaf het moment dat de ruimte niet meer kan worden samengevoegd. De tijdstempel heeft RFC3339 indeling: yyyy-MM-ddTHH:mm:ssZ.