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.

Centro de ayuda/ Meeting/ Referencia de la API del servidor/ Panel de control/ QoS de reunión/ APIs/ Configuración de Umbrales de Alarma QoS

Actualización más reciente 2023-01-31 GMT+08:00

Ver PDF

Configuración de Umbrales de Alarma QoS

Descripción

Esta API se utiliza para configurar umbrales de tipos de QoS específicos en una empresa.
Rol de permisos = Empresa de edición Premium/Standard + Administrador

Depuración

Puede depurar esta API en API Explorer.

Prototipo

**Tabla 1** Prototipo
Método de solicitud	POST
Dirección de solicitud	/v1/metrics/conference/threshold
Protocolo de transporte	HTTPS

Parámetros de solicitud

**Tabla 2** Parámetros
Parámetro	Obligatorio	Tipo	Localización	Descripción
thresholdType	Sí	String	Query	Tipo de umbral. AUDIO: umbral de audio. VIDEO: umbral de vídeo. SCREEN: umbral de uso compartido de pantalla. CPU: Umbral de CPU.
X-Access-Token	Sí	String	Header	Token de autorización. Utilice el valor de accessToken en la respuesta a la solicitud de Autenticación de un ID de aplicación.
latency	No	SetThresholdData object	Body	Umbral de retardo, en milisegundos. Este parámetro es obligatorio cuando thresholdType se establece en AUDIO, VIDEO o SCREEN. Este parámetro no es válido cuando thresholdType se establece en CPU.
jitter	No	SetThresholdData object	Body	Umbral de fluctuación, en milisegundos. Este parámetro es obligatorio cuando thresholdType se establece en AUDIO, VIDEO o SCREEN. Este parámetro no es válido cuando thresholdType se establece en CPU.
packetLoss	No	SetPacketThresholdData object	Body	Umbral de tasa de pérdida de paquetes, en porcentaje (%). Este parámetro es obligatorio cuando thresholdType se establece en AUDIO, VIDEO o SCREEN. Este parámetro no es válido cuando thresholdType se establece en CPU.
clientCpuMax	No	SetCPUThresholdData object	Body	Umbral máximo de CPU del cliente de Huawei Cloud Meeting, en porcentaje (%). Este parámetro no es válido cuando thresholdType se establece en AUDIO, VIDEO o SCREEN. Este parámetro es obligatorio cuando thresholdType se establece en CPU.
systemCpuMax	No	SetCPUThresholdData object	Body	Umbral máximo de CPU del sistema, en porcentaje (%). Este parámetro no es válido cuando thresholdType se establece en AUDIO, VIDEO o SCREEN. Este parámetro es obligatorio cuando thresholdType se establece en CPU.

**Tabla 3** Estructura de datos de SetThresholdData
Parámetro	Tipo	Descripción
receiving	Integer	Umbral de Rx, en milisegundos. Rango de valores: 0 a 10000.
sending	Integer	Umbral de Tx, en milisegundos. Rango de valores: 0 a 10000.

**Tabla 4** Estructura de datos de SetPacketThresholdData
Parámetro	Tipo	Descripción
receiving	Integer	Umbral de Rx, en porcentaje (%). Rango de valores: 0 a 100.
sending	Integer	Umbral de Tx, en porcentaje (%). Rango de valores: 0 a 100.

**Tabla 5** Estructura de datos de SetCPUThresholdData
Parámetro	Tipo	Descripción
cpu	Integer	Umbral de CPU, en porcentaje (%). Rango de valores: 0 a 100.

Códigos de estado

**Tabla 6** Códigos de estado
Código de estado de HTTP	Descripción
400	Solicitud incorrecta. Parámetros no válidos.
401	No autorizado. La autenticación no se realiza o falla.
403	Prohibido. Permisos insuficientes.
500	Excepción del servidor.

Parámetros de respuesta

**Tabla 7** Parámetros de respuesta
Parámetro	Tipo	Descripción
code	String	Código de retorno.
message	String	Mensaje de respuesta.

Ejemplo de solicitud

POST /v1/metrics/conference/threshold?thresholdType=AUDIO
Connection: keep-alive
X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC
user-agent: WeLink-desktop
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
	"latency": {
		"receiving": 500,
		"sending": 500
	},
	"jitter": {
		"receiving": 500,
		"sending": 500
	},
	"packetLoss": {
		"receiving": 20,
		"sending": 20
	}
}

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: 2450
Connection: keep-alive
Expires: 0
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: 6fba0eff9f832b463580fb06c5b0ff9c
Server: api-gateway
X-Request-Id: ac9f75ec3c97c823f128526a924532b2
{
	"code": "0",
	"message": "OK"
}

Códigos de error

Si se devuelve un código de error que comienza con MBI cuando usa 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 -X POST -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -d 'thresholdType=AUDIO' https://api.meeting.huaweicloud.com/v1/metrics/conference/threshold -d'{"latency":{"receiving":500,"sending":500},"jitter":{"receiving":500,"sending":500},"packetLoss":{"receiving":20,"sending":20}}'

Tema principal: APIs

Tema anterior: Consulta de umbrales de alarma QoS

Tema siguiente: Estadísticas de reuniones