Participants - Update

參考

服務:: Communication

API 版本:: 2024-04-15

更新會議室中的參與者。

PATCH {endpoint}/rooms/{roomId}/participants?api-version=2024-04-15

URI 參數

名稱	位於	必要	類型	Description
endpoint	path	True	string url	Azure 通訊資源的端點。
roomId	path	True	string	要更新參與者之會議室的標識碼。
api-version	query	True	string	要叫用的 API 版本。

要求標頭

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

名稱	必要	類型	Description
Authorization	True	string	驗證字串，包含使用 HMAC-SHA256 配置所產生的簽章。

要求本文

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

名稱	類型	Description
participants	<string, ParticipantProperties>	要更新的參與者。

回應

名稱	類型	Description
200 OK	object	參與者已成功更新。
Other Status Codes	CommunicationErrorResponse	錯誤回應標題 x-ms-error-code: string

名稱

類型

Description

200 OK

object

參與者已成功更新。

Other Status Codes

CommunicationErrorResponse

錯誤回應

標題

x-ms-error-code: string

安全性

Authorization

驗證字串，包含使用 HMAC-SHA256 配置所產生的簽章。

類型: apiKey
位於: header

範例

Update participants

範例要求

HTTP

PATCH https://contoso.communication.azure.com//rooms/99199690362660524/participants?api-version=2024-04-15

{
  "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": null
  }
}

範例回覆

狀態碼:: 200

{}

定義

名稱	Description
ParticipantProperties
Role	會議室參與者的角色。預設值為出席者。
UpdateParticipantsRequest	會議室中要更新的參與者。

ParticipantProperties

名稱	類型	Description
role	Role	會議室參與者的角色。預設值為出席者。

Role

會議室參與者的角色。預設值為出席者。

名稱	類型	Description
Attendee	string
Consumer	string
Presenter	string

UpdateParticipantsRequest

會議室中要更新的參與者。

名稱	類型	Description
participants	<string, ParticipantProperties>	要更新的參與者。

共用方式為