:Criar uma instância

A operação a ser executada. Defina o valor como CreateDBInstance.

O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

O mecanismo de banco de dados da instância. Valores válidos:

• MySQL
• SQLServer
• PostgreSQL
• MariaDB

A versão do mecanismo de banco de dados da instância.

• Valores válidos quando o parâmetro Engine é definido como MySQL: 5.5, 5.6, 5.7 e 8.0
• Valores válidos quando o parâmetro Engine é definido como SQLServer: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha e 2019_ent
• Valores válidos quando o parâmetro Engine é definido como PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0 e 15.0
• Valores válidos quando o parâmetro Engine é definido como MariaDB: 10.3

O tipo da instância. Para mais informações, consulte Tipos de instância primária do ApsaraDB RDS. Você também pode chamar a operação DescribeAvailableResource para consultar os tipos de instância disponíveis em uma região.

A capacidade de armazenamento da instância. Unidade: GB. É possível aumentar a capacidade de armazenamento em incrementos de 5 GB. Para mais informações, consulte Tipos de instância primária do ApsaraDB RDS. Você também pode chamar a operação DescribeAvailableResource para consultar o intervalo de capacidade de armazenamento suportado para um tipo de instância específico em uma região.

O conjunto de caracteres usado pela instância. Este parâmetro está obsoleto.

O tipo de conexão de rede à instância. Valores válidos:

• Internet: Internet
• Intranet: rede interna

O nome da instância. O nome deve ter entre 2 e 255 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Deve começar com uma letra.

A lista de permissões de endereços IP da instância. Para mais informações, consulte Usar um cliente de banco de dados ou a CLI para conectar-se a uma instância do ApsaraDB RDS for MySQL. Se a lista de permissões de endereços IP contiver mais de uma entrada, separe-as com vírgulas (,). Cada entrada deve ser única. A lista de permissões de endereços IP pode conter até 1.000 entradas. As entradas devem estar em um dos seguintes formatos:

• Endereços IP, como 10.10.XX.XX.
• Blocos CIDR, como 10.10.XX.XX/24. Neste exemplo, 24 indica que o prefixo de cada endereço IP na lista de permissões tem 24 bits. Substitua 24 por um valor no intervalo de 1 a 32.

O token do cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas garanta que ele seja único entre solicitações diferentes. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres.

O método de faturamento da instância. Valores válidos:

• Postpaid: pagamento conforme o uso.
• Prepaid: assinatura.
• Serverless: serverless. Este valor é suportado apenas para instâncias que executam MySQL. Para mais informações, consulte Visão geral.

O ID da zona da instância primária.

O ID da zona da instância secundária. Se definir o parâmetro ZoneIdSlave1 com o mesmo valor do parâmetro ZoneId, o método de implantação de zona única será usado. Se definir o parâmetro ZoneIdSlave1 com um valor diferente do parâmetro ZoneId, o método de implantação multizona será usado.

O ID da zona da instância de log. Se definir o parâmetro ZoneIdSlave2 com o mesmo valor do parâmetro ZoneId, o método de implantação de zona única será usado. Se definir o parâmetro ZoneIdSlave2 com um valor diferente do parâmetro ZoneId, o método de implantação multizona será usado.

O tipo de rede da instância. Valores válidos:

• VPC.
• Classic: rede clássica. Este é o valor padrão.

O modo de conexão da instância. Valores válidos:

• Standard: modo padrão
• Safe: modo de proxy de banco de dados

O sistema atribui automaticamente um modo de conexão à instância.

O ID da VPC.

O ID do vSwitch. O vSwitch deve pertencer à zona especificada pelo parâmetro ZoneId.

O endereço IP privado da instância. O endereço IP privado deve estar dentro do bloco CIDR suportado pelo vSwitch especificado. O ApsaraDB RDS atribui automaticamente um endereço IP privado à instância com base nos valores dos parâmetros VPCId e vSwitchId.

A duração da assinatura da instância. Valores válidos:

• Se definir o parâmetro Period como Year, o valor do parâmetro UsedTime varia de 1 a 5.
• Se definir o parâmetro Period como Month, o valor do parâmetro UsedTime varia de 1 a 11.

A unidade da duração da assinatura. Valores válidos:

• Year
• Month

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

O tipo de armazenamento da instância. Valores válidos:

• local_ssd: SSD local. Este é o tipo de armazenamento recomendado.
• cloud_ssd: SSD padrão. Este tipo de armazenamento não é recomendado. SSDs padrão não estão mais disponíveis para compra em algumas regiões da Alibaba Cloud.
• cloud_essd: ESSD de nível de desempenho 1 (PL1).
• cloud_essd2: ESSD de PL2.
• cloud_essd3: ESSD de PL3.

• Se o tipo de instância especificar o armazenamento SSD local, o valor padrão deste parâmetro será local_ssd.
• Se o tipo de instância especificar o armazenamento SSD padrão ou ESSD, o valor padrão deste parâmetro será cloud_essd.

Informações comerciais adicionais sobre a instância.

O ID da chave usada para criptografia de disco na região onde a instância reside. Se especificar o parâmetro EncryptionKey, a criptografia de disco será ativada automaticamente. Nesse caso, também será necessário especificar o parâmetro RoleARN. Não é possível desativar a criptografia de disco após a ativação.

Obtenha o ID da chave no console do Key Management Service (KMS). Também é possível criar uma chave. Para mais informações, consulte Criar uma CMK.

O Alibaba Cloud Resource Name (ARN) fornecido pela sua conta da Alibaba Cloud para usuários do RAM. Usuários do RAM podem usar o ARN para conectar o ApsaraDB RDS ao KMS. Chame a operação CheckCloudResourceAuthorized para consultar o ARN.

Especifica se a renovação automática deve ser ativada para a instância. Especifique este parâmetro apenas quando a instância usar o método de faturamento por assinatura. Valores válidos:

• true: ativa o recurso.
• false: desativa o recurso.

A edição do RDS da instância. Valores válidos:

• Basic: ApsaraDB RDS Basic Edition

• HighAvailability: ApsaraDB RDS High-availability Edition

• AlwaysOn: ApsaraDB RDS Cluster Edition para SQL Server
• Finance: ApsaraDB RDS Enterprise Edition
• serverless_basic: ApsaraDB RDS Serverless Basic Edition

  Nota Para criar uma instância serverless, use este valor.

O ID do cluster dedicado ao qual a instância pertence.

Se criar a instância em um cluster dedicado, especifique este parâmetro.

O ID do host ao qual a instância no cluster dedicado pertence.

Se criar a instância em um cluster dedicado, especifique este parâmetro. Se não especificar este parâmetro, o sistema atribuirá automaticamente um host.

O ID do host ao qual a instância secundária no cluster dedicado pertence.

Se a instância executar o ApsaraDB RDS High-availability Edition ou o ApsaraDB RDS Enterprise Edition e você criar a instância em um cluster dedicado, especifique este parâmetro. Se não especificar este parâmetro, o sistema atribuirá automaticamente um host.

O ID do host ao qual a instância de log no cluster dedicado pertence.

Se a instância executar o ApsaraDB RDS Enterprise Edition e você criar a instância em um cluster dedicado, especifique este parâmetro. Se não especificar este parâmetro, o sistema atribuirá automaticamente um host.

O ID do modelo de parâmetros. Chame a operação DescribeParameterGroups para consultar o ID do modelo de parâmetros.

O fuso horário da instância. Este parâmetro entra em vigor apenas quando o parâmetro Engine é definido como MySQL ou PostgreSQL.

• Se definir o parâmetro Engine como MySQL:
  • O fuso horário da instância está em UTC. Valores válidos: de -12:59 a +13:00.
  • Se a instância usar SSDs locais, especifique o nome do fuso horário. Por exemplo, especifique o fuso horário Asia/Hong_Kong. Para mais informações, consulte Fusos horários.
• Se definir o parâmetro Engine como PostgreSQL:
  • O fuso horário da instância não está em UTC. Para mais informações, consulte Fusos horários.
  • Especifique este parâmetro apenas quando a instância executar PostgreSQL com SSDs padrão ou ESSDs.

Especifica se o nome da tabela diferencia maiúsculas de minúsculas. Valores válidos:

• true: Os nomes das tabelas não diferenciam maiúsculas de minúsculas. Este é o valor padrão.
• false: Os nomes das tabelas diferenciam maiúsculas de minúsculas.

A versão secundária do mecanismo da instância. Este parâmetro é necessário apenas ao criar uma instância que executa MySQL ou PostgreSQL.

O formato do valor varia conforme o mecanismo de banco de dados da instância.

• Ao criar uma instância do ApsaraDB RDS for MySQL, o valor segue o formato: <Edição do RDS>_<Versão secundária do mecanismo>. Exemplos: rds_20200229, xcluster_20200229 e xcluster80_20200229. A lista a seguir descreve os campos nos valores de exemplo:
  • rds: A instância executa o ApsaraDB RDS Basic Edition ou High-availability Edition.
  • xcluster: A instância executa MySQL 5.7 no ApsaraDB RDS Enterprise Edition.
  • xcluster80: A instância executa MySQL 8.0 no ApsaraDB RDS Enterprise Edition.

• Ao criar uma instância do ApsaraDB RDS for PostgreSQL, o valor segue o formato: rds_postgres_<Versão principal do mecanismo>00_<Versão secundária do mecanismo>. Exemplo: rds_postgres_1400_20220830. A lista a seguir descreve os campos no valor de exemplo:
  • 1400: A versão principal do mecanismo é PostgreSQL 14.
  • 20220830: a versão do AliPG. Chame a operação DescribeDBMiniEngineVersions para consultar a versão do AliPG. Para mais informações sobre versões secundárias do mecanismo, consulte Notas de lançamento do AliPG.

Especifica se a expansão automática de armazenamento deve ser ativada para a instância. Valores válidos:

• Enable.
• Disable. Este é o valor padrão.

O limiar percentual que aciona a expansão automática de armazenamento.

• 10
• 20
• 30
• 40
• 50

A capacidade máxima de armazenamento permitida para a expansão automática de armazenamento. A capacidade de armazenamento da instância não pode exceder a capacidade máxima. Unidade: GB.

• Valores válidos: um número inteiro maior ou igual a 0.
• Se definir o parâmetro StorageAutoScale como Enable, também será necessário especificar este parâmetro.

Especifica se uma execução de teste deve ser realizada. Valores válidos:

• true: realiza uma execução de teste. O sistema verifica itens como parâmetros da solicitação, formato da solicitação, limites de serviço e recursos disponíveis.
• false: realiza uma execução de teste e envia a solicitação. Se a solicitação passar na execução de teste, a operação será executada. Este é o valor padrão.

O ID do arquivo de backup. Chame a operação ListUserBackupFiles para consultar arquivos de backup. Se quiser criar uma instância usando os dados de um arquivo de backup, especifique este parâmetro.

• O parâmetro PayType está definido como Postpaid.
• O parâmetro Engine está definido como MySQL.
• O parâmetro EngineVersion está definido como 5.7.
• O parâmetro Category está definido como Basic.

O número de instâncias do ApsaraDB RDS for MySQL a serem criadas. O parâmetro entra em vigor apenas quando várias instâncias do ApsaraDB RDS for MySQL são criadas simultaneamente usando uma única solicitação.

Valores válidos: de 1 a 20. Valor padrão: 1.

A política com base na qual várias instâncias são criadas. O parâmetro entra em vigor apenas quando o valor do parâmetro Amount é maior que 1. Valores válidos:

• Atomicity: atomicidade. Todas as instâncias são criadas. Se uma instância não puder ser criada, nenhuma delas será criada.
• Partial: não atômico. Cada instância é criada independentemente. A falha na criação de uma instância não afeta a criação das demais.

A chave da tag N a ser adicionada à instância. Use este parâmetro para adicionar tags à instância.

O valor da tag N adicionada à instância. Use este parâmetro para adicionar tags à instância.

Especifica se a proteção contra liberação deve ser ativada para a instância.

• true: ativa o recurso.
• false: desativa o recurso. Este é o valor padrão.

A configuração do recurso Babelfish para a instância do ApsaraDB RDS for PostgreSQL.

Formato:{"babelfishEnabled":"true","migrationMode":"xxxxxxx","masterUsername":"xxxxxxx","masterUserPassword":"xxxxxxxx"}

A lista a seguir descreve os campos no formato:

• babelfishEnabled: especifica se o Babelfish deve ser ativado para a instância. Se definir este campo como true, o Babelfish será ativado. Se deixar este parâmetro vazio, o Babelfish não será ativado.
• migrationMode: o modo de migração da instância. Valores válidos: single-db e multi-db.
• masterUsername: o nome de usuário da conta de administrador. O nome de usuário pode conter letras minúsculas, dígitos e sublinhados (_). Deve começar com uma letra e terminar com uma letra ou dígito. Pode ter até 63 caracteres e não pode começar com pg.
• masterUserPassword: a senha da conta de administrador. A senha deve conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Deve ter entre 8 e 32 caracteres. A senha pode conter qualquer um dos seguintes caracteres: ! @ # $ % ^ & * ( ) _ + - =.

O endpoint da instância.

Indica se a solicitação passou na execução de teste. Valores válidos:

• true: A solicitação passou na execução de teste.
• false: A solicitação falhou na execução de teste.
  Nota

  • Se o sistema não realizar uma execução de teste, este parâmetro não será retornado.
  • Se a solicitação falhar na execução de teste, uma mensagem de erro será retornada.

Indica se a tag especificada foi adicionada à instância. Valores válidos:

• true: A tag especificada foi adicionada à instância.
• false: A tag especificada não pôde ser adicionada à instância.

O ID da solicitação.

O endpoint da instância.

A mensagem que indica se várias instâncias foram criadas.

O ID da instância. Se o valor do parâmetro Amount for maior que 1, mais de um ID de instância será retornado. O número de IDs de instância retornados corresponde ao valor do parâmetro Amount. Os IDs de instância retornados são separados por vírgulas (,).

Por exemplo, se o valor do parâmetro Amount for 3, três IDs de instância serão retornados. Exemplos:

A porta da instância.

O ID da tarefa executada para criar várias instâncias.

Indica que o sistema realizou uma execução de teste.

O ID do pedido.