All Products
Search

This Product

    Elastic Compute Service:ModifyInstanceAttribute

    Document Center

    Elastic Compute Service:ModifyInstanceAttribute

    Last Updated:Jun 29, 2026

    Mengubah beberapa properti instans ECS, termasuk kata sandi, nama instans, hostname, keanggotaan grup keamanan, MTU, dan data pengguna instans.

    Deskripsi operasi

    Instans yang terkunci karena alasan keamanan tidak mendukung operasi ini. Untuk informasi selengkapnya, lihat Dampak kunci keamanan Sumber daya pada pemanggilan API.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ecs:ModifyInstanceAttribute

    update

    *Instance

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

    SecurityGroup

    acs:ecs:{#regionId}:{#accountId}:securitygroup/{#SecurityGroupId}
    • ecs:tag
    • ecs:PasswordCustomized
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    ID instans.

    i-bp67acfmxazb4ph****
    Password

    string

    No

    Kata sandi instans. Kata sandi harus memiliki panjang 8 hingga 30 karakter dan harus mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus. Karakter khusus berikut didukung: ()`~!@#$%^&*-_+=|{}[]:;'<>,.?/ . Untuk instans Windows, kata sandi tidak boleh diawali dengan garis miring (/). Perhatikan hal-hal berikut:

    • Instans tidak boleh berada dalam status Starting.

    • Kata sandi baru berlaku setelah Anda merestart instans. Anda dapat merestart instans di Konsol ECS (untuk informasi selengkapnya, lihat Restart an instance) atau dengan memanggil RebootInstance. Merestart instans dari dalam sistem operasi tidak akan berlaku.

    Catatan

    Jika Anda menentukan parameter Password, gunakan HTTPS untuk mengirim permintaan guna menghindari kebocoran kata sandi.

    Test123456&$
    HostName

    string

    No

    Hostname sistem operasi. Perhatikan hal-hal berikut:

    • Instans tidak boleh berada dalam status Pending atau Starting. Jika tidak, konfigurasi hostname dan /etc/hosts mungkin tidak berlaku. Anda dapat memanggil DescribeInstances untuk mengkueri status instans saat ini.

    • Hostname baru berlaku setelah Anda merestart instans. Anda dapat merestart instans di Konsol ECS (untuk informasi selengkapnya, lihat Restart an instance) atau dengan memanggil RebootInstance. Merestart instans dari dalam sistem operasi tidak akan berlaku.

    Hostname memiliki batas berikut untuk sistem operasi yang berbeda:

    • Windows Server: Hostname harus memiliki panjang 2 hingga 15 karakter dan dapat mengandung huruf besar, huruf kecil, angka, dan tanda hubung (-). Hostname tidak boleh diawali atau diakhiri dengan tanda hubung (-), tidak boleh mengandung tanda hubung (-) berurutan, dan tidak boleh hanya berisi angka.

    • Instans lain (seperti Linux): Hostname harus memiliki panjang 2 hingga 64 karakter. Anda dapat menggunakan titik (.) untuk memisahkan hostname menjadi beberapa segmen. Setiap segmen dapat mengandung huruf besar, huruf kecil, angka, dan tanda hubung (-), tetapi tidak boleh mengandung titik (.) atau tanda hubung (-) berurutan. Hostname tidak boleh diawali atau diakhiri dengan titik (.) atau tanda hubung (-).

    testHostName
    InstanceName

    string

    No

    Nama instans. Nama harus memiliki panjang 2 hingga 128 karakter. Nama harus diawali dengan huruf besar, huruf kecil, atau karakter Tionghoa, dan tidak boleh diawali dengan http:// atau https://. Nama dapat mengandung angka, titik dua (:), garis bawah (_), dan tanda hubung (-).

    testInstanceName
    Description

    string

    No

    Deskripsi instans. Deskripsi harus memiliki panjang 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    testInstanceDescription
    UserData

    string

    No

    Data pengguna instans. Kami menyarankan Anda untuk mengodekan data dalam Base64 sebelum meneruskannya. Perhatikan hal-hal berikut:

    • Instans harus memenuhi batas penggunaan untuk data pengguna instans. Untuk informasi selengkapnya, lihat Create instance user data.

    • Setelah Anda merestart instans, data pengguna baru ditampilkan pada instans tetapi tidak dijalankan.

    Catatan

    Sebelum pengodean Base64, data mentah tidak boleh melebihi 32 KB. Jangan meneruskan informasi sensitif seperti kata sandi dan kunci privat dalam teks biasa. Jika Anda harus meneruskan informasi sensitif, enkripsi informasi tersebut, kodekan dalam Base64, lalu dekripsi dengan cara yang sama di dalam instans.

    ZWNobyBoZWxsbyBlY3Mh
    Recyclable

    boolean

    No

    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk publik.

    true
    CreditSpecification

    string

    No

    Mode berjalan Instans burstable. Nilai valid:

    • Standard: mode standar.

    • Unlimited: mode tanpa batas.

    Untuk informasi selengkapnya tentang mode berjalan Instans burstable, lihat What are burstable instances?.

    Standard
    DeletionProtection

    boolean

    No

    Atribut perlindungan pelepasan instans. Apakah instans dapat dilepaskan dari konsol atau dengan memanggil DeleteInstance.

    Catatan

    Atribut ini hanya berlaku untuk instans pay-as-you-go dan hanya mencegah operasi pelepasan manual. Atribut ini tidak berlaku untuk operasi pelepasan yang diinisialisasi sistem.

    false
    NetworkInterfaceQueueNumber

    integer

    No

    Jumlah antrian untuk pengontrol antarmuka jaringan (NIC) utama. Perhatikan hal-hal berikut:

    • Instans harus berada dalam status Stopped.

    • Nilai tidak boleh melebihi jumlah antrian maksimum per NIC yang diizinkan oleh tipe instans. Jumlah total antrian untuk semua NIC pada instans tidak boleh melebihi kuota antrian total yang diizinkan oleh tipe instans. Anda dapat memanggil DescribeInstanceTypes untuk mengkueri jumlah antrian maksimum per NIC dan kuota antrian total untuk suatu tipe instans.

    • Jika Anda menetapkan parameter ini ke -1, jumlah antrian untuk NIC utama diatur ulang ke nilai default untuk tipe instans. Anda dapat memanggil DescribeInstanceTypes untuk mengkueri jumlah antrian Elastic Network Interface (ENI) default untuk suatu tipe instans.

    8
    SecurityGroupIds

    array

    No

    ID grup keamanan tempat instans ditetapkan ulang. Perhatikan hal-hal berikut:

    • ID grup keamanan dalam array tidak boleh duplikat. Panjang maksimum array bergantung pada jumlah maksimum grup keamanan yang dapat dimiliki instans. Untuk informasi selengkapnya, lihat Limits.

    • Instans keluar dari grup keamanan saat ini. Untuk mempertahankan grup keamanan saat ini, tambahkan ID-nya ke array.

    • Anda dapat beralih di antara tipe grup keamanan, tetapi daftar tidak boleh mengandung grup keamanan dasar dan grup keamanan lanjutan secara bersamaan.

    • Grup keamanan harus berada dalam VPC yang sama dengan instans.

    Catatan

    Perubahan pada grup keamanan berlaku pada instans sesaat setelah modifikasi, tetapi mungkin terjadi sedikit penundaan.

    sg-bp15ed6xe1yxeycg7o****

    string

    No

    ID grup keamanan.

    sg-bp15ed6xe1yxeycg7o****
    RemoteConnectionOptions

    object

    No

    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk publik.

    Password

    string

    No

    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk publik.

    hide
    Type

    string

    No

    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk publik.

    hide
    EnableJumboFrame

    boolean

    No

    Apakah akan mengaktifkan fitur Jumbo Frame untuk MTU instans. Nilai valid:

    • true: mengaktifkan fitur.

    • false: tidak mengaktifkan fitur.

    Perhatikan hal-hal berikut:

    • Instans harus berada dalam status Running atau Stopped.

    • Instans harus merupakan instans yang terhubung ke VPC.

    • Setelah fitur Jumbo Frame diaktifkan, nilai MTU instans berubah menjadi 8500. Setelah fitur dinonaktifkan, nilai MTU kembali ke 1500. Hanya beberapa tipe instans yang mendukung fitur Jumbo Frame. Untuk informasi selengkapnya, lihat MTU instans ECS.

    false
    CpuOptions.Core

    integer

    No

    Jumlah inti CPU. Parameter ini tidak mendukung nilai kustom dan hanya dapat menggunakan nilai default.

    2
    CpuOptions.ThreadsPerCore

    integer

    No

    Jumlah thread per inti CPU. Jumlah vCPU instans ECS = nilai CpuOptions.Core × nilai CpuOptions.ThreadsPerCore.

    • CpuOptions.ThreadsPerCore=1 menunjukkan bahwa hyper-threading dinonaktifkan.

    • Hanya beberapa tipe instans yang mendukung jumlah thread kustom.

    2
    CpuOptions.TopologyType

    string

    No

    Tipe topologi CPU instans. Nilai valid:

    • ContinuousCoreToHTMapping: hyper-thread dari inti yang sama dalam topologi CPU bersifat kontinu.

    • DiscreteCoreToHTMapping: hyper-thread dari inti yang sama bersifat diskrit.

    Nilai default: none.

    Perhatikan hal-hal berikut:

    • Instans harus berada dalam status Stopped.

    Catatan

    Hanya beberapa keluarga instans yang mendukung parameter ini. Untuk informasi tentang keluarga instans yang didukung, lihat Melihat dan mengubah struktur topologi CPU.

    DiscreteCoreToHTMapping
    PrivateDnsNameOptions

    object

    No

    Konfigurasi nama domain privat instans.

    Untuk informasi selengkapnya tentang resolusi domain privat, lihat ECS private private domain resolution.

    EnableInstanceIdDnsARecord

    boolean

    No

    Apakah akan mengaktifkan resolusi DNS dari nama domain berbasis ID instans ke alamat IPv4. Nilai valid:

    • true: mengaktifkan resolusi.

    • false: menonaktifkan resolusi.

    Nilai default: false.

    false
    EnableInstanceIdDnsAAAARecord

    boolean

    No

    Apakah akan mengaktifkan resolusi DNS dari nama domain berbasis ID instans ke alamat IPv6. Nilai valid:

    • true: mengaktifkan resolusi.

    • false: menonaktifkan resolusi.

    Nilai default: false.

    false
    EnableIpDnsARecord

    boolean

    No

    Apakah akan mengaktifkan resolusi DNS dari nama domain berbasis IP ke alamat IPv4. Nilai valid:

    • true: mengaktifkan resolusi.

    • false: menonaktifkan resolusi.

    Nilai default: false.

    false
    EnableIpDnsPtrRecord

    boolean

    No

    Apakah akan mengaktifkan resolusi DNS terbalik dari alamat IPv4 ke nama domain berbasis IP. Nilai valid:

    • true: mengaktifkan resolusi.

    • false: menonaktifkan resolusi.

    Nilai default: false.

    false
    HostnameType

    string

    No

    Tipe hostname. Nilai valid:

    • Custom: kustom.

    • IpBased: hostname berbasis IP.

    • InstanceIdBased: hostname berbasis ID instans.

    Nilai default: Custom.

    Custom
    CpuOptions

    object

    No

    NestedVirtualization

    string

    No

    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk publik.

    enabled
    EnableNetworkEncryption

    boolean

    No

    Apakah akan mengaktifkan enkripsi lalu lintas jaringan VPC. Nilai valid:

    • true: mengaktifkan enkripsi.

    • false: menonaktifkan enkripsi.

    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk publik.

    true

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidInstanceName.Malformed The specified parameter "InstanceName" is not valid.
    400 InvalidDescription.Malformed The specified parameter "Description" is not valid.
    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.
    400 InvalidPassword.Malformed The specified parameter "Password" is not valid.
    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.
    400 ChargeTypeViolation Pay-As-You-Go instances do not support this operation.
    400 InvalidParameter.RecycleBin You do not have permission to set recyclable properties.
    400 InvalidParameter.CreditSpecification The specified CreditSpecification is not supported in this region.
    400 InvalidInstanceStatus.CreditSpecRestricted The current status of the resource does not support this operation.
    400 InvalidInstanceStatus.NotRunning The current status of the resource is invalid, you can only do this operation when instance is 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
    400 InvalidParameter The specified parameter is not valid.
    400 InvalidOperation.InvalidEcsState %s
    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.
    400 InvalidParameter.CpuOptionsTopologyType The specified parameter CpuOptions.TopologyType: %s is not valid.
    400 InvalidInstanceType.NotSupportCpuOptionsTopologyType The specified instance type does not support CpuOptions.TopologyType: %s.
    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.
    400 InvalidStatus.StoppedRequired The current state of the resource does not support this operation, it can only be operated in a stopped state.
    400 InvalidParameter.CpuOptionsTurboMode The specified parameter TurboMode is not valid.
    400 InvalidInstanceType.EnableNVSUnsupported The specified instance type does not support EnableNVS.
    400 InvalidInstanceType.EnableVISSTUnsupported The specified instance type does not support EnableVISST.
    400 InvalidInstanceType.EnableVRDTUnsupported The specified instance type does not support EnableVRDT.
    400 InvalidInstanceType.SingleCoreMaxModeUnsupported The specified instance type does not support TurboMode: "SINGLE CORE MAX".
    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.
    400 InvalidParameterAuthorized.GpuOptionsConfidentialComputing The specified parameter confidential computing mode is unauthorized.
    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.
    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.
    403 OperationDenied The instance amount in the specified SecurityGroup reach its limit.
    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
    403 InvalidChargeType.ValueNotSupported Deletion protection is only valid for postPaid instance, not for prePaid or spot instance.
    403 InvalidUser.Unauthorized The user is not authorized
    403 EnterpriseGroupLimited.MutliGroupType The specified instance can not join multi SecurityGroup types.
    403 SecurityGroupInstanceLimitExceed %s
    403 InstanceNotInSecurityGroup The instance not in the group.
    403 InvalidOperation.InvalidRegion %s
    403 InvalidOperation.ResourceManagedByCloudProduct %s
    403 InvalidParameter.InvalidEniQueueNumber %s
    403 InvalidOperation.MaxEniQueueNumberExceeded %s
    403 InvalidOperation.ExceedInstanceTypeQueueNumber %s
    403 InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode %s
    403 InvalidParameter.InvalidQueuePairNumber %s
    403 InvalidOperation.MaxEniQueuePairNumberExceed %s
    403 InvalidOperation.EniQueuePairNumberOverflow %s
    403 AclLimitExceed %s
    403 InvalidInstanceType.CpuOptionsThreadsPerCoreUnsupported The current instance type does not support setting or modifying the CpuOptions.ThreadsPerCore parameter.
    403 InvalidParameter.CpuOptionsCore The specified parameter CpuOptions.Core is not valid.
    403 InvalidParameter.CpuOptionsThreadsPerCore The specified parameter CpuOptions.ThreadsPerCore is not valid.
    403 InvalidOperation.UserNotSupportNetworkEncryption User not support network encryption.
    403 InvalidOperation.InstanceTypeNotSupportNetworkEncryption The specified instance type does not support network encryption.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist.
    404 InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist.
    404 Credit.NotFound The specified credit information does not exist.
    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.
    404 InvalidSecurityGroupType.NotSupportClassic The specified SecurityGroupIds have classic group type.
    404 InvalidSecurityGroupVpc.NotBelongToOneVpc The specified SecurityGroupIds are belong to different vpc.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.