For service producers, provisions a new subnet in a peered service's shared VPC network in the requested region and with the requested size that's expressed as a CIDR range (number of leading bits of ipV4 network mask). The method checks against the assigned allocated ranges to find a non-conflicting IP address range. The method will reuse a subnet if subsequent calls contain the same subnet name, region, and prefix length. This method will make producer's tenant project to be a shared VPC service project as needed. The response from the get
operation will be of type Subnetwork
if the operation successfully completes.
HTTP request
POST https://servicenetworking.googleapis.com/v1/{parent=services/*/*/*}:addSubnetwork
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
parent |
Required. A tenant project in the service producer organization, in the following format: services/{service}/{collection-id}/{resource-id}. {collection-id} is the cloud resource collection type that represents the tenant project. Only Authorization requires the following Google IAM permission on the specified resource
|
Request body
The request body contains data with the following structure:
JSON representation | |
---|---|
{ "consumerNetwork": string, "subnetwork": string, "region": string, "ipPrefixLength": number, "description": string, "subnetworkUsers": [ string ], "consumer": string, "requestedAddress": string } |
Fields | |
---|---|
consumerNetwork |
Required. The name of the service consumer's VPC network. The network must have an existing private connection that was provisioned through the connections.create method. The name must be in the following format: |
subnetwork |
Required. A name for the new subnet. For information about the naming requirements, see subnetwork in the Compute API documentation. |
region |
Required. The name of a region for the subnet, such |
ipPrefixLength |
Required. The prefix length of the subnet's IP address range. Use CIDR range notation, such as |
description |
An optional description of the subnet. |
subnetworkUsers[] |
A list of members that are granted the |
consumer |
Required. A resource that represents the service consumer, such as |
requestedAddress |
Optional. The starting address of a range. The address must be a valid IPv4 address in the x.x.x.x format. This value combined with the IP prefix range is the CIDR range for the subnet. The range must be within the allocated range that is assigned to the private connection. If the CIDR range isn't available, the call fails. |
Response body
If successful, the response body contains an instance of Operation
.
Authorization Scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/service.management
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.