全部产品
Search

搜索本产品

    专有网络 VPC：DescribeIpv6Addresses - 查询IPv6地址列表

    文档中心

    专有网络 VPC：DescribeIpv6Addresses - 查询IPv6地址列表

    更新时间：Aug 28, 2026

    查询IPv6地址列表。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    vpc:DescribeIpv6Addresses

    list

    *Ipv6InternetBandwidth

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

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    是

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

    cn-huhehaote
    Ipv6AddressId

    string

    否

    要查询的 IPv6 地址 ID。每次调用最多可以输入 20 个 IPv6 地址 ID，以半角逗号（,）分隔。

    ipv6-2zen5j4axcp5l5qyy****
    Ipv6Address

    string

    否

    要查询的 IPv6 地址。

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

    string

    否

    要查询的 IPv6 地址的名称。

    名称长度为 0-128 个字符，不能以http://或https://开头。

    test
    AddressType

    string

    否

    IPv6 地址的类型，取值：

    • IPv6Address（默认值）：代表查询单 IPv6 IP 的 IPv6 实例。

    • IPv6Prefix：代表查询前缀网段的 IPv6 实例。

    IPv6Address
    AssociatedInstanceId

    string

    否

    要查询的 IPv6 地址关联的实例 ID。

    i-2ze72wuqj4y3jl4f****
    AssociatedInstanceType

    string

    否

    要查询的 IPv6 地址所关联的实例类型，取值：

    • EcsInstance：VPC 类型的 ECS。

    • NetworkInterface：辅助弹性网卡 ENI。

    EcsInstance
    NetworkType

    string

    否

    要查询的 IPv6 地址的通信能力类型，取值：

    • Private：私网通信类型。

    • Public：公网通信类型。

    Private
    VpcId

    string

    否

    要查询的 IPv6 地址所在的 VPC ID。

    vpc-bp15zckdt37pq72zv****
    VSwitchId

    string

    否

    要查询的 IPv6 地址所在的交换机 ID。

    vsw-25navfgbue4g****
    Ipv6InternetBandwidthId

    string

    否

    开通公网带宽后，要查询的 IPv6 地址对应的公网带宽实例 ID。

    ipv6bw-uf6hcyzu65v98v3du****
    IncludeReservationData

    boolean

    否

    是否包含未生效的订购数据，取值：

    • false（默认值）：不包含未生效的订购数据。

    • true：包含未生效的订购数据。

    false
    ResourceGroupId

    string

    否

    IPv6 网关所属的资源组 ID。

    rg-bp67acfmxazb4ph****
    Tag

    array<object>

    否

    标签列表。列表元素最大数量：20。

    object

    否

    资源的标签集合。

    Key

    string

    否

    资源的标签键。最多支持输入 20 个标签键。如需传入该值，则不能输入空字符串。

    一个标签键最多支持 128 个字符，不能以aliyun和acs:开头，不能包含http://或者https://。

    FinanceDept
    Value

    string

    否

    资源的标签值。最多支持输入 20 个标签值。一旦传入该值，可以为空字符串。

    一个标签值最多支持 128 个字符，必须以字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-），不能以aliyun和acs:开头，不能包含http://或者https://。

    yunke
    PageNumber

    integer

    否

    列表的页码，默认值：1。

    1
    PageSize

    integer

    否

    分页查询时每页的行数，最大值：50；默认值：10。

    10
    RegionId

    string

    是

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

    cn-huhehaote
    ServiceManaged

    boolean

    否

    是否为托管实例。取值：

    • true：是托管实例。

    • false：不是托管实例。

    不填默认查询所有实例。

    false

    返回参数

    名称

    类型

    描述

    示例值

    object

    PageSize

    integer

    分页查询时每页的行数，最大值为 50，默认值为 10。

    10
    RequestId

    string

    请求 ID。

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

    integer

    列表的页码，默认值为 1。

    1
    TotalCount

    integer

    列表条目数。

    2
    Ipv6Addresses

    object

    Ipv6Address

    array<object>

    IPv6 地址的详细信息。

    array<object>

    Ipv6 地址的详细信息。

    VpcId

    string

    IPv6 地址所在的 VPC ID。

    vpc-bp15zckdt37pq72zv****
    Status

    string

    IPv6 地址的状态，取值：

    • Pending：配置中。

    • Available：可用。

    Available
    Ipv6AddressId

    string

    IPv6 地址的实例 ID。

    ipv6-2zen5j4axcp5l5qyy****
    AllocationTime

    string

    IPv6 地址的创建时间。

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

    string

    IPv6 地址的实例名称。

    test
    Ipv6AddressDescription

    string

    IPv6 地址的实例描述。

    test
    AssociatedInstanceType

    string

    IPv6 地址关联的实例类型。

    EcsInstance
    AssociatedInstanceId

    string

    IPv6 地址关联的实例 ID。

    i-2ze72wuqj4y3jl4f****
    NetworkType

    string

    IPv6 地址的通信能力类型，取值：

    • Private：私网通信类型。

    • Public：公网通信类型 。

    Private
    Ipv6Address

    string

    IPv6 地址。

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

    string

    IPv6 地址的类型，取值：

    • IPv6Address（默认值）：代表当前实例是单个 IPv6 IP。

    • IPv6Prefix：代表当前实例是 IPv6 Cidr。

    IPv6Address
    Ipv6Isp

    string

    IPv6 地址的服务运营商，取值：

    • BGP（默认值）：阿里云 BGP IPv6。

    • ChinaMobile：中国移动（单线）。

    • ChinaUnicom：中国联通（单线）。

    • ChinaTelecom：中国电信（单线）。

    BGP
    VSwitchId

    string

    IPv6 地址所在的交换机的 ID。

    vsw-25navfgbue4g****
    Ipv6GatewayId

    string

    IPv6 地址的所属 IPv6 网关实例 ID。

    ipv6gw-2zewg0l66s73b4k2q****
    RealBandwidth

    integer

    IPv6 地址的实际带宽峰值。

    5
    Ipv6InternetBandwidth

    object

    IPv6 地址的公网带宽信息。

    InternetChargeType

    string

    IPv6 地址的公网带宽的计费方式，取值：

    • PayByTraffic：按使用流量计费。

    • PayByBandwidth：按固定带宽计费。

    PayByTraffic
    BusinessStatus

    string

    IPv6 地址的公网带宽的商业状态，取值：

    • Normal：正常。

    • FinancialLocked：欠费锁定。

    • SecurityLocked：安全锁定。

    Normal
    Bandwidth

    integer

    IPv6 地址的独享公网带宽，单位：Mbps。

    5
    Ipv6InternetBandwidthId

    string

    IPv6 地址的公网带宽实例 ID。

    ipv6bw-hp3b35oq1fj50kbv****
    InstanceChargeType

    string

    IPv6 地址的公网带宽的付费方式，取值：

    PostPaid：后付费。

    PostPaid
    HasReservationData

    boolean

    是否有续费数据。

    • false：无续费数据。

    • true：有续费数据。只有在入参 IncludeReservationData 为 true，且有未生效订购数据时才会为 true。

    false
    ReservationInternetChargeType

    string

    续费付费类型。

    • PayByTraffic：按使用流量计费。

    • PayByBandwidth：按固定带宽计费。

    PayByTraffic
    ReservationOrderType

    string

    续费订单类型。取值：RENEW，表示续费订单。

    RENEW
    ReservationActiveTime

    string

    续费生效时间，格式为YYYY-MM-DDThh:mm:ssZ。

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

    integer

    续费带宽。单位：Mbps。

    12
    ResourceGroupId

    string

    IPv6 网关所属的资源组 ID。

    rg-bp67acfmxazb4ph****
    Tags

    object

    Tag

    array<object>

    标签列表。

    object

    标签列表信息。

    Key

    string

    资源的标签键。最多支持输入 20 个标签键。如需传入该值，则不能输入空字符串。

    一个标签键最多支持 128 个字符，不能以aliyun和acs:开头，不能包含http://或者https://。

    FinanceDept
    Value

    string

    标签的标签值。

    标签值最多支持 128 个字符，可以为空字符串，不能以aliyun和acs:开头，不能包含http://或者https://。

    一个标签键对应一个标签值。一次最多支持输入 20 个标签值。

    yunke
    ServiceManaged

    integer

    是否为托管实例。取值：

    • 1：是托管实例。

    • 0：不是托管实例。

    1

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 IllegalParam.Ipv6Address The param of %s is illegal. 您指定的ipv6地址非法，请检查您的输入是否正确
    400 IllegalParam.NetworkType The param of %s is illegal. 您输入的NetworkType非法，请检查您的输入是否正确
    400 IllegalParam.AddressType The specified AddressType is illegal. 指定的入参AddressType非法
    400 IllegalParamSize.AssociatedInstanceId The param size of AssociatedInstanceId is illegal. 参数AssociatedInstanceId长度非法
    400 MissingParam.AssociatedInstanceId The param of AssociatedInstanceId is missing when AssociatedInstanceType is specified. 参数AssociatedInstanceId缺失

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。