ModifyInstanceAttribute - - Alibaba Cloud Documentation Center

Memodifikasi atribut instans Elastic Compute Service (ECS), seperti kata sandi, nama, deskripsi, hostname, grup keamanan, maximum transmission unit (MTU), dan user data. Jika instans tersebut merupakan burstable instance, Anda juga dapat mengubah mode performanya.

Catatan Penggunaan

Jika respons berisi {"OperationLocks": {"LockReason" : "security"}} saat Anda melakukan kueri informasi instans, instans tersebut dikunci karena alasan keamanan. Tidak ada operasi yang diizinkan pada instans tersebut.

Perhatikan hal-hal berikut:

Modifikasi hostname (HostName): Setelah memodifikasi hostname, restart instans melalui Konsol ECS atau dengan memanggil operasi RebootInstance agar perubahan berlaku. Untuk informasi tentang cara merestart instans di Konsol ECS, lihat Restart instances. Hostname baru tidak akan berlaku jika Anda merestart instans dari dalam sistem operasi.
Reset kata sandi (Password):
- Instans tidak boleh berada dalam status Starting (Starting).
- Setelah mereset kata sandi, restart instans melalui Konsol ECS atau dengan memanggil operasi RebootInstance agar perubahan berlaku. Untuk informasi tentang cara merestart instans di Konsol ECS, lihat Restart instances. Kata sandi baru tidak akan berlaku jika Anda merestart instans dari dalam sistem operasi.
Modifikasi user data (UserData):
- Instans harus berada dalam status Stopped (Stopped).
- Instans harus memenuhi batasan untuk user data. Untuk informasi selengkapnya, lihat Prepare user data.
  Catatan Setelah Anda merestart instans, user data baru akan ditampilkan tetapi tidak dijalankan sebagai skrip.
Mengganti grup keamanan (SecurityGroupIds.N):
- Anda dapat memindahkan instans ke grup keamanan dengan tipe berbeda.
  
  Jika ingin memindahkan instans ke grup keamanan dengan tipe berbeda, pahami perbedaan konfigurasi aturan antara kedua tipe grup keamanan tersebut untuk mencegah dampak terhadap jaringan instans.
- Grup keamanan untuk instans di classic network tidak dapat diubah.
  
  Untuk informasi selengkapnya, lihat deskripsi SecurityGroupIds.N.
Modifikasi jumlah antrian yang didukung oleh primary elastic network interface (ENI) (NetworkInterfaceQueueNumber):
- Instans harus berada dalam status Stopped (Stopped).
- Nilai parameter ini tidak boleh melebihi jumlah maksimum antrian yang diizinkan per ENI.
- Jumlah total antrian untuk semua ENI pada instans tidak boleh melebihi kuota antrian untuk tipe instans tersebut. Untuk mengetahui jumlah maksimum antrian per ENI dan kuota antrian untuk suatu tipe instans, panggil operasi DescribeInstanceTypes untuk melakukan kueri terhadap MaximumQueueNumberPerEni dan TotalEniQueueQuantity.
- Jika Anda mengatur parameter ini ke -1, nilainya akan direset ke nilai default untuk tipe instans tersebut. Untuk mengetahui jumlah default antrian yang didukung oleh primary ENI untuk suatu tipe instans, panggil operasi DescribeInstanceTypes untuk melakukan kueri terhadap nilai PrimaryEniQueueNumber.
Aktifkan atau nonaktifkan fitur Jumbo Frames (EnableJumboFrame): Untuk informasi selengkapnya, lihat MTUs.
- Instans harus berada dalam status Running (Running) atau Stopped (Stopped).
- Instans harus berada di virtual private cloud (VPC).
- Setelah fitur Jumbo Frames diaktifkan, nilai MTU instans diatur menjadi 8500. Setelah fitur Jumbo Frames dinonaktifkan, nilai MTU instans diatur menjadi 1500.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter Permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	ModifyInstanceAttribute	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyInstanceAttribute.
InstanceId	String	Ya	i-bp67acfmxazb4ph****	ID instans.
Password	String	Tidak	Test123456	Password instans. Password harus terdiri dari 8 hingga 30 karakter dan mengandung minimal tiga dari jenis karakter berikut: huruf kapital, huruf kecil, angka, dan karakter khusus. Karakter khusus meliputi: ( ) ` ~ ! @ # $ % ^ & * - _ + = \| { } [ ] : ; ' < > , . ? / Untuk instans Windows, password tidak boleh dimulai dengan garis miring (/). Catatan Karena alasan keamanan, kami menyarankan agar Anda menggunakan HTTPS untuk mengirim permintaan jika `Password` ditentukan.
HostName	String	Tidak	testHostName	Hostname instans. Perhatikan hal-hal berikut: Saat Anda memodifikasi hostname instans, instans tidak boleh berada dalam status Creating (`Pending`) atau Starting (`Starting`). Jika tidak, hostname baru dan konfigurasi di `/etc/hosts` mungkin tidak berlaku. Anda dapat memanggil operasi DescribeInstances untuk melakukan kueri status instans. Setelah Anda memodifikasi hostname, Anda harus memanggil operasi RebootInstance agar hostname baru berlaku. Batasan berikut berlaku untuk hostname instans yang menjalankan sistem operasi berbeda: Untuk Windows Server, hostname harus terdiri dari 2 hingga 15 karakter dan dapat berisi huruf, angka, serta tanda hubung (-). Hostname tidak boleh dimulai atau diakhiri dengan tanda hubung (-), tidak boleh mengandung tanda hubung (-) berurutan, dan tidak boleh hanya terdiri dari angka. Untuk sistem operasi lain seperti Linux, hostname harus terdiri dari 2 hingga 64 karakter. Anda dapat menggunakan titik (.) untuk memisahkan hostname menjadi beberapa segmen. Setiap segmen dapat berisi huruf, angka, dan tanda hubung (-). Hostname tidak boleh mengandung titik (.) atau tanda hubung (-) berurutan. Hostname tidak boleh dimulai atau diakhiri dengan titik (.) atau tanda hubung (-).
InstanceName	String	Tidak	testInstanceName	Nama instans. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan `http://` atau `https://`. Nama dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-).
Description	String	Tidak	testInstanceDescription	Deskripsi instans. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan `http://` atau `https://`.
UserData	String	Tidak	ZWNobyBoZWxsbyBlY3Mh	User data instans. User data harus di-encode dalam Base64. Ukuran user data tidak boleh melebihi 16 KB sebelum di-encode dalam Base64. Kami menyarankan agar Anda tidak memasukkan informasi rahasia seperti password dan kunci privat dalam teks biasa. Jika Anda harus memasukkan informasi rahasia, kami menyarankan agar Anda mengenkripsi dan meng-encode informasi tersebut dalam Base64 sebelum memasukkannya. Kemudian, Anda dapat mendekode dan mendekripsi informasi tersebut dengan cara yang sama di dalam instans.
Recyclable	Boolean	Tidak	hide	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.
CreditSpecification	String	Tidak	Standard	Mode performa burstable instance. Nilai yang valid: Standard Unlimited Untuk informasi selengkapnya tentang mode performa burstable instance, lihat Overview.
DeletionProtection	Boolean	Tidak	false	Atribut perlindungan release instans. Parameter ini menentukan apakah Anda dapat menggunakan Konsol ECS atau memanggil operasi DeleteInstance untuk melepas instans. Catatan Parameter ini hanya berlaku untuk instans pay-as-you-go. Atribut perlindungan release dapat melindungi instans dari pelepasan manual, tetapi tidak dari pelepasan otomatis.
NetworkInterfaceQueueNumber	Integer	Tidak	8	Jumlah queue yang didukung oleh primary ENI.
SecurityGroupIds.N	String	Tidak	sg-bp15ed6xe1yxeycg7o****	ID security group pengganti. ID security group harus unik. Instans dipindahkan dari security group saat ini ke security group pengganti. Jika Anda ingin instans tetap berada di security group saat ini, tambahkan ID security group saat ini ke daftar tersebut. Anda dapat memindahkan instans ke security group dengan tipe berbeda. Namun, daftar tersebut tidak boleh berisi ID security group dasar dan security group tingkat lanjut sekaligus. Security group yang ditentukan dan instans harus berada di VPC yang sama. Nilai valid N didasarkan pada jumlah maksimum security group yang dapat dimiliki oleh instans. Untuk informasi selengkapnya, lihat Limits. Security group baru akan berlaku untuk instans setelah jeda waktu singkat.
RemoteConnectionOptions.Password	String	Tidak	hide	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.
RemoteConnectionOptions.Type	String	Tidak	hide	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.
EnableJumboFrame	Boolean	Tidak	false	Menentukan apakah akan mengaktifkan fitur Jumbo Frames untuk instans. Nilai yang valid: true false Anda hanya dapat mengaktifkan fitur Jumbo Frames untuk tipe instans tertentu. Untuk informasi selengkapnya, lihat MTUs.
CpuOptions.TopologyType	String	Tidak	DiscreteCoreToHTMapping	Tipe topologi CPU instans. Nilai yang valid: ContinuousCoreToHTMapping: Teknologi Hyper-Threading (HT) memungkinkan thread berurutan berjalan pada core yang sama dalam topologi CPU instans. DiscreteCoreToHTMapping: Teknologi HT memungkinkan thread diskrit berjalan pada core yang sama dalam topologi CPU instans. Parameter ini kosong secara default. Catatan Parameter ini hanya didukung oleh keluarga instans tertentu. Untuk informasi selengkapnya tentang keluarga instans yang didukung, lihat View and modify the CPU topology. Sebelum menentukan parameter ini, pastikan bahwa instans berada dalam status Stopped (`Stopped`).

Parameter Respons

Parameter	Tipe	Contoh	Deskripsi
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.

Contoh

Contoh permintaan

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>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyInstanceAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAttributeResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Kode Kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidInstanceName.Malformed	The specified parameter "InstanceName" is not valid.	Nilai InstanceName tidak valid.
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	Format Description tidak valid. Nama harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.
400	ImageNotSupportCloudInit	The specified image does not support cloud-init.	Image yang ditentukan tidak mendukung cloud-init.
400	ChargeTypeViolation	Pay-As-You-Go instances do not support this operation.	Operasi ini tidak dapat dilakukan pada instans pay-as-you-go. Periksa metode penagihan instans.
400	InvalidParameter.RecycleBin	You do not have permission to set recyclable properties.	Anda tidak memiliki otorisasi untuk melakukan operasi ini.
400	InvalidParameter.CreditSpecification	The specified CreditSpecification is not supported in this region.	Spesifikasi kredit yang ditentukan tidak didukung di wilayah ini.
400	InvalidInstanceStatus.CreditSpecRestricted	The current status of the resource does not support this operation.	Operasi ini tidak dapat dilakukan pada resource dalam status saat ini.
400	InvalidInstanceStatus.NotRunning	The current status of the resource is invalid, you can only do this operation when instance is running.	Operasi ini tidak dapat dilakukan pada instans dalam status saat ini. Coba lagi ketika instans berada dalam status Running.
400	JoinedGroupLimitExceed	%s	Jumlah maksimum security group yang dapat ditetapkan ke resource yang ditentukan telah terlampaui. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan.
400	InvalidParameter	The specified parameter is not valid.	Salah satu parameter yang ditentukan tidak valid.
400	InvalidOperation.InvalidEcsState	%s	Operasi ini tidak dapat dilakukan pada instans dalam status saat ini.
400	InvalidOperation.InstanceStatusUnsupported	The specified instance status does not support modification of cpu topology type.	Topologi CPU tidak dapat dimodifikasi untuk instans dalam status saat ini.
400	InvalidParameter.CpuOptionsTopologyType	The specified parameter CpuOptions.TopologyType: %s is not valid.	Nilai enumerasi tipe topologi CPU saat ini tidak valid.
400	InvalidInstanceType.NotSupportCpuOptionsTopologyType	The specified instance type does not support CpuOptions.TopologyType: %s.	Tipe instans tidak mendukung topologi CPU yang ditentukan.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Operasi ini tidak dapat dilakukan pada resource dalam status saat ini.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Instans dikunci karena alasan keamanan.
403	OperationDenied	The instance amount in the specified SecurityGroup reach its limit.	Jumlah maksimum instans dalam security group yang ditentukan telah terlampaui.
403	OperationDenied	The current status of the resource does not support this operation.	Operasi ini tidak dapat dilakukan pada resource dalam status saat ini.
403	InvalidUserData.Base64FormatInvalid	The specified UserData is not valid	Nilai UserData tidak valid.
403	InvalidChargeType.ValueNotSupported	Deletion protection is only valid for postPaid instance, not for prePaid or spot instance.	Fitur perlindungan release hanya dapat digunakan pada resource pay-as-you-go.
403	InvalidUser.Unauthorized	The user is not authorized	Anda tidak memiliki otorisasi untuk melakukan operasi ini.
403	EnterpriseGroupLimited.MutliGroupType	The specified instance can not join multi SecurityGroup types.	Instans yang ditentukan tidak dapat termasuk dalam security group dasar dan security group tingkat lanjut sekaligus. Anda dapat memanggil operasi DescribeSecurityGroups untuk melakukan kueri tipe security group tertentu.
403	SecurityGroupInstanceLimitExceed	%s	Jumlah maksimum instans dalam security group yang ditentukan telah terlampaui.
403	InstanceNotInSecurityGroup	The instance not in the group.	Instans yang ditentukan tidak termasuk dalam security group tersebut.
403	InvalidOperation.InvalidRegion	%s	Nilai RegionId tidak valid.
403	OperationDenied	The specified Image is disabled or is deleted.	Image yang ditentukan dinonaktifkan atau dihapus.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Anda tidak dapat memodifikasi security group yang dikelola oleh layanan cloud.
403	InvalidParameter.InvalidEniQueueNumber	%s	Nilai QueueNumber tidak valid. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	Jumlah maksimum queue per ENI telah terlampaui. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Jumlah maksimum queue untuk semua ENI pada instans telah terlampaui. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	Security group yang ditentukan tidak ditemukan dalam akun ini. Periksa apakah ID security group sudah benar.
404	Credit.NotFound	The specified credit information does not exist.	Informasi kredit yang ditentukan tidak ada.
404	InvalidParameter.SecurityGroupIdRepeated	The specified security group ids has repeated.	Ditemukan ID security group yang duplikat. Periksa apakah nilai SecurityGroupIds.N valid.
404	InvalidSecurityGroupType.NotSupportClassic	The specified SecurityGroupIds have classic group type.	Security group yang ditentukan berada di classic network. Periksa apakah nilai SecurityGroupId.N valid.
404	InvalidSecurityGroupVpc.NotBelongToOneVpc	The specified SecurityGroupIds are belong to different vpc.	Security group yang ditentukan berada di VPC yang berbeda. Periksa apakah nilai SecurityGroupIds.N valid. Anda dapat memanggil operasi DescribeSecurityGroups untuk melakukan kueri VPC tempat security group tersebut berada.
500	InternalError	The request processing has failed due to some unknown error.	Terjadi kesalahan internal. Coba lagi nanti.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Terjadi kesalahan internal. Coba lagi nanti.

Untuk daftar kode kesalahan, lihat Service error codes.