Crie um grupo de mensagens interativas.
Descrição da operação
Antes de chamar esta operação, certifique-se de ter chamado a operação CreateLiveMessageApp para criar uma aplicação de mensagens interativas.
Você pode criar até 5.000 grupos de mensagens interativas em uma aplicação de mensagens interativas.
Limite de QPS
Você pode chamar esta operação até 50 vezes por segundo por conta. O sistema descarta solicitações que excedem esse limite, o que causa 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 operaçã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 pelo prefixo * .
Se não for possível conceder permissões no nível do recurso, a coluna Tipo de recurso exibirá
All Resources.
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 das permissões necessárias nas operações associadas.
| Operação | Nível de acesso | Tipo de recurso | Chave de condição | Operação associada |
|---|---|---|---|---|
| live:CreateLiveMessageGroup | crie | *Rtc acs:live::{#accountId}:rtc/{#AppId} |
| nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
|
AppId |
string |
Sim |
ID da aplicação. |
demo |
|
GroupId |
string |
Sim |
ID do grupo a ser criado. O ID do grupo deve ser exclusivo na sua aplicação. O ID pode ter até 64 bytes e conter letras e dígitos. |
grouptest |
|
GroupName |
string |
Não |
Nome do grupo. O nome pode ter até 128 bytes. |
mytestgroup |
|
GroupInfo |
string |
Não |
Informações adicionais sobre o grupo. O valor pode ter até 32 KB. |
testgroupinfo |
|
Administrators |
array |
Não |
Lista de administradores. |
|
|
string |
Não |
ID do administrador. O ID pode ter até 64 bytes e conter letras e dígitos. Separe vários IDs de administrador com vírgulas (,). Você pode especificar até três IDs de administrador. |
uid1 |
|
|
CreatorId |
string |
Não |
ID do criador do grupo. O ID pode ter até 64 bytes e conter letras e dígitos. |
uid1 |
|
DataCenter |
string |
Não |
Data center. Deve corresponder ao data center especificado ao chamar a operação CreateLiveMessageApp para criar a aplicação 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. |
A8C7B033-B339-1A58-B0E0-7B9197BA**** |
|
GroupId |
string |
ID do grupo criado. |
grouptest |
|
AlreadyExists |
boolean |
Indica se o grupo já existe. |
true |
|
AlreadyDelete |
boolean |
Indica se o grupo foi excluído. Se o grupo existia e foi excluído, o ID do grupo fica indisponível. Recomendamos criar um novo grupo. |
true |
Exemplos
Exemplos de respostas de sucesso
Formato JSON
{
"RequestId": "A8C7B033-B339-1A58-B0E0-7B9197BA****",
"GroupId": "grouptest",
"AlreadyExists": true,
"AlreadyDelete": true
}
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 |
|
400 |
ErrorTooManyGroups |
%s. |
Para cada AppId, é permitido criar no máximo 5000 grupos simultaneamente. |
|
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, consulte os Códigos de erro do serviço.
Histórico de alterações
|
Data da alteração |
Resumo das alterações |
Operação |
|
2024-01-31 |
O código de erro foi alterado |