Todos os produtos
Search

Este produto

    ApsaraDB for ClickHouse:CreateDBInstance

    Central de documentação

    ApsaraDB for ClickHouse:CreateDBInstance

    Última atualização: Aug 07, 2026

    Cria um cluster do ApsaraDB for ClickHouse.

    Descrição da operação

    Antes de chamar esta operação, certifique-se de compreender totalmente os métodos de cobrança e os preços do ApsaraDB for ClickHouse.

    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

    clickhouse:CreateDBInstance

    create

    *All Resource

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    RegionId

    string

    Sim

    O ID da região. Você pode chamar a operação DescribeRegions para consultar o ID da região.

    cn-hangzhou.
    ZoneId

    string

    Não

    O ID da zona. Você pode chamar a operação DescribeRegions para consultar o ID da zona.

    cn-hangzhou-h.
    DBClusterVersion

    string

    Sim

    A versão do kernel. Valores válidos:

    • 21.8.10.19

    • 22.8.5.29

    Valores válidos:

    • 22.8.5.29 :

      22.8.5.29

    • 21.8.10.19 :

      21.8.10.19

    22.8.5.29
    DBClusterCategory

    string

    Sim

    A configuração de réplicas. Valores válidos:

    • Basic: edição de réplica única.

    • HighAvailability: edição de réplica dupla.

    Valores válidos:

    • Basic :

      Basic.

    • HighAvailability :

      HighAvailability.

    Basic.
    DBClusterClass

    string

    Sim

    As especificações do cluster.

    • Edição de réplica única. Valores válidos:

      • LS20: armazenamento grande, 20 núcleos, 88 GB.

      • LS40: armazenamento grande, 40 núcleos, 176 GB.

      • LS80: armazenamento grande, 80 núcleos, 352 GB.

      • S8: padrão, 8 núcleos, 32 GB.

      • S16: padrão, 16 núcleos, 64 GB.

      • S32: padrão, 32 núcleos, 128 GB.

      • S64: padrão, 64 núcleos, 256 GB.

      • S80: padrão, 80 núcleos, 384 GB.

      • S104: padrão, 104 núcleos, 384 GB.

    • Edição de réplica dupla. Valores válidos:

      • LC20: armazenamento grande, 20 núcleos, 88 GB.

      • LC40: armazenamento grande, 40 núcleos, 176 GB.

      • LC80: armazenamento grande, 80 núcleos, 352 GB.

      • C8: padrão, 8 núcleos, 32 GB.

      • C16: padrão, 16 núcleos, 64 GB.

      • C32: padrão, 32 núcleos, 128 GB.

      • C64: padrão, 64 núcleos, 256 GB.

      • C80: padrão, 80 núcleos, 384 GB.

      • C104: padrão, 104 núcleos, 384 GB.

    • Edição de réplica única. Valores válidos:

      • S8: 8 núcleos, 32 GB.

      • S16: 16 núcleos, 64 GB.

      • S32: 32 núcleos, 128 GB.

      • S64: 64 núcleos, 256 GB.

      • S104: 104 núcleos, 384 GB.

    • Edição de réplica dupla. Valores válidos:

      • C8: 8 núcleos, 32 GB.

      • C16: 16 núcleos, 64 GB.

      • C32: 32 núcleos, 128 GB.

      • C64: 64 núcleos, 256 GB.

      • C104: 104 núcleos, 384 GB.

    S8
    DBNodeGroupCount

    string

    Sim

    O número de nós.

    • Edição de réplica única: valores válidos: 1 a 48.

    • Edição de réplica dupla: valores válidos: 1 a 24.

    1
    DBNodeStorage

    string

    Sim

    A capacidade de armazenamento por nó. Valores válidos: 100 a 32000. Unidade: GB.

    Nota

    O tamanho do incremento é de 100 GB.

    100
    DBClusterNetworkType

    string

    Sim

    O tipo de rede. Apenas VPC é suportado.

    VPC.
    DBClusterDescription

    string

    Não

    A descrição do cluster.

    test.
    PayType

    string

    Sim

    O método de cobrança. Valores válidos:

    • Postpaid: pós-pago.

    • Prepaid: assinatura.

    Valores válidos:

    • Prepaid :

      Prepaid.

    • Postpaid :

      Postpaid.

    Prepaid.
    Period

    string

    Não

    O tipo de assinatura do cluster por assinatura. Valores válidos:

    Importante Este parâmetro entra em vigor e é obrigatório apenas quando PayType está definido como Prepaid.

    • Year: assinatura anual.

    • Month: assinatura mensal.

    Month.
    UsedTime

    string

    Não

    A duração da assinatura do cluster por assinatura.

    Importante Este parâmetro entra em vigor e é obrigatório apenas quando PayType está definido como Prepaid.

    • Se Period estiver definido como Year, valores válidos: 1 a 3 (inteiro).

    • Se Period estiver definido como Month, valores válidos: 1 a 9 (inteiro).

    1
    VPCId

    string

    Sim

    O ID da VPC.

    vpc-bp175iuvg8nxqraf2****
    VSwitchId

    string

    Sim

    O ID do vSwitch.

    vsw-bp1gzt31twhlo0sa5****
    ClientToken

    string

    Não

    O token do cliente usado para garantir a idempotência da solicitação. O valor é uma string que contém até 64 caracteres ASCII.

    AB
    DbNodeStorageType

    string

    Sim

    O tipo de armazenamento. Valores válidos:

    • CloudESSD: ESSD PL1.

    • CloudESSD_PL2: ESSD PL2.

    • CloudESSD_PL3: ESSD PL3.

    • CloudEfficiency: disco em nuvem ultra.

    CloudESSD_PL2
    EncryptionKey

    string

    Não

    O ID da chave usada para criptografia de disco em nuvem. Este parâmetro é obrigatório quando EncryptionType está definido como CloudDisk.

    Você pode visualizar o ID da chave no console do Key Management Service (KMS) ou criar uma chave.

    Nota

    Se EncryptionType não for especificado, você não precisa especificar este parâmetro.

    0d2470df-da7b-4786-b981-9a164dae****
    EncryptionType

    string

    Não

    O tipo de criptografia. Apenas a criptografia de disco em nuvem é suportada. Defina o valor como CloudDisk.

    Nota

    Se este parâmetro não for especificado, os dados não serão criptografados.

    CloudDisk.
    BackupSetID

    string

    Não

    O ID do conjunto de backup. Você pode chamar a operação DescribeBackups para consultar o ID do conjunto de backup.

    Nota

    Este parâmetro é obrigatório quando você restaura dados de um cluster do ApsaraDB for ClickHouse.

    b-12af23adsf.
    SourceDBClusterId

    string

    Não

    O ID do cluster de origem. Você pode chamar a operação DescribeDBClusters para consultar o ID do cluster.

    Nota

    Este parâmetro é obrigatório quando você restaura dados de um cluster do ApsaraDB for ClickHouse.

    cc-bp1lxbo89u950****
    ResourceGroupId

    string

    Não

    O ID do grupo de recursos ao qual o cluster pertence.

    rg-4690g37929****
    ZoneIdBak

    string

    Não

    A zona secundária.

    cn-hangzhou-k.
    VSwitchBak

    string

    Não

    O vSwitch secundário.

    vsw-bp1gzt31twhlo0sa5****
    ZondIdBak2

    string

    Não

    A zona secundária 2.

    cn-hangzhou-j.
    VSwitchBak2

    string

    Não

    O vSwitch secundário 2.

    vsw-bp1gzt31twhlo0sa5****
    AutoRenew

    boolean

    Não

    Especifica se a renovação automática deve ser ativada.

    Nota

    Este parâmetro entra em vigor apenas quando PayType está definido como Prepaid.

    false.
    Tags

    array<object>

    Não

    As informações da tag.

    object

    Não

    As informações da tag.

    key

    string

    Não

    A chave da tag.

    user123
    value

    string

    Não

    O valor da tag.

    String de exemplo.

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Os parâmetros de resposta.

    RequestId

    string

    O ID da solicitação.

    F5178C10-1407-4987-9133-DE4DC9119F75
    DBClusterId

    string

    O ID do cluster.

    cc-bp1qx68m06981****
    OrderId

    string

    O ID do pedido.

    21137950671****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "F5178C10-1407-4987-9133-DE4DC9119F75",
  "DBClusterId": "cc-bp1qx68m06981****",
  "OrderId": "21137950671****"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    500 InternalError An error occurred while processing your request.
    503 ServiceUnavailable An error occurred while processing your request.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.