ModifyInstanceAttribute - - Centro de documentación de Alibaba Cloud

Modifica los atributos de una instancia de Elastic Compute Service (ECS), como la contraseña, el nombre, la descripción, el nombre de host, el security group, la unidad máxima de transmisión (MTU) y los datos de usuario. Si la instancia es de tipo burstable, también puede cambiar su modo de rendimiento.

Notas de uso

Si la respuesta contiene {"OperationLocks": {"LockReason" : "security"}} al consultar la información de una instancia, significa que la instancia está bloqueada por motivos de seguridad. No se permite realizar ninguna operación sobre ella.

Tenga en cuenta los siguientes puntos:

Modificar el nombre de host (HostName): Después de modificar el nombre de host, reinicie la instancia desde la consola de ECS o mediante la operación RebootInstance para que el cambio surta efecto. Para obtener más información sobre cómo reiniciar una instancia desde la consola de ECS, consulte Restart instances. El nuevo nombre de host no surte efecto si reinicia la instancia desde el sistema operativo.
Restablecer la contraseña (Password):
- La instancia no debe estar en estado Starting (Starting).
- Después de restablecer la contraseña, reinicie la instancia desde la consola de ECS o mediante la operación RebootInstance para que la nueva contraseña surta efecto. Para obtener más información sobre cómo reiniciar una instancia desde la consola de ECS, consulte Restart instances. La nueva contraseña no surte efecto si reinicia la instancia desde el sistema operativo.
Modificar los datos de usuario (UserData):
- La instancia debe estar en estado Stopped (Stopped).
- La instancia debe cumplir con los límites establecidos para los datos de usuario. Para obtener más información, consulte Prepare user data.
  
  Nota
  Después de reiniciar la instancia, los nuevos datos de usuario se muestran, pero no se ejecutan como scripts.
Cambiar los security groups (SecurityGroupIds.N):
- Es posible mover una instancia a un security group de otro tipo.
  
  Si desea mover una instancia a un security group de otro tipo, familiarícese con las diferencias entre las configuraciones de reglas de ambos tipos para evitar afectar la red de la instancia.
- No es posible cambiar los security groups de instancias en la red clásica.
  
  Para obtener más información, consulte la descripción de SecurityGroupIds.N.
Modificar el número de colas admitidas por la interfaz de red elástica (ENI) principal (NetworkInterfaceQueueNumber):
- La instancia debe estar en estado Stopped (Stopped).
- El valor de este parámetro no puede superar el número máximo de colas permitidas por ENI.
- El número total de colas de todas las ENI de la instancia no puede exceder la cuota de colas del tipo de instancia. Para obtener el número máximo de colas por ENI y la cuota de colas de un tipo de instancia, llame a la operación DescribeInstanceTypes y consulte los valores MaximumQueueNumberPerEni y TotalEniQueueQuantity.
- Si establece este parámetro en -1, el valor se restablece al valor predeterminado del tipo de instancia. Para obtener el número predeterminado de colas que admite la ENI principal de un tipo de instancia, llame a la operación DescribeInstanceTypes y consulte el valor PrimaryEniQueueNumber.
Habilitar o deshabilitar la función Jumbo Frames (EnableJumboFrame): Para obtener más información, consulte MTUs.
- La instancia debe estar en estado Running (Running) o Stopped (Stopped).
- La instancia debe residir en una Virtual Private Cloud (VPC).
- Cuando se habilita la función Jumbo Frames, el valor MTU de la instancia se establece en 8500. Cuando se deshabilita, el valor MTU se establece en 1500.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ModifyInstanceAttribute	La operación que se va a ejecutar. Establezca el valor en ModifyInstanceAttribute.
InstanceId	String	Sí	i-bp67acfmxazb4ph****	El ID de la instancia.
Password	String	No	Test123456	La contraseña de la instancia. Debe tener entre 8 y 30 caracteres e incluir como mínimo tres de los siguientes tipos: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Los caracteres especiales incluyen: ( ) ` ~ ! @ # $ % ^ & * - _ + = \| { } [ ] : ; ' < > , . ? / En instancias Windows, la contraseña no puede comenzar con una barra diagonal (/). Nota Por motivos de seguridad, se recomienda usar HTTPS para enviar solicitudes cuando se especifica `Password`.
HostName	String	No	testHostName	El nombre de host de la instancia. Tenga en cuenta lo siguiente: Al modificar el nombre de host, la instancia no debe estar en estado Creating (`Pending`) ni Starting (`Starting`). De lo contrario, es posible que el nuevo nombre de host y las configuraciones en `/etc/hosts` no surtan efecto. Puede llamar a la operación DescribeInstances para consultar el estado de la instancia. Después de modificar el nombre de host, debe llamar a la operación RebootInstance para que el cambio surta efecto. Se aplican los siguientes límites a los nombres de host según el sistema operativo: Para Windows Server, el nombre de host debe tener entre 2 y 15 caracteres, y puede contener letras, dígitos y guiones (-). No puede comenzar ni terminar con guion (-), contener guiones consecutivos ni estar compuesto únicamente por dígitos. Para otros sistemas operativos como Linux, el nombre de host debe tener entre 2 y 64 caracteres. Puede usar puntos (.) para dividir el nombre en varios segmentos. Cada segmento puede contener letras, dígitos y guiones (-). El nombre no puede contener puntos (.) ni guiones (-) consecutivos, ni comenzar o terminar con punto (.) o guion (-).
InstanceName	String	No	testInstanceName	El nombre de la instancia. Debe tener entre 2 y 128 caracteres, comenzar con una letra y no puede iniciar con `http://` ni `https://`. Puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).
Description	String	No	testInstanceDescription	La descripción de la instancia. Debe tener entre 2 y 256 caracteres y no puede comenzar con `http://` ni `https://`.
UserData	String	No	ZWNobyBoZWxsbyBlY3Mh	Los datos de usuario de la instancia. Deben codificarse en Base64. El tamaño de los datos de usuario no puede superar los 16 KB antes de la codificación en Base64. Se recomienda no transmitir información confidencial, como contraseñas y claves privadas, en texto plano. Si es necesario incluirla, cifre y codifique la información en Base64 antes de enviarla. Posteriormente, podrá decodificarla y descifrarla de la misma manera dentro de la instancia.
Recyclable	Boolean	No	hide	Nota Este parámetro se encuentra en vista previa privada y no está disponible públicamente.
CreditSpecification	String	No	Standard	El modo de rendimiento de la instancia burstable. Valores válidos: Standard Unlimited Para obtener más información sobre los modos de rendimiento de instancias burstable, consulte Overview.
DeletionProtection	Boolean	No	false	El atributo de protección contra liberación de la instancia. Este parámetro indica si se puede liberar la instancia desde la consola de ECS o mediante la operación DeleteInstance. Nota Este parámetro solo aplica a instancias pay-as-you-go. La protección contra liberación evita eliminaciones manuales, pero no protege contra liberaciones automáticas.
NetworkInterfaceQueueNumber	Integer	No	8	El número de colas que admite la ENI principal.
SecurityGroupIds.N	String	No	sg-bp15ed6xe1yxeycg7o****	Los ID de los security groups de reemplazo. El ID del security group debe ser único. La instancia se mueve de los security groups actuales a los de reemplazo. Si desea que permanezca en los grupos actuales, agregue sus ID a la lista. Puede mover la instancia a security groups de otro tipo; sin embargo, la lista no puede contener simultáneamente ID de security groups básicos y avanzados. El security group especificado y la instancia deben pertenecer a la misma VPC. Los valores válidos de N dependen del número máximo de security groups a los que puede pertenecer la instancia. Para obtener más información, consulte Limits. Los nuevos security groups surten efecto tras una breve latencia.
RemoteConnectionOptions.Password	String	No	hide	Nota Este parámetro se encuentra en vista previa privada y no está disponible públicamente.
RemoteConnectionOptions.Type	String	No	hide	Nota Este parámetro se encuentra en vista previa privada y no está disponible públicamente.
EnableJumboFrame	Boolean	No	false	Indica si se debe habilitar la función Jumbo Frames para la instancia. Valores válidos: true false La función Jumbo Frames solo se puede habilitar en ciertos tipos de instancia. Para obtener más información, consulte MTUs.
CpuOptions.TopologyType	String	No	DiscreteCoreToHTMapping	El tipo de topología de CPU de la instancia. Valores válidos: ContinuousCoreToHTMapping: La tecnología Hyper-Threading (HT) permite que hilos continuos se ejecuten en el mismo núcleo dentro de la topología de CPU de la instancia. DiscreteCoreToHTMapping: La tecnología HT permite que hilos discretos se ejecuten en el mismo núcleo dentro de la topología de CPU de la instancia. Este parámetro está vacío de forma predeterminada. Nota Solo ciertas familias de instancias admiten este parámetro. Para conocer las familias compatibles, consulte View and modify the CPU topology. Antes de especificar este parámetro, asegúrese de que la instancia esté en estado Stopped (`Stopped`).

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidInstanceName.Malformed	The specified parameter "InstanceName" is not valid.	Valor de InstanceName no válido.
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	Formato de Description no válido. La descripción debe tener entre 2 y 256 caracteres y no puede comenzar con http:// ni https://.
400	ImageNotSupportCloudInit	The specified image does not support cloud-init.	La imagen especificada no es compatible con cloud-init.
400	ChargeTypeViolation	Pay-As-You-Go instances do not support this operation.	Esta operación no se puede realizar en instancias pay-as-you-go. Compruebe el método de facturación de la instancia.
400	InvalidParameter.RecycleBin	You do not have permission to set recyclable properties.	No tiene permiso para establecer propiedades reciclables.
400	InvalidParameter.CreditSpecification	The specified CreditSpecification is not supported in this region.	La especificación de crédito indicada no es compatible con esta región.
400	InvalidInstanceStatus.CreditSpecRestricted	The current status of the resource does not support this operation.	Esta operación no se puede realizar en el recurso debido a su estado actual.
400	InvalidInstanceStatus.NotRunning	The current status of the resource is invalid, you can only do this operation when instance is running.	Esta operación no se puede realizar en la instancia debido a su estado actual. Inténtelo nuevamente cuando la instancia esté en estado Running.
400	JoinedGroupLimitExceed	%s	Se superó el número máximo de security groups a los que puede asignarse el recurso especificado. Para obtener más información, consulte el valor devuelto en el marcador %s del mensaje de error.
400	InvalidParameter	The specified parameter is not valid.	Un parámetro especificado no es válido.
400	InvalidOperation.InvalidEcsState	%s	Esta operación no se puede realizar en la instancia debido a su estado actual.
400	InvalidOperation.InstanceStatusUnsupported	The specified instance status does not support modification of cpu topology type.	No se puede modificar la topología de CPU mientras la instancia se encuentra en su estado actual.
400	InvalidParameter.CpuOptionsTopologyType	The specified parameter CpuOptions.TopologyType: %s is not valid.	El valor de enumeración del tipo de topología de CPU actual no es válido.
400	InvalidInstanceType.NotSupportCpuOptionsTopologyType	The specified instance type does not support CpuOptions.TopologyType: %s.	El tipo de instancia no admite la topología de CPU especificada.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Esta operación no se puede realizar en el recurso debido a su estado actual.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	La instancia está bloqueada por motivos de seguridad.
403	OperationDenied	The instance amount in the specified SecurityGroup reach its limit.	Se superó el número máximo de instancias permitido en el security group especificado.
403	OperationDenied	The current status of the resource does not support this operation.	Esta operación no se puede realizar en el recurso debido a su estado actual.
403	InvalidUserData.Base64FormatInvalid	The specified UserData is not valid	Valor de UserData no válido.
403	InvalidChargeType.ValueNotSupported	Deletion protection is only valid for postPaid instance, not for prePaid or spot instance.	La función de protección contra liberación solo es válida para recursos pay-as-you-go.
403	InvalidUser.Unauthorized	The user is not authorized	No está autorizado para realizar esta operación.
403	EnterpriseGroupLimited.MutliGroupType	The specified instance can not join multi SecurityGroup types.	La instancia especificada no puede pertenecer simultáneamente a un security group básico y a uno avanzado. Puede llamar a la operación DescribeSecurityGroups para consultar el tipo de un security group específico.
403	SecurityGroupInstanceLimitExceed	%s	Se superó el número máximo de instancias en el security group especificado.
403	InstanceNotInSecurityGroup	The instance not in the group.	La instancia especificada no pertenece al security group.
403	InvalidOperation.InvalidRegion	%s	Valor de RegionId no válido.
403	OperationDenied	The specified Image is disabled or is deleted.	La imagen especificada está deshabilitada o eliminada.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	No es posible modificar security groups administrados por servicios en la nube.
403	InvalidParameter.InvalidEniQueueNumber	%s	Valor de QueueNumber no válido. Para obtener más información, consulte el valor devuelto en el marcador %s del mensaje de error.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	Se superó el número máximo de colas por ENI. Para obtener más información, consulte el valor devuelto en el marcador %s del mensaje de error.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Se superó el número máximo de colas para todas las ENI de la instancia. Para obtener más información, consulte el valor devuelto en el marcador %s del mensaje de error.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	El security group especificado no existe en esta cuenta. Verifique que el ID sea correcto.
404	Credit.NotFound	The specified credit information does not exist.	La información de crédito especificada no existe.
404	InvalidParameter.SecurityGroupIdRepeated	The specified security group ids has repeated.	Se encontraron ID de security group duplicados. Verifique que el valor de SecurityGroupIds.N sea válido.
404	InvalidSecurityGroupType.NotSupportClassic	The specified SecurityGroupIds have classic group type.	El security group especificado pertenece a la red clásica. Verifique que el valor de SecurityGroupId.N sea válido.
404	InvalidSecurityGroupVpc.NotBelongToOneVpc	The specified SecurityGroupIds are belong to different vpc.	Los security groups especificados pertenecen a distintas VPC. Verifique que el valor de SecurityGroupIds.N sea válido. Puede llamar a la operación DescribeSecurityGroups para consultar las VPC a las que pertenecen.
500	InternalError	The request processing has failed due to some unknown error.	Ocurrió un error interno. Inténtelo de nuevo más tarde.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocurrió un error interno. Inténtelo de nuevo más tarde.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.