Modifica algunas propiedades de una instancia de ECS, como la contraseña, el nombre de la instancia, el nombre de host, los grupos de seguridad, la MTU y los datos de usuario de la instancia.
Descripción de la operación
No puede invocar esta operación en una instancia bloqueada por seguridad. Para obtener más información, consulte Impacto de los bloqueos de seguridad de recursos en las llamadas a la API.
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
ecs:ModifyInstanceAttribute |
update |
*Instance.
SecurityGroup.
|
|
Ninguna |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| InstanceId |
string |
Sí |
El ID de la instancia. |
i-bp67acfmxazb4ph**** |
| Password |
string |
No |
La contraseña de la instancia. La contraseña debe tener de 8 a 30 caracteres de longitud y debe contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Se admiten los siguientes caracteres especiales: ()`~!@#$%^&*-_+=|{}[]:;'<>,.?/. Para las instancias de Windows, la contraseña no puede comenzar con una barra diagonal (/). Tenga en cuenta los siguientes puntos:
Nota
Si especifica el parámetro |
Test123456&$ |
| HostName |
string |
No |
El nombre de host del sistema operativo. Tenga en cuenta los siguientes puntos:
El nombre de host tiene los siguientes límites para los diferentes sistemas operativos:
|
testHostName |
| InstanceName |
string |
No |
El nombre de la instancia. El nombre debe tener de 2 a 128 caracteres de longitud. Debe comenzar con una letra y no puede comenzar con |
testInstanceName |
| Description |
string |
No |
La descripción de la instancia. La descripción debe tener de 2 a 256 caracteres de longitud y no puede comenzar con |
testInstanceDescription |
| UserData |
string |
No |
Los datos de usuario de la instancia. Se recomienda codificar los datos en Base64 antes de incluirlos. Tenga en cuenta los siguientes puntos:
Nota
Antes de la codificación en Base64, los datos sin procesar no pueden superar los 32 KB. No incluya información confidencial como contraseñas y claves privadas en texto plano. Si debe incluir información confidencial, cifre la información, codifíquela en Base64 y, a continuación, descífrala de la misma manera dentro de la instancia. |
ZWNobyBoZWxsbyBlY3Mh |
| Recyclable |
boolean |
No |
Nota
Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente. |
true |
| CreditSpecification |
string |
No |
El modo de ejecución de la instancia ampliable. Valores válidos:
Para obtener más información sobre los modos de ejecución de las instancias ampliables, consulte Descripción general de las instancias ampliables. |
Standard |
| DeletionProtection |
boolean |
No |
El atributo de protección contra liberación de la instancia. Especifica si la instancia se puede liberar desde la consola o al invocar la operación DeleteInstance. Nota
Este atributo solo es aplicable a las instancias de pago por uso. Solo puede evitar la liberación manual, no la liberación iniciada por el sistema. |
false |
| NetworkInterfaceQueueNumber |
integer |
No |
El número de colas para la interfaz de red elástica (ENI) principal. Tenga en cuenta los siguientes puntos:
|
8 |
| SecurityGroupIds |
array |
No |
Los ID de los grupos de seguridad a los que se reasigna la instancia. Tenga en cuenta los siguientes puntos:
Nota
Los cambios surten efecto en la instancia poco después de la modificación, pero puede producirse un ligero retraso. |
sg-bp15ed6xe1yxeycg7o**** |
|
string |
No |
El ID del grupo de seguridad. |
sg-bp15ed6xe1yxeycg7o**** |
|
| RemoteConnectionOptions |
object |
No |
Nota
Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente. |
|
| Password |
string |
No |
Nota
Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente. |
hide |
| Type |
string |
No |
Nota
Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente. |
hide |
| EnableJumboFrame |
boolean |
No |
Especifica si se debe habilitar la función de tramas Jumbo para la MTU de la instancia. Valores válidos:
Tenga en cuenta los siguientes puntos:
|
false |
| CpuOptions.Core |
integer |
No |
El número de núcleos de CPU. Este parámetro no admite valores personalizados y solo puede usar el valor predeterminado. |
2 |
| CpuOptions.ThreadsPerCore |
integer |
No |
El número de subprocesos por núcleo de CPU. El número de vCPU de la instancia de ECS = valor de
|
2 |
| CpuOptions.TopologyType |
string |
No |
El tipo de topología de CPU de la instancia. Valores válidos:
Valor predeterminado: none. Tenga en cuenta los siguientes puntos:
Nota
Solo algunas familias de instancias admiten este parámetro. Para obtener información sobre las familias de instancias admitidas, consulte Ver y modificar la estructura de topología de CPU. |
DiscreteCoreToHTMapping |
| PrivateDnsNameOptions |
object |
No |
La configuración de nombre de dominio privado de la instancia. Para obtener más información sobre la resolución de nombres de dominio privados, consulte Resolución de nombres de dominio privados de ECS. |
|
| EnableInstanceIdDnsARecord |
boolean |
No |
Especifica si se debe habilitar la resolución de registros A de DNS desde el nombre de dominio basado en el ID de instancia a la dirección IPv4. Valores válidos:
Valor predeterminado: false. |
false |
| EnableInstanceIdDnsAAAARecord |
boolean |
No |
Especifica si se debe habilitar la resolución de registros AAAA de DNS desde el nombre de dominio basado en el ID de instancia a la dirección IPv6. Valores válidos:
Valor predeterminado: false. |
false |
| EnableIpDnsARecord |
boolean |
No |
Especifica si se debe habilitar la resolución de registros A de DNS desde el nombre de dominio basado en IP a la dirección IPv4. Valores válidos:
Valor predeterminado: false. |
false |
| EnableIpDnsPtrRecord |
boolean |
No |
Especifica si se debe habilitar la resolución inversa de registros PTR de DNS desde la dirección IPv4 al nombre de dominio basado en IP. Valores válidos:
Valor predeterminado: false. |
false |
| HostnameType |
string |
No |
El tipo de nombre de host. Valores válidos:
Valor predeterminado: Custom. |
Custom |
| CpuOptions |
object |
No |
Las opciones de CPU. |
|
| NestedVirtualization |
string |
No |
Nota
Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente. Valores válidos:
|
enabled |
| EnableNetworkEncryption |
boolean |
No |
Especifica si se debe habilitar el cifrado de tráfico de red de VPC. Valores válidos:
Nota
Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente. |
true |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
|
object |
|||
| RequestId |
string |
El ID de la solicitud. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
Ejemplos
Respuesta exitosa
JSON Formato
{
"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. | El formato del nombre de instancia especificado no es válido. El nombre debe tener de 2 a 128 caracteres y comenzar con una letra o un carácter chino. Puede contener dígitos, puntos (.), guiones bajos (_) o guiones (-). El nombre no puede comenzar con http:// ni https://. |
| 400 | InvalidDescription.Malformed | The specified parameter "Description" is not valid. | El formato de la descripción del recurso especificado no es válido. La descripción debe tener de 2 a 256 caracteres y no puede comenzar con http:// ni https://. |
| 400 | InvalidRemoteConnectionOptions.Password | The remote connection password is invalid. | |
| 400 | InvalidRemoteConnectionOptions.Type | The remote connection type is invalid. | |
| 400 | InstanceType.ValueNotSupported | The instance type not supported. | |
| 400 | OSType.ValueNotSupported | The OS type is not supported. | |
| 400 | InvalidHostPassword.Malformed | The specified parameter "Password" is not valid. | |
| 400 | InvalidHostName.Malformed | The specified parameter "HostName" is not valid. | El parámetro HostName especificado no es válido. |
| 400 | InvalidPassword.Malformed | The specified parameter "Password" is not valid. | El parámetro Password especificado no es válido. |
| 400 | InvalidUserData.SizeExceeded | The specified parameter "UserData" exceeds the size. | |
| 400 | InvalidUserData.NotSupported | TThe specified parameter "UserData" only support the vpc and IoOptimized Instance. | |
| 400 | ImageNotSupportCloudInit | The specified image does not support cloud-init. | La imagen especificada no admite CloudInit. |
| 400 | ChargeTypeViolation | Pay-As-You-Go instances do not support this operation. | |
| 400 | InvalidParameter.RecycleBin | You do not have permission to set recyclable properties. | No tiene autorización para realizar esta operación. |
| 400 | InvalidParameter.CreditSpecification | The specified CreditSpecification is not supported in this region. | El modo de ejecución especificado de la instancia de ráfaga no se admite en esta región. |
| 400 | InvalidInstanceStatus.CreditSpecRestricted | The current status of the resource does not support this operation. | El estado actual del recurso no admite esta operación. |
| 400 | InvalidInstanceStatus.NotRunning | The current status of the resource is invalid, you can only do this operation when instance is running. | El estado actual de la instancia no admite esta operación. Realice esta operación cuando el estado de la instancia sea Running. |
| 400 | InvalidNetworkType.NotSupported | The classic networkType does not support to modify security group | |
| 400 | InvalidOperation.EniCountExceeded | =The maximum number of eni in a enterprise security group is exceeded. | |
| 400 | JoinedGroupLimitExceed | %s | El recurso especificado ha alcanzado el número máximo de grupos de seguridad a los que puede unirse. Para obtener más información, consulte el valor real devuelto para el marcador de posición %s en el mensaje de error. |
| 400 | InvalidParameter | The specified parameter is not valid. | Los parámetros de la solicitud actual no son válidos. Inténtelo de nuevo. |
| 400 | InvalidOperation.InvalidEcsState | %s | Esta operación no está permitida en el estado actual del servicio en la nube. |
| 400 | InvalidParam.NotSupportJumboFrame | Not support jumbo frame. | |
| 400 | InvalidOperation.InstanceStatusNotSupport | The instance status is not support modify mtu config. | |
| 400 | InvalidOperation.InstanceStatusUnsupported | The specified instance status does not support modification of cpu topology type. | El estado actual de la instancia no admite la modificación del tipo de topología de CPU. |
| 400 | InvalidParameter.CpuOptionsTopologyType | The specified parameter CpuOptions.TopologyType: %s is not valid. | El valor especificado del tipo de topología de CPU no es válido. |
| 400 | InvalidInstanceType.NotSupportCpuOptionsTopologyType | The specified instance type does not support CpuOptions.TopologyType: %s. | El tipo de instancia actual no admite el tipo de topología de CPU especificado. |
| 400 | InvalidAdditionalInfoPvdConfig.SizeExceeded | The specified parameter AdditionalInfo.PvdConfig exceeds the size. | |
| 400 | InvalidInstanceType.NotSupportHighDensityMode | The specified instance type does not support the use of the high density mode. | El tipo de instancia actual no admite el modo de disco de alta densidad. |
| 400 | InvalidStatus.StoppedRequired | The current state of the resource does not support this operation, it can only be operated in a stopped state. | El estado actual del recurso no admite esta operación. El recurso debe estar en el estado Stopped. |
| 400 | InvalidParameter.CpuOptionsTurboMode | The specified parameter TurboMode is not valid. | El parámetro de modo de frecuencia especificado no es válido. |
| 400 | InvalidInstanceType.EnableNVSUnsupported | The specified instance type does not support EnableNVS. | El tipo de instancia especificado no admite la habilitación de la función NVS. |
| 400 | InvalidInstanceType.EnableVISSTUnsupported | The specified instance type does not support EnableVISST. | El tipo de instancia especificado no admite la habilitación de la función VISST. |
| 400 | InvalidInstanceType.EnableVRDTUnsupported | The specified instance type does not support EnableVRDT. | El tipo de instancia especificado no admite la habilitación de la función VRDT. |
| 400 | InvalidInstanceType.SingleCoreMaxModeUnsupported | The specified instance type does not support TurboMode: "SINGLE CORE MAX". | El tipo de instancia especificado no admite la habilitación del modo de frecuencia turbo máxima de un solo núcleo. |
| 400 | InvalidInstanceType.GpuOptionsConfidentialComputingUnsupported | The specified instance type does not support the confidential computing mode. | El tipo de instancia actual no admite el modo de cómputo cifrado. |
| 400 | InvalidParameter.GpuOptionsConfidentialComputing | The specified parameter confidential computing mode is not valid. | El valor de enumeración del modo de cómputo cifrado de GPU de la instancia no es válido. |
| 400 | InvalidParameterAuthorized.GpuOptionsConfidentialComputing | The specified parameter confidential computing mode is unauthorized. | El valor especificado del parámetro del modo de cómputo cifrado de GPU para la instancia no está autorizado. |
| 400 | InvalidParameter.CpuOptionsNestedVirtualization | The specified parameter CpuOptions.NestedVirtualization: %s is not valid. | |
| 400 | InvalidInstanceType.NotSupportCpuOptionsNestedVirtualization | The specified instance type does not support CpuOptions.NestedVirtualization: %s. | La capacidad de virtualización anidada especificada no se admite en el tipo de instancia actual. |
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | |
| 403 | InstanceLockedForSecurity | The specified operation is denied as your instance is locked for security reasons. | La instancia a la que está conectado el disco está bloqueada por motivos de seguridad. |
| 403 | OperationDenied | The instance amount in the specified SecurityGroup reach its limit. | La instantánea especificada no permite la creación de volúmenes de datos. |
| 403 | InvalidUserData.Forbidden | User not authorized to input the parameter "UserData"please apply for permission "UserData" | |
| 403 | InvalidUserData.Base64FormatInvalid | The specified UserData is not valid | El UserData especificado no es válido. |
| 403 | InvalidChargeType.ValueNotSupported | Deletion protection is only valid for postPaid instance, not for prePaid or spot instance. | El método de facturación de la instancia no admite la operación especificada. |
| 403 | InvalidUser.Unauthorized | The user is not authorized | La cuenta actual no tiene los permisos requeridos. |
| 403 | EnterpriseGroupLimited.MutliGroupType | The specified instance can not join multi SecurityGroup types. | No se puede agregar la instancia especificada a un grupo de seguridad personalizado y a un grupo de seguridad avanzado al mismo tiempo. Puede llamar a DescribeSecurityGroups para consultar el tipo del grupo de seguridad especificado. |
| 403 | SecurityGroupInstanceLimitExceed | %s | Se alcanzó el número máximo de instancias en el grupo de seguridad. |
| 403 | InstanceNotInSecurityGroup | The instance not in the group. | |
| 403 | InvalidOperation.InvalidRegion | %s | |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | %s | Los grupos de seguridad gestionados por servicios en la nube no admiten operaciones de modificación. |
| 403 | InvalidParameter.InvalidEniQueueNumber | %s | El número de colas de la interfaz de red elástica (ENI) en el controlador de interfaz de red (NIC) es incorrecto. Para obtener más información, consulte el valor real devuelto para el marcador de posición %s en el mensaje de error. |
| 403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | El número de colas de la interfaz de red elástica (ENI) en el controlador de interfaz de red (NIC) supera el límite superior. Para obtener más información, consulte el valor real devuelto para el marcador de posición %s en el mensaje de error. |
| 403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | El número total de colas de la interfaz de red elástica (ENI) en el controlador de interfaz de red (NIC) supera el límite superior. Para obtener más información, consulte el valor real devuelto para el marcador de posición %s en el mensaje de error. |
| 403 | InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode | %s | El tipo de instancia de la instancia especificada no admite ENI en modo RDMA. |
| 403 | InvalidParameter.InvalidQueuePairNumber | %s | |
| 403 | InvalidOperation.MaxEniQueuePairNumberExceed | %s | |
| 403 | InvalidOperation.EniQueuePairNumberOverflow | %s | |
| 403 | AclLimitExceed | %s | El número de reglas de grupo de seguridad para la ENI o la instancia supera la cuota. |
| 403 | InvalidInstanceType.CpuOptionsThreadsPerCoreUnsupported | The current instance type does not support setting or modifying the CpuOptions.ThreadsPerCore parameter. | El tipo de instancia actual no admite establecer ni modificar el parámetro CpuOptions.ThreadsPerCore. |
| 403 | InvalidParameter.CpuOptionsCore | The specified parameter CpuOptions.Core is not valid. | El parámetro CpuOptions.Core no es válido. |
| 403 | InvalidParameter.CpuOptionsThreadsPerCore | The specified parameter CpuOptions.ThreadsPerCore is not valid. | El parámetro CpuOptions.ThreadsPerCore no es válido. |
| 403 | InvalidOperation.UserNotSupportNetworkEncryption | User not support network encryption. | El usuario no admite la especificación de parámetros de cifrado del tráfico de red. |
| 403 | InvalidOperation.InstanceTypeNotSupportNetworkEncryption | The specified instance type does not support network encryption. | El tipo de instancia especificado no admite el cifrado del tráfico de VPC. |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | La instancia especificada no existe. Verifique si el ID de la instancia es correcto. |
| 404 | InvalidSecurityGroupId.NotFound | The specified SecurityGroupId does not exist. | El grupo de seguridad especificado no existe en su cuenta. Verifique que el ID del grupo de seguridad sea correcto. |
| 404 | Credit.NotFound | The specified credit information does not exist. | La información de créditos de CPU de la instancia burstable especificada no existe. |
| 404 | InvalidInstanceStatus.NeedRestart | The current status of the resource is invalid, you can only do this operation after instance is restarted. | |
| 404 | InvalidParameter.SecurityGroupIdRepeated | The specified security group ids has repeated. | El grupo de seguridad especificado ya se ha agregado. Verifique si el valor del parámetro SecurityGroupIds es correcto. |
| 404 | InvalidSecurityGroupType.NotSupportClassic | The specified SecurityGroupIds have classic group type. | El tipo de red del grupo de seguridad especificado es red clásica. Verifique si el valor del parámetro SecurityGroupIds es correcto. |
| 404 | InvalidSecurityGroupVpc.NotBelongToOneVpc | The specified SecurityGroupIds are belong to different vpc. | Los ID de grupo de seguridad especificados pertenecen a distintas VPC. Verifique si el valor del parámetro SecurityGroupIds es correcto. Puede llamar a DescribeSecurityGroups para consultar la VPC a la que pertenece el grupo de seguridad especificado. |
Consulte Códigos de error para ver la lista completa.
Notas de la versión
Consulte Notas de la versión para ver la lista completa.