published on Tuesday, Jun 9, 2026 by Pulumi
published on Tuesday, Jun 9, 2026 by Pulumi
SipTrunk is the resource that represents a SIP trunk to connect to the Google Telephony Platform SIP trunking service.
To get more information about SipTrunk, see:
Example Usage
Dialogflow Sip Trunk Basic
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const basicTrunk = new gcp.diagflow.SipTrunk("basic_trunk", {
displayName: "basic-trunk",
location: "europe-west3",
expectedHostnames: ["basic-trunk.example.com"],
});
import pulumi
import pulumi_gcp as gcp
basic_trunk = gcp.diagflow.SipTrunk("basic_trunk",
display_name="basic-trunk",
location="europe-west3",
expected_hostnames=["basic-trunk.example.com"])
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/diagflow"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := diagflow.NewSipTrunk(ctx, "basic_trunk", &diagflow.SipTrunkArgs{
DisplayName: pulumi.String("basic-trunk"),
Location: pulumi.String("europe-west3"),
ExpectedHostnames: pulumi.StringArray{
pulumi.String("basic-trunk.example.com"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var basicTrunk = new Gcp.Diagflow.SipTrunk("basic_trunk", new()
{
DisplayName = "basic-trunk",
Location = "europe-west3",
ExpectedHostnames = new[]
{
"basic-trunk.example.com",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.diagflow.SipTrunk;
import com.pulumi.gcp.diagflow.SipTrunkArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var basicTrunk = new SipTrunk("basicTrunk", SipTrunkArgs.builder()
.displayName("basic-trunk")
.location("europe-west3")
.expectedHostnames("basic-trunk.example.com")
.build());
}
}
resources:
basicTrunk:
type: gcp:diagflow:SipTrunk
name: basic_trunk
properties:
displayName: basic-trunk
location: europe-west3
expectedHostnames:
- basic-trunk.example.com
pulumi {
required_providers {
gcp = {
source = "pulumi/gcp"
}
}
}
resource "gcp_diagflow_siptrunk" "basic_trunk" {
display_name = "basic-trunk"
location = "europe-west3"
expected_hostnames = ["basic-trunk.example.com"]
}
Create SipTrunk Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new SipTrunk(name: string, args: SipTrunkArgs, opts?: CustomResourceOptions);@overload
def SipTrunk(resource_name: str,
args: SipTrunkArgs,
opts: Optional[ResourceOptions] = None)
@overload
def SipTrunk(resource_name: str,
opts: Optional[ResourceOptions] = None,
expected_hostnames: Optional[Sequence[str]] = None,
location: Optional[str] = None,
deletion_policy: Optional[str] = None,
display_name: Optional[str] = None,
project: Optional[str] = None)func NewSipTrunk(ctx *Context, name string, args SipTrunkArgs, opts ...ResourceOption) (*SipTrunk, error)public SipTrunk(string name, SipTrunkArgs args, CustomResourceOptions? opts = null)
public SipTrunk(String name, SipTrunkArgs args)
public SipTrunk(String name, SipTrunkArgs args, CustomResourceOptions options)
type: gcp:diagflow:SipTrunk
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "gcp_diagflow_siptrunk" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args SipTrunkArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args SipTrunkArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args SipTrunkArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args SipTrunkArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args SipTrunkArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var sipTrunkResource = new Gcp.Diagflow.SipTrunk("sipTrunkResource", new()
{
ExpectedHostnames = new[]
{
"string",
},
Location = "string",
DeletionPolicy = "string",
DisplayName = "string",
Project = "string",
});
example, err := diagflow.NewSipTrunk(ctx, "sipTrunkResource", &diagflow.SipTrunkArgs{
ExpectedHostnames: pulumi.StringArray{
pulumi.String("string"),
},
Location: pulumi.String("string"),
DeletionPolicy: pulumi.String("string"),
DisplayName: pulumi.String("string"),
Project: pulumi.String("string"),
})
resource "gcp_diagflow_siptrunk" "sipTrunkResource" {
expected_hostnames = ["string"]
location = "string"
deletion_policy = "string"
display_name = "string"
project = "string"
}
var sipTrunkResource = new SipTrunk("sipTrunkResource", SipTrunkArgs.builder()
.expectedHostnames("string")
.location("string")
.deletionPolicy("string")
.displayName("string")
.project("string")
.build());
sip_trunk_resource = gcp.diagflow.SipTrunk("sipTrunkResource",
expected_hostnames=["string"],
location="string",
deletion_policy="string",
display_name="string",
project="string")
const sipTrunkResource = new gcp.diagflow.SipTrunk("sipTrunkResource", {
expectedHostnames: ["string"],
location: "string",
deletionPolicy: "string",
displayName: "string",
project: "string",
});
type: gcp:diagflow:SipTrunk
properties:
deletionPolicy: string
displayName: string
expectedHostnames:
- string
location: string
project: string
SipTrunk Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The SipTrunk resource accepts the following input properties:
- Expected
Hostnames List<string> - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- Location string
- The location of the SIP trunk.
- Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Display
Name string - Optional. Human-readable alias for this trunk.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Expected
Hostnames []string - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- Location string
- The location of the SIP trunk.
- Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Display
Name string - Optional. Human-readable alias for this trunk.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- expected_
hostnames list(string) - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- location string
- The location of the SIP trunk.
- deletion_
policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display_
name string - Optional. Human-readable alias for this trunk.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- expected
Hostnames List<String> - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- location String
- The location of the SIP trunk.
- deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name String - Optional. Human-readable alias for this trunk.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- expected
Hostnames string[] - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- location string
- The location of the SIP trunk.
- deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name string - Optional. Human-readable alias for this trunk.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- expected_
hostnames Sequence[str] - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- location str
- The location of the SIP trunk.
- deletion_
policy str - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display_
name str - Optional. Human-readable alias for this trunk.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- expected
Hostnames List<String> - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- location String
- The location of the SIP trunk.
- deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name String - Optional. Human-readable alias for this trunk.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Outputs
All input properties are implicitly available as output properties. Additionally, the SipTrunk resource produces the following output properties:
- Connections
List<Sip
Trunk Connection> - Output only. The connections of the SIP trunk. Structure is documented below.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- Identifier. The unique identifier of the SIP trunk.
- Connections
[]Sip
Trunk Connection - Output only. The connections of the SIP trunk. Structure is documented below.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- Identifier. The unique identifier of the SIP trunk.
- connections list(object)
- Output only. The connections of the SIP trunk. Structure is documented below.
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- Identifier. The unique identifier of the SIP trunk.
- connections
List<Sip
Trunk Connection> - Output only. The connections of the SIP trunk. Structure is documented below.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- Identifier. The unique identifier of the SIP trunk.
- connections
Sip
Trunk Connection[] - Output only. The connections of the SIP trunk. Structure is documented below.
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- Identifier. The unique identifier of the SIP trunk.
- connections
Sequence[Sip
Trunk Connection] - Output only. The connections of the SIP trunk. Structure is documented below.
- id str
- The provider-assigned unique ID for this managed resource.
- name str
- Identifier. The unique identifier of the SIP trunk.
- connections List<Property Map>
- Output only. The connections of the SIP trunk. Structure is documented below.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- Identifier. The unique identifier of the SIP trunk.
Look up Existing SipTrunk Resource
Get an existing SipTrunk resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: SipTrunkState, opts?: CustomResourceOptions): SipTrunk@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
connections: Optional[Sequence[SipTrunkConnectionArgs]] = None,
deletion_policy: Optional[str] = None,
display_name: Optional[str] = None,
expected_hostnames: Optional[Sequence[str]] = None,
location: Optional[str] = None,
name: Optional[str] = None,
project: Optional[str] = None) -> SipTrunkfunc GetSipTrunk(ctx *Context, name string, id IDInput, state *SipTrunkState, opts ...ResourceOption) (*SipTrunk, error)public static SipTrunk Get(string name, Input<string> id, SipTrunkState? state, CustomResourceOptions? opts = null)public static SipTrunk get(String name, Output<String> id, SipTrunkState state, CustomResourceOptions options)resources: _: type: gcp:diagflow:SipTrunk get: id: ${id}import {
to = gcp_diagflow_siptrunk.example
id = "${id}"
}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Connections
List<Sip
Trunk Connection> - Output only. The connections of the SIP trunk. Structure is documented below.
- Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Display
Name string - Optional. Human-readable alias for this trunk.
- Expected
Hostnames List<string> - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- Location string
- The location of the SIP trunk.
- Name string
- Identifier. The unique identifier of the SIP trunk.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Connections
[]Sip
Trunk Connection Args - Output only. The connections of the SIP trunk. Structure is documented below.
- Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Display
Name string - Optional. Human-readable alias for this trunk.
- Expected
Hostnames []string - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- Location string
- The location of the SIP trunk.
- Name string
- Identifier. The unique identifier of the SIP trunk.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- connections list(object)
- Output only. The connections of the SIP trunk. Structure is documented below.
- deletion_
policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display_
name string - Optional. Human-readable alias for this trunk.
- expected_
hostnames list(string) - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- location string
- The location of the SIP trunk.
- name string
- Identifier. The unique identifier of the SIP trunk.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- connections
List<Sip
Trunk Connection> - Output only. The connections of the SIP trunk. Structure is documented below.
- deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name String - Optional. Human-readable alias for this trunk.
- expected
Hostnames List<String> - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- location String
- The location of the SIP trunk.
- name String
- Identifier. The unique identifier of the SIP trunk.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- connections
Sip
Trunk Connection[] - Output only. The connections of the SIP trunk. Structure is documented below.
- deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name string - Optional. Human-readable alias for this trunk.
- expected
Hostnames string[] - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- location string
- The location of the SIP trunk.
- name string
- Identifier. The unique identifier of the SIP trunk.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- connections
Sequence[Sip
Trunk Connection Args] - Output only. The connections of the SIP trunk. Structure is documented below.
- deletion_
policy str - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display_
name str - Optional. Human-readable alias for this trunk.
- expected_
hostnames Sequence[str] - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- location str
- The location of the SIP trunk.
- name str
- Identifier. The unique identifier of the SIP trunk.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- connections List<Property Map>
- Output only. The connections of the SIP trunk. Structure is documented below.
- deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name String - Optional. Human-readable alias for this trunk.
- expected
Hostnames List<String> - Required. The expected hostnames in the peer certificate from the partner that is used for TLS authentication.
- location String
- The location of the SIP trunk.
- name String
- Identifier. The unique identifier of the SIP trunk.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Supporting Types
SipTrunkConnection, SipTrunkConnectionArgs
- Connection
Id string - (Output) Output only. The unique identifier of the connection.
- Error
Details List<SipTrunk Connection Error Detail> - (Output) Output only. The error details of the connection. Structure is documented below.
- State string
- (Output) Output only. The state of the connection.
- Update
Time string - (Output) Output only. The last update time of the connection.
- Connection
Id string - (Output) Output only. The unique identifier of the connection.
- Error
Details []SipTrunk Connection Error Detail - (Output) Output only. The error details of the connection. Structure is documented below.
- State string
- (Output) Output only. The state of the connection.
- Update
Time string - (Output) Output only. The last update time of the connection.
- connection_
id string - (Output) Output only. The unique identifier of the connection.
- error_
details list(object) - (Output) Output only. The error details of the connection. Structure is documented below.
- state string
- (Output) Output only. The state of the connection.
- update_
time string - (Output) Output only. The last update time of the connection.
- connection
Id String - (Output) Output only. The unique identifier of the connection.
- error
Details List<SipTrunk Connection Error Detail> - (Output) Output only. The error details of the connection. Structure is documented below.
- state String
- (Output) Output only. The state of the connection.
- update
Time String - (Output) Output only. The last update time of the connection.
- connection
Id string - (Output) Output only. The unique identifier of the connection.
- error
Details SipTrunk Connection Error Detail[] - (Output) Output only. The error details of the connection. Structure is documented below.
- state string
- (Output) Output only. The state of the connection.
- update
Time string - (Output) Output only. The last update time of the connection.
- connection_
id str - (Output) Output only. The unique identifier of the connection.
- error_
details Sequence[SipTrunk Connection Error Detail] - (Output) Output only. The error details of the connection. Structure is documented below.
- state str
- (Output) Output only. The state of the connection.
- update_
time str - (Output) Output only. The last update time of the connection.
- connection
Id String - (Output) Output only. The unique identifier of the connection.
- error
Details List<Property Map> - (Output) Output only. The error details of the connection. Structure is documented below.
- state String
- (Output) Output only. The state of the connection.
- update
Time String - (Output) Output only. The last update time of the connection.
SipTrunkConnectionErrorDetail, SipTrunkConnectionErrorDetailArgs
Import
SipTrunk can be imported using any of these accepted formats:
{{name}}
When using the pulumi import command, SipTrunk can be imported using one of the formats above. For example:
$ pulumi import gcp:diagflow/sipTrunk:SipTrunk default {{name}}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-betaTerraform Provider.
published on Tuesday, Jun 9, 2026 by Pulumi