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

Modifica os atributos de uma instância do Elastic Compute Service (ECS), como senha, nome, descrição, hostname, grupo de segurança, unidade máxima de transmissão (MTU) e dados de usuário. Se a instância for do tipo burstable, também é possível alterar o modo de desempenho.

Observações de uso

Se a resposta contiver {"OperationLocks": {"LockReason" : "security"}} ao consultar as informações de uma instância, a instância estará bloqueada por motivos de segurança. Nenhuma operação é permitida na instância nesse estado.

Observe os seguintes pontos:

Modificar o hostname (HostName): Após modificar o hostname, reinicie a instância no console ECS ou chame a operação RebootInstance para que a alteração tenha efeito. Para obter informações sobre como reiniciar uma instância no console ECS, consulte Restart instances. O novo hostname não terá efeito se você reiniciar a instância pelo sistema operacional.
Redefinir a senha (Password):
- A instância não pode estar no estado Starting (Starting).
- Após redefinir a senha, reinicie a instância no console ECS ou chame a operação RebootInstance para que a nova senha tenha efeito. Para obter informações sobre como reiniciar uma instância no console ECS, consulte Restart instances. A nova senha não terá efeito se você reiniciar a instância pelo sistema operacional.
Modificar dados de usuário (UserData):
- A instância deve estar no estado Stopped (Stopped).
- A instância deve atender aos limites para dados de usuário. Para mais informações, consulte Prepare user data.
  
  Nota
  Após reiniciar a instância, os novos dados de usuário são exibidos, mas não executados como scripts.
Alterar os grupos de segurança (SecurityGroupIds.N):
- É possível mover uma instância para um grupo de segurança de tipo diferente.
  
  Para mover uma instância para um grupo de segurança de tipo diferente, familiarize-se com as diferenças entre as configurações de regras dos dois tipos de grupo de segurança e evite impactos na rede da instância.
- Não é possível alterar grupos de segurança de instâncias na rede clássica.
  
  Para mais informações, consulte a descrição de SecurityGroupIds.N.
Modificar o número de filas suportadas pela interface de rede elástica (ENI) primária (NetworkInterfaceQueueNumber):
- A instância deve estar no estado Stopped (Stopped).
- O valor deste parâmetro não pode exceder o número máximo de filas permitido por ENI.
- O número total de filas de todas as ENIs na instância não pode exceder a cota de filas do tipo de instância. Para obter o número máximo de filas por ENI e a cota de filas de um tipo de instância, chame a operação DescribeInstanceTypes e consulte MaximumQueueNumberPerEni e TotalEniQueueQuantity.
- Se você definir este parâmetro como -1, o valor será redefinido para o padrão do tipo de instância. Para obter o número padrão de filas suportadas pela ENI primária de um tipo de instância, chame a operação DescribeInstanceTypes e consulte o valor PrimaryEniQueueNumber.
Ativar ou desativar o recurso Jumbo Frames (EnableJumboFrame): Para mais informações, consulte MTUs.
- A instância deve estar no estado Running (Running) ou Stopped (Stopped).
- A instância deve residir em uma VPC.
- Ao ativar o recurso Jumbo Frames, o valor de MTU da instância é definido como 8500. Ao desativar o recurso Jumbo Frames, o valor de MTU da instância é definido como 1500.

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 de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyInstanceAttribute	A operação a ser executada. Defina o valor como ModifyInstanceAttribute.
InstanceId	String	Sim	i-bp67acfmxazb4ph****	O ID da instância.
Password	String	Não	Test123456	A senha da instância. A senha deve ter de 8 a 30 caracteres e conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Os caracteres especiais incluem: ( ) ` ~ ! @ # $ % ^ & * - _ + = \| { } [ ] : ; ' < > , . ? / Para instâncias Windows, as senhas não podem começar com uma barra (/). Nota Por motivos de segurança, recomendamos usar HTTPS para enviar solicitações se `Password` for especificado.
HostName	String	Não	testHostName	O hostname da instância. Observe os seguintes itens: Ao modificar o hostname da instância, ela não pode estar no estado Creating (`Pending`) ou Starting (`Starting`). Caso contrário, o novo hostname e as configurações em `/etc/hosts` podem não ter efeito. Chame a operação DescribeInstances para consultar o estado da instância. Após modificar o hostname, chame a operação RebootInstance para que o novo hostname tenha efeito. Os seguintes limites se aplicam aos hostnames de instâncias que executam diferentes sistemas operacionais: Para Windows Server, o hostname deve ter de 2 a 15 caracteres e pode conter letras, dígitos e hifens (-). O hostname não pode começar ou terminar com um hífen (-), conter hifens consecutivos (-) ou conter apenas dígitos. Para outros sistemas operacionais, como Linux, o hostname deve ter de 2 a 64 caracteres. É possível usar pontos (.) para separar um hostname em vários segmentos. Cada segmento pode conter letras, dígitos e hifens (-). O hostname não pode conter pontos (.) ou hifens (-) consecutivos, nem começar ou terminar com um ponto (.) ou um hífen (-).
InstanceName	String	Não	testInstanceName	O nome da instância. O nome deve ter de 2 a 128 caracteres, 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	testInstanceDescription	A descrição da instância. A descrição deve ter de 2 a 256 caracteres e não pode começar com `http://` ou `https://`.
UserData	String	Não	ZWNobyBoZWxsbyBlY3Mh	Os dados de usuário da instância. Os dados de usuário devem ser codificados em Base64. O tamanho dos dados de usuário não pode exceder 16 KB antes da codificação em Base64. Recomendamos não transmitir informações confidenciais, como senhas e chaves privadas, em texto simples. Se for necessário transmitir informações confidenciais, criptografe e codifique as informações em Base64 antes da transmissão. Em seguida, decodifique e descriptografe as informações da mesma maneira dentro da instância.
Recyclable	Boolean	Não	hide	Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
CreditSpecification	String	Não	Standard	O modo de desempenho da instância burstable. Valores válidos: Standard Unlimited Para mais informações sobre os modos de desempenho de instâncias burstable, consulte Overview.
DeletionProtection	Boolean	Não	false	O atributo de proteção contra liberação da instância. Este parâmetro especifica se é possível usar o console ECS ou chamar a operação DeleteInstance para liberar a instância. Nota Este parâmetro aplica-se apenas a instâncias de pagamento conforme o uso. O atributo de proteção contra liberação protege as instâncias contra liberações manuais, mas não contra liberações automáticas.
NetworkInterfaceQueueNumber	Integer	Não	8	O número de filas suportadas pela ENI primária.
SecurityGroupIds.N	String	Não	sg-bp15ed6xe1yxeycg7o****	Os IDs dos grupos de segurança de substituição. O ID do grupo de segurança deve ser único. A instância é movida dos grupos de segurança atuais para os grupos de segurança de substituição. Para manter a instância nos grupos de segurança atuais, adicione os IDs dos grupos atuais à lista. É possível mover a instância para grupos de segurança de um tipo diferente. No entanto, a lista não pode conter IDs de grupos de segurança básicos e avançados simultaneamente. O grupo de segurança e a instância especificados devem pertencer à mesma VPC. Os valores válidos de N baseiam-se no número máximo de grupos de segurança aos quais a instância pode pertencer. Para mais informações, consulte Limits. Os novos grupos de segurança tornam-se válidos para a instância após uma breve latência.
RemoteConnectionOptions.Password	String	Não	hide	Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
RemoteConnectionOptions.Type	String	Não	hide	Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
EnableJumboFrame	Boolean	Não	false	Especifica se o recurso Jumbo Frames deve ser ativado para a instância. Valores válidos: true false O recurso Jumbo Frames pode ser ativado apenas para tipos específicos de instância. Para mais informações, consulte MTUs.
CpuOptions.TopologyType	String	Não	DiscreteCoreToHTMapping	O tipo de topologia de CPU da instância. Valores válidos: ContinuousCoreToHTMapping: A tecnologia Hyper-Threading (HT) permite que threads contínuas sejam executadas no mesmo núcleo na topologia de CPU da instância. DiscreteCoreToHTMapping: A tecnologia HT permite que threads discretas sejam executadas no mesmo núcleo na topologia de CPU da instância. Este parâmetro está vazio por padrão. Nota Este parâmetro é suportado apenas por famílias específicas de instâncias. Para mais informações sobre as famílias de instâncias suportadas, consulte View and modify the CPU topology. Antes de especificar este parâmetro, certifique-se de que a instância esteja no estado Stopped (`Stopped`).

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=ModifyInstanceAttribute
&InstanceId=i-bp67acfmxazb4ph****
&Action=ModifyInstanceAttribute
&CreditSpecification=Standard
&DeletionProtection=false
&Description=testInstanceDescription
&HostName=testHostName
&InstanceName=testInstanceName
&Password=Test123456
&SecurityGroupIds.1=sg-bp15ed6xe1yxeycg7o****
&SecurityGroupIds.2=sg-bp15ed6xe1yxeycg7p****
&SecurityGroupIds.3=sg-bp15ed6xe1yxeycg7q****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyInstanceAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAttributeResponse>

Formato JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInstanceName.Malformed	The specified parameter "InstanceName" is not valid.	Valor de InstanceName inválido.
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	Formato de Description inválido. O nome deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
400	ImageNotSupportCloudInit	The specified image does not support cloud-init.	A imagem especificada não suporta cloud-init.
400	ChargeTypeViolation	Pay-As-You-Go instances do not support this operation.	Não é possível realizar a operação em instâncias de pagamento conforme o uso. Verifique o método de faturamento da instância.
400	InvalidParameter.RecycleBin	You do not have permission to set recyclable properties.	Você não tem autorização para realizar a operação.
400	InvalidParameter.CreditSpecification	The specified CreditSpecification is not supported in this region.	A especificação de crédito especificada não é suportada nesta região.
400	InvalidInstanceStatus.CreditSpecRestricted	The current status of the resource does not support this operation.	Não é possível realizar esta operação no recurso no estado atual.
400	InvalidInstanceStatus.NotRunning	The current status of the resource is invalid, you can only do this operation when instance is running.	Não é possível realizar esta operação na instância no estado atual. Tente novamente quando a instância estiver no estado Running.
400	JoinedGroupLimitExceed	%s	O número máximo de grupos de segurança aos quais o recurso especificado pode ser atribuído foi excedido. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.
400	InvalidParameter	The specified parameter is not valid.	Um parâmetro especificado é inválido.
400	InvalidOperation.InvalidEcsState	%s	Não é possível realizar esta operação na instância no estado atual.
400	InvalidOperation.InstanceStatusUnsupported	The specified instance status does not support modification of cpu topology type.	Não é possível modificar a topologia de CPU da instância no estado atual.
400	InvalidParameter.CpuOptionsTopologyType	The specified parameter CpuOptions.TopologyType: %s is not valid.	O valor de enumeração do tipo de topologia de CPU atual é inválido.
400	InvalidInstanceType.NotSupportCpuOptionsTopologyType	The specified instance type does not support CpuOptions.TopologyType: %s.	O tipo de instância não suporta a topologia de CPU especificada.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Não é possível realizar esta operação no recurso no estado atual.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	A instância está bloqueada por motivos de segurança.
403	OperationDenied	The instance amount in the specified SecurityGroup reach its limit.	O número máximo de instâncias no grupo de segurança especificado foi excedido.
403	OperationDenied	The current status of the resource does not support this operation.	Não é possível realizar esta operação no recurso no estado atual.
403	InvalidUserData.Base64FormatInvalid	The specified UserData is not valid	Valor de UserData inválido.
403	InvalidChargeType.ValueNotSupported	Deletion protection is only valid for postPaid instance, not for prePaid or spot instance.	O recurso de proteção contra liberação pode ser usado apenas em recursos de pagamento conforme o uso.
403	InvalidUser.Unauthorized	The user is not authorized	Você não tem autorização para realizar esta operação.
403	EnterpriseGroupLimited.MutliGroupType	The specified instance can not join multi SecurityGroup types.	A instância especificada não pode pertencer simultaneamente a um grupo de segurança básico e a um grupo de segurança avançado. Chame a operação DescribeSecurityGroups para consultar o tipo de um grupo de segurança específico.
403	SecurityGroupInstanceLimitExceed	%s	O número máximo de instâncias no grupo de segurança especificado foi excedido.
403	InstanceNotInSecurityGroup	The instance not in the group.	A instância especificada não pertence ao grupo de segurança.
403	InvalidOperation.InvalidRegion	%s	Valor de RegionId inválido.
403	OperationDenied	The specified Image is disabled or is deleted.	A imagem especificada está desativada ou excluída.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Não é possível modificar grupos de segurança gerenciados por serviços de nuvem.
403	InvalidParameter.InvalidEniQueueNumber	%s	Valor de QueueNumber inválido. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	O número máximo de filas por ENI foi excedido. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	O número máximo de filas para todas as ENIs em uma instância foi excedido. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	O grupo de segurança especificado não foi encontrado nesta conta. Verifique se o ID do grupo de segurança está correto.
404	Credit.NotFound	The specified credit information does not exist.	As informações de crédito especificadas não existem.
404	InvalidParameter.SecurityGroupIdRepeated	The specified security group ids has repeated.	IDs de grupo de segurança duplicados foram encontrados. Verifique se o valor de SecurityGroupIds.N é válido.
404	InvalidSecurityGroupType.NotSupportClassic	The specified SecurityGroupIds have classic group type.	O grupo de segurança especificado está na rede clássica. Verifique se o valor de SecurityGroupId.N é válido.
404	InvalidSecurityGroupVpc.NotBelongToOneVpc	The specified SecurityGroupIds are belong to different vpc.	Os grupos de segurança especificados pertencem a VPCs diferentes. Verifique se o valor de SecurityGroupIds.N é válido. Chame a operação DescribeSecurityGroups para consultar as VPCs às quais os grupos de segurança pertencem.
500	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente mais tarde.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Service error codes.