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 sala de reunião na nuvem/ Consulta de salas de reunião em nuvem por página como um administrador empresarial
Atualizado em 2023-08-02 GMT+08:00
Ver PDF
Compartilhar

Consulta de salas de reunião em nuvem por página como um administrador empresarial

Descrição

Esta API é usada por um administrador empresarial para consultar salas de reunião em nuvem na empresa por página.

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/vmr

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

offset

Não

Integer

Consulta

Deslocamento de consulta. Se o valor exceder o número máximo de registros disponíveis, os registros na última página serão retornados.

Valor padrão: 0.

limit

Não

Integer

Consulta

Número de registros para consultar.

Valor padrão: 100

searchKey

Não

String

Consulta

Critérios de pesquisa. Pesquisa difusa com base no nome da sala de reunião na nuvem, ID da sala de reunião na nuvem e nome do usuário ou terminal físico ao qual a sala de reunião na nuvem está alocada é suportada.

status

Não

Integer

Consulta

Status da sala de reunião na nuvem. Se o valor for null, todas as salas de reunião na nuvem serão consultadas.

  • 0: normal.
  • 1: desativado.
  • 2: não alocado.

vmrMode

Não

Integer

Consulta

Modo de sala de reunião na nuvem. Se este parâmetro for deixado em branco, o modo é sala de reunião em nuvem por padrão.

  • 1: sala de reuniões em nuvem.
  • 2: webinar.

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

count

Integer

Número total de registros.

limit

Integer

Número de registros exibidos por página.

Valor padrão: 10.

offset

Integer

Número da página inicial da consulta. O valor começa em 0.

data

Array of QueryOrgVmrResultDTO objects

Lista de salas de reunião na nuvem.
Tabela 5 Estrutura de dados QueryOrgVmrResultDTO

Parâmetro

Tipo

Descrição

device

IdMarkDTO object

Terminal físico ao qual a sala de reunião em nuvem está alocada. O valor do parâmetro id é a conta de acesso de terminal físico.

id

String

Lista de salas de reunião na nuvem.

NOTA:

Ele corresponde ao vmrID na API para criar uma reunião.

member

IdMarkDTO object

Usuário ao qual a sala de reunião em nuvem está alocada. O valor do parâmetro id é a conta de usuário.

status

Integer

Status da sala de reunião na nuvem.

  • 0: normal.
  • 1: desativada.
  • 2: não alocada.

vmrId

String

ID da reunião fixo da sala de reunião na nuvem.

NOTA:

Ele corresponde a vmrConferenceID na resposta de chamar a API para criar uma reunião.

vmrName

String

Nome de sala de reunião na nuvem.

vmrPkgName

String

Nome do pacote da sala de reuniões na nuvem.

vmrPkgParties

Integer

Número de participantes simultâneos no pacote de sala de reuniões na nuvem.

maxAudienceParties

Integer

Número máximo de participantes (válido apenas para webinars).

expireDate

Long

Carimbo de data/hora de criação, em milissegundos.

commercialMaxAudienceParties

Integer

Número máximo de participantes nas especificações comerciais (válido apenas para webinars).
Tabela 6 Estrutura de dados IdMarkDTO

Parâmetro

Tipo

Descrição

id

String

ID único.

mark

String

Descrição correspondente ao valor do parâmetro id. Geralmente, o valor é um nome.

Exemplo de solicitação

GET /v1/usg/dcs/corp/vmr?searchKey=6767&offset=0&limit=10
Connection: keep-alive
X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF
Content-Type: application/json
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: 308
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: fbbc91569f0efed914e0427fc2a9c4ac 

{
   "count" : 1,
   "data" : [
      {
         "device" : {
            "id" : "22c1804004374b558084c50e44e77085",
            "mark" : "13456789"
         },
         "id" : "ff8080816c52e2a6016c53878f030030",
         "member" : {
            "id" : "nhl",
            "mark" : "nhl(nhl)"
         },
         "status" : 0,
         "vmrId" : "9*******7",
         "vmrName" : "Cloud meeting room",
         "vmrPkgName" : "Small cloud meeting room-10 participants",
         "vmrPkgParties" : 10,
         "maxAudienceParties": 1000,
         "commercialMaxAudienceParties": 1000,
         "expireDate": 1666195200000
      }
   ],
   "limit" : 10,
   "offset" : 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  -v -X GET -H  "X-Access-Token:cnrYgnb27xFYyyYu4HNdmZ0zJL8WcKc3M6ir"  "https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/vmr?searchKey=6767&offset=0&limit=10"