Service Networking API

Provides automatic management of network configurations necessary for certain services.

Service: servicenetworking.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://servicenetworking.googleapis.com

REST Resource: v1.operations

Methods
cancel POST /v1/{name=operations/**}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1/{name=operations/**}
Deletes a long-running operation.
get GET /v1/{name=operations/*}
Gets the latest state of a long-running operation.
list GET /v1/{name}
Lists operations that match the specified filter in the request.

REST Resource: v1.services

Methods
addSubnetwork POST /v1/{parent=services/*/*/*}:addSubnetwork
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).
disableVpcServiceControls PATCH /v1/{parent=services/*}:disableVpcServiceControls
Disables VPC service controls for a connection.
enableVpcServiceControls PATCH /v1/{parent=services/*}:enableVpcServiceControls
Enables VPC service controls for a connection.
searchRange POST /v1/{parent=services/*}:searchRange
Service producers can use this method to find a currently unused range within consumer allocated ranges.
validate POST /v1/{parent=services/*}:validate
Service producers use this method to validate if the consumer provided network, project and requested range are valid.

REST Resource: v1.services.connections

Methods
create POST /v1/{parent=services/*}/connections
Creates a private connection that establishes a VPC Network Peering connection to a VPC network in the service producer's organization.
deleteConnection POST /v1/{name=services/*/connections/*}
Deletes a private service access connection.
list GET /v1/{parent=services/*}/connections
List the private connections that are configured in a service consumer's VPC network.
patch PATCH /v1/{name=services/*/connections/*}
Updates the allocated ranges that are assigned to a connection.

REST Resource: v1.services.dnsRecordSets

Methods
add POST /v1/{parent=services/*}/dnsRecordSets:add
Service producers can use this method to add DNS record sets to private DNS zones in the shared producer host project.
remove POST /v1/{parent=services/*}/dnsRecordSets:remove
Service producers can use this method to remove DNS record sets from private DNS zones in the shared producer host project.
update POST /v1/{parent=services/*}/dnsRecordSets:update
Service producers can use this method to update DNS record sets from private DNS zones in the shared producer host project.

REST Resource: v1.services.dnsZones

Methods
add POST /v1/{parent=services/*}/dnsZones:add
Service producers can use this method to add private DNS zones in the shared producer host project and matching peering zones in the consumer project.
remove POST /v1/{parent=services/*}/dnsZones:remove
Service producers can use this method to remove private DNS zones in the shared producer host project and matching peering zones in the consumer project.

REST Resource: v1.services.projects.global.networks

Methods
get GET /v1/{name=services/*/projects/*/global/networks/*}
Service producers use this method to get the configuration of their connection including the import/export of custom routes and subnetwork routes with public IP.
updateConsumerConfig PATCH /v1/{parent=services/*/projects/*/global/networks/*}:updateConsumerConfig
Service producers use this method to update the configuration of their connection including the import/export of custom routes and subnetwork routes with public IP.

REST Resource: v1.services.projects.global.networks.peeredDnsDomains

Methods
create POST /v1/{parent=services/*/projects/*/global/networks/*}/peeredDnsDomains
Creates a peered DNS domain which sends requests for records in given namespace originating in the service producer VPC network to the consumer VPC network to be resolved.
delete DELETE /v1/{name=services/*/projects/*/global/networks/*/peeredDnsDomains/*}
Deletes a peered DNS domain.
list GET /v1/{parent=services/*/projects/*/global/networks/*}/peeredDnsDomains
Lists peered DNS domains for a connection.

REST Resource: v1.services.roles

Methods
add POST /v1/{parent=services/*}/roles:add
Service producers can use this method to add roles in the shared VPC host project.