Remove usuários de um canal.
Descrição da operação
Use esta operação para remover um ou mais usuários de um canal.
Limite de QPS
Você pode chamar esta operação até 100 vezes por segundo por conta. O sistema descarta solicitações que excedem esse limite, o que pode causar interrupções no serviço. Considere esse limite ao chamar esta operação.
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 a um usuário RAM ou função RAM as permissões necessárias para chamar esta operação da API. Descrição:
Operação: valor usado no elemento Action para especificar a operação em 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 você autoriza o usuário RAM ou a função RAM a executar a operação. Observe os seguintes pontos:
Tipos de recursos obrigatórios são indicados com o prefixo * .
Se não for possível conceder permissões no nível do recurso, a coluna Tipo de recurso da operação exibirá
All Resources.
Operação associada: outras operações que o usuário RAM ou a função RAM precisam ter permissão para executar a fim de concluir a operação principal. Para concluir a operação, é necessário possuir permissões também nas operações associadas.
Chave de condição: chave de condição definida pelo serviço de nuvem.
| Operation | Access level | Resource type | Condition key | Associated operation |
|---|---|---|---|---|
| live:RemoveTerminals | none | *Rtc acs:live:*:{#accountId}:rtc/{#AppId} |
| none |
Parâmetros da solicitação
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| AppId | string | Yes | ID do aplicativo. Especifique apenas um ID de aplicativo por solicitação. | aec**** |
| ChannelId | string | Yes | ID do canal. Especifique apenas um ID de canal por solicitação. | testId |
| TerminalIds | array | Yes | IDs dos usuários a serem removidos. | |
| string | Yes | IDs dos usuários a serem removidos. Valores válidos de N: 1 a 30. Formato: | 1811**** |
Parâmetros de resposta
| Parameter | Type | Description | Example |
|---|---|---|---|
| object | |||
| RequestId | string | ID da solicitação. | 16A96B9A-F203-4EC5-8E43-CB92E68F4AF8 |
| Terminals | array<object> | Informações sobre os usuários. | |
| Terminal | object | ||
| Code | integer | Código de status retornado. O valor 0 indica sucesso na solicitação. Em caso de falha, o sistema retorna uma mensagem de erro. | 0 |
| Message | string | Resultado da remoção dos usuários especificados do canal. Valores válidos:
| Success |
| Id | string | ID do usuário. | 1811**** |
Exemplos
Exemplo de respostas de sucesso
Formato JSON
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4AF8",
"Terminals": [
{
"Code": 0,
"Message": "Success",
"Id": "1811****"
}
]
}
Códigos de erro
|
HTTP status code |
Error code |
Error message |
Description |
|
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, consulte os Códigos de erro do serviço.
Histórico de alterações
|
Change time |
Summary of changes |
Operation |
|
2024-10-18 |
O código de erro foi alterado |
|
|
2023-08-31 |
O código de erro foi alterado |