Todos os produtos
Search
Central de documentação

:Crie uma conta de host dedicado

Última atualização: Jun 28, 2026

Cria uma conta para um host.

Cada host admite apenas uma conta. Antes de criar uma conta para um host, exclua a conta existente. Para obter mais informações, consulte Criar uma conta para um host.

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âmetro Tipo Obrigatório Exemplo Descrição
Action String Sim CreateDedicatedHostAccount

Operação a ser executada. Defina o valor como CreateDedicatedHostAccount.

DedicatedHostId String Sim ch-bp10a5id3boqi****

ID do host. Chame a operação DescribeDedicatedHosts para obter esse ID.

AccountName String Sim test

Nome de usuário da conta a ser criada.

  • Deve ter de 2 a 16 caracteres.
  • Deve começar com uma letra minúscula e terminar com uma letra minúscula ou dígito.
  • Pode conter letras minúsculas, dígitos e sublinhados (_).
AccountPassword String Sim testxxxxxx

Senha da conta. A senha deve atender aos seguintes requisitos:

  • Ter de 6 a 32 caracteres.
  • Conter letras, dígitos e caracteres especiais.
  • Caracteres especiais permitidos: ! @ # $ % ^ & * ( ) _ + - =
Nota Se o host for usado para bancos de dados SQL Server, a senha não poderá incluir o nome de usuário da conta, independentemente do uso de maiúsculas ou minúsculas.
RegionId String Sim cn-hangzhou

ID da região onde o host está implantado. Chame a operação DescribeDedicatedHostAttribute para obter o ID da região.

BastionInstanceId String Não bastionhost-cn-xxxxxxxxxxx

ID do bastionhost associado ao host especificado. No console do ApsaraDB MyBase, visualize o ID do bastionhost na página Bastion Hosts.

AccountType String Não Admin

Tipo da conta. Valores válidos:

  • Normal: conta padrão.
  • Admin: conta de administrador.

Para obter mais informações, consulte Permissões de host.

ClientToken String Sim ETnLKlblzczshOTUbOCz*******

Token de cliente usado para garantir a idempotência da solicitação. Gere o token por meio do cliente e assegure que seu valor seja exclusivo entre diferentes solicitações. O token aceita apenas caracteres ASCII e pode ter até 64 caracteres.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

D6E068C3-25BC-455A-85FE-45F0B22E12AS

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://cddc.aliyuncs.com/?Action=CreateDedicatedHostAccount
&AccountName=test
&AccountPassword=testxxxxxx
&ClientToken=ETnLKlblzczshOTUbOCz*******
&DedicatedHostId=ch-bp10a5id3boqi****
&RegionId=cn-hangzhou
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<CreateDedicatedHostAccountReponse>
<RequestId>D6E068C3-25BC-455A-85FE-45F0B22E12AS</RequestId>
</CreateDedicatedHostAccountReponse>

Formato JSON

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

{
  "RequestId" : "D6E068C3-25BC-455A-85FE-45F0B22E12AS"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

InvalidAccountPassword.Format

The account password format is invalid.

A senha especificada é inválida.

403

InvalidAction.NotSupport

The host status does not support the operation.

Esta operação não é compatível com o estado atual do host.

404

HostInfo.NotFound

The host is not found.

O host especificado não existe.

Para obter uma lista de códigos de erro, visite a Central de Erros da API.