Todos os produtos
Search

Este produto

    :CreateDedicatedHostGroup

    Central de documentação

    :CreateDedicatedHostGroup

    Última atualização: Jun 28, 2026

    Cria um cluster dedicado.

    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 também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

    Parâmetros da solicitação

    ParâmetroTipoObrigatórioExemploDescrição
    ActionStringSimCreateDedicatedHostGroup

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

    RegionIdStringSimcn-hangzhou

    ID da região onde criar o cluster dedicado. Para mais informações, consulte IDs de regiões.

    EngineStringSimMySQL

    Mecanismo de banco de dados do cluster dedicado. Valores válidos:

    • MySQL
    • SQL Server
    CpuAllocationRatioIntegerNão200%

    Taxa de overcommit de CPU do cluster dedicado.

    Nota Valores válidos: 100% a 300%. Valor padrão: 200%. Essa configuração permite alocar o dobro dos recursos de CPU fornecidos, o que maximiza a utilização da CPU.
    MemAllocationRatioIntegerNão100%

    Uso máximo de memória de cada host no cluster dedicado.

    Nota Valores válidos: 0% a 100%. Valor padrão: 100%.
    DiskAllocationRatioIntegerNão200%

    Taxa de overcommit de armazenamento do cluster dedicado.

    Nota Valores válidos: 100% a 300%. Valor padrão: 200%. Essa configuração permite alocar o dobro dos recursos de armazenamento fornecidos, o que maximiza a utilização de recursos.
    AllocationPolicyStringNãoEvenly

    Política de alocação de recursos no cluster dedicado. Valor padrão: Evenly. Valores válidos:

    • Evenly: Cria instâncias preferencialmente nos hosts com menor carga. Isso equilibra as cargas entre os hosts do cluster dedicado e maximiza a estabilidade do sistema.
    • Intensively: Prioriza a criação de instâncias em hosts criados anteriormente e com menos recursos disponíveis no cluster dedicado. Isso maximiza a utilização de recursos.
    VPCIdStringSimvpc-t4n7v5m6icc0a4314****

    ID da Virtual Private Cloud (VPC) onde reside o cluster dedicado. Para visualizar o ID da VPC a gerenciar, faça login no console VPC e clique em VPCs no painel de navegação à esquerda.

    HostReplacePolicyStringNãoAuto

    Política de tratamento de falhas de host. Valor padrão: Auto. Valores válidos:

    • Auto: Substitui automaticamente os hosts com falha.
    • Manual: Exige substituição manual dos hosts com falha.
    Nota Selecione uma política conforme suas necessidades de negócio apenas se o cluster dedicado executar o mecanismo de banco de dados MySQL. Clusters dedicados com outros mecanismos usam o valor padrão Auto.
    ClientTokenStringSimETnLKlblzczshOTUbOCz*******

    Token de cliente para garantir a idempotência da solicitação. Gere esse valor no cliente e garanta que seja único entre diferentes solicitações. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres.

    OpenPermissionIntegerNão1

    Define se deve ativar o recurso de permissões de SO nos hosts do cluster dedicado. Valor padrão: 1. Valores válidos:

    • 0: não
    • 1: sim
    Nota Ative este recurso conforme suas necessidades de negócio apenas ao criar um cluster dedicado com o mecanismo de banco de dados MySQL, SQL Server. O recurso está indisponível para clusters dedicados com outros mecanismos de banco de dados, que assumem o valor padrão 0.
    DedicatedHostGroupDescStringNãomysqlcluster

    Nome do cluster dedicado. Deve ter de 1 a 64 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Precisa começar com uma letra.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    RequestId

    String

    C6592723-09E1-4248-A78E-12AB00D7A79D

    ID da solicitação.

    DedicatedHostGroupId

    String

    dhg-7a9****

    ID do cluster dedicado.

    Exemplos

    Exemplos de solicitações

    http(s)://cddc.aliyuncs.com?Action=CreateDedicatedHostGroup
&ClientToken=ETnLKlblzczshOTUbOCz*******
&Engine=MySQL
&RegionId=cn-hangzhou
&VPCId=vpc-t4n7v5m6icc0a4314****
&<Common request parameters>

    Exemplos de respostas de sucesso

    Formato XML

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

<CreateDedicatedHostGroupReponse>
<RequestId>C6592723-09E1-4248-A78E-12AB00D7A79D</RequestId>
<DedicatedHostGroupId>dhg-7a9********</DedicatedHostGroupId>
</CreateDedicatedHostGroupReponse>

    Formato JSON

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

{
  "RequestId" : "C6592723-09E1-4248-A78E-12AB00D7A79D",
  "DedicatedHostGroupId" : "dhg-7a9********"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição

    403

    Permission.NotSupport

    You are not authorized to perform this action.

    Erro retornado quando você não tem autorização para executar esta operação.

    404

    ClustersTemplateNotFound

    Key account cluster is not supported for the region.

    Erro retornado porque não é possível criar clusters dedicados na região especificada.

    Para obter uma lista de códigos de erro, visite o API Error Center.