Criação de uma instância

project_id

String

Sim

Indica a ID de um projeto.

name

String

Sim

Indica o nome da instância.

Um nome de ocorrência começa com uma letra, tem de 4 a 64 caracteres e pode conter apenas letras, dígitos, (_), e hífens.

description

String

Não

Indica a descrição de uma instância.

É uma cadeia de caracteres que não contém mais de 1024 caracteres.

engine

String

Sim

Indica o motor de mensagens. Defina o valor para kafka.

engine_version

String

Sim

Indica a versão do motor de mensagens. Valor: 1.1.0 ou 2.3.0.

specification

String

Sim

Indica a largura de banda de linha de base de uma ocorrência de Kafka, ou seja, a quantidade máxima de dados transferidos por unidade de tempo. Unidade: MB

Opções:

• 100MB
• 300MB
• 600MB
• 1200MB

storage_space

Integer

Sim

Indica o espaço de armazenamento da mensagem.

Unidade: GB. Faixa de valor:

• Instância de Kafka com specification de 100MB: 600–90.000 GB
• Instância de Kafka com specification de 300MB: 1200–90.000 GB
• Instância de Kafka com specification de 600MB: 2400–90.000 GB
• Instância de Kafka com specification de 1200MB: 4800–90.000 GB

partition_num

Integer

Sim

Indica o número máximo de partições em uma ocorrência de Kafka.

Opções:

• Quando specification for 100MB: 300
• Quando specification é de 300MB: 900
• Quando specification é de 600MB: 1800
• Quando specification é de 1200 MB: 1800

access_user

String

Não

Este parâmetro é obrigatório quando ssl_enable é definido como true. Este parâmetro é inválido quando ssl_enable é definido como false.

Indica um nome de usuário. Um nome de usuário consiste de 4 a 64 caracteres e pode conter letras, dígitos e hífens (-).

password

String

Não

Este parâmetro é obrigatório quando ssl_enable é definido como true. Este parâmetro é inválido quando ssl_enable é definido como false.

Indica uma senha de instância.

A senha deve atender aos seguintes requisitos de complexidade:

• Deve ser uma string composta de 8 a 32 caracteres.
• Deve conter pelo menos três dos seguintes tipos de caracteres:
  • Letras minúsculas
  • Letras maiúsculas
  • Dígitos
  • Caracteres especiais `~!@#$%^&*()-_=+\|[{}];:',<.>/?

vpc_id

String

Sim

Indica o ID da VPC.

Obtenha o valor utilizando um dos seguintes métodos:

• Método 1: Faça login no console da VPC e visualize o ID da VPC nos detalhes da VPC.
• Método 2: Consulte o ID da VPC por meio da API da VPC. Para obter detalhes, consulte Consulta dos VPC.

security_group_id

String

Sim

Indica o grupo de segurança ao qual a instância pertence.

Obtenha o valor utilizando um dos seguintes métodos:

• Método 1: Faça login no console da VPC. Escolha Access Control > Security Groups no painel de navegação à esquerda. Na página exibida, clique no grupo de segurança de destino. Você pode exibir o ID do grupo de segurança na página exibida.
• Método 2: Chame a API para consultar grupos de segurança. Para obter detalhes, consulte Consulta dos grupos de segurança.

subnet_id

String

Sim

Indica a ID da sub-rede.

Obtenha o valor utilizando um dos seguintes métodos:

• Método 1: Faça login no console da VPC e clique na sub-rede de destino na página de guia Subnets. Você pode visualizar o ID da rede na página exibida.
• Método 2: Chame a API para consultar sub-redes. Para obter detalhes, consulte Consulta das sub-redes.

available_zones

Array

Sim

Indica o ID da AZ onde os corretores residem e que tem recursos disponíveis. O valor do parâmetro não pode ser um array vazio ou um array vazio. Para obter detalhes sobre como obter o valor, consulte Consulta das informações da AZ. Verifique se a AZ tem recursos disponíveis.

Ao criar uma instância do Kafka, você pode selecionar 1 AZ ou pelo menos 3 AZ. Ao especificar as AZ para corretores, use (,) de vírgulas para separar várias AZ. Exemplo de configurações de parâmetros:

• Uma AZ: "available_zones": [ "a0865121f83b41cbafce65930a22a6e8" ]
• Três ou mais AZ: "available_zones": ["a0865121f83b41cbafce65930a22a6e8","a0865121f83b41cbafce65930a22a6e7","a0865121f83b41cbafce65930a22a6e6"]

product_id

String

Sim

Indica o ID do produto.

Para obter detalhes sobre como obter o ID, consulte Consulta das especificações do produto.

kafka_manager_user

String

Sim

Indica o nome de usuário para fazer login no Gerenciador de Kafka. O nome de usuário consiste de 4 a 64 caracteres e pode conter letras, dígitos, hífens (-) e sublinhados (_).

kafka_manager_password

String

Sim

Indica a senha para efetuar login no Gerenciador de Kafka.

A senha deve atender aos seguintes requisitos de complexidade:

• Deve ser uma string composta de 8 a 32 caracteres.
• Deve conter pelo menos três dos seguintes tipos de caracteres:
  • Letras minúsculas
  • Letras maiúsculas
  • Dígitos
  • Caracteres especiais `~!@#$%^&*()-_=+\|[{}];:',<.>/?

maintain_begin

String

Não

Indica a hora em que uma janela de tempo de manutenção é iniciada.

Formato: HH:mm:ss

• A hora de início e a hora de término da janela de tempo de manutenção devem indicar o segmento de tempo de uma janela de tempo de manutenção suportada. Para obter detalhes sobre como consultar os segmentos de tempo das janelas de tempo de manutenção suportadas, consulte Consulta da janela de tempo de manutenção.
• A hora de início deve ser definida para 22:00:00, 02:00:00, 06:00:00, 10:00:00, 14:00:00 ou 18:00:00:00.
• Os parâmetros maintain_begin e maintain_end devem ser definidos em pares. Se o parâmetro maintain_begin for deixado em branco, o parâmetro maintain_end também será deixado em branco. Neste caso, o sistema define automaticamente a hora de início para 02:00:00.

maintain_end

String

Não

Indica a hora em que uma janela de tempo de manutenção termina.

Formato: HH:mm:ss

• A hora de início e a hora de término da janela de tempo de manutenção devem indicar o segmento de tempo de uma janela de tempo de manutenção suportada. Para obter detalhes sobre como consultar os segmentos de tempo das janelas de tempo de manutenção suportadas, consulte Consulta da janela de tempo de manutenção.
• A hora final é quatro horas mais tarde do que a hora de início. Por exemplo, se a hora de início for 22:00:00, a hora de término será 02:00:00.
• Os parâmetros maintain_begin e maintain_end devem ser definidos em pares. Se o parâmetro maintain_end for deixado em branco, o parâmetro maintain_start também estará em branco. Nesse caso, o sistema define automaticamente a hora de término para 06:00:00.

enable_publicip

Boolean

Não

Indica se deve ativar o acesso público para uma instância.

• true: ativar
• false: desativar

public_bandwidth

String

Não

Indica a largura de banda da rede pública. Unidade: Mbit/s

Faixa de valor:

• Quando specification é 100MB, o valor deve ser um múltiplo do número de corretores e cair no intervalo de 3 a 900.
• Quando specification é 300MB, o valor deve ser um múltiplo do número de corretores e cair no intervalo de 3 a 900.
• Quando specification é 600MB, o valor deve ser um múltiplo do número de corretores e cair no intervalo de 4 a 1200.
• Quando specification é 1200MB, o valor deve ser um múltiplo do número de corretores e cair no intervalo de 8 a 2400.

publicip_id

String

Não

Indica o ID do endereço IP elástico (EIP) vinculado a uma instância.

Use (,) de vírgulas para separar vários IDs EIP.

Esse parâmetro é obrigatório se o acesso público estiver habilitado (ou seja, enable_publicip estiver definido como true).

ssl_enable

Boolean

Não

Indica se deve ativar o acesso encriptado por SSL.

• true: ativar
• false: desativar

retention_policy

String

Não

Indica a ação a ser executada quando o uso da memória atingir o limite de capacidade do disco. Opções:

• time_base: Eliminar automaticamente as mensagens mais antigas.
• produce_reject: Pare de produzir novas mensagens.

connector_enable

Boolean

Não

Indica se deseja ativar o despejo.

enable_auto_topic

Boolean

Não

Indica se deseja ativar a criação automática de tópicos.

• true: ativar
• false: desativar

Se a criação automática de tópicos estiver ativada, um tópico será criado automaticamente com 3 partições e 3 réplicas quando uma mensagem for produzida ou consumida a partir de um tópico que não existe.

storage_spec_code

String

Sim

Indica a especificação de E/S de armazenamento. Para obter detalhes sobre como selecionar um tipo de disco, consulte Tipos de disco e desempenho.

Opções:

• dms.physical.storage.high ou dms.physical.storage.ultra quando o parâmetro specification for 100MB
• dms.physical.storage.high or dms.physical.storage.ultra quando o parâmetro specification for 300MB
• dms.physical.storage.ultra quando o parâmetro specification for 600MB
• dms.physical.storage.ultra quando o parâmetro specification for 1200MB

enterprise_project_id

String

Não

Indica a ID do projeto da empresa.

tags

Array<Object>

Não

Indica a lista de tags.

key

String

Não

Indica a chave da tag. Uma chave de etiqueta pode conter um máximo de 36 caracteres Unicode.

A chave não pode ser deixada em branco ou ser uma string vazia.

Não pode conter caracteres ASCII (0–31) não imprimíveis e os seguintes caracteres especiais: =*<>\,|/

value

String

Não

Indica o valor. Um valor de tag pode conter no máximo 43 caracteres Unicode.

O valor não pode ser deixado em branco ou ser uma string vazia.

Não pode conter caracteres ASCII (0–31) não imprimíveis e os seguintes caracteres especiais: =*<>\,|/

id_da_instância

String

Indica o ID da instância.

200

A instância foi criada com êxito.