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
Compartir

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