文档首页/ 虚拟私有云 VPC/ API参考（安卡拉区域）/ API V3/ IP地址组/ 查询地址组
更新时间：2024-04-15 GMT+08:00
查看PDF
分享

查询地址组

功能介绍

查询地址组详情。

URI

GET /v3/{project_id}/vpc/address-groups/{address_group_id}

表1 参数说明

参数

是否必选

参数类型

描述

address_group_id

是

String

地址组的唯一标识。

project_id

是

String

项目ID。

获取方法请参见获取项目ID。

请求参数

无

请求示例

  • 查询IP地址组详情 
    "GET https://{Endpoint}/v3/2bc7a67b35a64a79ad1d3bb8b5f61fc9/vpc/address-groups/dd18a501-fcd5-4adc-acfe-b0e2384baf08"

响应参数

状态码为 200 时:

表2 响应Body参数

参数

参数类型

描述

request_id

String

请求ID

address_group

AddressGroup object

地址组的查询响应体
表3 AddressGroup

参数

参数类型

描述

id

String
  • 功能说明：地址组唯一标识。
  • 取值范围：合法UUID的字符串。

name

String
  • 功能说明：地址组名称。
  • 取值范围：0-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）。

description

String
  • 功能说明：地址组描述信息。
  • 取值范围：0-255个字符。
  • 约束：不能包含“<”和“>”。

ip_set

Array of strings
  • 功能说明：地址组可包含地址集。
  • 取值范围：可以是单个ip地址，ip地址范围，ip地址cidr。
  • 约束：当前一个地址组ip_set数量限制默认值为20，即配置的ip地址、ip地址范围或ip地址cidr的总数默认限制20。

ip_version

Integer
  • 功能说明：IP地址组ip版本。
  • 取值范围：
    • 4：表示ipv4地址组。
    • 6：表示ipv6地址组。

created_at

String
  • 功能说明：地址组创建时间，UTC时间。
  • 取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss。

updated_at

String
  • 功能描述：地址组最近一次更新资源的时间，UTC时间。
  • 取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss。

tenant_id

String
  • 功能说明：资源所属项目ID。

响应示例

状态码为 200 时:

地址组创建API的GET查询操作正常返回 
{
    "address_group": {
        "id": "dd18a501-fcd5-4adc-acfe-b0e2384baf08", 
        "name": "AutoTester746010.580123789", 
        "tenant_id": "b2782e6708b8475c993e6064bc456bf8", 
        "ip_version": 4, 
        "ip_set": [
            "192.168.5.0/24", 
            "192.168.3.20-192.168.3.100", 
            "192.168.3.40", 
            "192.168.3.2"
        ], 
        "created_at": "2019-06-28T02:06:38", 
        "updated_at": "2019-06-28T02:06:38", 
        "description": "10.10.4.0/23"
    }, 
    "request_id": "ce6c359b-9002-41e5-a0b1-232759bd6637"
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： IP地址组