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 departamento/ APIs/ Modificação de um departamento
Atualizado em 2023-08-02 GMT+08:00
Ver PDF

Modificação de um departamento

Descrição

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

SLA

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

Atraso na solicitação TP99: 657 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/dept/{dept_code}

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

deptCode

Sim

String

Caminho

Código do departamento.

O valor pode conter até 32 caracteres.

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.

deptName

Não

String

Corpo

Nome do departamento.

maxLength: 128

minLength: 1

designatedOutDeptCodes

Não

Array of strings

Corpo

Lista de departamentos que podem ser acessados. Este parâmetro é válido somente quando outPermission é definido como DESIGNATED_DEPARTMENT. Até 150 departamentos podem ser configurados.

inPermission

Não

String

Corpo

Permissões de usuários em outros departamentos para acessar detalhes de usos neste departamento.

  • UNLIMITED: não restrito. Este é o valor padrão.
  • OPEN: detalhes de usuários neste departamento são acessíveis a outros departamentos (independentemente das configurações de permissão de outros).

note

Não

String

Corpo

Observações.

maxLength: 96

minLength: 0

outPermission

Não

String

Corpo

Permissões de usuários neste departamento para acessar detalhes de usos em outros departamentos.

  • UNLIMITED: não restrito.
  • ONLY_SELF: os usuários deste departamento só podem consultar detalhes sobre si mesmos.
  • SELF_AND_CHILD_DEPARTMENT: os usuários do departamento podem consultar detalhes do departamento e seus subdepartamentos.
  • DESIGNATED_DEPARTMENT: os usuários deste departamento podem consultar detalhes de departamentos específicos.

parentDeptCode

Não

String

Corpo

Código do departamento pai.

O valor pode conter até 32 caracteres.

sortLevel

Não

Integer

Corpo

Número de sequência do departamento. Um departamento com um número de sequência menor é exibido primeiro.

Mínimo: 1

Máximo: 10000

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/dept/s4f
Connection: keep-alive
X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki
Content-Type: application/json
Content-Length: 53
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) 

{
    "deptName": "111111",
    "note": "string"
}

Exemplo de resposta

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

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: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki' -d '{"deptName": "111111","note": "string"}' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/dept/s4f
Tópico principal: APIs