Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2023-01-31 GMT+08:00

Aplicar o renunciar al rol de host

Descripción

Esta API se utiliza para solicitar o renunciar al rol de host. Los invitados pueden solicitar ser el host, y el host puede renunciar al rol de host.

Depuración

Puede depurar esta API en API Explorer.

Prototipo

Tabla 1 Prototipo

Método de solicitud

PUT

Dirección de solicitud

/v1/mmc/control/conferences/participants/role

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

conferenceID

String

Query

ID de la reunión.

participantID

String

Query

ID del participante.

X-Conference-Authorization

String

Header

Token de control de reunión, que se obtiene a través de la API para obtener un token de control de reunión.

applyChair

Integer

Body

  • 1: Aplicar para ser el host.
  • 0: Renunciar al rol de host.

chairmanPwd

No

String

Body

Contraseña del host. Este parámetro es obligatorio si un participante solicita ser el host.

Códigos de estado

Tabla 3 Códigos de estado

Código de estado de HTTP

Descripción

200

Operación exitosa.

400

Parámetros inválidos.

401

La autenticación no se realiza o falla.

403

Permisos insuficientes.

500

Excepción del servidor.

Parámetros de respuesta

Ninguno

Ejemplo de solicitud

PUT /v1/mmc/control/conferences/participants/role?conferenceID=914083136&participantID=d2c3ae64216e11eabc510dc9b62e3a80
Connection: keep-alive
X-Conference-Authorization:stbaf8fa2ea8a1b0e3ab2e007a85a75f88c55d5f6d5c1912dfb
Content-Type: application/json
user-agent: WeLink-desktop
Content-Length: 22
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
  "applyChair": 1,
  "chairmanPwd": "157599"
}

Ejemplo de respuesta

HTTP/1.1 200
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 39
Connection: keep-alive
http_proxy_id: 8e6fe9e1d0a45e33398f426a227e855a
Server: api-gateway
X-Request-Id: 8957e54c2881f52125edd6439995fbf7

Códigos de error

Si se devuelve un código de error que comienza con MMC o USG cuando utiliza esta API, corrija el error siguiendo las instrucciones proporcionadas en Centro de errores de la API de Huawei Cloud.

Ejemplo de comando cURL

curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Conference-Authorization:stb39b3f21898d4972fed86b3f22ac70914a77303def15e126a' -d '{"applyChair":0}' https://api.meeting.huaweicloud.com/v1/mmc/control/conferences/participants/role?conferenceID=914083136&participantID=d2c3ae64216e11eabc510dc9b62e3a80