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

Observações de uso

Todas as instâncias do Elastic Compute Service (ECS) hospedadas em um host dedicado devem estar no estado Stopped (Stopped) antes que você modifique a taxa de overcommit de CPU do host dedicado.
Alterações na taxa de overcommit de CPU de um host dedicado não afetam a operação do host. Após modificar a taxa de overcommit de CPU, o número de vCPUs alocadas no host dedicado não pode exceder o novo total de vCPUs. Caso contrário, as instâncias ECS que utilizam as vCPUs excedentes não serão iniciadas.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyDedicatedHostAttribute	A operação que você deseja executar. Defina o valor como ModifyDedicatedHostAttribute.
RegionId	String	Sim	cn-hangzhou	O ID da região do host dedicado. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.
DedicatedHostId	String	Sim	dh-bp165p6xk2tlw61e****	O ID do host dedicado.
DedicatedHostName	String	Não	testDedicatedHostName	O nome do host dedicado. O nome deve ter entre 2 e 128 caracteres. Deve começar com uma letra e não pode iniciar com http:// ou https://. O nome pode conter letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-).
Description	String	Não	testDescription	A descrição do host dedicado. A descrição deve ter entre 2 e 256 caracteres e não pode começar com `http://` ou `https://`.
ActionOnMaintenance	String	Não	Migrate	A política para migrar as instâncias implantadas no host dedicado quando o host falha ou precisa de reparo online. Valores válidos: Migrate: As instâncias são migradas para outra máquina física e reiniciadas. 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 o host dedicado tiver discos em nuvem anexados, o valor padrão é Migrate. Se o host dedicado tiver discos locais anexados, 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 da Alibaba Cloud no host dedicado. Unidade: segundos. Valores válidos: 15 a 310.
AutoPlacement	String	Não	on	Define se o host dedicado deve ser adicionado ao pool de recursos para implantação automática. Se você não especificar o parâmetro DedicatedHostId ao criar uma instância em um host dedicado, a Alibaba Cloud selecionará automaticamente um host dedicado do pool de recursos para hospedar a instância. 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. Para obter informações sobre implantação automática, consulte Recursos.
DedicatedHostClusterId	String	Não	dc-bp165p6xk2tlw61e****	O ID do cluster de hosts dedicados ao qual o host dedicado pertence.
CpuOverCommitRatio	Float	Não	1	A taxa de overcommit de CPU. Você só pode definir taxas de overcommit de CPU para os seguintes tipos de hosts dedicados: 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 o número de vCPUs disponíveis: Número de vCPUs disponíveis = Número de núcleos físicos de CPU × 2 × Taxa de overcommit de CPU. Por exemplo, o número de núcleos físicos de CPU em cada host dedicado g6s é 52. Se você alterar a taxa de overcommit de CPU de um host dedicado g6s para 4, o número de vCPUs disponíveis no host será 416. Em cenários com requisitos mínimos de estabilidade de CPU ou onde a carga de CPU não é pesada, como ambientes de desenvolvimento e teste, aumentar a taxa de overcommit de CPU eleva o número de vCPUs disponíveis. Dessa forma, é possível implantar mais instâncias ECS das mesmas especificações no host dedicado e reduzir o custo unitário de implantação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	2A4EA075-CB5B-41B7-B0EB-70D339F6****	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=ModifyDedicatedHostAttribute
&DedicatedHostId=dh-bp165p6xk2tlw61e****
&RegionId=cn-hangzhou
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyDedicatedHostAttributeResponse>
    <RequestId>2A4EA075-CB5B-41B7-B0EB-70D339F6****</RequestId>
</ModifyDedicatedHostAttributeResponse>

Formato JSON

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

{
  "RequestId" : "2A4EA075-CB5B-41B7-B0EB-70D339F6****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDedicatedHostName.Malformed	The specified parameter DedicatedHostName is not valid.	Valor inválido para DedicatedHostName.
400	InvalidDescription.Malformed	The specified parameter Description is not valid.	Formato inválido para Description. A descrição deve ter entre 2 e 256 caracteres e não pode começar com http:// ou https://.
400	InvalidParameter.SlbUdpTimeout	The specified value is invalid.	Valor inválido para NetworkAttributes.SlbUdpTimeout.
400	InvalidParameter.UdpTimeout	The specified value is invalid.	Valor inválido para NetworkAttributes.UdpTimeout.
403	InvalidUser.Unauthorized	The user is not authorized	Você não tem autorização para executar esta operação.
404	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	O valor de DedicatedHostId não foi encontrado.
404	InvalidParameter.ActionOnMaintenance	The specified ActionOnMaintenance does not exist.	O valor de ActionOnMaintenance não foi encontrado.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.