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

Observações de uso

Utilize esta operação para criar um tópico ao lançar uma nova aplicação ou expandir seus negócios.

Limite de QPS

O limite de consultas por segundo (QPS) desta operação é de 10 por usuário. Chamadas que excedem esse limite são limitadas. Para evitar que a limitação afete seus negócios, chame esta operação em uma taxa razoável. Para mais informações, consulte Limites de QPS.

Autorização

Por padrão, apenas contas Alibaba Cloud podem chamar esta operação. Para permitir que um usuário do Resource Access Management (RAM) a utilize, conceda as permissões necessárias a esse usuário. A tabela a seguir lista as permissões exigidas para chamar esta operação. Para mais informações, consulte Políticas e exemplos.

API

Action

Resource (with namespace)

Resource (without namespace)

OnsTopicCreate

mq:QueryInstanceBaseInfo

mq:CreateTopic

acs:mq:::{instanceId}%{topic}

acs:mq:::{topic}

Parâmetros da solicitação

Nome	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	OnsTopicCreate	Parâmetro obrigatório. Defina o valor como OnsTopicCreate.
Topic	String	Sim	test	Nome do tópico a ser criado. O nome deve atender aos seguintes requisitos: Deve ter entre 3 e 64 caracteres, contendo apenas letras, dígitos, hifens (-) e sublinhados (_). Não pode começar com CID ou GID, pois esses prefixos são reservados para IDs de grupo. Caso a instância onde o tópico será criado possua um namespace, o nome deve ser único dentro dessa instância. Ele não pode ser igual a um nome de tópico ou ID de grupo já existente na mesma instância. Nomes de tópicos podem se repetir em instâncias diferentes. Por exemplo, um tópico na Instância A pode ter o mesmo nome que um tópico ou ID de grupo na Instância B. Se a instância não possuir um namespace, o nome do tópico deve ser globalmente único em todas as instâncias e regiões. Não é permitido reutilizar nomes de tópicos ou IDs de grupo existentes. Nota Para verificar se uma instância possui um namespace, acesse a página Instance Details no console do Message Queue for RocketMQ e consulte a seção Basic Information.
MessageType	Integer	Sim	0	Tipo da mensagem. Valores válidos: 0: mensagem normal 1: mensagem parcialmente ordenada 2: mensagem globalmente ordenada 4: mensagem transacional 5: mensagem agendada e atrasada Para mais detalhes sobre os tipos de mensagem, consulte Tipos de mensagem.
Remark	String	Não	Test	Descrição do tópico.
InstanceId	String	Sim	MQ_INST_188077086902****_BXSuW61e	ID da instância onde o tópico será criado.

Dados retornados

Nome	Tipo	Exemplo	Descrição
RequestId	String	B6949B58-223E-4B75-B4FE-7797C15E****	ID da solicitação. Este identificador é exclusivo para cada solicitação. Utilize-o para solucionar problemas.

Exemplos

Exemplo de solicitação

http(s)://ons.cn-zhangjiakou.aliyuncs.com/?Action=OnsTopicCreate
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&MessageType=0
&Topic=test
&<Common request parameters>

Exemplo de resposta

Formato XML

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

<OnsTopicCreateResponse>
<RequestId>B6949B58-223E-4B75-B4FE-7797C15E****</RequestId>
</OnsTopicCreateResponse>

Formato JSON

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

{
  "RequestId" : "B6949B58-223E-4B75-B4FE-7797C15E****"
}

Códigos de erro

Para mais informações sobre códigos de erro, consulte a Central de Erros da API.

Operações no console

Além de chamar a operação OnsTopicCreate, você também pode criar um tópico diretamente no console do Message Queue for RocketMQ. Para mais informações, consulte Gerencie tópicos.