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

Consulta de Terminales en Páginas

Descripción

Esta API es utilizada por un administrador de empresa para consultar terminales en páginas.

SLA

Tasa de éxito de solicitudes: > 99.99%

Retraso de la petición TP99: 64 ms

Depuración

Puede depurar esta API en API Explorer.

Prototipo

Tabla 1 Prototipo

Método de solicitud

GET

Dirección de solicitud

/v1/usg/dcs/corp/device

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

offset

No

Integer

Query

Desplazamiento de consulta. Si el valor excede el número máximo de registros disponibles, se devuelven los registros de la última página.

limit

No

Integer

Query

Número de registros a consultar.

Valor predeterminado: 10.

searchKey

No

String

Query

Criterios de búsqueda. Se admite la búsqueda difusa por nombre y SN.

model

No

String

Query

Modelo del dispositivo. El valor es un tipo enumerado. Actualmente, solo se admiten terminales duros de la serie TE. Puede obtener los modelos de terminal usando la API en Obtención de todos los modelos de terminal.

maxLength: 128

minLength: 0

deptCode

No

String

Query

ID del departamento. El valor predeterminado es el departamento root.

Valor predeterminado: 1.

maxLength: 32

minLength: 0

enableSubDept

No

Boolean

Query

Si se debe consultar a los subdepartamentos.

Valor predeterminado: true.

X-Access-Token

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.

X-Request-Id

No

String

Header

ID de solicitud, que se utiliza para el seguimiento y la localización de fallos. Se recomienda utilizar un UUID. Si este parámetro no se incluye, se genera automáticamente un ID de solicitud.

Accept-Language

No

String

Header

Idioma. Valores: zh-CN para chino (predeterminado) y en-US para inglés.

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

Tabla 4 Parámetros de respuesta

Parámetro

Tipo

Descripción

count

Integer

Número total de registros.

limit

Integer

Número de registros mostrados por página.

Valor predeterminado: 10.

offset

Integer

Número de la página de inicio de la consulta. El valor comienza desde 0.

data

Array of QueryDeviceResultDTO objects

Lista de terminales.

Ejemplo de solicitud

GET /v1/usg/dcs/corp/device 
Connection: keep-alive
X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF
Content-Type: application/json
Content-Length: 119
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: 481
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 3df9b4a1b0f8e77050d27a858add946c 

{
    "offset": 0,
    "limit": 10,
    "count": 1,
    "data": [
        {
            "name": "test",
            "type": "TE",
            "model": "TE20",
            "sn": "asdasfscasd",
            "account": "df8bce2178294683bb83a4985fef7165",
            "number": "+991118029589",
            "prjCodeMode": 0,
            "deptCode": "1",
            "deptName": "wangyue",
            "deptNamePath": "wangyue",
            "phone": "+86***********",
            "country": "chinaPR",
            "email": "test@huawei.com",
            "description": "test",
            "status": 0
        }
    ]
}

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 -X GET -H 'X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/device