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

Descrição

Antes de criar um host dedicado, chame a operação DescribeAvailableResource para consultar os recursos disponíveis em uma região ou zona específica.

Recomendamos compreender os métodos de faturamento dos recursos antes de criar um host dedicado. Os recursos utilizados pelo host dedicado criado são cobrados. Para mais informações, consulte Visão geral do faturamento.

É possível criar até 100 hosts dedicados com pagamento conforme o uso ou assinatura por vez.
Após a criação do host dedicado, use o ID retornado como valor de um parâmetro de requisição na operação DescribeDedicatedHosts para consultar o estado do host.
Se algum parâmetro for inválido ou se os recursos solicitados forem insuficientes ao enviar uma requisição de criação, o sistema retornará um erro. Para detalhes sobre as causas dos erros, consulte a seção "Códigos de erro" deste tópico.
Depois de criar o host dedicado, chame a operação ModifyInstanceDeployment para migrar instâncias ECS de um host compartilhado para o host dedicado. Também é possível migrar instâncias ECS de outro host dedicado para o host recém-criado.

Depuração

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

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AllocateDedicatedHosts	A operação a ser executada. Defina o valor como AllocateDedicatedHosts.
RegionId	String	Sim	cn-hangzhou	O ID da região onde o host dedicado será criado. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
Tag.N.Key	String	Não	Environment	A chave da tag N a ser adicionada ao host dedicado. Valores válidos para N: 1 a 20. A chave da tag não pode ser uma string vazia. Deve ter no máximo 128 caracteres e não pode começar com acs: ou aliyun. Não pode conter `http://` ou `https://`.
Tag.N.Value	String	Não	Production	O valor da tag N a ser adicionada ao host dedicado. Valores válidos para N: 1 a 20. O valor da tag pode ser uma string vazia. Deve ter no máximo 128 caracteres e não pode começar com acs: nem conter `http://` ou `https://`.
ResourceGroupId	String	Não	rg-bp67acfmxazb4ph***	O ID do grupo de recursos ao qual o host dedicado será atribuído.
ZoneId	String	Não	cn-hangzhou-f	O ID da zona onde o host dedicado será criado. Este parâmetro está vazio por padrão. Caso nenhuma zona seja especificada, o sistema selecionará uma automaticamente.
DedicatedHostName	String	Não	myDDH	O nome do host dedicado. Deve ter entre 2 e 128 caracteres, começar com uma letra e não pode iniciar com `http://` ou `https://`. Pode conter letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-).
DedicatedHostClusterId	String	Não	dc-bp12wlf6am0vz9v2****	O ID do cluster de hosts dedicados onde o host dedicado será criado.
DedicatedHostType	String	Sim	ddh.c5	O tipo do host dedicado. Chame a operação DescribeDedicatedHostTypes para consultar a lista mais recente de tipos de hosts dedicados.
ActionOnMaintenance	String	Não	Migrate	A política usada para migrar as instâncias implantadas no host dedicado quando este falha ou precisa de reparo online. Valores válidos: Migrate: As instâncias são migradas para outro servidor físico e reiniciadas. Se discos em nuvem estiverem anexados ao host dedicado, o valor padrão é Migrate. Stop: As instâncias são paradas. Se o host dedicado não puder ser reparado, as instâncias serão migradas para outra máquina física e reiniciadas. Se discos locais estiverem anexados ao host dedicado, o valor padrão é Stop.
NetworkAttributes.SlbUdpTimeout	Integer	Não	60	O tempo limite para uma sessão UDP entre uma instância do Server Load Balancer (SLB) e o host dedicado. Unidade: segundos. Valores válidos: 15 a 310.
NetworkAttributes.UdpTimeout	Integer	Não	60	O tempo limite para uma sessão UDP entre um usuário e um serviço Alibaba Cloud no host dedicado. Unidade: segundos. Valores válidos: 15 a 310.
Description	String	Não	This-is-my-DDH	A descrição do host dedicado. Deve ter entre 2 e 256 caracteres e não pode começar com `http://` ou `https://`.
AutoPlacement	String	Não	off	Define se o host dedicado deve ser adicionado ao pool de recursos para implantação automática. Ao criar uma instância ECS em um host dedicado sem especificar o parâmetro DedicatedHostId, o Alibaba Cloud seleciona um host dedicado do pool para hospedar a instância. Para mais informações, consulte Implantação automática. Valores válidos: on: adiciona o host dedicado ao pool de recursos para implantação automática. off: não adiciona o host dedicado ao pool de recursos para implantação automática. Valor padrão: on. Nota Se não desejar adicionar o host dedicado ao pool de recursos para implantação automática, defina o valor como off.
CpuOverCommitRatio	Float	Não	1	A taxa de overcommit de CPU. É possível configurar taxas de overcommit de CPU apenas para os seguintes tipos de host dedicado: g6s, c6s e r6s. Valores válidos: 1 a 5. A taxa de overcommit de CPU afeta o número de vCPUs disponíveis em um host dedicado. Use a seguinte fórmula para calcular esse número: Número de vCPUs disponíveis = Número de núcleos físicos de CPU × 2 × Taxa de overcommit de CPU. Por exemplo, cada host dedicado g6s possui 52 núcleos físicos de CPU. Se você definir a taxa de overcommit de CPU de um host dedicado g6s como 4, o número de vCPUs disponíveis será 416. Em cenários com requisitos mínimos de estabilidade de CPU ou carga leve, como ambientes de desenvolvimento e teste, aumentar a taxa de overcommit eleva o número de vCPUs disponíveis. Isso permite implantar mais instâncias ECS das mesmas especificações no host dedicado, reduzindo o custo unitário de implantação.
MinQuantity	Integer	Não	2	O número mínimo de hosts dedicados a serem criados. Valores válidos: 1 a 100. Nota Se os recursos disponíveis forem suficientes para criar menos hosts dedicados do que o mínimo especificado, a criação falhará.
ChargeType	String	Não	PrePaid	O método de faturamento do host dedicado. Valores válidos: PrePaid: assinatura. Ao definir este parâmetro como PrePaid, certifique-se de ter saldo ou créditos suficientes na conta. Caso contrário, `InvalidPayMethod` será retornado. PostPaid: pagamento conforme o uso. Valor padrão: PostPaid.
Quantity	Integer	Não	2	O número de hosts dedicados a serem criados. Valores válidos: 1 a 100. Valor padrão: 1.
Period	Integer	Não	6	A duração da assinatura do host dedicado. O parâmetro `Period` é obrigatório e entra em vigor apenas quando o parâmetro `ChargeType` está definido como `PrePaid`. Valores válidos: Valores válidos quando o parâmetro PeriodUnit está definido como Month: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 e 60. Valores válidos quando o parâmetro PeriodUnit está definido como Year: 1, 2, 3, 4 e 5.
PeriodUnit	String	Não	Month	A unidade da duração da assinatura do host dedicado. Valores válidos: Month Year Valor padrão: Month.
AutoRenew	Boolean	Não	false	Define se a assinatura do host dedicado deve ser renovada automaticamente. Nota O parâmetro AutoRenew entra em vigor apenas quando o parâmetro ChargeType está definido como PrePaid. Valor padrão: false.
AutoRenewPeriod	Integer	Não	1	A duração da renovação automática do host dedicado. O parâmetro AutoRenewPeriod entra em vigor e é obrigatório apenas quando o parâmetro AutoRenew está definido como true. Valores válidos: Valores válidos quando PeriodUnit está definido como Month: 1, 2, 3, 6 e 12.
AutoReleaseTime	String	Não	2019-08-21T12:30:24Z	O horário para liberar automaticamente o host dedicado. Especifique o horário no padrão `ISO 8601` no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. Nota Deve ser pelo menos meia hora após o horário atual. Deve ser no máximo três anos após o horário atual. Se o valor dos segundos (ss) não for 00, ele será automaticamente definido como 00.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	O token do cliente usado para garantir a idempotência da requisição. Utilize o cliente para gerar o valor, mas garanta que seja único entre diferentes requisições. O valor de ClientToken pode conter apenas caracteres ASCII e não deve exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	E2A664A6-2933-4C64-88AE-5033D003****	O ID da requisição.
DedicatedHostIdSets	Array of String	"DedicatedHostIdSets":{"DedicatedHostId":["dh-bp67acfmxazb4p", "dh-bp67acfmxazb4d"]}	Os IDs dos hosts dedicados.

Exemplos

Exemplos de requisições

http(s)://ecs.aliyuncs.com/?Action=AllocateDedicatedHosts
&RegionId=cn-hangzhou
&DedicatedHostType=ddh.sn1ne
&Quantity=2
&ChargeType=PostPaid
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<AllocateDedicatedHostsResponse>
    <RequestId>E2A664A6-2933-4C64-88AE-5033D003EADF</RequestId>
    <DedicatedHostIdSets>
        <DedicatedHostId>dh-bp67acfmxazb4p****</DedicatedHostId>
        <DedicatedHostId>dh-bp67acfmxazb4d****</DedicatedHostId>
    </DedicatedHostIdSets>
</AllocateDedicatedHostsResponse>

Formato JSON

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

{
  "RequestId" : "E2A664A6-2933-4C64-88AE-5033D003EADF",
  "DedicatedHostIdSets" : {
    "DedicatedHostId" : [ "dh-bp67acfmxazb4p****", "dh-bp67acfmxazb4d****" ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Mensagem de erro retornada porque você não tem autorização para usar o tipo de instância especificado.
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	Mensagem de erro retornada porque o parâmetro Description especificado é inválido. A descrição deve ter entre 2 e 256 caracteres e não pode começar com http:// ou https://.
400	InvalidParameter.Conflict	The specified region and cluster do not match.	Mensagem de erro retornada porque a região e o cluster especificados não correspondem entre si.
400	InvalidAutoRenewPeriod.ValueNotSupported	The specified autoRenewPeriod is not valid.	Mensagem de erro retornada porque o parâmetro AutoRenewPeriod especificado é inválido.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Mensagem de erro retornada porque o parâmetro Tag.N.Key especificado é inválido.
400	InvalidDedicatedHostType.ValueNotSupported	%s	Mensagem de erro retornada porque o parâmetro DedicatedHostType especificado é inválido.
400	RegionUnauthorized	%s	Mensagem de erro retornada porque você não tem autorização para executar a operação na região especificada. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
400	Zone.NotOnSale	%s	Mensagem de erro retornada porque os recursos solicitados estão indisponíveis na zona especificada. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
400	OperationDenied	The specified DedicatedHostType or Zone is not available or not authorized.	Mensagem de erro retornada porque o tipo de host dedicado ou a zona especificada está indisponível, ou porque você não tem autorização para gerenciar os recursos.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	Mensagem de erro retornada porque o parâmetro PeriodUnit especificado é inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Mensagem de erro retornada porque o parâmetro Tag.N.Value especificado é inválido.
400	QuotaExceed.AfterpayDedicatedHost	The maximum number of Pay-As-You-Go DedicatedHosts is exceeded: %s	Mensagem de erro retornada porque os recursos de pagamento conforme o uso do tipo de host dedicado especificado são insuficientes. Reduza o número de hosts dedicados a serem criados.
400	InvalidChargeType.ValueNotSupported	ChargeType is not valid	Mensagem de erro retornada porque o parâmetro ChargeType especificado é inválido.
400	InvalidParameter.SlbUdpTimeout	The specified value is invalid.	Mensagem de erro retornada porque o parâmetro NetworkAttributes.SlbUdpTimeout especificado é inválido.
400	InvalidParameter.UdpTimeout	The specified value is invalid.	Mensagem de erro retornada porque o parâmetro NetworkAttributes.UdpTimeout especificado é inválido.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Mensagem de erro retornada porque a chave de tag especificada já existe. As chaves de tag devem ser únicas.
403	OperationDenied	The creation of Host to the specified Zone is not allowed.	Mensagem de erro retornada porque você não tem autorização para criar hosts dedicados na zona especificada.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	Mensagem de erro retornada porque os recursos solicitados estão indisponíveis na zona especificada. Tente um tipo de instância ou zona diferente. Chame a operação DescribeZones para consultar os recursos disponíveis.
403	OperationDenied	Sales of this resource are temporarily suspended in the specified region; please try again later.	Mensagem de erro retornada porque os recursos solicitados estão indisponíveis na região especificada. Tente novamente mais tarde.
403	NodeControllerUnavailable	The Node Controller is temporarily unavailable.	Mensagem de erro retornada porque o controlador de nó está indisponível.
403	OperationDenied	The resource is out of usage.	Mensagem de erro retornada porque a instância não está no estado Running. Inicie a instância ou verifique se a operação especificada é válida.
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.	Mensagem de erro retornada porque o parâmetro ResourceOwnerAccount especificado é inválido.
403	Zone.NotOpen	The specified zone is not granted to you to buy resources yet.	Mensagem de erro retornada porque você não tem autorização para comprar recursos na zona especificada.
403	Zone.NotOnSale	The specified zone is not available for purchase.	Mensagem de erro retornada porque os recursos solicitados estão indisponíveis na zona especificada. Tente um tipo de instância diferente ou selecione outra região ou zona.
403	InvalidDedicatedHostType.ValueNotSupported	The specified DedicatedHostType does not exist or beyond the permitted range.	Mensagem de erro retornada porque o parâmetro DedicatedHostType especificado não existe.
403	InvalidDedicatedHostType.ZoneNotSupported	The specified zone does not support this dedicatedHostType.	Mensagem de erro retornada porque o tipo de host dedicado especificado não é suportado na zona indicada.
403	InvalidParameter.NotMatch	%s	Mensagem de erro retornada porque um parâmetro especificado é inválido. Verifique se existem conflitos de parâmetros.
403	Account.Arrearage	Your account has been in arrears.	Mensagem de erro retornada porque o saldo da sua conta é insuficiente. Adicione fundos à sua conta Alibaba Cloud e tente novamente.
404	OperationDenied	Another Host has been creating	Mensagem de erro retornada porque outro host está sendo criado.
404	PaymentMethodNotFound	No payment method has been registered on the account.	Mensagem de erro retornada porque nenhum método de pagamento foi configurado para sua conta.
404	InvalidDedicatedHostName.Malformed	The specified parameter DedicatedHostName is not valid.	Mensagem de erro retornada porque o parâmetro DedicatedHostName especificado é inválido.
500	InternalError	The request processing has failed due to some unknown error.	Mensagem de erro retornada devido a um erro interno. Tente novamente mais tarde.
500	InternalError	%s	Mensagem de erro retornada devido a um erro interno.

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