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

Adição de um departamento

Descrição

Esta API é usada por um administrador empresarial para adicionar um departamento. Até 10 níveis de departamentos com até 100 subdepartamentos em cada nível podem ser adicionados. Por padrão, uma empresa pode ter até 10.000 departamentos.

SLA

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

Atraso na solicitação TP99: 70 ms

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

Tabela 1 Protótipo

Método de solicitação

POST

Endereço de solicitação

/v1/usg/dcs/corp/dept

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

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.

deptCode

Não

String

Corpo

Código de departamento único na empresa. Se este parâmetro é transportado, o valor real é usado e não pode ser alterado.

O valor pode conter até 32 caracteres.

deptName

Sim

String

Corpo

Nome do departamento.

maxLength: 128

minLength: 1

parentDeptCode

Não

String

Corpo

Código do departamento de pais. O valor padrão é o código do departamento raiz.

Valor padrão: 1.

O valor pode conter até 32 caracteres.

note

Não

String

Corpo

Observações.

maxLength: 96

minLength: 0

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

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.

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.

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

Tabela 4 Parâmetros de resposta

Parâmetro

Tipo

Descrição

value

String

Código do departamento.

Exemplo de solicitação

POST /v1/usg/dcs/corp/dept
Connection: keep-alive
X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki
Content-Type: application/json
Content-Length: 31
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
     
{
    "deptName": "test999"
}

Exemplo de resposta

HTTP/1.1 200 
Date: Tue, 17 Dec 2019 09:32:47 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

{
    "value": "s4f"
}

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 POST -H 'X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki' -d '{"deptName": "test999"}' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/dept