方法: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

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

试试看!