CreateDedicatedHost - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateDedicatedHost	A operação a ser executada. Defina o valor como CreateDedicatedHost.
RegionId	String	Sim	cn-hangzhou	ID da região onde o cluster está implantado. Para obter o ID da região, consulte IDs de regiões.
DedicatedHostGroupId	String	Sim	dhg-6w7q18iwt5jo****	ID do cluster que contém o host. Para visualizar o ID do cluster, faça login no console do ApsaraDB MyBase e verifique o ID na página Dedicated Clusters. Nota O mecanismo de banco de dados do host deve ser igual ao do cluster.
ZoneId	String	Sim	cn-hangzhou-i	ID da zona onde implantar o host. Para obter o ID da zona, consulte Clusters dedicados.
VSwitchId	String	Sim	vsw-bp133c8ifzxd3iv6q****	ID do vSwitch ao qual conectar o host. Visualize o ID do vSwitch no console da Virtual Private Cloud (VPC).
HostClass	String	Sim	rds.g6.4xlarge	Especificação do host. Para obter informações sobre as especificações de host compatíveis com diferentes tipos de bancos de dados, consulte Tipos de instância de hosts.
PayType	String	Sim	prepaid	Método de faturamento. Defina o valor como prepaid. prepaid indica o método de faturamento por assinatura.
Period	String	Não	Month	Unidade da duração da assinatura. Valores válidos: Year Month
UsedTime	String	Não	1	Duração da assinatura do host. Valores válidos: Se o parâmetro Period estiver definido como Year, os valores válidos para o parâmetro UsedTime são números inteiros de 1 a 5. Se o parâmetro Period estiver definido como Month, os valores válidos para o parâmetro UsedTime são números inteiros de 1 a 9.
ClientToken	String	Sim	ETnLKlblzczshOTUbOCzSBZH8****	Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor. Certifique-se de que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e ter até 64 caracteres.
AutoRenew	String	Não	false	Especifica se a renovação automática deve ser ativada. Valores válidos: true: ativa a renovação automática. false: desativa a renovação automática. Nota Se este parâmetro não for especificado, o valor padrão false será usado.
ImageCategory	String	Não	AliLinux	Imagem a ser usada para criar o host. Valores válidos: WindowsWithMssqlEntAlwaysonLicense: SQL Server Cluster Edition WindowsWithMssqlStdLicense: SQL Server Standard Edition WindowsWithMssqlEntLicense: SQL Server Enterprise Edition WindowsWithMssqlWebLicense: SQL Server Web Edition AliLinux: outras imagens Nota Ao criar um host SQL Server, especifique uma imagem da edição correspondente à do host.
OsPassword	String	Não	Test123456	Senha usada para fazer login no host. A criação de senha é permitida apenas se o host estiver em um cluster privado. A senha deve atender aos seguintes requisitos: Deve ter entre 8 e 30 caracteres. Deve conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Caracteres especiais compatíveis: `( ) \ ~ ! @ # $ % ^ & * - _ + = \| { } [ ] : ; ' < > , . ? /`
HostStorageType	String	Não	cloud_essd0	Tipo de disco a ser usado para o host. Este parâmetro tem efeito apenas para hosts Tair. Apenas os dois tipos de disco a seguir são compatíveis: cloud_essd: Enhanced SSD (ESSD) com nível de desempenho (PL) 1 cloud_essd0: ESSD com PL 0
HostStorage	String	Não	512	Capacidade do disco do host. Este parâmetro tem efeito apenas para hosts Tair. Unidade: GB. Valores válidos: 512 1.024 1.536 2.048 2.560 3.072 3.584 4.096

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
OrderId	Long	102565235	ID do pedido.
RequestId	String	C860658E-68A6-46C1-AF6E-3AE7C4D32375	ID da solicitação.
DedicateHostList	Array of DedicateHostList		Informações sobre o host criado.
DedicateHostList
DedicatedHostId	String	ch-bp108dki3wdl6****	ID do host criado.

Exemplos

Exemplos de solicitações

http(s)://cddc.aliyuncs.com/?Action=CreateDedicatedHost
&RegionId=cn-hangzhou
&DedicatedHostGroupId=dhg-6w7q18iwt5jo****
&ZoneId=cn-hangzhou-i
&VSwitchId=vsw-bp133c8ifzxd3iv6q****
&HostClass=rds.g6.4xlarge
&PayType=prepaid
&Period=Month
&UsedTime=1
&ClientToken=ETnLKlblzczshOTUbOCzSBZH8****
&AutoRenew=false
&ImageCategory=AliLinux

&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<CreateDedicatedHostResponse>
    <OrderId>102565235</OrderId>
    <RequestId>C860658E-68A6-46C1-AF6E-3AE7C4D32375</RequestId>
    <DedicateHostList>
        <DedicatedHostId> ch-bp108dki3wdl6****</DedicatedHostId>
    </DedicateHostList>
</CreateDedicatedHostResponse>

Formato JSON

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

{
  "OrderId" : 102565235,
  "RequestId" : "C860658E-68A6-46C1-AF6E-3AE7C4D32375",
  "DedicateHostList" : [ {
    "DedicatedHostId" : " ch-bp108dki3wdl6****"
  } ]
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The parameter is invalid.	Mensagem retornada porque um parâmetro foi definido com um valor inválido.
400	InvalidAccountPassword.Format	The account password format is invalid.	Mensagem retornada porque a senha especificada é inválida.
400	InsufficientResourceCapacity	No host is available for the requested instance.	Mensagem retornada porque o sistema falhou ao criar o host devido a recursos insuficientes no cluster dedicado.

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