Todos os produtos
Search
Central de documentação

ApsaraDB for SelectDB:CreateDBInstance

Última atualização: Aug 03, 2026

Cria uma instância do ApsaraDB for SelectDB.

Descrição da operação

Instâncias por assinatura não podem ser excluídas.

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

selectdb:CreateDBInstance

create

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ResourceGroupId

string

Não

O ID do grupo de recursos.

rg-aekzt2zaluvuvqa_fake

ClientToken

string

Não

O token do cliente usado para garantir a idempotência da solicitação e evitar envios repetidos. O token é gerado pelo cliente e deve ser único entre diferentes solicitações. O token pode ter até 64 caracteres ASCII e não pode conter caracteres não ASCII.

AB

Engine

string

Não

O tipo de banco de dados. Valor padrão: selectdb.

selectdb

EngineVersion

string

Sim

A versão do mecanismo de banco de dados. Valor padrão: 4.1. Descrição dos valores válidos:

4.1

ChargeType

string

Sim

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

PrePaid

UsedTime

integer

Não

A duração da assinatura da instância. Descrição dos valores válidos:

1

Period

string

Não

Especifica se o cluster pré-pago é faturado anualmente ou mensalmente. Descrição dos valores válidos:

Month

DBInstanceClass

string

Sim

As especificações da instância. Você pode chamar a operação DescribeAllDBInstanceClass para consultar as especificações da instância.

selectdb.xlarge

RegionId

string

Sim

O ID da região.

cn-hangzhou

ZoneId

string

Sim

O ID da zona.

cn-hangzhou-e

CacheSize

integer

Sim

O tamanho de cache reservado.

200GB

VpcId

string

Sim

O ID da VPC.

vpc-bp175iuvg8nxqraf2****

VSwitchId

string

Sim

O ID do vSwitch.

vsw-bp1gzt31twhlo0sa5****

DBInstanceDescription

string

Não

A descrição da instância.

Teste de nova instância

ConnectionString

string

Não

O endpoint do banco de dados.

selectdb-cn-7213c8y****-public.selectdbfe.pre.rds.aliyuncs.com

SecurityIPList

string

Não

A lista de permissões de IP da instância. Separe vários endereços IP com vírgulas (,).

192.168.1.1

Tag

array<object>

Não

A lista de tags da instância.

object

Não

A lista de tags da instância.

Key

string

Não

A chave da tag.

testKey

Value

string

Não

O valor da tag.

testValue

DeployScheme

string

Não

O modo de implantação da instância.

single_az

MultiZone

array<object>

Não

A configuração de múltiplas zonas.

object

Não

A lista de múltiplas zonas.

ZoneId

string

Não

O ID da zona.

cn-hangzhou-k

VSwitchIds

array

Não

A lista de IDs de vSwitch.

string

Não

O ID do vSwitch.

vsw-bp10dbralpn4bzmgkkh8f

AddVPCIPs

string

Não

Especifica se o bloco CIDR da VPC deve ser adicionado à lista de permissões. Descrição dos valores válidos:

1

ClusterNodeType

string

Não

ClusterNodeCount

integer

Não

ScaleMax

number

Não

ScaleMin

number

Não

ConfigPatternType

string

Não

O modelo de configuração aplicado à instância.

Não

As especificações de nó de um único nó de cluster FE. Este parâmetro entra em vigor apenas quando você cria uma instância pós-paga ou por assinatura. Valor padrão: selectdb_fe.xlarge16.

Não

O número de nós de cluster FE. Este parâmetro entra em vigor apenas quando você cria uma instância pós-paga ou por assinatura. Valor padrão: 3. Valores válidos: 1 a 11 (apenas números ímpares).

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

RequestId

string

O ID da solicitação.

4773E4EC-025D-509F-AEA9-D53123FDFB0F

Data

object

O resultado retornado.

DBInstanceId

string

O ID da instância.

selectdb-cn-7213cjv****

OrderId

integer

O ID do pedido.

21137950671****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4773E4EC-025D-509F-AEA9-D53123FDFB0F",
  "Data": {
    "DBInstanceId": "selectdb-cn-7213cjv****",
    "OrderId": 0
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 COMMODITY.INVALID_COMPONENT Order configuration parameters do not meet the verification conditions, please re-match the product.
400 DocumentConvertFailed.ExceedFileSizeLimit The conversion has been failed, exceed file size limit.
400 Forbidden User not authorized to operate on the specified resource, or this API does not support RAM.
400 InvalidDBName The specified database name is not allowed.
400 CreateOrderFailed Failed to create order.
400 InvalidVSwitchId.Malformed The specified parameter "VSwitchId" is not valid.
400 InvalidMultiZone.NotThreeZones The number of zones must be three.
400 InvalidZoneId.Duplicated The zones cannot be repeated please select different zones.
400 EngineVersionDoNotSupportMultiZone The specified engine version doesn't support multi zone.
400 InvalidChargeType.Malformed The specified parameter "ChargeType" is not valid.
400 InvalidBuyConfigCpuOrCacheSize The specified purchase configuration CPU or cache size is invalid.
400 InvalidZoneId.Malformed The specified parameter "ZoneId" is not valid.
400 InvalidVpcId.Malformed The specified parameter "VpcId" is not valid.
400 ORDER.INST_HAS_UNPAID_ORDER Instance has unpaid order.
400 OperationDenied.OrderProcessing There are orders in process.
400 InvalidInstanceClass.MultiAZ The instance with 4-core BE cluster does not support multi-zone redundancy.
400 InvalidFEClassCode.Blank The specified parameter "FEClassCode" is blank.
400 InvalidFENodeCount The specified parameter "FENodeCount" is not valid.
400 InvalidFENodeCount.Blank The specified parameter "FENodeCount" is blank.
400 InvalidInstanceClass.ForMultiAZ The instance with 4-core BE cluster does not support upgrading to multi-zone redundancy.
400 InvalidFENodeCount.ForMultiAZ The instance with FENodeCount that less than 3 does not support upgrading to multi-zone redundancy.
403 DBClusterNotSupported The requested operation can not be performed while the cluster is not sale.
403 IncorrectDBInstanceState Current DB instance state does not support this operation.
403 InstanceEngineType.NotSupport The instance engine and type does not support operations.
403 InvalidDBInstanceState.NotSupport The specified instance state does't support this operation.
403 MoneyLessThan100 The Account Monet less Than 100.
403 OperationDenied.DBNameAndAccountPrivilegeCount The operation is not permitted due to count of database or account privilege.
403 InsufficientResourceCapacity The resource is out of usage.
403 INSUFFICIENT_AVAILABLE_QUOTA Your account available limit is less than 0, please recharge before trying to purchase.
403 OperationDenied.SpecificClassCodeNotSupported The uid is not in specific classcode whitelist.
404 DBInstanceLocked The current instance lock mode does not support this operation.
404 IncorrectVswitchId The specified parameter VSwitchId is not valid.
404 InvalidApi.NotFound Specified api is not found, please check your url and method.
404 InvalidDBInstance.NotFound The specified instance is not found.
404 InvalidDBInstanceClass.NotFound The specified instance classic does not exist.
404 InvalidRegionId.NotFound The provided RegionId does not exist in our records.
404 QueryPrice.Failed The inquiry failed. Contact Alibaba Cloud customer service representatives.
404 InvalidVSwitch.NoIP VSwitch has zero available IP.
404 InvalidDBClusterClass.NotFound The specified cluster class does not exist.
404 InvalidVPC.NotFound VPC or VSwitch is not valid.
404 InvalidFEClass.NotFound The specified fe class doesn't exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.