All Products
Search

This Product

    Elastic Compute Service:ModifyInstanceVpcAttribute

    Document Center

    Elastic Compute Service:ModifyInstanceVpcAttribute

    Last Updated:Sep 08, 2026

    Memodifikasi VPC, alamat IP privat, grup keamanan, atau vSwitch dari instans ECS tipe VPC.

    Deskripsi operasi

    Saat memanggil operasi ini, instans ECS harus berada dalam status Stopped (Stopped).

    • Saat memodifikasi alamat IP privat atau vSwitch suatu instans, perhatikan hal-hal berikut:

      • Instans ECS yang baru dibuat harus di-restart sebelum Anda dapat memanggil operasi ini.

      • Setelah modifikasi berhasil, instans ECS harus di-restart sebelum Anda dapat memanggil operasi ini lagi.

    • Saat memodifikasi VPC suatu instans, perhatikan hal-hal berikut:

      • Instans:

        • Status instans: Instans tidak boleh terkunci, menunggu rilis, kedaluwarsa, dalam proses daur ulang karena kedaluwarsa, atau dalam proses daur ulang karena pembayaran tertunda. Untuk informasi selengkapnya, lihat Masa pakai instans.

        • Instans ECS yang dikaitkan dengan instans load balancing tidak didukung.

        • Instans tidak boleh sedang digunakan oleh layanan cloud lain. Misalnya, instans tidak boleh sedang dalam proses migrasi, tidak boleh sedang mengalami perubahan VPC, dan database yang dideploy pada instans tersebut tidak boleh dikelola oleh Data Transmission Service (DTS).

      • Jaringan:

        • Instans yang dikonfigurasi dengan EIP dalam pola visible network interface controller (NIC) atau pola multi-EIP ke NIC visible tidak didukung.

        • Instans yang disambungkan ke alamat IP virtual high availability (HaVips) tidak didukung.

        • Instans yang vSwitch-nya dikaitkan dengan tabel rute kustom tidak didukung.

        • Instans yang telah mengaktifkan Global Accelerator (GA) tidak didukung.

        • Instans yang disambungkan ke Elastic Network Interfaces (ENIs) sekunder tidak didukung.

        • Instans yang telah dialokasikan alamat IPv6 tidak didukung.

        • Instans yang NIC primernya memiliki beberapa alamat IP tidak didukung.

        • vSwitch yang ditentukan harus termasuk dalam VPC tujuan.

        • Zona vSwitch harus tetap sama sebelum dan sesudah modifikasi.

        • Jika Anda menentukan IP privat untuk NIC primer, alamat IP tersebut harus berada dalam blok CIDR vSwitch dan tersedia. Jika tidak ditentukan, alamat IP akan dialokasikan secara acak. Pastikan vSwitch tujuan memiliki cukup alamat IP yang tersedia.

        • Jika Anda menggunakan VPC yang dibagikan oleh akun lain, pastikan grup keamanan tujuan dibuat oleh akun Anda di VPC bersama tersebut, bukan oleh akun pemilik VPC.

    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:ModifyInstanceVpcAttribute

    update

    *Instans.

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

    *VSwitch.

    acs:vpc:{#regionId}:{#accountId}:vswitch/{#vswitchId}
    • vpc:tag
    • vpc:VPC
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    ID instans.

    Catatan

    Saat memanggil operasi ini, instans ECS harus berada dalam status Stopped (Stopped). Untuk batasan lain terkait instans, baca dengan cermat bagian deskripsi operasi.

    i-bp1iudwa5b1tqag1****
    VSwitchId

    string

    Yes

    ID vSwitch.

    • Jika ID yang ditentukan adalah vSwitch saat ini dari instans, vSwitch tetap tidak berubah.

    • Jika ID yang ditentukan adalah vSwitch baru dan parameter VpcId kosong, vSwitch baru dan asli harus berada dalam zona dan VPC yang sama.

    • Jika parameter VpcId tidak kosong, vSwitch yang ditentukan oleh parameter ini harus termasuk dalam VPC yang ditentukan dan berada dalam zona yang sama dengan vSwitch asli.

    vsw-bp1s5fnvk4gn3tw12****
    PrivateIpAddress

    string

    No

    Alamat IP privat baru.

    Catatan

    Parameter PrivateIpAddress bergantung pada VSwitchId. Alamat IP yang ditentukan harus berada dalam blok CIDR vSwitch.

    Nilai default: Jika parameter ini tidak ditentukan, alamat IP privat akan dialokasikan secara acak dari blok CIDR vSwitch.

    172.17.**.**
    VpcId

    string

    No

    ID VPC tujuan.

    vpc-bp1vwnn14rqpyiczj****
    SecurityGroupId

    array

    No

    ID grup keamanan tempat instans ditambahkan setelah VPC diubah. Parameter ini hanya diperlukan jika parameter VpcId ditentukan.

    • Grup keamanan harus termasuk dalam VPC yang sama dengan VPC tujuan.

    • Anda dapat menentukan satu atau beberapa grup keamanan untuk instans. Jumlah grup keamanan mengikuti batasan jumlah grup keamanan yang dapat dimiliki suatu instans. Untuk informasi selengkapnya, lihat Batasan.

    • Semua grup keamanan dalam daftar harus bertipe sama.

    • Pengalihan antar jenis grup keamanan didukung. Saat mengalihkan instans ECS antar jenis grup keamanan, pastikan Anda memahami perbedaan konfigurasi aturan grup keamanan antara kedua jenis tersebut agar tidak mengganggu jaringan instans. Untuk informasi selengkapnya, lihat Ikhtisar grup keamanan.

    sg-o6w9l8bc8dgmkw87****

    string

    No

    ID grup keamanan.

    sg-o6w9l8bc8dgmkw87****

    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 InvalidTarget.TrafficMirrorSession Instance is target of traffic mirror session.
    400 InvalidSource.TrafficMirrorSession Instance is source of traffic mirror session.
    400 InvalidPrivateIpAddress.Malformed Specified private IP address is malformed. PrivateIpAddress yang ditentukan tidak valid.
    400 InvalidPrivateIpAddress.Duplicated Specified private IP address is duplicated.
    400 IncorrectVSwitchStatus The current status of virtual switch does not support this operation. vSwitch tertentu berada dalam status tertunda dan tidak dapat dihapus.
    400 IncorrectInstanceStatus The current status of instance does not support this operation. Status instans saat ini tidak mendukung operasi ini.
    400 OperationDenied Specified operation is denied as your instance is not in VPC. Snapshot yang ditentukan tidak mengizinkan pembuatan volume data.
    400 InvalidVSwitchId.Mismatch Specified instance and virtual switch are not in the same zone. Instans tertentu dan vSwitch tertentu tidak berada di zona yang sama.
    400 InvalidPrivateIpAddress.Mismatch Specified private IP address is not in the CIDR block of virtual switch. Alamat IP privat yang ditentukan tidak berada dalam blok CIDR vSwitch yang ditentukan.
    400 InvalidPrivateIp.Changing Previous action is not finished yet. Modifikasi alamat IP privat untuk instans belum selesai. Anda tidak dapat memodifikasinya lagi.
    400 PrimaryEniHasSubIp Primary network interface of the specified instance has more than one private ip. Operasi ditolak. Instans yang ENI primernya memiliki beberapa alamat IP tidak didukung.
    400 VSwitchIdNotMatch The subnet of private ip is different to the instance, please unbind ha vip. Blok CIDR vSwitch tidak mengandung alamat IP yang ditentukan. Periksa konfigurasi.
    400 InvalidOperation.EniCountExceeded The number of ENIs in an enterprise security group has reached the maximum limit.
    400 InvalidParameter.SecurityGroupId Security group ids are invalid. ID grup keamanan tidak valid.
    400 InvalidVSwitch.IllegalStatus The operation is not allowed in the current VSwitch state. Expecting state includes "Created", but current state is "%s". Status vSwitch saat ini tidak mendukung operasi ini.
    400 QuotaExceeded.PrivateIpAddress There are not enough private IPs in the specified VSwitch. Alamat IP pribadi di vSwitch telah habis. Gunakan vSwitch lain.
    401 InvalidOperation.SecurityGroupNotAuthorized The specified security group is not authorized to operate. Anda tidak memiliki izin untuk melakukan operasi pada grup keamanan tertentu.
    500 InternalError The request processing has failed due to some unknown error.
    403 OperationDenied The Specified operation is denied as your instance is locked for security reasons.
    403 InvalidIp.Ipv6Assigned The specified instance has been assigned IPv6 address.
    403 SecurityGroupInstanceLimitExceed %s Jumlah maksimum instans dalam grup keamanan telah tercapai.
    403 InvalidInstance.HasTransitionRecord The operation is denied because the specified instance has a migration plan.
    403 InvalidInstanceStatus.NotNormal The Specified operation is denied due to instance status.
    403 InvalidVpcId.SharedVpc The Specified operation is denied as your targe vpc is SharedVpc.
    403 InvalidOperation.NotAllowed The operation is denied because the specified VPC has advanced features enabled.
    403 InvalidParameter.ToSecurityGroupId %s
    403 InvalidOperation.ResourceManagedByCloudProduct %s Grup keamanan yang dikelola oleh layanan cloud tidak mendukung operasi modifikasi.
    403 InvalidOperation.VswAndEcsAvailabilityZoneMismatch Specified instance and virtual switch are not in the same zone. Instans dan vSwitch tujuan tidak berada di zona yang sama.
    403 InvalidOperation.CloudBoxEcsNotSupport Cloud box ecs instance does not support modifying VPC. Instans CloudBox tidak mendukung modifikasi VPC.
    403 AclLimitExceed %s Jumlah aturan grup keamanan untuk ENI atau instans telah melebihi kuota.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist. Instans yang ditentukan tidak ada. Periksa apakah ID instans sudah benar.
    404 InvalidVSwitchId.NotFound Specified virtual switch does not exist. ID vSwitch yang ditentukan tidak ada.
    404 NoSuchResource The specified resource is not found. Sumber daya yang ditentukan tidak ada.
    404 InvalidParameter.InvalidInstanceId The specified InstanceId does not exist.
    404 InvalidParameter.VSwitchId The specified virtual vswitch does not exist. VSwitchId yang ditentukan tidak ada. Anda dapat memanggil DescribeVSwitches untuk mengkueri informasi tentang vSwitch yang telah dibuat.
    404 InvalidRegion.ValueNotSupported The specified Region does not exist.
    404 InvalidInstance.AttachedEni The Specified operation is denied due to elastic network interface. Status ENI dari instans tertentu tidak mendukung operasi modifikasi. Pastikan Anda memahami tindakan pencegahan untuk operasi ini. Untuk informasi lebih lanjut, lihat dokumentasi API ModifyInstanceVpcAttribute.
    404 InvalidIp.MultiPrimaryIp The Specified operation is denied due to multi private ip. Instans tertentu memiliki beberapa alamat IP pribadi dan tidak mendukung operasi modifikasi. Pastikan Anda memahami tindakan pencegahan untuk operasi ini. Untuk informasi lebih lanjut, lihat dokumentasi API ModifyInstanceVpcAttribute.
    404 InvalidIp.Ipv6 The Specified operation is denied due to ipv6.
    404 InvalidVSwitch.NotBelongToVpc %s VSwitchId tertentu tidak termasuk dalam VPC tertentu. Periksa apakah nilai parameter benar.
    404 InvalidParameter.EniNo %s
    404 InvalidSecurityGroupId.NotFound %s Grup keamanan yang ditentukan tidak ada di bawah akun Anda. Periksa apakah ID grup keamanan sudah benar.
    404 InvalidParameter.SecurityGroupIdRepeated %s
    404 InvalidSecurityGroupType.NotSupportClassic The specified SecurityGroupIds have classic group type. Jenis jaringan dari grup keamanan tertentu adalah jaringan klasik. Periksa apakah nilai parameter SecurityGroupIds benar.
    404 InvalidSecurityGroupVpc.NotBelongToOneVpc The specified SecurityGroupIds are belong to different vpc. ID grup keamanan tertentu termasuk dalam VPC yang berbeda. Periksa apakah nilai parameter SecurityGroupIds benar. Anda dapat memanggil DescribeSecurityGroups untuk mengkueri VPC tempat grup keamanan tertentu berada.
    404 EnterpriseGroupLimited.MutliGroupType The specified instance can not join multi SecurityGroup types.
    404 InvalidParameter.AlreadyInTargetVpc The specified instance is already in the destination VPC.
    404 InvalidParameter.SecurityGroupId The specified SecurityGroupId.N is invalid or does not exist.
    404 JoinedGroupLimitExceed The specified instance has exceed quota of SecurityGroup.
    404 InvalidParameter.MustBeEmpty The specified parameter SecurityGroupId.N and VpcId need be empty. Parameter SecurityGroupId.N dan VpcId yang ditentukan harus kosong. Jika Anda hanya perlu memodifikasi vSwitch, Anda tidak perlu menentukan parameter SecurityGroupId.N dan VpcId.
    404 InvalidParameter.NotEnoughIpInVSwitch The specified virtual switch has not enough available ip.
    404 InvalidDependence.MutliDirectlyEip The Specified operation is denied due to multi directly Eips.
    404 InvalidDependence.HaVip The Specified operation is denied due to HaVip.
    404 InvalidDependence.NextHopOfCustomRouter The Specified operation is denied due to next hop of Custom Router. Entri rute kustom saat ini mengarah ke instans ini. Mengubah VPC tidak didukung.
    404 InvalidDependence.BeenUsedAsAppServer The Specified operation is denied due to AppServer.
    404 InvalidDependence.GrantAccess The Specified operation is denied due to grant access. Instans saat ini memiliki aturan akses balik. Memodifikasi VPC tidak didukung.
    404 InvalidDependence.BindGA The Specified operation is denied due to GA.
    404 InvalidDependence.SLB The Specified operation is denied as your instance with alb or clb. Operasi ditolak. Instance ECS yang terkait dengan instans Server Load Balancer tidak didukung.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.