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.

Central de ajuda/ Meeting/ Referência de API do servidor/ Gerenciamento de usuário/ APIs/ Modificação de um usuário

Atualizado em 2023-08-02 GMT+08:00

Ver PDF

Modificação de um usuário

Descrição

Esta API é usada por um administrador empresarial para modificar um usuário.

SLA

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

Atraso na solicitação TP99: 34 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/member/{account}
Protocolo de transporte	HTTPS

Parâmetros de solicitação

**Tabela 2** Parâmetros
Parâmetro	Obrigatório	Tipo	Localização	Descrição
account	Sim	String	Caminho	Conta de usuário. Se o modo de autenticação de conta e senha for usado, o valor é uma conta do Huawei Cloud Meeting. Se o modo de autenticação de ID da aplicação for usado, o valor será um ID de usuário de terceiros.
accountType	Não	Integer	Consulta	Tipo de conta. 0: conta do Huawei Cloud Meeting, que é usada para autenticação de conta e senha. 1: ID de usuário de terceiros, que é usado para autenticação de ID de aplicação. Valor padrão: 0.
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. Se este parâmetro não for transportado, o departamento raiz é usado por padrão. Valor padrão: 1. maxLength: 32 minLength: 0
desc	Não	String	Corpo	Observações. maxLength: 128 minLength: 0
email	Não	String	Corpo	Endereço de e-mail. maxLength: 255 minLength: 0
englishName	Não	String	Corpo	Nome em inglês do usuário. maxLength: 64 minLength: 0
hidePhone	Não	Boolean	Corpo	Se esconder o número de celular. Valor padrão: false.
name	Não	String	Corpo	Nome do usuário. maxLength: 64 minLength: 1
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. O número de celular ou endereço de e-mail deve ser especificado. maxLength: 32 minLength: 0
signature	Não	String	Corpo	Assinatura. maxLength: 512 minLength: 0
sortLevel	Não	Integer	Corpo	Número de sequência no diretório empresarial. Um valor menor indica uma posição mais alta no diretório empresarial. Valor padrão: 10000. maximum: 10000 minimum: 1
status	Não	Integer	Corpo	Status do usuário. 0: normal. 1: desativado. Valor padrão: 0.
title	Não	String	Corpo	Título do trabalho. maxLength: 32 minLength: 0
vmrId	Não	String	Corpo	Lista de salas de reunião na nuvem. Se este parâmetro não for transportado, o ID da sala de reunião em nuvem será gerado automaticamente. maxLength: 32 minLength: 0

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
activeTime	Long	Tempo de ativação (carimbo de data/hora UTC).
adminType	Integer	Tipo de administrador. 0: administrador padrão (super). 1: administrador comum. 2: membro comum da empresa (Esse valor é válido somente quando UserType é definido como 2.)
corp	CorpBasicInfoDTO object	Detalhes de registro da empresa, que são retornados apenas quando os usuários consultam os dados pessoais de si mesmos.
country	String	País ou região ao qual o número de celular do usuário pertence.
deptCode	String	Código do departamento.
deptName	String	Nome do departamento.
deptNamePath	String	Caminho do nome do departamento.
desc	String	Observações.
devType	QueryDeviceInfoResultDTO object	Tipo do dispositivo associado.
email	String	Endereço de e-mail.
englishName	String	Nome em inglês.
function	UserFunctionDTO object	Sinalizador de função do usuário.
hidePhone	Boolean	Se esconder o número de celular.
id	String	ID do usuário.
license	Integer	Licença. 0: utilização comercial. 1: avaliação gratuita.
name	String	Nome do usuário.
phone	String	Número de celular.
signature	String	Assinatura.
sipNum	String	Número SIP.
sortLevel	Integer	Número de sequência no diretório empresarial. Um valor menor indica uma posição mais alta no diretório empresarial.
status	Integer	Status do usuário. 0: normal. 1: desativado.
thirdAccount	String	ID de usuário de terceiros.
title	String	Título do trabalho.
userAccount	String	Conta do Huawei Cloud Meeting.
userType	Integer	Tipo de usuário. 2: membro da empresa.
visionAccount	String	Conta exclusiva da TV inteligente.
vmrList	Array of UserVmrDTO objects	Lista de salas de reunião na nuvem.

Exemplo de solicitação

PUT /v1/usg/dcs/corp/member/3e48b79b660e403cb5e0208f7be83961?accountType=0
Connection: keep-alive
Content-Type: application/json
X-Access-Token: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9
Content-Length: 173
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "country": "chinaPR",
    "deptCode": "1",
    "desc": "modDesc",
    "email": "modEmail@huawei.com",
    "englishName": "modEnglishName",
    "hidePhone": true,
    "name": "modName",
    "phone": "123456789",
    "signature": "modSignature",
    "sortLevel": 1,
    "status": 1,
    "title": "modTitle",
    "vmrId": ""
}

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: 26701eb8f982b175b70776316d46e33e

{
    "activeTime": 1601221696783,
    "adminType": 2,
    "corp": null,
    "country": "chinaPR",
    "deptCode": "1",
    "deptName": "Root Department",
    "deptNamePath": "Root Department",
    "desc": "modDesc",
    "devType": {
        "deviceSize": null,
        "model": null,
        "purchaseChannel": null
    },
    "email": "modEmail@huawei.com",
    "englishName": "modEnglishName",
    "function": {
        "enableRoom": true
    },
    "hidePhone": true,
    "id": "f521bebcbb27422cb3241c4cb19942c5",
    "license": 0,
    "name": "modName",
    "phone": "+86123456789",
    "signature": "modSignature",
    "sipNum": "+8657198480",
    "sortLevel": 1,
    "status": 1,
    "thirdAccount": "thirdAccount",
    "title": "modTitle",
    "userAccount": "3e48b79b660e403cb5e0208f7be83961",
    "userType": 2,
    "visionAccount": null,
    "vmrList": [
        {
            "id": "2c908bc76f61a5f2016f61bbfdf5039b",
            "status": "0",
            "vmrId": "912992631",
            "vmrName": "name's cloud meeting room",
            "vmrPkgId": null,
            "vmrPkgLength": null,
            "vmrPkgName": null,
            "vmrPkgParties": null
        }
    ]
}

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: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9' -d '{"country": "chinaPR","deptCode": "1","desc": "modDesc","email": "modEmail@huawei.com","englishName": "modEnglishName","hidePhone": true,"name": "modName","phone": "123456789","signature": "modSignature","sortLevel": 1,"status": 1,"title": "modTitle","vmrId": ""}' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/member/3e48b79b660e403cb5e0208f7be83961?accountType=0

Tópico principal: APIs

Tópico anterior: Adição de um usuário

Próximo tópico: Consulta de detalhes de usuário