Consulta o status de silenciamento de usuários.
Descrição da operação
Antes de chamar esta operação, certifique-se de ter chamado a operação CreateLiveMessageGroup para criar um grupo de mensagens interativas.
Limite de QPS
Você pode chamar esta operação até 50 vezes por segundo por conta. Solicitações que excedem esse limite são descartadas, causando interrupções no serviço. Considere esse limite ao chamar esta operação.
Depuração
Informações de autorização
A tabela a seguir mostra 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. Descrição:
Operação: valor usado no elemento Action para especificar a ação em um recurso.
Nível de acesso: nível de acesso de cada operação. Os níveis são leitura, escrita e listagem.
-
Tipo de recurso: tipo de recurso no qual você autoriza o usuário RAM ou a função RAM a executar a operação. Observe os seguintes itens:
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 definida pelo serviço de nuvem.
Operação associada: outras operações que o usuário RAM ou a função RAM deve ter permissão para executar. Para concluir a operação principal, o usuário RAM ou a função RAM precisa 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:DescribeLiveMessageGroupBand | get | *Rtc acs:live::{#accountId}:rtc/{#AppId} |
| nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
|
AppId |
string |
Sim |
O ID do aplicativo. |
demo |
|
GroupId |
string |
Sim |
O ID do grupo de mensagens interativas. |
grouptest |
|
DataCenter |
string |
Não |
O data center. Deve ser igual ao data center especificado quando você chamou a operação CreateLiveMessageApp 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 |
Os parâmetros de resposta. |
||
|
RequestId |
string |
O ID da solicitação. |
021D1FE7-2E87-16AC-9364-4E7EA47C**** |
|
GroupId |
string |
O ID do grupo. |
grouptest |
|
BannedUserList |
array |
A lista de usuários silenciados individualmente, sem silenciar todo o grupo. |
|
|
BannedUsers |
string |
Os IDs dos usuários. |
["uid1","uid2"] |
|
UnbannedUserList |
array |
A lista de usuários não silenciados quando todo o grupo foi silenciado. |
|
|
UnbannedUsers |
string |
Os IDs dos usuários. |
["uid3"] |
|
IsbannedAll |
boolean |
Indica se todos os usuários no grupo de mensagens interativas estão silenciados. |
false |
Exemplos
Exemplos de respostas de sucesso
Formato JSON
{
"RequestId": "021D1FE7-2E87-16AC-9364-4E7EA47C****",
"GroupId": "grouptest",
"BannedUserList": [
[
"uid1",
"uid2"
]
],
"UnbannedUserList": [
[
"uid3"
]
],
"IsbannedAll": false
}
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 suporte. |
Para obter uma lista de códigos de erro, visite Códigos de erro do serviço.
Histórico de alterações
|
Data da alteração |
Resumo das alterações |
Operação |
Sem histórico de alterações