Tüm Ürünler
Search
Belge Merkezi

:ModifyInstanceAttribute

Son Güncelleme:Oct 01, 2026

Örnek parolası ve adı dahil olmak üzere örnek özniteliklerini değiştirmek için ModifyInstanceAttribute işlemini çağırır.

Operation description

  • Örnek durumu Starting olduğunda örnek parolasını sıfırlayamazsınız.

  • Örnek durumu Running olduğunda örnek parolasını değiştiremezsiniz.

  • Parolayı sıfırladıktan sonra, değişikliğin etkili olması için örneği konsoldan yeniden başlatın veya RebootInstance işlemini çağırın. Örneği işletim sistemi içinden yeniden başlatmak değişikliğin etkili olmasını sağlamaz.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ens:ModifyInstanceAttribute

update

*Instance

acs:ens:*:{#accountId}:instance/{#InstanceId}

None None

Request parameters

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

Değiştirilecek örneğin kimliği. Yalnızca tek bir örnek desteklenir.

i-instanc****

Password

string

No

Örneğin parolası.

yourPassword

InstanceName

string

No

Örneğin adı.

Ad 2 ila 128 karakter uzunluğunda olmalıdır ve harf, rakam, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir. Bir harf veya Çince karakterle başlamalıdır ve http:// veya https:// ile başlayamaz.

i-instanceidname

HostName

string

No

ECS örneğinin ana bilgisayar adı. Ana bilgisayar adı 2 ila 64 karakter uzunluğunda olmalıdır. Ana bilgisayar adını birden fazla bölüme ayırmak için nokta (.) kullanabilirsiniz. Her bölüm harf, rakam ve tire (-) içerebilir. Ana bilgisayar adı ardışık nokta (.) veya tire (-) içeremez ve nokta (.) veya tire (-) ile başlayamaz veya bitemez.

testHostName

UserData

string

No

Base64 ile kodlanması gereken örneğin kullanıcı verileri. Kodlamadan önceki ham verilerin boyutu 16 KB'ı aşamaz. Parola veya özel anahtarlar gibi hassas bilgileri düz metin olarak iletmeyin. Hassas bilgileri iletmeniz gerekiyorsa, Base64 ile kodlamadan önce şifreleyin ve örneğin içinde aynı şekilde şifresini çözün.

/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgK****

DeletionProtection

boolean

No

Response elements

Element

Type

Description

Example

object

Code

integer

İşlem dönüş kodu. 0 değeri başarıyı gösterir.

200

RequestId

string

İstek kimliği.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Examples

Success response

JSON format

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

Error codes

HTTP status code

Error code

Error message

Description

400 MissingParameter The input parameter that is mandatory for processing this request is not supplied.
400 InstanceIdNotFound The input parameter InstanceId that is not found.
400 InvalidParameter.%s The specified field %s invalid. Please check it again.
400 NoPermission Permission denied.
400 InvalidDeletionAppointmentNotSupported The scheduled release time of the current instance is set to prohibit this operation.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.