Consulta de recursos da empresa por página como um administrador de SP
Descrição
Esta API é usada por um SP para consultar recursos da empresa que correspondem a condições específicas.
Depuração
Você pode depurar essa API no API Explorer.
Protótipo
Método de solicitação |
GET |
---|---|
Endereço de solicitação |
/v1/usg/dcs/sp/corp/{corp_id}/resource |
Protocolo de transporte |
HTTPS |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Localização |
Descrição |
---|---|---|---|---|
corp_id |
Sim |
String |
Caminho |
ID da empresa. |
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: 10. |
searchKey |
Não |
String |
Consulta |
Critérios de pesquisa. |
startExpireDate |
Não |
Integer |
Consulta |
Se este parâmetro for especificado, os recursos cuja hora de expiração é posterior à data especificada serão consultados. |
endExpireDate |
Não |
Integer |
Consulta |
Se este parâmetro for especificado, os recursos cuja hora de expiração é anterior à data especificada serão consultados. |
type |
Não |
String |
Consulta |
Tipo de recurso. |
typeId |
Não |
String |
Consulta |
ID do tipo de recurso. Por exemplo, se você quiser consultar salas de reunião na nuvem de cinco participantes, defina esse parâmetro como o ID do pacote de salas de reunião na nuvem de cinco participantes. |
status |
Não |
Integer |
Consulta |
Status do recurso.
|
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
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
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 QueryResourceResultDTO objects |
Detalhes do usuário empresarial. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
count |
Integer |
Quantidade de recursos. |
editable |
Boolean |
Se um recurso pode ser editado ou excluído. Se o valor for false, os botões para modificar ou excluir recursos devem estar ocultos na GUI. |
expireDate |
Long |
Hora UTC quando o recurso expira. |
id |
String |
Identifica exclusivamente um recurso. Se a solicitação carrega esse parâmetro, o valor do parâmetro é usado. Caso contrário, o back-end gera automaticamente um UUID. |
status |
Integer |
Status do recurso. |
type |
String |
Tipo de recurso. |
typeDesc |
String |
Descrição do tipo de recurso. Por exemplo, se o tipo de recurso for pacote de sala de reunião na nuvem, o valor desse parâmetro será o nome do pacote de sala de reunião na nuvem. |
typeId |
String |
ID do tipo de recurso. Por exemplo, se o tipo de recurso for pacote de sala de reunião na nuvem, o valor desse parâmetro será o ID do pacote de sala de reunião na nuvem. |
vmrMode |
Integer |
Modo de sala de reunião na nuvem.
|
orderId |
String |
ID do pedido correspondente ao recurso. |
Exemplo de solicitação
GET /v1/usg/dcs/sp/corp/818803911/resource?offset=0&limit=5&searchKey=&startExpireDate=&endExpireDate=&type=&typeId=&status=0 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: 1329 Connection: keep-alive Pragma: No-cache Cache-Control: no-cache Server: api-gateway X-Request-Id: 63facce44898efa03629afd189da7f0f { "count": 1, "data": [ { "count": 10, "editable": true, "expireDate": 2549030400000, "id": "b974dfbe2daf456880afd10c80d12c9f", "status": 0, "type": "VMR", "typeDesc": null, "typeId": "ff808081699b56cb0169c411a0980152" } ], "limit": 5, "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 -X GET -H 'X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF' https://api.meeting.huaweicloud.com/v1/usg/dcs/sp/corp/818803911/resource?offset=0&limit=5&searchKey=&startExpireDate=&endExpireDate=&type=&typeId=&status=0