Modifie certains attributs d'une instance ECS, tels que le mot de passe, le nom de l'instance, le nom d'hôte, les groupes de sécurité, le MTU et les données utilisateur de l'instance.
Description de l'opération
Vous ne pouvez pas appeler cette opération sur une instance verrouillée pour des raisons de sécurité. Pour plus d'informations, consultez Impact des verrous de sécurité des ressources sur les appels d'API.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
|
ecs:ModifyInstanceAttribute |
update |
*Instance.
SecurityGroup.
|
|
Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| InstanceId |
string |
Oui |
L'identifiant de l'instance. |
i-bp67acfmxazb4ph**** |
| Password |
string |
Non |
Le mot de passe de l'instance. Le mot de passe doit comporter de 8 à 30 caractères et doit contenir au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux. Les caractères spéciaux suivants sont pris en charge : ()`~!@#$%^&*-_+=|{}[]:;'<>,.?/ . Pour les instances Windows, le mot de passe ne peut pas commencer par une barre oblique (/). Prenez note des éléments suivants :
Remarque
Si vous spécifiez le paramètre Password, utilisez HTTPS pour envoyer la requête afin d'éviter les fuites de mot de passe. |
Test123456&$ |
| HostName |
string |
Non |
Le nom d'hôte du système d'exploitation. Prenez note des éléments suivants :
Le nom d'hôte présente les limites suivantes pour les différents systèmes d'exploitation :
|
testHostName |
| InstanceName |
string |
Non |
Le nom de l'instance. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par http:// ou https://. Le nom peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-). |
testInstanceName |
| Description |
string |
Non |
La description de l'instance. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://. |
testInstanceDescription |
| UserData |
string |
Non |
Les données utilisateur de l'instance. Nous vous recommandons d'encoder les données en Base64 avant de les transmettre. Prenez note des éléments suivants :
Remarque
Avant l'encodage en Base64, les données brutes ne peuvent pas dépasser 32 Ko. Ne transmettez pas d'informations sensibles telles que des mots de passe et des clés privées en texte brut. Si vous devez transmettre des informations sensibles, chiffrez les informations, encodez-les en Base64, puis déchiffrez-les de la même manière au sein de l'instance. |
ZWNobyBoZWxsbyBlY3Mh |
| Recyclable |
boolean |
Non |
Remarque
Ce paramètre est en préversion sur invitation et n'est pas disponible publiquement. |
true |
| CreditSpecification |
string |
Non |
Le mode de fonctionnement de l'instance extensible. Valeurs valides :
Pour plus d'informations sur les modes de fonctionnement des instances extensibles, consultez Présentation des instances extensibles. |
Standard |
| DeletionProtection |
boolean |
Non |
L'attribut de protection contre la libération de l'instance. Indique si l'instance peut être libérée depuis la console ou en appelant l'opération DeleteInstance. Remarque
Cet attribut s'applique uniquement aux instances à la demande. Il peut uniquement empêcher la libération manuelle, et non la libération initiée par le système. |
false |
| NetworkInterfaceQueueNumber |
integer |
Non |
Le nombre de files d'attente pour l'interface réseau élastique (ENI) principale. Prenez note des éléments suivants :
|
8 |
| SecurityGroupIds |
array |
Non |
Les identifiants des groupes de sécurité auxquels l'instance est réaffectée. Prenez note des éléments suivants :
Remarque
Les modifications prennent effet sur l'instance peu de temps après la modification, mais un léger délai peut survenir. |
sg-bp15ed6xe1yxeycg7o**** |
|
string |
Non |
L'identifiant du groupe de sécurité. |
sg-bp15ed6xe1yxeycg7o**** |
|
| RemoteConnectionOptions |
object |
Non |
Remarque
Ce paramètre est en préversion sur invitation et n'est pas disponible publiquement. |
|
| Password |
string |
Non |
Remarque
Ce paramètre est en préversion sur invitation et n'est pas disponible publiquement. |
hide |
| Type |
string |
Non |
Remarque
Ce paramètre est en préversion sur invitation et n'est pas disponible publiquement. |
hide |
| EnableJumboFrame |
boolean |
Non |
Indique si la fonctionnalité Jumbo Frame doit être activée pour le MTU de l'instance. Valeurs valides :
Prenez note des éléments suivants :
|
false |
| CpuOptions.Core |
integer |
Non |
Le nombre de cœurs de processeur. Ce paramètre ne prend pas en charge les valeurs personnalisées et ne peut utiliser que la valeur par défaut. |
2 |
| CpuOptions.ThreadsPerCore |
integer |
Non |
Le nombre de threads par cœur de processeur. Le nombre de vCPU de l'instance ECS = valeur CpuOptions.Core × valeur CpuOptions.ThreadsPerCore.
|
2 |
| CpuOptions.TopologyType |
string |
Non |
Le type de topologie du processeur de l'instance. Valeurs valides :
Valeur par défaut : none. Prenez note des éléments suivants :
Remarque
Seules certaines familles d'instances prennent en charge ce paramètre. Pour plus d'informations sur les familles d'instances prises en charge, consultez Afficher et modifier la structure de topologie du processeur. |
DiscreteCoreToHTMapping |
| PrivateDnsNameOptions |
object |
Non |
La configuration du nom de domaine privé de l'instance. Pour plus d'informations sur la résolution de noms de domaine privés, consultez Résolution de noms de domaine privés ECS. |
|
| EnableInstanceIdDnsARecord |
boolean |
Non |
Indique si la résolution d'enregistrement DNS A doit être activée du nom de domaine basé sur l'identifiant de l'instance vers l'adresse IPv4. Valeurs valides :
Valeur par défaut : false. |
false |
| EnableInstanceIdDnsAAAARecord |
boolean |
Non |
Indique si la résolution d'enregistrement DNS AAAA doit être activée du nom de domaine basé sur l'identifiant de l'instance vers l'adresse IPv6. Valeurs valides :
Valeur par défaut : false. |
false |
| EnableIpDnsARecord |
boolean |
Non |
Indique si la résolution d'enregistrement DNS A doit être activée du nom de domaine basé sur l'IP vers l'adresse IPv4. Valeurs valides :
Valeur par défaut : false. |
false |
| EnableIpDnsPtrRecord |
boolean |
Non |
Indique si la résolution d'enregistrement PTR DNS inversé doit être activée de l'adresse IPv4 vers le nom de domaine basé sur l'IP. Valeurs valides :
Valeur par défaut : false. |
false |
| HostnameType |
string |
Non |
Le type de nom d'hôte. Valeurs valides :
Valeur par défaut : Custom. |
Custom |
| CpuOptions |
object |
Non |
Les options du processeur. |
|
| NestedVirtualization |
string |
Non |
Remarque
Ce paramètre est en préversion sur invitation et n'est pas disponible publiquement. Valeurs valides :
|
enabled |
| EnableNetworkEncryption |
boolean |
Non |
Indique si le chiffrement du trafic réseau du VPC doit être activé. Valeurs valides :
Remarque
Ce paramètre est en préversion sur invitation et n'est pas disponible publiquement. |
true |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
|||
| RequestId |
string |
L'identifiant de la requête. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
Exemples
JSON format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
Codes d'erreur
|
Code de statut HTTP |
Code d'erreur |
Message d'erreur |
Description |
|---|---|---|---|
| 400 | InvalidInstanceName.Malformed | The specified parameter "InstanceName" is not valid. | Le format du nom d'instance spécifié n'est pas valide. Le nom doit comporter de 2 à 128 caractères et commencer par une lettre ou un caractère chinois. Il peut contenir des chiffres, des points (.), des traits de soulignement (_) ou des traits d'union (-). Il ne peut pas commencer par http:// ou https://. |
| 400 | InvalidDescription.Malformed | The specified parameter "Description" is not valid. | Le format de description de la ressource spécifié n'est pas valide. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par http:// ou 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. | Le paramètre HostName spécifié n'est pas valide. |
| 400 | InvalidPassword.Malformed | The specified parameter "Password" is not valid. | Le paramètre Password spécifié n'est pas valide. |
| 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. | L'image spécifiée ne prend pas en charge 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. | Vous n'êtes pas autorisé à effectuer cette opération. |
| 400 | InvalidParameter.CreditSpecification | The specified CreditSpecification is not supported in this region. | Le mode de fonctionnement spécifié de l'instance extensible n'est pas pris en charge dans cette région. |
| 400 | InvalidInstanceStatus.CreditSpecRestricted | The current status of the resource does not support this operation. | L'état actuel de la ressource ne prend pas en charge cette opération. |
| 400 | InvalidInstanceStatus.NotRunning | The current status of the resource is invalid, you can only do this operation when instance is running. | L'état actuel de l'instance ne prend pas en charge cette opération. Effectuez cette opération lorsque l'état de l'instance est 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 | La ressource spécifiée a atteint le nombre maximal de groupes de sécurité qu'elle peut rejoindre. Pour plus d'informations, consultez le résultat réel de l'espace réservé %s dans le message d'erreur. |
| 400 | InvalidParameter | The specified parameter is not valid. | Les paramètres de requête actuels ne sont pas valides. Réessayez. |
| 400 | InvalidOperation.InvalidEcsState | %s | Cette opération n'est pas autorisée dans l'état actuel du service cloud. |
| 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. | L'état actuel de l'instance ne prend pas en charge la modification du type de topologie CPU. |
| 400 | InvalidParameter.CpuOptionsTopologyType | The specified parameter CpuOptions.TopologyType: %s is not valid. | La valeur du type de topologie CPU spécifié n'est pas valide. |
| 400 | InvalidInstanceType.NotSupportCpuOptionsTopologyType | The specified instance type does not support CpuOptions.TopologyType: %s. | Le type d'instance actuel ne prend pas en charge le type de topologie CPU spécifié. |
| 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. | Le type d'instance actuel ne prend pas en charge le mode de disque haute densité. |
| 400 | InvalidStatus.StoppedRequired | The current state of the resource does not support this operation, it can only be operated in a stopped state. | L'état actuel de la ressource ne prend pas en charge cette opération. La ressource doit être dans l'état Stopped. |
| 400 | InvalidParameter.CpuOptionsTurboMode | The specified parameter TurboMode is not valid. | Le paramètre de mode de fréquence spécifié n'est pas valide. |
| 400 | InvalidInstanceType.EnableNVSUnsupported | The specified instance type does not support EnableNVS. | Le type d'instance spécifié ne prend pas en charge l'activation de la fonctionnalité NVS. |
| 400 | InvalidInstanceType.EnableVISSTUnsupported | The specified instance type does not support EnableVISST. | Le type d'instance spécifié ne prend pas en charge l'activation de la fonctionnalité VISST. |
| 400 | InvalidInstanceType.EnableVRDTUnsupported | The specified instance type does not support EnableVRDT. | Le type d'instance spécifié ne prend pas en charge l'activation de la fonctionnalité VRDT. |
| 400 | InvalidInstanceType.SingleCoreMaxModeUnsupported | The specified instance type does not support TurboMode: "SINGLE CORE MAX". | Le type d'instance spécifié ne prend pas en charge l'activation du mode de fréquence turbo maximale monocœur. |
| 400 | InvalidInstanceType.GpuOptionsConfidentialComputingUnsupported | The specified instance type does not support the confidential computing mode. | |
| 400 | InvalidParameter.GpuOptionsConfidentialComputing | The specified parameter confidential computing mode is not valid. | La valeur d'énumération pour le mode de calcul chiffré du GPU de l'instance n'est pas valide. |
| 400 | InvalidParameterAuthorized.GpuOptionsConfidentialComputing | The specified parameter confidential computing mode is unauthorized. | La valeur du paramètre du mode de calcul chiffré du GPU spécifiée pour l'instance n'est pas autorisée. |
| 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. | Le type d'instance spécifié ne prend pas en charge la fonctionnalité de virtualisation imbriquée spécifiée. |
| 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. | L'instance à laquelle le disque est attaché est verrouillée pour des raisons de sécurité. |
| 403 | OperationDenied | The instance amount in the specified SecurityGroup reach its limit. | L'instantané spécifié ne permet pas la création de volumes de données. |
| 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 | Le UserData spécifié est invalide. |
| 403 | InvalidChargeType.ValueNotSupported | Deletion protection is only valid for postPaid instance, not for prePaid or spot instance. | La méthode de facturation de l'instance ne prend pas en charge l'opération spécifiée. |
| 403 | InvalidUser.Unauthorized | The user is not authorized | Le compte actuel ne dispose pas des autorisations requises. |
| 403 | EnterpriseGroupLimited.MutliGroupType | The specified instance can not join multi SecurityGroup types. | L'instance spécifiée ne peut pas être ajoutée à la fois à un groupe de sécurité personnalisé et à un groupe de sécurité avancé. Vous pouvez appeler DescribeSecurityGroups pour interroger le type du groupe de sécurité spécifié. |
| 403 | SecurityGroupInstanceLimitExceed | %s | Le nombre maximal d'instances dans le groupe de sécurité a été atteint. |
| 403 | InstanceNotInSecurityGroup | The instance not in the group. | |
| 403 | InvalidOperation.InvalidRegion | %s | |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | %s | Les groupes de sécurité gérés par les services cloud ne prennent pas en charge les opérations de modification. |
| 403 | InvalidParameter.InvalidEniQueueNumber | %s | Le nombre de files d'attente d'interface réseau élastique (ENI) sur le contrôleur d'interface réseau (NIC) est incorrect. Pour plus d'informations, consultez le résultat réel de l'espace réservé %s dans le message d'erreur. |
| 403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | Le nombre de files d'attente d'interface réseau élastique (ENI) sur le contrôleur d'interface réseau (NIC) dépasse la limite supérieure. Pour plus d'informations, consultez le résultat réel de l'espace réservé %s dans le message d'erreur. |
| 403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | Le nombre total de files d'attente d'interface réseau élastique (ENI) sur le contrôleur d'interface réseau (NIC) dépasse la limite supérieure. Pour plus d'informations, consultez le résultat réel de l'espace réservé %s dans le message d'erreur. |
| 403 | InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode | %s | Le type d'instance de l'instance spécifiée ne prend pas en charge les ENI en mode RDMA. |
| 403 | InvalidParameter.InvalidQueuePairNumber | %s | |
| 403 | InvalidOperation.MaxEniQueuePairNumberExceed | %s | |
| 403 | InvalidOperation.EniQueuePairNumberOverflow | %s | |
| 403 | AclLimitExceed | %s | Le nombre de règles de groupe de sécurité pour l'ENI ou l'instance dépasse le quota. |
| 403 | InvalidInstanceType.CpuOptionsThreadsPerCoreUnsupported | The current instance type does not support setting or modifying the CpuOptions.ThreadsPerCore parameter. | Le type d'instance actuel ne prend pas en charge la définition ou la modification du paramètre CpuOptions.ThreadsPerCore. |
| 403 | InvalidParameter.CpuOptionsCore | The specified parameter CpuOptions.Core is not valid. | Le paramètre CpuOptions.Core est invalide. |
| 403 | InvalidParameter.CpuOptionsThreadsPerCore | The specified parameter CpuOptions.ThreadsPerCore is not valid. | Le paramètre CpuOptions.ThreadsPerCore est invalide. |
| 403 | InvalidOperation.UserNotSupportNetworkEncryption | User not support network encryption. | L'utilisateur ne prend pas en charge la spécification des paramètres de chiffrement du trafic réseau. |
| 403 | InvalidOperation.InstanceTypeNotSupportNetworkEncryption | The specified instance type does not support network encryption. | Le type d'instance spécifié ne prend pas en charge le chiffrement du trafic VPC. |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | L'instance spécifiée n'existe pas. Vérifiez que l'identifiant de l'instance est correct. |
| 404 | InvalidSecurityGroupId.NotFound | The specified SecurityGroupId does not exist. | Le groupe de sécurité spécifié n'existe pas sur votre compte. Vérifiez que l'identifiant du groupe de sécurité est correct. |
| 404 | Credit.NotFound | The specified credit information does not exist. | Les informations de crédit CPU pour l'instance extensible spécifiée n'existent pas. |
| 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. | Le groupe de sécurité spécifié a déjà été ajouté. Vérifiez si la valeur du paramètre SecurityGroupIds est correcte. |
| 404 | InvalidSecurityGroupType.NotSupportClassic | The specified SecurityGroupIds have classic group type. | Le type de réseau du groupe de sécurité spécifié est le réseau classique. Vérifiez si la valeur du paramètre SecurityGroupIds est correcte. |
| 404 | InvalidSecurityGroupVpc.NotBelongToOneVpc | The specified SecurityGroupIds are belong to different vpc. | Les identifiants de groupe de sécurité spécifiés appartiennent à différents VPC. Vérifiez si la valeur du paramètre SecurityGroupIds est correcte. Vous pouvez appeler DescribeSecurityGroups pour consulter le VPC auquel appartient le groupe de sécurité spécifié. |
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.