Network Services API

Service: networkservices.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 documents:

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://networkservices.googleapis.com

REST Resource: v1.projects.locations

Methods
get GET /v1/{name=projects/*/locations/*}
Gets information about a location.
list GET /v1/{name=projects/*}/locations
Lists information about the supported locations for this service.

REST Resource: v1.projects.locations.endpointPolicies

Methods
create POST /v1/{parent=projects/*/locations/*}/endpointPolicies
Creates a new EndpointPolicy in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/endpointPolicies/*}
Deletes a single EndpointPolicy.
get GET /v1/{name=projects/*/locations/*/endpointPolicies/*}
Gets details of a single EndpointPolicy.
list GET /v1/{parent=projects/*/locations/*}/endpointPolicies
Lists EndpointPolicies in a given project and location.
patch PATCH /v1/{endpointPolicy.name=projects/*/locations/*/endpointPolicies/*}
Updates the parameters of a single EndpointPolicy.
setIamPolicy POST /v1/{resource=projects/*/locations/*/endpointPolicies/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=projects/*/locations/*/endpointPolicies/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.locations.gateways

Methods
create POST /v1/{parent=projects/*/locations/*}/gateways
Creates a new Gateway in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/gateways/*}
Deletes a single Gateway.
get GET /v1/{name=projects/*/locations/*/gateways/*}
Gets details of a single Gateway.
list GET /v1/{parent=projects/*/locations/*}/gateways
Lists Gateways in a given project and location.
patch PATCH /v1/{gateway.name=projects/*/locations/*/gateways/*}
Updates the parameters of a single Gateway.
setIamPolicy POST /v1/{resource=projects/*/locations/*/gateways/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=projects/*/locations/*/gateways/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.locations.grpcRoutes

Methods
create POST /v1/{parent=projects/*/locations/*}/grpcRoutes
Creates a new GrpcRoute in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/grpcRoutes/*}
Deletes a single GrpcRoute.
get GET /v1/{name=projects/*/locations/*/grpcRoutes/*}
Gets details of a single GrpcRoute.
list GET /v1/{parent=projects/*/locations/*}/grpcRoutes
Lists GrpcRoutes in a given project and location.
patch PATCH /v1/{grpcRoute.name=projects/*/locations/*/grpcRoutes/*}
Updates the parameters of a single GrpcRoute.
setIamPolicy POST /v1/{resource=projects/*/locations/*/grpcRoutes/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=projects/*/locations/*/grpcRoutes/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.locations.httpRoutes

Methods
create POST /v1/{parent=projects/*/locations/*}/httpRoutes
Creates a new HttpRoute in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/httpRoutes/*}
Deletes a single HttpRoute.
get GET /v1/{name=projects/*/locations/*/httpRoutes/*}
Gets details of a single HttpRoute.
list GET /v1/{parent=projects/*/locations/*}/httpRoutes
Lists HttpRoute in a given project and location.
patch PATCH /v1/{httpRoute.name=projects/*/locations/*/httpRoutes/*}
Updates the parameters of a single HttpRoute.
setIamPolicy POST /v1/{resource=projects/*/locations/*/httpRoutes/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=projects/*/locations/*/httpRoutes/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.locations.meshes

Methods
create POST /v1/{parent=projects/*/locations/*}/meshes
Creates a new Mesh in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/meshes/*}
Deletes a single Mesh.
get GET /v1/{name=projects/*/locations/*/meshes/*}
Gets details of a single Mesh.
list GET /v1/{parent=projects/*/locations/*}/meshes
Lists Meshes in a given project and location.
patch PATCH /v1/{mesh.name=projects/*/locations/*/meshes/*}
Updates the parameters of a single Mesh.
setIamPolicy POST /v1/{resource=projects/*/locations/*/meshes/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=projects/*/locations/*/meshes/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.locations.operations

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

REST Resource: v1.projects.locations.tcpRoutes

Methods
create POST /v1/{parent=projects/*/locations/*}/tcpRoutes
Creates a new TcpRoute in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/tcpRoutes/*}
Deletes a single TcpRoute.
get GET /v1/{name=projects/*/locations/*/tcpRoutes/*}
Gets details of a single TcpRoute.
list GET /v1/{parent=projects/*/locations/*}/tcpRoutes
Lists TcpRoute in a given project and location.
patch PATCH /v1/{tcpRoute.name=projects/*/locations/*/tcpRoutes/*}
Updates the parameters of a single TcpRoute.
setIamPolicy POST /v1/{resource=projects/*/locations/*/tcpRoutes/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=projects/*/locations/*/tcpRoutes/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.locations.tlsRoutes

Methods
create POST /v1/{parent=projects/*/locations/*}/tlsRoutes
Creates a new TlsRoute in a given project and location.
delete DELETE /v1/{name=projects/*/locations/*/tlsRoutes/*}
Deletes a single TlsRoute.
get GET /v1/{name=projects/*/locations/*/tlsRoutes/*}
Gets details of a single TlsRoute.
list GET /v1/{parent=projects/*/locations/*}/tlsRoutes
Lists TlsRoute in a given project and location.
patch PATCH /v1/{tlsRoute.name=projects/*/locations/*/tlsRoutes/*}
Updates the parameters of a single TlsRoute.
setIamPolicy POST /v1/{resource=projects/*/locations/*/tlsRoutes/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=projects/*/locations/*/tlsRoutes/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1alpha1.projects.locations

Methods
get GET /v1alpha1/{name=projects/*/locations/*}
Gets information about a location.
list GET /v1alpha1/{name=projects/*}/locations
Lists information about the supported locations for this service.

REST Resource: v1alpha1.projects.locations.gateways

Methods
create POST /v1alpha1/{parent=projects/*/locations/*}/gateways
Creates a new Gateway in a given project and location.
delete DELETE /v1alpha1/{name=projects/*/locations/*/gateways/*}
Deletes a single Gateway.
get GET /v1alpha1/{name=projects/*/locations/*/gateways/*}
Gets details of a single Gateway.
getIamPolicy GET /v1alpha1/{resource=projects/*/locations/*/gateways/*}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1alpha1/{parent=projects/*/locations/*}/gateways
Lists Gateways in a given project and location.
patch PATCH /v1alpha1/{gateway.name=projects/*/locations/*/gateways/*}
Updates the parameters of a single Gateway.
setIamPolicy POST /v1alpha1/{resource=projects/*/locations/*/gateways/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1alpha1/{resource=projects/*/locations/*/gateways/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1alpha1.projects.locations.grpcRoutes

Methods
create POST /v1alpha1/{parent=projects/*/locations/*}/grpcRoutes
Creates a new GrpcRoute in a given project and location.
delete DELETE /v1alpha1/{name=projects/*/locations/*/grpcRoutes/*}
Deletes a single GrpcRoute.
get GET /v1alpha1/{name=projects/*/locations/*/grpcRoutes/*}
Gets details of a single GrpcRoute.
getIamPolicy GET /v1alpha1/{resource=projects/*/locations/*/grpcRoutes/*}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1alpha1/{parent=projects/*/locations/*}/grpcRoutes
Lists GrpcRoutes in a given project and location.
patch PATCH /v1alpha1/{grpcRoute.name=projects/*/locations/*/grpcRoutes/*}
Updates the parameters of a single GrpcRoute.
setIamPolicy POST /v1alpha1/{resource=projects/*/locations/*/grpcRoutes/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1alpha1/{resource=projects/*/locations/*/grpcRoutes/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1alpha1.projects.locations.httpRoutes

Methods
create POST /v1alpha1/{parent=projects/*/locations/*}/httpRoutes
Creates a new HttpRoute in a given project and location.
delete DELETE /v1alpha1/{name=projects/*/locations/*/httpRoutes/*}
Deletes a single HttpRoute.
get GET /v1alpha1/{name=projects/*/locations/*/httpRoutes/*}
Gets details of a single HttpRoute.
getIamPolicy GET /v1alpha1/{resource=projects/*/locations/*/httpRoutes/*}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1alpha1/{parent=projects/*/locations/*}/httpRoutes
Lists HttpRoute in a given project and location.
patch PATCH /v1alpha1/{httpRoute.name=projects/*/locations/*/httpRoutes/*}
Updates the parameters of a single HttpRoute.
setIamPolicy POST /v1alpha1/{resource=projects/*/locations/*/httpRoutes/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1alpha1/{resource=projects/*/locations/*/httpRoutes/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1alpha1.projects.locations.meshes

Methods
create POST /v1alpha1/{parent=projects/*/locations/*}/meshes
Creates a new Mesh in a given project and location.
delete DELETE /v1alpha1/{name=projects/*/locations/*/meshes/*}
Deletes a single Mesh.
get GET /v1alpha1/{name=projects/*/locations/*/meshes/*}
Gets details of a single Mesh.
getIamPolicy GET /v1alpha1/{resource=projects/*/locations/*/meshes/*}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1alpha1/{parent=projects/*/locations/*}/meshes
Lists Meshes in a given project and location.
patch PATCH /v1alpha1/{mesh.name=projects/*/locations/*/meshes/*}
Updates the parameters of a single Mesh.
setIamPolicy POST /v1alpha1/{resource=projects/*/locations/*/meshes/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1alpha1/{resource=projects/*/locations/*/meshes/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1alpha1.projects.locations.operations

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

REST Resource: v1alpha1.projects.locations.serviceBindings

Methods
create POST /v1alpha1/{parent=projects/*/locations/*}/serviceBindings
Creates a new ServiceBinding in a given project and location.
delete DELETE /v1alpha1/{name=projects/*/locations/*/serviceBindings/*}
Deletes a single ServiceBinding.
get GET /v1alpha1/{name=projects/*/locations/*/serviceBindings/*}
Gets details of a single ServiceBinding.
list GET /v1alpha1/{parent=projects/*/locations/*}/serviceBindings
Lists ServiceBinding in a given project and location.

REST Resource: v1alpha1.projects.locations.tcpRoutes

Methods
create POST /v1alpha1/{parent=projects/*/locations/*}/tcpRoutes
Creates a new TcpRoute in a given project and location.
delete DELETE /v1alpha1/{name=projects/*/locations/*/tcpRoutes/*}
Deletes a single TcpRoute.
get GET /v1alpha1/{name=projects/*/locations/*/tcpRoutes/*}
Gets details of a single TcpRoute.
getIamPolicy GET /v1alpha1/{resource=projects/*/locations/*/tcpRoutes/*}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1alpha1/{parent=projects/*/locations/*}/tcpRoutes
Lists TcpRoute in a given project and location.
patch PATCH /v1alpha1/{tcpRoute.name=projects/*/locations/*/tcpRoutes/*}
Updates the parameters of a single TcpRoute.
setIamPolicy POST /v1alpha1/{resource=projects/*/locations/*/tcpRoutes/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1alpha1/{resource=projects/*/locations/*/tcpRoutes/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1alpha1.projects.locations.tlsRoutes

Methods
create POST /v1alpha1/{parent=projects/*/locations/*}/tlsRoutes
Creates a new TlsRoute in a given project and location.
delete DELETE /v1alpha1/{name=projects/*/locations/*/tlsRoutes/*}
Deletes a single TlsRoute.
get GET /v1alpha1/{name=projects/*/locations/*/tlsRoutes/*}
Gets details of a single TlsRoute.
getIamPolicy GET /v1alpha1/{resource=projects/*/locations/*/tlsRoutes/*}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1alpha1/{parent=projects/*/locations/*}/tlsRoutes
Lists TlsRoute in a given project and location.
patch PATCH /v1alpha1/{tlsRoute.name=projects/*/locations/*/tlsRoutes/*}
Updates the parameters of a single TlsRoute.
setIamPolicy POST /v1alpha1/{resource=projects/*/locations/*/tlsRoutes/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1alpha1/{resource=projects/*/locations/*/tlsRoutes/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1beta1.projects.locations

Methods
get GET /v1beta1/{name=projects/*/locations/*}
Gets information about a location.
list GET /v1beta1/{name=projects/*}/locations
Lists information about the supported locations for this service.

REST Resource: v1beta1.projects.locations.endpointPolicies

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/endpointPolicies
Creates a new EndpointPolicy in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/endpointPolicies/*}
Deletes a single EndpointPolicy.
get GET /v1beta1/{name=projects/*/locations/*/endpointPolicies/*}
Gets details of a single EndpointPolicy.
getIamPolicy GET /v1beta1/{resource=projects/*/locations/*/endpointPolicies/*}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1beta1/{parent=projects/*/locations/*}/endpointPolicies
Lists EndpointPolicies in a given project and location.
patch PATCH /v1beta1/{endpointPolicy.name=projects/*/locations/*/endpointPolicies/*}
Updates the parameters of a single EndpointPolicy.
setIamPolicy POST /v1beta1/{resource=projects/*/locations/*/endpointPolicies/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1beta1/{resource=projects/*/locations/*/endpointPolicies/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1beta1.projects.locations.gateways

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/gateways
Creates a new Gateway in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/gateways/*}
Deletes a single Gateway.
get GET /v1beta1/{name=projects/*/locations/*/gateways/*}
Gets details of a single Gateway.
list GET /v1beta1/{parent=projects/*/locations/*}/gateways
Lists Gateways in a given project and location.
patch PATCH /v1beta1/{gateway.name=projects/*/locations/*/gateways/*}
Updates the parameters of a single Gateway.

REST Resource: v1beta1.projects.locations.grpcRoutes

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/grpcRoutes
Creates a new GrpcRoute in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/grpcRoutes/*}
Deletes a single GrpcRoute.
get GET /v1beta1/{name=projects/*/locations/*/grpcRoutes/*}
Gets details of a single GrpcRoute.
list GET /v1beta1/{parent=projects/*/locations/*}/grpcRoutes
Lists GrpcRoutes in a given project and location.
patch PATCH /v1beta1/{grpcRoute.name=projects/*/locations/*/grpcRoutes/*}
Updates the parameters of a single GrpcRoute.

REST Resource: v1beta1.projects.locations.httpRoutes

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/httpRoutes
Creates a new HttpRoute in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/httpRoutes/*}
Deletes a single HttpRoute.
get GET /v1beta1/{name=projects/*/locations/*/httpRoutes/*}
Gets details of a single HttpRoute.
list GET /v1beta1/{parent=projects/*/locations/*}/httpRoutes
Lists HttpRoute in a given project and location.
patch PATCH /v1beta1/{httpRoute.name=projects/*/locations/*/httpRoutes/*}
Updates the parameters of a single HttpRoute.

REST Resource: v1beta1.projects.locations.meshes

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/meshes
Creates a new Mesh in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/meshes/*}
Deletes a single Mesh.
get GET /v1beta1/{name=projects/*/locations/*/meshes/*}
Gets details of a single Mesh.
list GET /v1beta1/{parent=projects/*/locations/*}/meshes
Lists Meshes in a given project and location.
patch PATCH /v1beta1/{mesh.name=projects/*/locations/*/meshes/*}
Updates the parameters of a single Mesh.

REST Resource: v1beta1.projects.locations.operations

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

REST Resource: v1beta1.projects.locations.serviceBindings

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/serviceBindings
Creates a new ServiceBinding in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/serviceBindings/*}
Deletes a single ServiceBinding.
get GET /v1beta1/{name=projects/*/locations/*/serviceBindings/*}
Gets details of a single ServiceBinding.
list GET /v1beta1/{parent=projects/*/locations/*}/serviceBindings
Lists ServiceBinding in a given project and location.

REST Resource: v1beta1.projects.locations.tcpRoutes

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/tcpRoutes
Creates a new TcpRoute in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/tcpRoutes/*}
Deletes a single TcpRoute.
get GET /v1beta1/{name=projects/*/locations/*/tcpRoutes/*}
Gets details of a single TcpRoute.
list GET /v1beta1/{parent=projects/*/locations/*}/tcpRoutes
Lists TcpRoute in a given project and location.
patch PATCH /v1beta1/{tcpRoute.name=projects/*/locations/*/tcpRoutes/*}
Updates the parameters of a single TcpRoute.

REST Resource: v1beta1.projects.locations.tlsRoutes

Methods
create POST /v1beta1/{parent=projects/*/locations/*}/tlsRoutes
Creates a new TlsRoute in a given project and location.
delete DELETE /v1beta1/{name=projects/*/locations/*/tlsRoutes/*}
Deletes a single TlsRoute.
get GET /v1beta1/{name=projects/*/locations/*/tlsRoutes/*}
Gets details of a single TlsRoute.
list GET /v1beta1/{parent=projects/*/locations/*}/tlsRoutes
Lists TlsRoute in a given project and location.
patch PATCH /v1beta1/{tlsRoute.name=projects/*/locations/*/tlsRoutes/*}
Updates the parameters of a single TlsRoute.