Todos os produtos
Search
Central de documentação

PolarDB:CreateDBInstance

Última atualização: Jun 28, 2026

Crie uma instância do PolarDB-X em uma região específica. Use esta operação para provisionar uma nova instância com o método de faturamento, a topologia, a versão do mecanismo e as especificações de nó desejados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

CreateDBInstance

Operação a executar. Defina o valor como CreateDBInstance.

RegionId

String

Sim

cn-hangzhou

Região onde a instância está localizada.

PayType

String

Sim

PREPAY

Método de faturamento. Valores válidos: PREPAY (assinatura) e POSTPAY (pagamento conforme o uso).

EngineVersion

String

Sim

5.7

Versão do mecanismo MySQL. Valores válidos: 5.7 e 8.0.

TopologyType

String

Sim

3azones

Topologia de implantação. Valores válidos: 3azones (três zonas) e 1azone (zona única).

DBNodeCount

Integer

Não

2

Número de nós na instância. Valor mínimo: 2.

DBNodeClass

String

Não

polarx.x4.2xlarge.2d

Especificações do nó. Valores válidos: polarx.x4.medium.2e (2 vCPUs, 8 GB), polarx.x4.large.2e (4 vCPUs, 16 GB), polarx.x8.large.2e (4 vCPUs, 32 GB), polarx.x4.xlarge.2e (8 vCPUs, 32 GB), polarx.x8.xlarge.2e (8 vCPUs, 64 GB), polarx.x4.2xlarge.2e (16 vCPUs, 64 GB), polarx.x8.2xlarge.2e (16 vCPUs, 128 GB), polarx.x4.4xlarge.2e (32 vCPUs, 128 GB), polarx.x8.4xlarge.2e (32 vCPUs, 256 GB), polarx.st.8xlarge.2e (60 vCPUs, 470 GB) e polarx.st.12xlarge.2e (90 vCPUs, 720 GB).

CnClass

String

Não

polarx.x4.medium.2e

Especificações do nó de computação. Os valores válidos correspondem aos de DBNodeClass.

DnClass

String

Não

mysql.n4.medium.25

Especificações do nó de armazenamento. Valores válidos: mysql.n4.medium.25 (2 vCPUs, 8 GB), mysql.n4.large.25 (4 vCPUs, 16 GB), mysql.x8.large.25 (4 vCPUs, 32 GB), mysql.n4.xlarge.25 (8 vCPUs, 32 GB), mysql.x8.xlarge.25 (8 vCPUs, 64 GB), mysql.n4.2xlarge.25 (16 vCPUs, 64 GB), mysql.x8.2xlarge.25 (16 vCPUs, 128 GB), mysql.x4.4xlarge.25 (32 vCPUs, 128 GB), mysql.x8.4xlarge.25 (32 vCPUs, 256 GB), mysql.st.8xlarge.25 (60 vCPUs, 470 GB) e mysql.st.12xlarge.25 (90 vCPUs, 720 GB).

CNNodeCount

String

Não

2

Quantidade de nós de computação.

DNNodeCount

String

Não

2

Quantidade de nós de armazenamento.

NetworkType

String

Não

vpc

Tipo de rede. Somente a Virtual Private Cloud (VPC) é compatível.

VPCId

String

Não

vpc-*

ID da VPC.

VSwitchId

String

Não

vsw-*****

ID do vSwitch.

ZoneId

String

Não

cn-hangzhou-a

Zona da instância.

PrimaryZone

String

Não

cn-shenzhen-e

Zona primária. Obrigatória para implantações em três zonas.

SecondaryZone

String

Não

cn-shenzhen-a

Zona secundária. Obrigatória para implantações em três zonas.

TertiaryZone

String

Não

cn-shenzhen-e

Zona terciária. Obrigatória para implantações em três zonas.

Period

String

Não

Month

Unidade do ciclo de faturamento. Para instâncias por assinatura, os valores válidos são Month e Year. Para instâncias com pagamento conforme o uso, o valor padrão é Hour.

UsedTime

Integer

Não

1

Duração da assinatura. Se Period for definido como Year, os valores válidos serão 1, 2 e 3.

AutoRenew

Boolean

Não

true

Defina se a renovação automática deve ser ativada para instâncias por assinatura. Valor padrão: true. Valores válidos: true (ativado) e false (desativado).

IsReadDBInstance

Boolean

Não

false

Defina se a instância será criada como somente leitura. Valores válidos: true (somente leitura) e false (leitura e gravação).

PrimaryDBInstanceName

String

Não

pxc-*****

Nome da instância primária. Necessário quando IsReadDBInstance for definido como true.

IsColumnarReadDBInstance

Boolean

Não

true

Defina se a instância será criada como columnar somente leitura.

Series

String

Não

enterprise

Edição. Valores válidos: enterprise (Enterprise Edition) e standard (Standard Edition).

ClientToken

String

Não

xxxxxx-xxx

Token gerado pelo cliente para garantir a idempotência da solicitação. Cada token deve ser único.

ResourceGroupId

String

Não

ID do grupo de recursos. Este recurso não é compatível atualmente. Deixe este parâmetro em branco.

CnNums

Integer

Não

2

Espaço em disco do nó de armazenamento.

DnStorageSpace

String

Não

1500

Outros parâmetros.

(sem nome)

Map

Não

xxxx

Outros parâmetros.

Elementos da resposta

Parâmetro

Tipo

Exemplo

Descrição

DBInstanceName

String

pxc-*****

Nome da instância criada.

OrderId

String

12345

ID do pedido.

RequestId

String

9B2F3840-5C98-475C-B269-2D5C3A31797C

ID da solicitação.

Exemplos

Exemplo de solicitação

http(s)://[Endpoint]/?Action=CreateDBInstance
&RegionId=cn-hangzhou
&PayType=PREPAY
&EngineVersion=5.7
&TopologyType=3azones
&DBNodeCount=2
&DBNodeClass=polarx.x4.2xlarge.2e
&CnClass=polarx.x4.medium.2e
&DnClass=mysql.n4.medium.25
&CNNodeCount=2
&DNNodeCount=2
&NetworkType=vpc
&VPCId=vpc-*****
&VSwitchId=vsw-*********
&PrimaryZone=cn-shenzhen-e
&SecondaryZone=cn-shenzhen-a
&TertiaryZone=cn-shenzhen-e
&Period=Month
&UsedTime=1
&AutoRenew=true
&ClientToken=xxxxxx-xxx
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<CreateDBInstanceResponse>
    <DBInstanceName>pxc-*********</DBInstanceName>
    <RequestId>9B2F3840-5C98-475C-B269-2D5C3A31797C</RequestId>
    <OrderId>12345</OrderId>
</CreateDBInstanceResponse>

Formato JSON

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

{
  "DBInstanceName": "pxc-*********",
  "RequestId": "9B2F3840-5C98-475C-B269-2D5C3A31797C",
  "OrderId": "12345"
}

Códigos de erro

Para obter mais informações sobre códigos de erro, consulte o Error Center.