# REST Resource: services.connections

- [Resource: Connection](https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.connections#Connection)
  - [JSON representation](https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.connections#Connection.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.connections#METHODS_SUMMARY)

## Resource: Connection

Represents a private connection resource. A private connection is implemented as a VPC Network Peering connection between a service producer's VPC network and a service consumer's VPC network.

| JSON representation |
|---|
| ``` { "network": string, "reservedPeeringRanges": [ string ], "peering": string, "service": string } ``` |

| Fields ||
|---|---|
| `network` | `string` Required. The name of the service consumer's VPC network that's connected to the service producer network, in the following format: `projects/{project}/global/networks/{network}`. `{project}` is a project number, such as in `12345` that includes the VPC service consumer's VPC network. `{network}` is the name of the service consumer's VPC network. |
| `reservedPeeringRanges[]` | `string` The name of one or more allocated IP address ranges for this service producer of type `PEERING`. Note that invoking connections.create method with a different range when connection is already established will not modify already provisioned service producer subnetworks. If connections.create method is invoked repeatedly to reconnect when peering connection had been disconnected on the consumer side, leaving this field empty will restore previously allocated IP ranges. |
| `peering` | `string` Output only. The name of the VPC Network Peering connection that was created by the service producer. |
| `service` | `string` Output only. The name of the peering service that's associated with this connection, in the following format: `services/{service name}`. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.connections/create` | Creates a private connection that establishes a VPC Network Peering connection to a VPC network in the service producer's organization. |
| ### `https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.connections/deleteConnection` | Deletes a private service access connection. |
| ### `https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.connections/list` | List the private connections that are configured in a service consumer's VPC network. |
| ### `https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.connections/patch` | Updates the allocated ranges that are assigned to a connection. |