更新时间:2025-08-19 GMT+08:00

查询子网预留网段

功能介绍

查询单个子网预留网段详情。

调用方法

请参见如何调用API

URI

GET /v3/{project_id}/vpc/virsubnet-cidr-reservations/{virsubnet_cidr_reservation_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

获取方式请参见获取项目ID

virsubnet_cidr_reservation_id

String

子网预留网段资源ID。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

virsubnet_cidr_reservation

VirsubnetCidrReservation object

查询子网预留网段详情响应体。

表3 VirsubnetCidrReservation

参数

参数类型

描述

id

String

  • 功能描述:子网预留网段对应的唯一标识。

  • 取值范围:带“-”的标准UUID格式。

virsubnet_id

String

  • 功能描述:子网预留网段所在虚拟子网的ID。

  • 取值范围:带“-”的标准UUID格式。

vpc_id

String

  • 功能描述:子网预留网段所在VPC的ID。

  • 取值范围:带“-”的标准UUID格式。

ip_version

Integer

  • 功能描述:子网预留网段的IP版本。

  • 取值范围:

    • 4,IPv4

    • 6,IPv6

cidr

String

  • 功能说明:子网预留网段。

  • 取值范围:CIDR格式,掩码长度最小值为“所属子网的网段掩码 + 2”,最大值为32(IPv4)或128(IPv6)。

name

String

  • 功能说明:子网预留网段名称。

  • 取值范围:1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)。

description

String

  • 功能说明:子网预留网段的描述信息。

  • 取值范围:0-255个字符,不能包含“<”和“>”。

project_id

String

  • 功能说明:子网预留网段所属的项目ID。

created_at

String

  • 功能说明:子网预留网段创建时间。

  • 取值范围:UTC时间格式,yyyy-MM-ddTHH:mm:ssZ。

updated_at

String

  • 功能说明:子网预留网段更新时间。

  • 取值范围:UTC时间格式,yyyy-MM-ddTHH:mm:ssZ。

请求示例

查询子网预留网段详情。

GET https://{Endpoint}/v3/{project_id}/vpc/virsubnet-cidr-reservations/987d7959-9c48-ad49-2fdd-bf4146d6ebc4

响应示例

状态码:200

GET操作正常返回,更多状态码请参见状态码

{
  "virsubnet_cidr_reservation" : {
    "id" : "987d7959-9c48-ad49-2fdd-bf4146d6ebc4",
    "virsubnet_id" : "fb0e2bd6-190f-0d1a-7728-a5f6b1d8dd19",
    "vpc_id" : "cef5d621-6c20-d5df-74e8-746271fba734",
    "ip_version" : 4,
    "cidr" : "192.168.21.96/28",
    "name" : "test",
    "description" : "for test",
    "project_id" : "11e8dd119c77479db890e266e68c1ecf",
    "created_at" : "2024-09-09T10:20:35Z",
    "updated_at" : "2024-09-09T10:20:35Z"
  },
  "request_id" : "96579891a62195d2c54054ac43fab0aa"
}

状态码

状态码

描述

200

GET操作正常返回,更多状态码请参见状态码

错误码

请参见错误码