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

Modificação de um terminal

Descrição

Esta API é usada por um administrador empresarial para modificar um terminal.

SLA

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

Atraso na solicitação TP99: 39 ms

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

Tabela 1 Protótipo

Método de solicitação

PUT

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 de 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.

country

Não

String

Corpo

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

Valor padrão: chinaPR.

maxLength: 255

minLength: 0

deptCode

Não

String

Corpo

ID do departamento. O valor padrão é o departamento raiz.

Valor padrão: 1.

maxLength: 32

minLength: 0

description

Não

String

Corpo

Descrição do terminal.

maxLength: 128

minLength: 0

email

Não

String

Corpo

Formato de endereço de e-mail unificado.

maxLength: 255

minLength: 0

name

Não

String

Corpo

Nome do terminal. É aconselhável definir este parâmetro para um local específico.

maxLength: 64

minLength: 0

phone

Não

String

Corpo

Número de celular, que deve conter o código do país.

Por exemplo, um número de celular na China continental é +86xxxxxxxxxxx. Este parâmetro é combinado com o parâmetro country.

O número de celular pode conter apenas números.

maxLength: 32

minLength: 0

NOTA:

O número de celular ou endereço de e-mail deve ser especificado.

prjCodeMode

Não

Integer

Corpo

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.

status

Não

Integer

Corpo

Status do terminal.

  • 0: normal.
  • 1: congelado.

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

Nenhum

Exemplo de solicitação

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

{
    "name": "test",
    "deptCode": "1",
    "email": "test@huawei.com",
    "country": "chinaPR",
    "description": "test",
    "status": 0
}

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: 143
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 88007a3bf4d6478e530b09589582f26f 

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 -H 'content-type: application/json' -X PUT -H 'X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF'  -d '{"model": "TE20","name": "test","deptCode": "1","email": "test@huawei.com","country": "chinaPR","description": "test","status": 0}' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/device/asdasfscasd