方法:services.searchRange

服务提供方可以使用此方法来在使用方的已分配范围内查找当前未使用的范围。返回的范围不会预留,也不一定保持未使用状态。此范围将用于验证先前提供的已分配范围,并根据请求的大小查找非冲突的子范围(以 ipv4 网络掩码的前导位数表示,采用与 CIDR 范围相同的表示法)。Operation<response: Range>

HTTP 请求

POST https://servicenetworking.googleapis.com/v1/{parent=services/*}:searchRange

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必填。此参数采用 services/{service} 形式。{service} 是专用访问权限管理服务的名称,例如“service-peering.example.com”。

必须对指定的资源 parent 具有以下 Google IAM 权限才能进行授权:

  • servicenetworking.services.get

请求正文

请求正文中包含结构如下的数据:

JSON 表示法

{
  "network": string,
  "ipPrefixLength": number
}
字段
network

string

使用方项目中的网络名称。此网络必须已使用 connections.create 方法与共享 VPC 网络建立了对等互连。必须采用下列形式“projects/{project}/global/networks/{network}”。{project} 指项目编号,正如在 '12345' {network} 中指网络名称一样。

ipPrefixLength

number

必填。IP 范围的前缀长度。使用通常的 CIDR 范围表示法。例如,值“30”表示查找未使用的 x.x.x.x/30 CIDR 范围。实际范围将根据为使用方对等互连网络分配的范围确定,并在结果中返回。

响应正文

如果成功,响应正文将包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/service.management
  • https://www.googleapis.com/auth/cloud-platform

如需了解详情,请参阅身份验证概览

试试看!