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/ Consulta de umbrales de alarma QoS

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

Ver PDF

Consulta de umbrales de alarma QoS

Descripción

Esta API se utiliza para consultar el umbral de un tipo de QoS específico 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	GET
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.

Códigos de estado

**Tabla 3** 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 4** Parámetros de respuesta
Parámetro	Tipo	Descripción
latency	ThresholdData object	Umbral de retardo, en milisegundos. Este parámetro no es válido cuando thresholdType se establece en CPU.
jitter	ThresholdData object	Umbral de fluctuación, en milisegundos. Este parámetro no es válido cuando thresholdType se establece en CPU.
packetLoss	PacketThresholdData object	Umbral de tasa de pérdida de paquetes, en porcentaje (%). Este parámetro no es válido cuando thresholdType se establece en CPU.
clientCpuMax	CPUThresholdData object	Umbral máximo de CPU del cliente de Huawei Cloud Meeting, en porcentaje (%). Este parámetro sólo es válido cuando thresholdType se establece en CPU.
systemCpuMax	CPUThresholdData object	Umbral máximo de CPU del sistema, en porcentaje (%). Este parámetro sólo es válido cuando thresholdType se establece en CPU.

**Tabla 5** estructura de ThresholdData
Parámetro	Tipo	Descripción
receiving	Integer	Umbral de Rx personalizado, en milisegundos.
receivingDefault	Integer	Umbral de Rx predeterminado, en milisegundos.
sending	Integer	Umbral de Tx personalizado, en milisegundos.
sendingDefault	Integer	Umbral de Tx predeterminado, en milisegundos.

**Tabla 6** estructura de PacketThresholdData
Parámetro	Tipo	Descripción
receiving	Integer	Umbral de Rx personalizado, en porcentaje (%).
receivingDefault	Integer	Umbral de Rx predeterminado, en porcentaje (%).
sending	Integer	Umbral de Tx personalizado, en porcentaje (%).
sendingDefault	Integer	Umbral de Tx predeterminado, en porcentaje (%).

**Tabla 7** Estructura de CPUThresholdData
Parámetro	Tipo	Descripción
cpu	Integer	Umbral de CPU personalizado, en porcentaje (%).
cpuDefault	Integer	Umbral de CPU predeterminado, en porcentaje (%).

Ejemplo de solicitud

GET /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)

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
{
		"latency": {
		"receiving": 500,
		"receivingDefault": 800,
		"sending": 500,
		"sendingDefault": 800
	},
	"jitter": {
		"receiving": 500,
		"receivingDefault": 800,
		"sending": 500,
		"sendingDefault": 800
	},
	"packetLoss": {
		"receiving": 20,
		"receivingDefault": 50,
		"sending": 20,
		"sendingDefault": 50
	}
}

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 GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -d 'thresholdType=AUDIO' https://api.meeting.huaweicloud.com/v1/metrics/conference/threshold

Tema principal: APIs

Tema anterior: Consulta de QoS de un participante

Tema siguiente: Configuración de Umbrales de Alarma QoS