REST Resource: projects.locations.serviceConnectionPolicies

Resource: ServiceConnectionPolicy

The ServiceConnectionPolicy resource. Next id: 12

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "network": string,
  "serviceClass": string,
  "infrastructure": enum (Infrastructure),
  "pscConfig": {
    object (PscConfig)
  },
  "pscConnections": [
    {
      object (PscConnection)
    }
  ],
  "etag": string
}
Fields
name

string

Immutable. The name of a ServiceConnectionPolicy. Format: projects/{project}/locations/{location}/serviceConnectionPolicies/{serviceConnectionPolicy} See: https://google.aip.dev/122#fields-representing-resource-names

createTime

string (Timestamp format)

Output only. Time when the ServiceConnectionMap was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. Time when the ServiceConnectionMap was updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

User-defined labels.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

description

string

A description of this resource.

network

string

The resource path of the consumer network. Example: - projects/{projectNumOrId}/global/networks/{resourceId}.

serviceClass

string

The service class identifier for which this ServiceConnectionPolicy is for. The service class identifier is a unique, symbolic representation of a ServiceClass. It is provided by the Service Producer. Google services have a prefix of gcp. For example, gcp-cloud-sql. 3rd party services do not. For example, test-service-a3dfcx.

infrastructure

enum (Infrastructure)

Output only. The type of underlying resources used to create the connection.

pscConfig

object (PscConfig)

Configuration used for Private Service Connect connections. Used when Infrastructure is PSC.

pscConnections[]

object (PscConnection)

Output only. [Output only] Information about each Private Service Connect connection.

etag

string

Optional. The etag is computed by the server, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.

PscConfig

Configuration used for Private Service Connect connections. Used when Infrastructure is PSC.

JSON representation
{
  "subnetworks": [
    string
  ],
  "limit": string
}
Fields
subnetworks[]

string

The resource paths of subnetworks to use for IP address management. Example: projects/{projectNumOrId}/regions/{region}/subnetworks/{resourceId}.

limit

string (int64 format)

Optional. Max number of PSC connections for this policy.

PscConnection

Information about a specific Private Service Connect connection.

JSON representation
{
  "state": enum (State),
  "consumerForwardingRule": string,
  "consumerAddress": string,
  "errorType": enum (ConnectionErrorType),
  "error": {
    object (Status)
  },
  "gceOperation": string,
  "consumerTargetProject": string,
  "pscConnectionId": string,
  "errorInfo": {
    object (ErrorInfo)
  },
  "selectedSubnetwork": string,
  "producerInstanceId": string
}
Fields
state

enum (State)

State of the PSC Connection

consumerForwardingRule

string

The resource reference of the PSC Forwarding Rule within the consumer VPC.

consumerAddress

string

The resource reference of the consumer address.

errorType

enum (ConnectionErrorType)

The error type indicates whether the error is consumer facing, producer facing or system internal.

error
(deprecated)

object (Status)

The most recent error during operating this connection.

gceOperation

string

The last Compute Engine operation to setup PSC connection.

consumerTargetProject

string

The project where the PSC connection is created.

pscConnectionId

string

The PSC connection id of the PSC forwarding rule.

errorInfo

object (ErrorInfo)

Output only. The error info for the latest error during operating this connection.

selectedSubnetwork

string

Output only. The URI of the subnetwork selected to allocate IP address for this connection.

producerInstanceId

string

Immutable. An immutable identifier for the producer instance.

State

The state of the PSC connection.

Enums
STATE_UNSPECIFIED An invalid state as the default case.
ACTIVE The connection is fully established and ready to use.
FAILED The connection is not functional since some resources on the connection fail to be created.
CREATING The connection is being created.
DELETING The connection is being deleted.

Methods

create

Creates a new ServiceConnectionPolicy in a given project and location.

delete

Deletes a single ServiceConnectionPolicy.

get

Gets details of a single ServiceConnectionPolicy.

list

Lists ServiceConnectionPolicies in a given project and location.

patch

Updates the parameters of a single ServiceConnectionPolicy.