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

Observações de uso

Uma instância é uma máquina virtual (VM) que armazena informações sobre tópicos e grupos do Message Queue for Apache RocketMQ. Chame esta operação para criar recursos de serviço destinados aos negócios que você deseja implantar. Antes de chamar esta operação, observe os seguintes limites:

Cada região aceita no máximo oito instâncias do Message Queue for Apache RocketMQ.
Esta operação cria apenas instâncias da Standard Edition. Para criar instâncias da Standard Edition e da Enterprise Platinum Edition, use o console do Message Queue for Apache RocketMQ. Para mais detalhes sobre a criação de instâncias, consulte Gerencie instâncias.

Limite de QPS

Cada conta Alibaba Cloud pode chamar esta operação até 10 vezes por segundo. Se o número de requisições enviadas por segundo ultrapassar o limite de consultas por segundo (QPS), o sistema ativa o throttling, o que pode interromper seus negócios. Para mais informações, consulte Limites de QPS.

Autorização

Por padrão, apenas contas Alibaba Cloud podem chamar esta operação. Usuários do Resource Access Management (RAM) só conseguem executá-la após receberem a permissão necessária. A tabela a seguir descreve a permissão exigida para chamar esta operação. Para mais informações, consulte Políticas e exemplos.

API	Action	Resource
OnsInstanceCreate	mq:CreateInstance	acs:mq:::*

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	OnsInstanceCreate	A operação a ser executada. Defina o valor como OnsInstanceCreate.
Remark	String	Não	Description	A descrição da instância.
InstanceName	String	Sim	Test	Nome da instância. Configure este parâmetro conforme as regras abaixo: O nome deve ser exclusivo na região de implantação da instância. Deve ter entre 3 e 64 caracteres, podendo conter letras, dígitos, hifens (-), sublinhados (_) e caracteres chineses.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	A07E3902-B92E-44A6-B6C5-6AA111111****	ID da requisição. Trata-se de um parâmetro comum; cada requisição possui um ID exclusivo para auxiliar na solução de problemas.
Data	Object		Resultados retornados.
InstanceId	String	MQ_INST_188077086902****_BXSuW61e	ID da instância criada.
InstanceType	Integer	1	Edição da instância criada. Valor válido: 1: Standard Edition

Exemplos

Exemplos de requisições

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsInstanceCreate
&InstanceName=Test
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<OnsInstanceCreateResponse>
<Data>
    <InstanceId>MQ_INST_188077086902****_BXSuW61e</InstanceId>
    <InstanceType>1</InstanceType>
</Data>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsInstanceCreateResponse>

Formato JSON

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

{
  "Data" : {
    "InstanceId" : "MQ_INST_188077086902****_BXSuW61e",
    "InstanceType" : 1
  },
  "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 uma instância pelo console

Além de chamar a operação OnsInstanceCreate, crie uma instância diretamente pelo console do Message Queue for Apache RocketMQ. Para saber como usar o console na criação de instâncias, consulte Gerencie instâncias.