All Products
Search

This Product

    Virtual Private Cloud:UnassociateHaVip

    Document Center

    Virtual Private Cloud:UnassociateHaVip

    Last Updated:Jun 12, 2026

    Melepaskan alamat IP virtual ketersediaan tinggi (HaVip) dari Instans ECS VPC atau antarmuka jaringan elastis (ENI) dengan memanggil operasi UnassociateHaVip.

    Deskripsi operasi

    Saat Anda memanggil operasi ini untuk melepaskan HaVip dari Instans ECS VPC atau ENI, perhatikan hal-hal berikut:

    • Instans ECS yang akan dilepaskan harus berada dalam status Running atau Stopped.

    • HaVip yang akan dilepaskan harus berada dalam status Available atau InUse.

    • UnassociateHaVip adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID permintaan. Namun, HaVip belum dilepaskan, dan sistem terus menjalankan tugas pelepasan di latar belakang. Anda dapat memanggil operasi DescribeHaVips untuk mengkueri status pelepasan HaVip:

      • Jika HaVip berada dalam status Unassociating, HaVip sedang dilepaskan.

      • Jika HaVip berada dalam status Inuse atau Available, HaVip telah dilepaskan.

    • UnassociateHaVip tidak mendukung pelepasan HaVip yang sama secara bersamaan.

    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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.

    0c593ea1-3bea-11e9-b96b-88e9fe63****
    RegionId

    string

    Yes

    ID wilayah tempat HaVip berada.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-shanghai
    HaVipId

    string

    Yes

    ID HaVip yang ingin Anda lepaskan.

    havip-2zeo05qre24nhrqpy****
    InstanceId

    string

    Yes

    ID Instans ECS atau ENI yang akan dilepaskan dari HaVip.

    i-faf344422ffsfad****
    Force

    string

    No

    Apakah akan melepaskan Instans ECS atau ENI dari HaVip secara paksa. Nilai valid:

    • True: melepaskan Instans secara paksa.

    • False (default): tidak melepaskan Instans secara paksa.

    Catatan

    Jika parameter ini diatur ke False, Instans utama yang terikat pada HaVip tidak dapat dilepaskan.

    True
    InstanceType

    string

    No

    Tipe instans yang akan dilepaskan dari HaVip. Nilai valid:

    • EcsInstance: instans Elastic Compute Service (ECS).

    • NetworkInterface: antarmuka jaringan elastis (ENI).

    Catatan

    Parameter ini wajib diisi jika instans yang akan dilepaskan adalah ENI.

    EcsInstance

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    C44F62BE-9CE7-4277-B117-69243F3988BF

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "C44F62BE-9CE7-4277-B117-69243F3988BF"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 IncorrectHaVipStatus HaVip can be operated by this action only when it's status is InUse.
    400 IncorrectInstanceStatus ECS instance can be operated by this action only when it's status is Running or Stopped.
    400 ResourceNotAssociated The HaVip and ECS instance are not associated.
    400 Forbidden.UnassociateMaster Unassociating a master instance is not allowed unless the parameter Force is True.
    400 HA.VIP.NOT.ASSOCIATED.WITH.INSTANCE ha vip not associated with instance.
    400 OperationFailed.DistibuteLock Distibute lock fail.
    400 OperationFailed.QueryNetworkInterfaceInfo Failed to query network interface information.
    400 IllegalParam.InstanceType The specified instance type is invalid. Only ECS instances and network interface are allowed.
    400 InvalidNetworkInterfaceId.NotFound The network interface is not found.
    400 ResourceNotFound.Instance The specified binding resource is not found.
    400 Forbidden.HaVip No permissions to perform operations on HAVIPs. Please apply for privilege--vpc_privilege_allow_buy_havip_instance.
    400 InvalidRegionId.NotFound The RegionId provided does not exist in our records.
    500 InternalError The request processing has failed due to some unknown error.
    404 InvalidHaVipId.NotFound The specified HaVip does not exist in the specified region.
    404 InvalidInstanceId.NotFound The specified Instance does not exist in the specified region.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.