OnsGroupCreate - : Central de Documentação do Alibaba Cloud

Observações de uso

Ao lançar um novo aplicativo ou implementar uma nova lógica de negócios, novos grupos são necessários. Chame esta operação para criar um grupo.

Limite de solicitações

Cada conta Alibaba Cloud pode chamar esta operação até 10 vezes por segundo. Se o número de solicitações enviadas em 1 segundo atingir o limite, as novas solicitações falharão. Isso pode interromper seus serviços. Para obter informações sobre os limites de solicitação de cada operação, consulte Limites de taxa da API.

Autorização

Por padrão, apenas contas Alibaba Cloud podem chamar esta operação. Um usuário do Resource Access Management (RAM) só poderá executá-la após receber as permissões necessárias. A tabela a seguir descreve as permissões que devem ser concedidas a um usuário RAM para chamar esta operação. Para saber como conceder permissões, consulte Políticas e exemplos.

API

Action

Resource

OnsGroupCreate

mq:QueryInstanceBaseInfo

mq:CreateGroup

acs:mq:::{instanceId}

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	OnsGroupCreate	A operação a ser executada. Defina o valor como OnsGroupCreate.
GroupId	String	Sim	GID_test_groupId	O ID do grupo a ser criado. Especifique o ID do grupo seguindo estas regras: O ID deve ter entre 2 e 64 caracteres e conter apenas letras, dígitos, hifens (-) e sublinhados (_). Se a instância do Message Queue for Apache RocketMQ onde o grupo será criado utilizar um namespace, o ID do grupo deverá ser exclusivo nessa instância. Ele não pode ser igual a um ID de grupo existente ou a um nome de tópico na mesma instância. No entanto, pode coincidir com um ID de grupo ou nome de tópico em outra instância que use namespace. Por exemplo, se a Instância A e a Instância B usarem namespaces diferentes, um ID de grupo na Instância A poderá ser igual a um ID de grupo ou nome de tópico na Instância B. Caso a instância não utilize namespace, o ID do grupo deve ser globalmente exclusivo em todas as instâncias e regiões. Ele não pode ser igual a nenhum ID de grupo ou nome de tópico existente nas instâncias do Message Queue for Apache RocketMQ da sua conta Alibaba Cloud. Nota Após a criação do grupo, o ID não pode ser alterado. Para verificar se uma instância usa namespace, faça login no console do Message Queue for Apache RocketMQ, acesse a página Instance Details e visualize o valor do campo Namespace na seção Basic Information.
Remark	String	Não	test	A descrição do grupo.
InstanceId	String	Sim	MQ_INST_111111111111_DOxxxxxx	O ID da instância do Message Queue for Apache RocketMQ onde você deseja criar o grupo.
GroupType	String	Não	tcp	O protocolo usado pelos clientes do grupo para se comunicarem com o broker do Message Queue for Apache RocketMQ. Todos os clientes de um grupo utilizam o mesmo protocolo. É necessário criar grupos distintos para clientes TCP e HTTP. Valores válidos: tcp: Os clientes do grupo publicam ou recebem mensagens via TCP. Este é o valor padrão. http: Os clientes do grupo publicam ou recebem mensagens via HTTP.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	A07E3902-B92E-44A6-B6C5-6AA111111****	O ID da solicitação. O sistema gera um ID exclusivo para cada solicitação. Use esse ID para solucionar problemas.

Exemplos

Exemplos de solicitações

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsGroupCreate
&GroupId=GID_test_groupId
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Remark=test
&GroupType=tcp
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<OnsGroupCreateResponse>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsGroupCreateResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A07E3902-B92E-44A6-B6C5-6AA111111****"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros da API.

Criar um grupo no console

Também é possível criar um grupo no console do Message Queue for Apache RocketMQ. Para mais informações, consulte Gerencie grupos.