All Products
Search

This Product

    Virtual Private Cloud:DescribeIpv6Addresses

    Document Center

    Virtual Private Cloud:DescribeIpv6Addresses

    Last Updated:Jun 12, 2026

    Mengkueri daftar alamat IPv6.

    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

    vpc:DescribeIpv6Addresses

    list

    *Ipv6InternetBandwidth

    acs:vpc:{#regionId}:{#accountId}:vpc/*

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah tempat alamat IPv6 yang ingin dikueri berada. Anda dapat memanggil operasi DescribeRegions untuk mendapatkan ID wilayah.

    cn-huhehaote
    Ipv6AddressId

    string

    No

    ID alamat IPv6 yang ingin dikueri. Anda dapat menentukan hingga 20 ID alamat IPv6 dalam setiap panggilan. Pisahkan beberapa ID dengan koma (,).

    ipv6-2zen5j4axcp5l5qyy****
    Ipv6Address

    string

    No

    Alamat IPv6 yang ingin dikueri.

    2408:XXXX:153:3921:851c:c435:7b12:1c5f
    Name

    string

    No

    Nama alamat IPv6 yang ingin dikueri.

    Panjang nama harus 0 hingga 128 karakter dan tidak boleh diawali dengan http:// atau https://.

    test
    AddressType

    string

    No

    Tipe alamat IPv6. Nilai valid:

    • IPv6Address (default): mengkueri instans IPv6 dengan satu alamat IPv6.

    • IPv6Prefix: mengkueri instans IPv6 dengan blok CIDR awalan.

    IPv6Address
    AssociatedInstanceId

    string

    No

    ID instans yang terkait dengan alamat IPv6 yang ingin dikueri.

    i-2ze72wuqj4y3jl4f****
    AssociatedInstanceType

    string

    No

    Tipe instans yang terkait dengan alamat IPv6 yang ingin dikueri. Nilai valid:

    • EcsInstance: Instance ECS di VPC.

    • NetworkInterface: antarmuka jaringan elastis (ENI) sekunder. ENI sekunder juga disebut sebagai pengontrol antarmuka jaringan (NIC) sekunder.

    EcsInstance
    NetworkType

    string

    No

    Tipe komunikasi alamat IPv6 yang ingin dikueri. Nilai valid:

    • Private: komunikasi privat.

    • Public: komunikasi publik.

    Private
    VpcId

    string

    No

    ID VPC tempat alamat IPv6 yang ingin dikueri berada.

    vpc-bp15zckdt37pq72zv****
    VSwitchId

    string

    No

    ID vSwitch tempat alamat IPv6 yang ingin dikueri berada.

    vsw-25navfgbue4g****
    Ipv6InternetBandwidthId

    string

    No

    ID instans bandwidth Internet yang terkait dengan alamat IPv6 yang ingin dikueri. Parameter ini berlaku setelah bandwidth Internet diaktifkan.

    ipv6bw-uf6hcyzu65v98v3du****
    IncludeReservationData

    boolean

    No

    Apakah akan menyertakan data langganan tertunda. Nilai valid:

    • false (default): tidak menyertakan data langganan tertunda.

    • true: menyertakan data langganan tertunda.

    false
    ResourceGroupId

    string

    No

    ID kelompok sumber daya tempat gerbang IPv6 berada.

    rg-bp67acfmxazb4ph****
    Tag

    array<object>

    No

    Daftar tag. Anda dapat menentukan hingga 20 tag.

    object

    No

    Tag sumber daya.

    Key

    string

    No

    Kunci tag sumber daya. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

    Panjang kunci tag dapat mencapai 128 karakter. Tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh mengandung http:// atau https://.

    FinanceDept
    Value

    string

    No

    Nilai tag sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong.

    Panjang nilai tag dapat mencapai 128 karakter. Harus diawali dengan huruf atau karakter Tionghoa dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh mengandung http:// atau https://.

    yunke
    PageNumber

    integer

    No

    Nomor halaman. Nilai default: 1.

    1
    PageSize

    integer

    No

    Jumlah entri per halaman untuk kueri penomoran halaman. Nilai maksimum: 50. Nilai default: 10.

    10
    RegionId

    string

    Yes

    要查询的 IPv6 地址所在的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。

    cn-huhehaote
    ServiceManaged

    boolean

    No

    Apakah instans merupakan instans terkelola. Nilai valid:

    • true: Instans merupakan instans terkelola.

    • false: Instans bukan instans terkelola.

    Jika Anda tidak menetapkan parameter ini, semua instans akan dikueri.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    PageSize

    integer

    Jumlah entri per halaman untuk kueri penomoran halaman. Nilai maksimum: 50. Nilai default: 10.

    10
    RequestId

    string

    ID permintaan.

    AA4486A8-B6AE-469E-AB09-820EF8ECFA2B
    PageNumber

    integer

    Nomor halaman. Nilai default: 1.

    1
    TotalCount

    integer

    Jumlah total entri yang dikembalikan.

    2
    Ipv6Addresses

    object

    Ipv6Address

    array<object>

    Detail alamat IPv6.

    array<object>

    Detail alamat IPv6.

    VpcId

    string

    The ID of the VPC to which the IPv6 address belongs.

    vpc-bp15zckdt37pq72zv****
    Status

    string

    The status of the IPv6 address.

    • Pending

    • Available

    Available
    Ipv6AddressId

    string

    The ID of the IPv6 address.

    ipv6-2zen5j4axcp5l5qyy****
    AllocationTime

    string

    The time when the IPv6 address was created.

    2020-12-20T14:56:09Z
    Ipv6AddressName

    string

    The name of the IPv6 address.

    test
    Ipv6AddressDescription

    string

    The description of the IPv6 address.

    test
    AssociatedInstanceType

    string

    The type of instance associated with the IPv6 address.

    EcsInstance
    AssociatedInstanceId

    string

    The ID of the instance associated with the IPv6 address.

    i-2ze72wuqj4y3jl4f****
    NetworkType

    string

    The type of connection supported by the IPv6 address. Valid values:

    • Private

    • Public

    Private
    Ipv6Address

    string

    The IPv6 address.

    2408:XXXX:153:3921:851c:c435:7b12:1c5f
    AddressType

    string

    The type of IPv6 address. Valid values:

    • IPv6Address (default): indicates a single IPv6 IP.

    • IPv6Prefix: indicates IPv6 CIDR.

    IPv6Address
    Ipv6Isp

    string

    The ISP of the IPv6 address. Valid values:

    • BGP (default)

    • ChinaMobile

    • ChinaUnicom

    • ChinaTelecom

    BGP
    VSwitchId

    string

    The ID of the vSwitch to which the IPv6 address belongs.

    vsw-25navfgbue4g****
    Ipv6GatewayId

    string

    The ID of the IPv6 gateway to which the IPv6 address belongs.

    ipv6gw-2zewg0l66s73b4k2q****
    RealBandwidth

    integer

    The peak bandwidth of the IPv6 address.

    5
    Ipv6InternetBandwidth

    object

    The Internet bandwidth of the IPv6 address.

    InternetChargeType

    string

    The billing method of the Internet bandwidth of the IPv6 address. Valid values:

    • PayByTraffic

    • PayByBandwidth

    PayByTraffic
    BusinessStatus

    string

    The status of the Internet bandwidth of the IPv6 address. Valid values:

    • Normal

    • FinancialLocked

    • SecurityLocked

    Normal
    Bandwidth

    integer

    The dedicated Internet bandwidth of the IPv6 address. Unit: Mbit/s.

    5
    Ipv6InternetBandwidthId

    string

    The Internet bandwidth ID of the IPv6 address.

    ipv6bw-hp3b35oq1fj50kbv****
    InstanceChargeType

    string

    The billing method of the Internet bandwidth of the IPv6 address. Valid values:

    Only PostPaid may be returned, which indicates the pay-as-you-go billing method.

    PostPaid
    HasReservationData

    boolean

    Indicates whether renewal data is included. Valid values:

    • false

    • true true is returned only when IncludeReservationData is set to true and some orders have not taken effect.

    false
    ReservationInternetChargeType

    string

    The metering method that is used after the renewal takes effect.

    • PayByTraffic

    • PayByBandwidth

    PayByTraffic
    ReservationOrderType

    string

    The type of the renewal order. Only RENEW may be returned, which indicates that the order is placed for service renewal.

    RENEW
    ReservationActiveTime

    string

    The time when the renewal takes effect. The time is displayed in the YYYY-MM-DDThh:mm:ssZ format.

    2021-05-23T16:00:00Z
    ReservationBandwidth

    integer

    The maximum bandwidth after the renewal takes effect. Unit: Mbit/s.

    12
    ResourceGroupId

    string

    The ID of the resource group to which the IPv6 gateway belongs.

    rg-bp67acfmxazb4ph****
    Tags

    object

    Tag

    array<object>

    The tag list.

    object

    The tag list.

    Key

    string

    The tag key. You can specify up to 20 tag keys. The tag key cannot be an empty string.

    The tag key can be up to 128 characters in length. The tag key cannot start with aliyun or acs:, and cannot contain http:// or https://.

    FinanceDept
    Value

    string

    The tag value.

    The tag value can be up to 128 characters in length. It can be an empty string. It cannot start with aliyun or acs:, and cannot contain http:// or https://.

    Each tag key corresponds to one tag value. You can specify at most 20 tag values at a time.

    yunke
    ServiceManaged

    integer

    Indicates whether the instance is managed. Valid values:

    • 1: yes

    • 0: no

    1

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalParam.Ipv6Address The param of %s is illegal. The IPv6 address is invalid.
    400 IllegalParam.NetworkType The param of %s is illegal. Invalid NetworkType value.
    400 IllegalParam.AddressType The specified AddressType is illegal. The specified input AddressType is illegal.
    400 IllegalParamSize.AssociatedInstanceId The param size of AssociatedInstanceId is illegal. Illegal parameter AssociatedInstanceId length
    400 MissingParam.AssociatedInstanceId The param of AssociatedInstanceId is missing when AssociatedInstanceType is specified. Missing parameter AssociatedInstanceId

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.