Todos os produtos
Search
Central de documentação

ApsaraMQ for RabbitMQ:CreateInstance

Última atualização: Aug 04, 2026

Cria uma instância do ApsaraMQ for RabbitMQ.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

amqp:CreateInstance

create

*All Resource

*

  • amqp:InstanceType
  • amqp:SupportEIP
  • amqp:ServerlessChargeType
Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ClientToken

string

Não

O token de cliente.

c2c5d1274axxxxxxxx

PaymentType

string

Sim

O tipo de pagamento. Valores válidos:

Valores válidos:

  • PayAsYouGo :

    PayAsYouGo.

  • Subscription :

    Subscription.

Subscription

Period

integer

Não

O período de assinatura. Unidade: periodCycle.

1

PeriodCycle

string

Não

A unidade do período de assinatura. Valores válidos:

Valores válidos:

  • Month :

    Month.

  • Year :

    Year.

Month

AutoRenew

boolean

Não

O método de renovação. Valores válidos:

false

AutoRenewPeriod

integer

Não

A época de renovação automática. A unidade é especificada pelo valor RenewalDurationUnit. Unidade padrão: mês.

1

RenewStatus

string

Não

O status de renovação. Este parâmetro é equivalente a autoRenew. Você só precisa configurar um deles. Valores válidos:

false

RenewalDurationUnit

string

Não

A unidade da época de renovação automática. Valores válidos:

Valores válidos:

  • Month :

    Month.

  • Year :

    Year.

Month

InstanceType

string

Não

O tipo de instância.

Valores válidos:

  • enterprise :

    enterprise.

  • vip :

    vip.

  • professional :

    professional.

professional

ServerlessChargeType

string

Não

O tipo de cobrança da instância serverless. Valores válidos:

onDemand

InstanceName

string

Não

O nome da instância. O nome pode ter até 64 caracteres.

amqp-xxxxx

MaxPrivateTps

integer

Não

O TPS de rede privada. Unidade: transações por segundo.

1000

SupportEip

boolean

Não

Especifica se o acesso à rede pública é suportado. Valores válidos:

true

MaxEipTps

integer

Não

O TPS máximo de rede pública. Unidade: TPS.

128

QueueCapacity

integer

Não

O número de filas. Unidade: contagem.

1000

MaxConnections

integer

Não

O número máximo de conexões.

50000

StorageSize

integer

Não

O espaço de armazenamento de mensagens. Unidade: GB. Valores válidos:

7

SupportTracing

boolean

Não

Especifica se deve ativar o recurso de rastreamento de mensagens. Valores válidos:

true

TracingStorageTime

integer

Não

O período de retenção para rastros de mensagens. Unidade: dias. Valores válidos:

3

ResourceGroupId

string

Não

O ID do grupo de recursos ao qual a instância pertence.

rg-acfmvvajg5qkxhi

EncryptedInstance

boolean

Não

Este recurso está disponível apenas para instâncias dedicadas. Especifica se deve ativar a criptografia de armazenamento de dados para a instância.

false

KmsKeyId

string

Não

Este recurso está disponível apenas para instâncias dedicadas. Este parâmetro é obrigatório quando EncryptedInstance é definido como true. O ID da chave KMS usada para criptografia de dados em repouso. A chave deve atender aos seguintes requisitos:

key-xxx

ProvisionedCapacity

integer

Não

A capacidade de TPS provisionada para instâncias reservadas + elásticas.

2000

Edition

string

Não

A arquitetura de implantação da instância serverless. Valores válidos:

shared

Tags

array<object>

Não

As tags de recurso.

object

Não

O objeto de tag.

Key

string

Não

A chave da tag de recurso.

testKey

Value

string

Não

O valor da tag de recurso.

testValue

VpcId

string

Sim

O ID da VPC usado para criar um endpoint PrivateLink.

vpc-xxx

VswitchIds

array

Sim

Os IDs de vSwitch usados para criar um endpoint PrivateLink ao criar uma instância.

string

Sim

O ID do vSwitch especificado ao criar a instância.

vsw-xxx

SecurityGroupId

string

Sim

O ID do grupo de segurança usado para criar um endpoint PrivateLink.

sg-xxx

ListenerMode

string

Não

Especifica se deve ativar apenas a porta criptografada por TLS para a instância. Este parâmetro é suportado apenas para instâncias Platinum e dedicadas reservadas + elásticas.

tcp_and_ssl

AuthModel

string

Não

O modo de autenticação. Valor padrão: Modo de autenticação RAM.

Valores válidos:

  • openSource :

    openSource.

  • ram :

    ram.

ram

ServerlessSwitch

boolean

Não

O switch elástico.

Os exemplos a seguir contêm apenas parâmetros obrigatórios. Configure outros parâmetros conforme necessário:

Comprar uma instância serverless pay-as-you-go:

Comprar uma instância serverless reservada + elástica (compartilhada):

> O intervalo de provisionedCapacity é [2000, 20000] com um tamanho de passo de 2000.

```json.

Comprar uma instância serverless reservada + elástica (dedicada):

> O intervalo de provisionedCapacity é [5000, 500000] com um tamanho de passo de 5000.

```json.

Comprar uma instância Enterprise:

> Valores válidos para MaxPrivateTps: 3000, 5000, 8000, 10000, 15000, 20000, 30000, 40000, 50000, 80000, 100000

```json.

Comprar uma instância Platinum:

> Valores válidos para MaxPrivateTps: 8000, 15000, 25000, 40000, 50000, 100000, 200000, 300000, 500000, 800000, 1000000

```json.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

JsonResult

RequestId

string

O parâmetro comum. Cada solicitação possui um ID exclusivo que é ativo para solução de problemas.

CCBB1225-C392-480E-8C7F-D09AB2CD2***

Code

integer

O código de resposta. Um valor de 200 indica sucesso.

200

Message

string

A mensagem de resposta.

xxx failed,xxxx

Data

any

O ID da instância criada.

amqp-cn-xxxxx

Success

boolean

Indica se a solicitação foi bem-sucedida.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "CCBB1225-C392-480E-8C7F-D09AB2CD2***",
  "Code": 200,
  "Message": "xxx failed,xxxx",
  "Data": "amqp-cn-xxxxx",
  "Success": true
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.