All Products
Search

This Product

    Virtual Private Cloud:ModifyRouterInterfaceAttribute

    Document Center

    Virtual Private Cloud:ModifyRouterInterfaceAttribute

    Last Updated:Jun 12, 2026

    Mengubah konfigurasi antarmuka router dengan memanggil operasi ModifyRouterInterfaceAttribute.

    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
    RegionId

    string

    Yes

    ID Wilayah antarmuka router.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID Wilayah.

    cn-shanghai
    RouterInterfaceId

    string

    Yes

    ID antarmuka router.

    ri-2zeo3xzyf38r4urz****
    Name

    string

    No

    Nama antarmuka router.

    Panjang nama harus 2 hingga 128 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Nama dapat berisi angka, garis bawah (_), dan tanda hubung (-).

    TEST
    Description

    string

    No

    Deskripsi antarmuka router.

    Panjang deskripsi harus 2 hingga 256 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Deskripsi tidak dapat diawali dengan http:// atau https://.

    路由器接口
    OppositeInterfaceId

    string

    No

    ID antarmuka router peer.

    ri-2zeo3xzyf38r4urz****
    OppositeRouterId

    string

    No

    ID router peer.

    vrt-bp1jcg5cmxjbl9xgc****
    OppositeRouterType

    string

    No

    Tipe router tempat antarmuka router peer berada. Nilai valid:

    • VRouter: vRouter.

    • VBR (default): Virtual Border Router.

    VBR
    OppositeInterfaceOwnerId

    integer

    No

    ID akun tempat antarmuka router peer berada.

    28768383240243****
    HealthCheckSourceIp

    string

    No

    Alamat IP sumber untuk Pemeriksaan kesehatan. Alamat IP harus berupa alamat IP yang tidak digunakan di VPC lokal.

    Catatan

    Anda dapat menentukan parameter ini dalam skenario sirkuit Express Connect.

    116.62.XX.XX
    HealthCheckTargetIp

    string

    No

    Alamat IP tujuan untuk Pemeriksaan kesehatan.

    Catatan

    Parameter ini wajib diisi jika HealthCheckSourceIp ditentukan.

    116.62.XX.XX
    HcThreshold

    integer

    No

    Ambang batas Pemeriksaan kesehatan. Unit: packets. Nilai yang direkomendasikan: 8. Parameter ini menentukan jumlah paket probe yang dikirim selama Pemeriksaan kesehatan.

    8
    HcRate

    integer

    No

    Laju Pemeriksaan kesehatan. Unit: milliseconds. Nilai yang direkomendasikan: 2000. Parameter ini menentukan interval antara paket probe berurutan yang dikirim selama Pemeriksaan kesehatan.

    Dalam contoh ini, HcThreshold diatur ke 8 dan HcRate diatur ke 2000. Ini berarti bahwa selama Pemeriksaan kesehatan, paket probe dikirim setiap 2000 milidetik dari HealthCheckSourceIp (alamat IP sumber untuk Pemeriksaan kesehatan) ke HealthCheckTargetIp (alamat IP tujuan untuk Pemeriksaan kesehatan). Jika 8 paket probe berurutan tidak menerima tanggapan, Pemeriksaan kesehatan gagal.

    2000
    DeleteHealthCheckIp

    boolean

    No

    Apakah akan menghapus alamat IP Pemeriksaan kesehatan yang dikonfigurasi pada antarmuka router. Nilai valid:

    • true: Menghapus alamat IP Pemeriksaan kesehatan.

    • false (default): Tidak menghapus alamat IP Pemeriksaan kesehatan.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ID permintaan.

    RequestId

    string

    ID permintaan.

    4EC47282-1B74-4534-BD0E-403F3EE64CAF

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 Forbidden.FinancialLocked This RouterInterface is financiel locked because of bills outstanding.
    400 InvalidName.Malformed The attribute name is illegal.
    400 InvalidOppositeRouterType.ValueNotSupported The specified OppositeRouterType is not valid.
    400 InvalidDescription.Malformed The Description is illegal.
    400 Forbbiden The Router instance owner error
    400 LinkRole.NotSupport This linkrole is not supported
    400 Forbbiden.ModifyIdAndType Opposite is VBR, cannot modify the ID and type
    400 InvalidParam.ModifyRouterInterface Modify routerinterface param invalid
    400 INSTANCE_IN_PROCESSIONG Instance is in processing,please wait and try again
    400 IllegalParam.HcThreshold %s
    400 IllegalParam.HcRate %s
    400 InvalidHealthCheckIP.Malformd Healthcheck sourceip or targetip is not valid.
    400 IllegalParam.HcSourceIp The specified healthCheck Ip is not valid.
    400 OperationFailed.OperationLocked Operation failed because OperationLocked.
    400 IncorrectStatus.RouterInterface This openeration would not be allowed because status of this RouterInterface is not correct.
    404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
    404 InvalidRouterInterfaceId.NotFound The specified RouterInterfaceId does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.