Consulta se um ou mais usuários especificados estão online.
Descrição da operação
Esta operação permite até 50 chamadas por segundo por conta. O sistema descarta solicitações que excedem esse limite, o que pode causar interrupções no serviço. Considere essa restrição ao chamar esta API.
Depuração
Informações de autorização
A tabela a seguir apresenta as informações de autorização correspondentes à API. Use essas informações no elemento de política Action para conceder permissões a um usuário RAM ou função RAM e permitir a chamada desta operação de API. Descrição:
Operação: valor usado no elemento Action para especificar a ação sobre um recurso.
Nível de acesso: nível de acesso de cada operação. Os níveis incluem leitura, gravação e listagem.
-
Tipo de recurso: tipo de recurso no qual é possível autorizar o usuário RAM ou a função RAM a executar a operação. Observe os seguintes pontos:
Tipos de recurso obrigatórios são indicados com o prefixo * .
Se não for possível conceder permissões no nível do recurso, use
All Resourcesna coluna Tipo de recurso da operação.
Chave de condição: chave de condição definida pelo serviço de nuvem.
Operação associada: outras operações que exigem permissão do usuário RAM ou da função RAM para concluir a ação principal. Para finalizar a operação, o usuário ou a função deve ter permissões para executar as operações associadas.
| Operação | Nível de acesso | Tipo de recurso | Chave de condição | Operação associada |
|---|---|---|---|---|
| live:CheckLiveMessageUsersOnline | none | *Domain acs:live:*:{#accountId}:domain/{#DomainName} |
| none |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
|
AppId |
string |
Sim |
ID do aplicativo. |
demo |
|
UserIds |
array |
Sim |
Lista de usuários a consultar. |
|
|
string |
Sim |
ID do usuário. Separe vários IDs de usuário por vírgulas (,). É possível consultar de 1 a 10 usuários em cada chamada. |
uid |
|
|
DataCenter |
string |
Não |
Data center. Deve corresponder ao data center especificado na chamada da operação CreateLiveMessageApp usada para criar o aplicativo de mensagens interativas. Valores válidos: cn-shanghai e ap-southeast-1 (Singapura). |
cn-shanghai |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Descrição |
Exemplo |
|
object |
|||
|
RequestId |
string |
ID da solicitação. |
178F572F-AECF-100B-937A-B8047B4D**** |
|
UserList |
array |
Lista de usuários consultados. |
|
|
Users |
object |
||
|
Online |
boolean |
Indica se o usuário está online. |
false |
|
UserId |
string |
ID do usuário. |
uid1 |
Exemplos
Exemplos de respostas de sucesso
Formato JSON
{
"RequestId": "178F572F-AECF-100B-937A-B8047B4D****",
"UserList": [
{
"Online": false,
"UserId": "uid1"
}
]
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
InputInvalid |
%s. |
Parâmetros de entrada inválidos |
|
403 |
NoAuth |
%s. |
Sem permissão |
|
404 |
ResourceNotExist |
%s. |
O recurso solicitado não existe; verifique e tente novamente |
|
500 |
ServerError |
%s. |
Erro desconhecido; tente novamente mais tarde ou envie um ticket para consulta. |
Para obter uma lista completa de códigos de erro, acesse os Códigos de erro do serviço.
For a list of error codes, visit the Service error codes.
Histórico de alterações
|
Data da alteração |
Resumo das alterações |
Operação |
Nenhum histórico de alterações