Todos os produtos
Search
Central de documentação

ApsaraMQ for RocketMQ:Criar recursos

Última atualização: Jul 10, 2026

Antes de usar o SDK para enviar e receber mensagens, crie os recursos obrigatórios do ApsaraMQ for RocketMQ: uma instância, um tópico e um grupo de consumidores. Você também precisa do endpoint da instância. Especifique esses recursos no código do SDK.

Pré-requisitos

Informações básicas

Você pode criar recursos no console ou por meio de chamadas de API. O procedimento a seguir utiliza o console.

Para criar recursos usando a OpenAPI, consulte os tópicos abaixo:

Limites

  • Restrições de região

    Certifique-se de que a instância criada esteja na mesma região da VPC e do vSwitch configurados nos pré-requisitos.

  • Convenções de nomenclatura

    Para as convenções de nomenclatura de instâncias, tópicos e grupos de consumidores, consulte Cotas e limites.

  • Restrições de tipo de tópico

    O tipo de mensagem de um tópico deve corresponder ao tipo das mensagens enviadas e recebidas. Por exemplo, se você criar um tópico para mensagens normais, só poderá usá-lo para enviar e receber mensagens normais, e não mensagens ordenadas. Para mais informações, consulte Recomendações de uso de tópicos.

Criar uma instância

  1. Faça logon no console do ApsaraMQ for RocketMQ. No painel de navegação à esquerda, clique em Instances.

  2. Na barra de navegação superior, selecione uma região, por exemplo, China (Hangzhou).

  3. Na página Instances, clique em Create Instance. No painel Create Message Queue for Apache RocketMQ Instance, defina Instance Version como V5.0, selecione um Product Type e clique em OK.

    O ApsaraMQ for RocketMQ oferece suporte aos seguintes tipos de product:

    • Subscription: modelo pré-pago com cobrança mensal baseada na especificação de computação da instância.

    • Pay-as-you-go: modelo pós-pago com cobrança horária baseada na especificação de computação da instância.

    • Serverless: modelo de pagamento conforme o uso, com cobrança baseada no número total de solicitações de mensagens.

      Nota

      Instâncias Serverless estão disponíveis nas seguintes regiões: China (Hangzhou), China (Zhangjiakou), China (Beijing), China (Shenzhen), Singapore (Singapore), Germany (Frankfurt), US (Virginia) e US (Silicon Valley). Novas regiões serão adicionadas gradualmente. Para verificar a disponibilidade atual, consulte Regiões suportadas.

    Para detalhes sobre itens faturáveis e cenários aplicáveis, consulte Visão geral de faturamento.

  4. Na página de compra, selecione as especificações da instância, clique em Buy Now e conclua o pagamento.

    Consulte as tabelas abaixo ao criar uma instância. Para obter detalhes sobre cada parâmetro, veja Selecionar edição da instância.

    Serverless

    Parâmetro

    Valor de exemplo

    Primary Edition

    Standard

    Modo de faturamento

    O padrão é Pay-by-request.

    Especificação de armazenamento de mensagens

    Não é necessário selecionar uma capacidade de armazenamento. A cobrança ocorre com base no espaço de armazenamento realmente utilizado.

    VPC ID

    vpc-bp1cg09dua6sgh0

    ID da VPC criada nos pré-requisitos.

    Importante

    Após a criação da instância, não é possível alterar a VPC selecionada. Para mudar a VPC associada, libere a instância adquirida e compre uma nova.

    vSwitch ID

    vsw-bp1vqb0p9nz3irz

    ID do vSwitch criado nos pré-requisitos.

    Selecione dois vSwitch ID para uma instância Serverless.

    Importante

    Após a criação da instância, não é possível alterar o vSwitch selecionado. Para modificar o vSwitch associado, libere a instância adquirida e compre uma nova.

    Internet Access

    Off

    Nota
    • Este procedimento usa acesso via VPC como exemplo; portanto, o acesso à Internet fica desativado por padrão. Para acessar o service pela Internet, defina Internet Access Type como Enabled.

    Tipo de acesso à rede interna

    O padrão é Pay-By-Data-Transfer.

    Instâncias Serverless oferecem suporte apenas a acesso via VPC, sem suporte a acesso pela Internet.

    Resource Group

    Selecione o grupo de recursos padrão.

    Security Group

    Selecione o grupo de segurança criado durante os pré-requisitos.

    Subscription ou pay-as-you-go

    Parâmetro

    Valor de exemplo

    Primary Edition

    Standard

    Edição de subcategoria

    Cluster High-availability Edition (Recomendado para ambientes de produção)

    Especificação de computação para envio e recebimento de mensagens

    rmq.s2.2xlarge

    VPC ID

    vpc-bp1cg09dua6sgh0

    ID da VPC criada nos pré-requisitos.

    Importante

    Após a criação da instância, não é possível alterar a VPC selecionada. Para mudar a VPC associada, libere a instância adquirida e compre uma nova.

    vSwitch ID

    vsw-bp1vqb0p9nz3irz

    ID do vSwitch criado nos pré-requisitos.

    Importante

    Após a criação da instância, não é possível alterar o vSwitch selecionado. Para mudar o vSwitch associado, libere a instância adquirida e compre uma nova.

    Tipo de acesso público

    Off

    Nota

    Este procedimento usa acesso via VPC como exemplo; portanto, o acesso à Internet fica desativado por padrão. Para acessar o service pela Internet, defina o Internet access type como Enabled.

    Resource Group

    Selecione o grupo de recursos padrão.

    Disk Encryption

    Off

    Nota

    A criptografia de disco tem suporte apenas para instâncias Platinum Edition.

    Disk Encryption Key

    key-hzz66c8207****

    Nota

    ID da chave usada para criptografia de disco na mesma região. Este parâmetro é necessário apenas quando Disk Encryption estiver definido como Enable.

Obter o endpoint da instância

  1. Na página Instances, clique no nome da instância desejada.

  2. Na página Instance Details, visualize as informações de endpoint na seção TCP Endpoint.

    • Endpoint de VPC: use este endpoint para acessar o ApsaraMQ for RocketMQ a partir de uma VPC. Ele é fornecido por padrão.

    • Endpoint público: use este endpoint para acessar o service pela Internet. Esta opção aparece apenas se o acesso público estiver ativado.

Obter o nome de usuário e a senha da instância

Nota

As etapas a seguir mostram como obter o nome de usuário e a senha do sistema usando o método de controle de acesso padrão: autenticação inteligente.

Caso prefira usar a autenticação por lista de controle de acesso (ACL), crie um usuário ACL, configure as permissões e utilize o nome de usuário e a senha da ACL. Para mais informações, consulte Autenticação de usuário.

Ao conectar um cliente ao servidor do ApsaraMQ for RocketMQ, configure o nome de usuário e a senha de acordo com o método de acesso.

  • Acesso via Internet: configure obrigatoriamente o nome de usuário e a senha da instância.

  • Acesso via VPC: para instâncias Serverless, as credenciais não são necessárias se o acesso sem autenticação estiver ativado. Para outros tipos de instância, a autenticação é automática e não exige credenciais.

  1. Na página Instances, clique no nome da instância desejada.

  2. No painel de navegação à esquerda, clique em Access Control.

  3. Clique na aba Intelligent Authentication para visualizar o Username e a Password da instância.

Criar um tópico

  1. Na página Instances, clique no nome da instância desejada.

  2. No painel de navegação à esquerda, clique em Topics. Em seguida, na página Topics, clique em Create Topic.

  3. No painel Create Topic, insira um nome e uma descrição para o tópico, defina Message Type como Normal Message e clique em OK.

Criar um grupo de consumidores

  1. Na página Instances, clique no nome da instância desejada.

  2. No painel de navegação à esquerda, clique em Groups. Em seguida, na página Groups, clique em Create Group.

  3. No painel Create Group, insira um Group ID, mantenha os demais parâmetros com as configurações padrão e clique em OK.

Próximas etapas

Etapa 3: Usar um SDK para enviar e receber mensagens