方法：services.addSubnetwork

服务提供方可以使用此方法在请求的区域，为对等互连服务的共享 VPC 网络预配所请求大小（表示为 CIDR 范围，即 ipV4 网络掩码的前导位数）的新子网。该方法会针对已分配的范围运行检查，以找到非冲突的 IP 地址范围。如果后续调用包含相同的子网名称、区域和前缀长度，则该方法将重用子网。该方法会根据需要将提供方的租户项目设为共享 VPC 服务项目。如果 get 操作成功完成，则它将返回 Subnetwork 类型的响应。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必填。服务提供方组织中的租户项目，采用 services/{service}/{collection-id}/{resource-id} 格式。{collection-id} 是表示租户项目的云资源集合类型。仅支持 projects。{resource-id} 是租户项目的数字 ID（例如 123456）。{service} 是对等互连服务的名称（例如 service-peering.example.com）。服务使用方的项目必须已启用该服务。

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

  • servicenetworking.services.addSubnetwork

请求正文

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

JSON 表示法 

{
  "consumerNetwork": string,
  "subnetwork": string,
  "region": string,
  "ipPrefixLength": number,
  "description": string,
  "subnetworkUsers": [
    string
  ],
  "consumer": string,
  "requestedAddress": string
}
字段
consumerNetwork

string

必填。服务使用方的 VPC 网络的名称。该网络必须已有一个通过 connections.create 方法预配的专用连接。该名称必须采用 projects/{project}/global/networks/{network} 格式，其中 {project} 是项目编号，例如 12345。{network} 是项目中的 VPC 网络名称。

subnetwork

string

必填。新子网的名称。如需了解命名要求，请参阅 Compute API 文档中的子网。

region

string

必填。子网的区域名称，例如 europe-west1。

ipPrefixLength

number

必填。子网 IP 地址范围的前缀长度。采用 CIDR 范围表示法（例如，值 30 表示预配一个范围为 x.x.x.x/30 CIDR 的子网）。此 IP 地址范围提取自为服务使用方分配的范围内的可用范围池。

description

string

子网的说明（可选）。

subnetworkUsers[]

string

在子网上被授予 compute.networkUser 角色的成员列表。

consumer

string

必填。表示服务使用方的资源，例如 projects/123456。项目编号可不同于使用方网络参数中的值。例如，网络可能是共享 VPC 网络的一部分。在这些情况下，Service Networking 会验证此资源是否属于该共享 VPC。
requestedAddress

string

选填。范围的起始地址。该地址必须是采用 x.x.x.x 格式的有效 IPv4 地址。此值在与 IP 前缀范围组合使用时表示子网的 CIDR 范围。此范围必须在分配给专用连接的范围内。如果 CIDR 范围不可用，则调用失败。

响应正文

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

授权范围

需要以下 OAuth 范围之一：

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

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

试试看！