Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2023-08-02 GMT+08:00

Consulta de detalhes do terminal

Descrição

Esta API é usada por um administrador empresarial para consultar detalhes do terminal.

SLA

Taxa de sucesso de solicitação: > 99,99%

Atraso na solicitação TP99: 110 ms

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

Tabela 1 Protótipo

Método de solicitação

GET

Endereço de solicitação

/v1/usg/dcs/corp/device/{sn}

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

sn

Sim

String

Caminho

SN do terminal. O valor pode conter apenas números, letras e sublinhados (_).

maxLength: 30

minLength: 1

X-Access-Token

Sim

String

Cabeçalho

Token de autorização. Use o valor de accessToken na resposta à solicitação de Autenticação de um ID de aplicação.

X-Request-Id

Não

String

Cabeçalho

ID da solicitação, que é usado para rastreamento e localização de falhas. É aconselhável usar um UUID. Se este parâmetro não for transportado, um ID de solicitação é gerado automaticamente.

Accept-Language

Não

String

Cabeçalho

Idioma. Valores: zh-CN para chinês (padrão) e en-US para inglês.

Códigos de status

Tabela 3 Códigos de status

Código de status HTTP

Descrição

200

Operação bem-sucedida.

400

Parâmetros inválidos.

401

A autenticação não é executada ou falha.

403

Permissões insuficientes.

500

Exceção do servidor.

Parâmetros de resposta

Tabela 4 Parâmetros de resposta

Parâmetro

Tipo

Descrição

account

String

Conta embutida do terminal físico.

country

String

País ou região a que o número de telemóvel pertence.

deptCode

String

Código do departamento.

deptName

String

Nome do departamento.

deptNamePath

String

Caminho do nome do departamento.

description

String

Descrição do terminal.

email

String

Endereço de e-mail.

model

String

Modelo do dispositivo. O valor é um tipo enumerado. Atualmente, apenas os terminais físicos da série TE são suportados. Você pode obter os modelos de terminal usando a API em Obtenção de todos os modelos de terminal.

name

String

Nome do dispositivo.

number

String

Número SIP vinculado ao terminal.

phone

String

Número de celular.

prjCodeMode

Integer

Modo de geração de código de projeção.

  • 0: modo automático.

    Neste modo, a complexidade do código é controlada com base no endereço IP relatado na mensagem. Para um endereço IP privado, um código de projeção simples é gerado. Para um endereço IP público, um código de projeção complexo é gerado.

  • 1: modo simples.
  • 2: modo complexo.

sn

String

SN do terminal. O valor pode conter apenas números, letras e sublinhados (_).

status

Integer

Status do terminal.

  • 0: normal.
  • 1: congelado.

type

String

Tipo de terminal, que é usado para distinguir terminais desenvolvidos pela Huawei ou de terceiros.

Exemplo de solicitação

GET /v1/usg/dcs/corp/device/asdasfscasd
Connection: keep-alive
X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

Exemplo de resposta

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 407
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: efa03c0b6cb71b96129744f5a1a8a736 

{
    "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 erro

Se um código de erro começando com MMC ou USG for retornado quando você usar essa API, corrija a falha seguindo as instruções fornecidas no Centro de erros da API da Huawei Cloud.

Exemplo de comando cURL

curl -k -i -X GET -H 'X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/device/asdasfscasd