REST Resource: projects.locations.sipTrunks

Resource: SipTrunk

SipTrunk is the resource that represents a SIP trunk to connect to Google Telephony platform SIP trunking service.

JSON representation
{
  "name": string,
  "expectedHostname": [
    string
  ],
  "connections": [
    {
      object (Connection)
    }
  ],
  "displayName": string
}
Fields
name

string

Identifier. The unique identifier of the SIP trunk. Format: projects/<Project ID>/locations/<Location ID>/sipTrunks/<SipTrunk ID>.

expectedHostname[]

string

Required. The expected hostnames in the peer certificate from partner that is used for TLS authentication.

connections[]

object (Connection)

Output only. Connections of the SIP trunk.

displayName

string

Optional. Human readable alias for this trunk.

Connection

Represents a connection for SIP Trunk.

JSON representation
{
  "connectionId": string,
  "state": enum (State),
  "updateTime": string,
  "errorDetails": {
    object (ErrorDetails)
  }
}
Fields
connectionId

string

Output only. The unique identifier of the SIP Trunk connection.

state

enum (State)

Output only. State of the connection.

updateTime

string (Timestamp format)

Output only. When the connection status changed.

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".

errorDetails

object (ErrorDetails)

Output only. The error details for the connection. Only populated when authentication errors occur.

State

The state of Sip Trunk connection.

Enums
STATE_UNSPECIFIED SIP Trunk connection state is Not specified.
CONNECTED SIP Trunk connection is connected.
DISCONNECTED SIP Trunk connection is disconnected.
AUTHENTICATION_FAILED SIP Trunk connection has authentication error.
KEEPALIVE SIP Trunk connection is keepalive.

ErrorDetails

The error details of Sip Trunk connection authentication.

JSON representation
{
  "certificateState": enum (CertificateState),
  "errorMessage": string
}
Fields
certificateState

enum (CertificateState)

Output only. The status of the certificate authentication.

errorMessage

string

The error message provided from SIP trunking auth service

CertificateState

The state of Sip Trunk certificate authentication.

Enums
CERTIFICATE_STATE_UNSPECIFIED Certificate state is not specified.
CERTIFICATE_VALID Certificate is valid.
CERTIFICATE_INVALID Catch all for any error not specified.
CERTIFICATE_EXPIRED Certificate leaf node has expired.
CERTIFICATE_HOSTNAME_NOT_FOUND There is no hostname defined to authenticate in SipTrunkingServer.
CERTIFICATE_UNAUTHENTICATED No path found from the leaf certificate to any root.
CERTIFICATE_TRUST_STORE_NOT_FOUND Trust store does not exist.
CERTIFICATE_HOSTNAME_INVALID_FORMAT Hostname has invalid format.
CERTIFICATE_QUOTA_EXCEEDED Certificate has exhausted its quota.

Methods

create

Creates a SipTrunk for a specified location.

delete

Deletes a specified SipTrunk.

get

Retrieves the specified SipTrunk.

list

Returns a list of SipTrunks in the specified location.

patch

Updates the specified SipTrunk.