Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. Google Cloud (GCP)
  4. API Docs
  5. compute
  6. getServiceAttachments
Viewing docs for Google Cloud v10.2.0
published on Tuesday, Oct 20, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-gcp

gcp.compute.getServiceAttachments

gcp logo
Viewing docs for Google Cloud v10.2.0
published on Tuesday, Oct 20, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-gcp

    List all service attachments in a given project and region. For more information see the official documentation and API reference.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const all = gcp.compute.getServiceAttachments({
    project: "my-project",
    region: "us-central1",
});

    import pulumi
import pulumi_gcp as gcp

all = gcp.compute.get_service_attachments(project="my-project",
    region="us-central1")

    package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v10/go/gcp/compute"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := compute.GetServiceAttachments(ctx, &compute.GetServiceAttachmentsArgs{
			Project: pulumi.StringRef("my-project"),
			Region:  pulumi.StringRef("us-central1"),
		}, nil)
		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 all = Gcp.Compute.GetServiceAttachments.Invoke(new()
    {
        Project = "my-project",
        Region = "us-central1",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.ComputeFunctions;
import com.pulumi.gcp.compute.inputs.GetServiceAttachmentsArgs;
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) {
        final var all = ComputeFunctions.getServiceAttachments(GetServiceAttachmentsArgs.builder()
            .project("my-project")
            .region("us-central1")
            .build());

    }
}

    variables:
  all:
    fn::invoke:
      function: gcp:compute:getServiceAttachments
      arguments:
        project: my-project
        region: us-central1

    terraform {
  required_providers {
    gcp = {
      source = "pulumi/gcp"
    }
  }
}

data "gcp_compute_service_attachments" "all" {
  project = "my-project"
  region  = "us-central1"
}

    With Filter

    import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const filtered = gcp.compute.getServiceAttachments({
    project: "my-project",
    region: "us-central1",
    filter: "name = my-service-attachment",
});

    import pulumi
import pulumi_gcp as gcp

filtered = gcp.compute.get_service_attachments(project="my-project",
    region="us-central1",
    filter="name = my-service-attachment")

    package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v10/go/gcp/compute"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := compute.GetServiceAttachments(ctx, &compute.GetServiceAttachmentsArgs{
			Project: pulumi.StringRef("my-project"),
			Region:  pulumi.StringRef("us-central1"),
			Filter:  pulumi.StringRef("name = my-service-attachment"),
		}, nil)
		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 filtered = Gcp.Compute.GetServiceAttachments.Invoke(new()
    {
        Project = "my-project",
        Region = "us-central1",
        Filter = "name = my-service-attachment",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.ComputeFunctions;
import com.pulumi.gcp.compute.inputs.GetServiceAttachmentsArgs;
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) {
        final var filtered = ComputeFunctions.getServiceAttachments(GetServiceAttachmentsArgs.builder()
            .project("my-project")
            .region("us-central1")
            .filter("name = my-service-attachment")
            .build());

    }
}

    variables:
  filtered:
    fn::invoke:
      function: gcp:compute:getServiceAttachments
      arguments:
        project: my-project
        region: us-central1
        filter: name = my-service-attachment

    terraform {
  required_providers {
    gcp = {
      source = "pulumi/gcp"
    }
  }
}

data "gcp_compute_service_attachments" "filtered" {
  project = "my-project"
  region  = "us-central1"
  filter  = "name = my-service-attachment"
}

    Using getServiceAttachments

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getServiceAttachments(args: GetServiceAttachmentsArgs, opts?: InvokeOptions): Promise<GetServiceAttachmentsResult>
function getServiceAttachmentsOutput(args: GetServiceAttachmentsOutputArgs, opts?: InvokeOutputOptions): Output<GetServiceAttachmentsResult>
    def get_service_attachments(filter: Optional[str] = None,
                            project: Optional[str] = None,
                            region: Optional[str] = None,
                            opts: Optional[InvokeOptions] = None) -> GetServiceAttachmentsResult
def get_service_attachments_output(filter: pulumi.Input[Optional[str]] = None,
                            project: pulumi.Input[Optional[str]] = None,
                            region: pulumi.Input[Optional[str]] = None,
                            opts: Optional[InvokeOutputOptions] = None) -> Output[GetServiceAttachmentsResult]
    func GetServiceAttachments(ctx *Context, args *GetServiceAttachmentsArgs, opts ...InvokeOption) (*GetServiceAttachmentsResult, error)
func GetServiceAttachmentsOutput(ctx *Context, args *GetServiceAttachmentsOutputArgs, opts ...InvokeOption) GetServiceAttachmentsResultOutput

    > Note: This function is named GetServiceAttachments in the Go SDK.

    public static class GetServiceAttachments 
{
    public static Task<GetServiceAttachmentsResult> InvokeAsync(GetServiceAttachmentsArgs args, InvokeOptions? opts = null)
    public static Output<GetServiceAttachmentsResult> Invoke(GetServiceAttachmentsInvokeArgs args, InvokeOptions? opts = null)
    public static Output<GetServiceAttachmentsResult> Invoke(GetServiceAttachmentsInvokeArgs args, InvokeOutputOptions opts)
}
    public static CompletableFuture<GetServiceAttachmentsResult> getServiceAttachments(GetServiceAttachmentsArgs args, InvokeOptions options)
public static Output<GetServiceAttachmentsResult> getServiceAttachments(GetServiceAttachmentsArgs args, InvokeOptions options)
public static Output<GetServiceAttachmentsResult> getServiceAttachments(GetServiceAttachmentsArgs args, InvokeOutputOptions options)

    fn::invoke:
  function: gcp:compute/getServiceAttachments:getServiceAttachments
  arguments:
    # arguments dictionary
    data "gcp_compute_get_service_attachments" "name" {
    # arguments
}

    The following arguments are supported:

    Filter string
    A filter expression that filters service attachments listed in the response. See the API filter parameter documentation for details.
    Project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    Region string
    The region in which the resource belongs. If it is not provided, the provider region is used.
    Filter string
    A filter expression that filters service attachments listed in the response. See the API filter parameter documentation for details.
    Project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    Region string
    The region in which the resource belongs. If it is not provided, the provider region is used.
    filter string
    A filter expression that filters service attachments listed in the response. See the API filter parameter documentation for details.
    project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    region string
    The region in which the resource belongs. If it is not provided, the provider region is used.
    filter String
    A filter expression that filters service attachments listed in the response. See the API filter parameter documentation for details.
    project String
    The project in which the resource belongs. If it is not provided, the provider project is used.
    region String
    The region in which the resource belongs. If it is not provided, the provider region is used.
    filter string
    A filter expression that filters service attachments listed in the response. See the API filter parameter documentation for details.
    project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    region string
    The region in which the resource belongs. If it is not provided, the provider region is used.
    filter str
    A filter expression that filters service attachments listed in the response. See the API filter parameter documentation for details.
    project str
    The project in which the resource belongs. If it is not provided, the provider project is used.
    region str
    The region in which the resource belongs. If it is not provided, the provider region is used.
    filter String
    A filter expression that filters service attachments listed in the response. See the API filter parameter documentation for details.
    project String
    The project in which the resource belongs. If it is not provided, the provider project is used.
    region String
    The region in which the resource belongs. If it is not provided, the provider region is used.

    getServiceAttachments Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    ServiceAttachments List<GetServiceAttachmentsServiceAttachment>
    A list of service attachments matching the provided filter. Each element contains:
    Filter string
    Project string
    Region string
    The region of the service attachment.
    Id string
    The provider-assigned unique ID for this managed resource.
    ServiceAttachments []GetServiceAttachmentsServiceAttachment
    A list of service attachments matching the provided filter. Each element contains:
    Filter string
    Project string
    Region string
    The region of the service attachment.
    id string
    The provider-assigned unique ID for this managed resource.
    service_attachments list(object)
    A list of service attachments matching the provided filter. Each element contains:
    filter string
    project string
    region string
    The region of the service attachment.
    id String
    The provider-assigned unique ID for this managed resource.
    serviceAttachments List<GetServiceAttachmentsServiceAttachment>
    A list of service attachments matching the provided filter. Each element contains:
    filter String
    project String
    region String
    The region of the service attachment.
    id string
    The provider-assigned unique ID for this managed resource.
    serviceAttachments GetServiceAttachmentsServiceAttachment[]
    A list of service attachments matching the provided filter. Each element contains:
    filter string
    project string
    region string
    The region of the service attachment.
    id str
    The provider-assigned unique ID for this managed resource.
    service_attachments Sequence[GetServiceAttachmentsServiceAttachment]
    A list of service attachments matching the provided filter. Each element contains:
    filter str
    project str
    region str
    The region of the service attachment.
    id String
    The provider-assigned unique ID for this managed resource.
    serviceAttachments List<Property Map>
    A list of service attachments matching the provided filter. Each element contains:
    filter String
    project String
    region String
    The region of the service attachment.

    Supporting Types

    GetServiceAttachmentsServiceAttachment

    ConnectedEndpoints List<GetServiceAttachmentsServiceAttachmentConnectedEndpoint>
    An array of the consumer forwarding rules connected to this service attachment.
    ConnectionPreference string
    The connection preference of the service attachment. Possible values are ACCEPT_AUTOMATIC and ACCEPT_MANUAL.
    ConsumerAcceptLists List<GetServiceAttachmentsServiceAttachmentConsumerAcceptList>
    An array of projects that are allowed to connect to this service attachment.
    ConsumerRejectLists List<string>
    An array of projects that are not allowed to connect to this service attachment.
    DeletionPolicy string
    Whether Terraform will be prevented from destroying the instance. Defaults to "DELETE". When a 'terraform destroy' or 'terraform apply' would delete the instance, 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.
    Description string
    An optional description of the service attachment.
    DomainNames List<string>
    A list of domain names for the service attachment.
    EnableProxyProtocol bool
    Whether the proxy protocol is enabled on the service attachment.
    Fingerprint string
    The fingerprint of the service attachment.
    Name string
    The name of the service attachment.
    NatIpsPerEndpoint int
    The number of NAT IPs allocated per connected endpoint.
    NatSubnets List<string>
    A list of URLs of subnetworks used for NAT in this service attachment.
    Project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    PropagatedConnectionLimit int

    The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer.

    If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint.

    If unspecified, the default propagated connection limit is 250. To explicitly send a zero value, set 'send_propagated_connection_limit_if_zero = true'.

    PscServiceAttachmentIds List<GetServiceAttachmentsServiceAttachmentPscServiceAttachmentId>
    An 128-bit global unique ID of the PSC service attachment.
    ReconcileConnections bool

    This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.

    If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list.

    Region string
    The region in which the resource belongs. If it is not provided, the provider region is used.
    SelfLink string
    The URI of the service attachment.
    SendPropagatedConnectionLimitIfZero bool
    Controls the behavior of propagated_connection_limit. When false, setting propagatedConnectionLimit to zero causes the provider to use to the API's default value. When true, the provider will set propagatedConnectionLimit to zero. Defaults to false.
    ShowNatIps bool
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. [If true, show NAT IPs of all connected endpoints.]
    TargetService string
    The URL of the forwarding rule that represents the service identified by this service attachment.
    TunnelingConfigs List<GetServiceAttachmentsServiceAttachmentTunnelingConfig>
    Tunneling configuration for this service attachment.
    ConnectedEndpoints []GetServiceAttachmentsServiceAttachmentConnectedEndpoint
    An array of the consumer forwarding rules connected to this service attachment.
    ConnectionPreference string
    The connection preference of the service attachment. Possible values are ACCEPT_AUTOMATIC and ACCEPT_MANUAL.
    ConsumerAcceptLists []GetServiceAttachmentsServiceAttachmentConsumerAcceptList
    An array of projects that are allowed to connect to this service attachment.
    ConsumerRejectLists []string
    An array of projects that are not allowed to connect to this service attachment.
    DeletionPolicy string
    Whether Terraform will be prevented from destroying the instance. Defaults to "DELETE". When a 'terraform destroy' or 'terraform apply' would delete the instance, 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.
    Description string
    An optional description of the service attachment.
    DomainNames []string
    A list of domain names for the service attachment.
    EnableProxyProtocol bool
    Whether the proxy protocol is enabled on the service attachment.
    Fingerprint string
    The fingerprint of the service attachment.
    Name string
    The name of the service attachment.
    NatIpsPerEndpoint int
    The number of NAT IPs allocated per connected endpoint.
    NatSubnets []string
    A list of URLs of subnetworks used for NAT in this service attachment.
    Project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    PropagatedConnectionLimit int

    The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer.

    If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint.

    If unspecified, the default propagated connection limit is 250. To explicitly send a zero value, set 'send_propagated_connection_limit_if_zero = true'.

    PscServiceAttachmentIds []GetServiceAttachmentsServiceAttachmentPscServiceAttachmentId
    An 128-bit global unique ID of the PSC service attachment.
    ReconcileConnections bool

    This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.

    If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list.

    Region string
    The region in which the resource belongs. If it is not provided, the provider region is used.
    SelfLink string
    The URI of the service attachment.
    SendPropagatedConnectionLimitIfZero bool
    Controls the behavior of propagated_connection_limit. When false, setting propagatedConnectionLimit to zero causes the provider to use to the API's default value. When true, the provider will set propagatedConnectionLimit to zero. Defaults to false.
    ShowNatIps bool
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. [If true, show NAT IPs of all connected endpoints.]
    TargetService string
    The URL of the forwarding rule that represents the service identified by this service attachment.
    TunnelingConfigs []GetServiceAttachmentsServiceAttachmentTunnelingConfig
    Tunneling configuration for this service attachment.
    connected_endpoints list(object)
    An array of the consumer forwarding rules connected to this service attachment.
    connection_preference string
    The connection preference of the service attachment. Possible values are ACCEPT_AUTOMATIC and ACCEPT_MANUAL.
    consumer_accept_lists list(object)
    An array of projects that are allowed to connect to this service attachment.
    consumer_reject_lists list(string)
    An array of projects that are not allowed to connect to this service attachment.
    deletion_policy string
    Whether Terraform will be prevented from destroying the instance. Defaults to "DELETE". When a 'terraform destroy' or 'terraform apply' would delete the instance, 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.
    description string
    An optional description of the service attachment.
    domain_names list(string)
    A list of domain names for the service attachment.
    enable_proxy_protocol bool
    Whether the proxy protocol is enabled on the service attachment.
    fingerprint string
    The fingerprint of the service attachment.
    name string
    The name of the service attachment.
    nat_ips_per_endpoint number
    The number of NAT IPs allocated per connected endpoint.
    nat_subnets list(string)
    A list of URLs of subnetworks used for NAT in this service attachment.
    project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    propagated_connection_limit number

    The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer.

    If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint.

    If unspecified, the default propagated connection limit is 250. To explicitly send a zero value, set 'send_propagated_connection_limit_if_zero = true'.

    psc_service_attachment_ids list(object)
    An 128-bit global unique ID of the PSC service attachment.
    reconcile_connections bool

    This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.

    If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list.

    region string
    The region in which the resource belongs. If it is not provided, the provider region is used.
    self_link string
    The URI of the service attachment.
    send_propagated_connection_limit_if_zero bool
    Controls the behavior of propagated_connection_limit. When false, setting propagatedConnectionLimit to zero causes the provider to use to the API's default value. When true, the provider will set propagatedConnectionLimit to zero. Defaults to false.
    show_nat_ips bool
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. [If true, show NAT IPs of all connected endpoints.]
    target_service string
    The URL of the forwarding rule that represents the service identified by this service attachment.
    tunneling_configs list(object)
    Tunneling configuration for this service attachment.
    connectedEndpoints List<GetServiceAttachmentsServiceAttachmentConnectedEndpoint>
    An array of the consumer forwarding rules connected to this service attachment.
    connectionPreference String
    The connection preference of the service attachment. Possible values are ACCEPT_AUTOMATIC and ACCEPT_MANUAL.
    consumerAcceptLists List<GetServiceAttachmentsServiceAttachmentConsumerAcceptList>
    An array of projects that are allowed to connect to this service attachment.
    consumerRejectLists List<String>
    An array of projects that are not allowed to connect to this service attachment.
    deletionPolicy String
    Whether Terraform will be prevented from destroying the instance. Defaults to "DELETE". When a 'terraform destroy' or 'terraform apply' would delete the instance, 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.
    description String
    An optional description of the service attachment.
    domainNames List<String>
    A list of domain names for the service attachment.
    enableProxyProtocol Boolean
    Whether the proxy protocol is enabled on the service attachment.
    fingerprint String
    The fingerprint of the service attachment.
    name String
    The name of the service attachment.
    natIpsPerEndpoint Integer
    The number of NAT IPs allocated per connected endpoint.
    natSubnets List<String>
    A list of URLs of subnetworks used for NAT in this service attachment.
    project String
    The project in which the resource belongs. If it is not provided, the provider project is used.
    propagatedConnectionLimit Integer

    The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer.

    If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint.

    If unspecified, the default propagated connection limit is 250. To explicitly send a zero value, set 'send_propagated_connection_limit_if_zero = true'.

    pscServiceAttachmentIds List<GetServiceAttachmentsServiceAttachmentPscServiceAttachmentId>
    An 128-bit global unique ID of the PSC service attachment.
    reconcileConnections Boolean

    This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.

    If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list.

    region String
    The region in which the resource belongs. If it is not provided, the provider region is used.
    selfLink String
    The URI of the service attachment.
    sendPropagatedConnectionLimitIfZero Boolean
    Controls the behavior of propagated_connection_limit. When false, setting propagatedConnectionLimit to zero causes the provider to use to the API's default value. When true, the provider will set propagatedConnectionLimit to zero. Defaults to false.
    showNatIps Boolean
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. [If true, show NAT IPs of all connected endpoints.]
    targetService String
    The URL of the forwarding rule that represents the service identified by this service attachment.
    tunnelingConfigs List<GetServiceAttachmentsServiceAttachmentTunnelingConfig>
    Tunneling configuration for this service attachment.
    connectedEndpoints GetServiceAttachmentsServiceAttachmentConnectedEndpoint[]
    An array of the consumer forwarding rules connected to this service attachment.
    connectionPreference string
    The connection preference of the service attachment. Possible values are ACCEPT_AUTOMATIC and ACCEPT_MANUAL.
    consumerAcceptLists GetServiceAttachmentsServiceAttachmentConsumerAcceptList[]
    An array of projects that are allowed to connect to this service attachment.
    consumerRejectLists string[]
    An array of projects that are not allowed to connect to this service attachment.
    deletionPolicy string
    Whether Terraform will be prevented from destroying the instance. Defaults to "DELETE". When a 'terraform destroy' or 'terraform apply' would delete the instance, 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.
    description string
    An optional description of the service attachment.
    domainNames string[]
    A list of domain names for the service attachment.
    enableProxyProtocol boolean
    Whether the proxy protocol is enabled on the service attachment.
    fingerprint string
    The fingerprint of the service attachment.
    name string
    The name of the service attachment.
    natIpsPerEndpoint number
    The number of NAT IPs allocated per connected endpoint.
    natSubnets string[]
    A list of URLs of subnetworks used for NAT in this service attachment.
    project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    propagatedConnectionLimit number

    The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer.

    If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint.

    If unspecified, the default propagated connection limit is 250. To explicitly send a zero value, set 'send_propagated_connection_limit_if_zero = true'.

    pscServiceAttachmentIds GetServiceAttachmentsServiceAttachmentPscServiceAttachmentId[]
    An 128-bit global unique ID of the PSC service attachment.
    reconcileConnections boolean

    This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.

    If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list.

    region string
    The region in which the resource belongs. If it is not provided, the provider region is used.
    selfLink string
    The URI of the service attachment.
    sendPropagatedConnectionLimitIfZero boolean
    Controls the behavior of propagated_connection_limit. When false, setting propagatedConnectionLimit to zero causes the provider to use to the API's default value. When true, the provider will set propagatedConnectionLimit to zero. Defaults to false.
    showNatIps boolean
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. [If true, show NAT IPs of all connected endpoints.]
    targetService string
    The URL of the forwarding rule that represents the service identified by this service attachment.
    tunnelingConfigs GetServiceAttachmentsServiceAttachmentTunnelingConfig[]
    Tunneling configuration for this service attachment.
    connected_endpoints Sequence[GetServiceAttachmentsServiceAttachmentConnectedEndpoint]
    An array of the consumer forwarding rules connected to this service attachment.
    connection_preference str
    The connection preference of the service attachment. Possible values are ACCEPT_AUTOMATIC and ACCEPT_MANUAL.
    consumer_accept_lists Sequence[GetServiceAttachmentsServiceAttachmentConsumerAcceptList]
    An array of projects that are allowed to connect to this service attachment.
    consumer_reject_lists Sequence[str]
    An array of projects that are not allowed to connect to this service attachment.
    deletion_policy str
    Whether Terraform will be prevented from destroying the instance. Defaults to "DELETE". When a 'terraform destroy' or 'terraform apply' would delete the instance, 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.
    description str
    An optional description of the service attachment.
    domain_names Sequence[str]
    A list of domain names for the service attachment.
    enable_proxy_protocol bool
    Whether the proxy protocol is enabled on the service attachment.
    fingerprint str
    The fingerprint of the service attachment.
    name str
    The name of the service attachment.
    nat_ips_per_endpoint int
    The number of NAT IPs allocated per connected endpoint.
    nat_subnets Sequence[str]
    A list of URLs of subnetworks used for NAT in this service attachment.
    project str
    The project in which the resource belongs. If it is not provided, the provider project is used.
    propagated_connection_limit int

    The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer.

    If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint.

    If unspecified, the default propagated connection limit is 250. To explicitly send a zero value, set 'send_propagated_connection_limit_if_zero = true'.

    psc_service_attachment_ids Sequence[GetServiceAttachmentsServiceAttachmentPscServiceAttachmentId]
    An 128-bit global unique ID of the PSC service attachment.
    reconcile_connections bool

    This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.

    If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list.

    region str
    The region in which the resource belongs. If it is not provided, the provider region is used.
    self_link str
    The URI of the service attachment.
    send_propagated_connection_limit_if_zero bool
    Controls the behavior of propagated_connection_limit. When false, setting propagatedConnectionLimit to zero causes the provider to use to the API's default value. When true, the provider will set propagatedConnectionLimit to zero. Defaults to false.
    show_nat_ips bool
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. [If true, show NAT IPs of all connected endpoints.]
    target_service str
    The URL of the forwarding rule that represents the service identified by this service attachment.
    tunneling_configs Sequence[GetServiceAttachmentsServiceAttachmentTunnelingConfig]
    Tunneling configuration for this service attachment.
    connectedEndpoints List<Property Map>
    An array of the consumer forwarding rules connected to this service attachment.
    connectionPreference String
    The connection preference of the service attachment. Possible values are ACCEPT_AUTOMATIC and ACCEPT_MANUAL.
    consumerAcceptLists List<Property Map>
    An array of projects that are allowed to connect to this service attachment.
    consumerRejectLists List<String>
    An array of projects that are not allowed to connect to this service attachment.
    deletionPolicy String
    Whether Terraform will be prevented from destroying the instance. Defaults to "DELETE". When a 'terraform destroy' or 'terraform apply' would delete the instance, 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.
    description String
    An optional description of the service attachment.
    domainNames List<String>
    A list of domain names for the service attachment.
    enableProxyProtocol Boolean
    Whether the proxy protocol is enabled on the service attachment.
    fingerprint String
    The fingerprint of the service attachment.
    name String
    The name of the service attachment.
    natIpsPerEndpoint Number
    The number of NAT IPs allocated per connected endpoint.
    natSubnets List<String>
    A list of URLs of subnetworks used for NAT in this service attachment.
    project String
    The project in which the resource belongs. If it is not provided, the provider project is used.
    propagatedConnectionLimit Number

    The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer.

    If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint.

    If unspecified, the default propagated connection limit is 250. To explicitly send a zero value, set 'send_propagated_connection_limit_if_zero = true'.

    pscServiceAttachmentIds List<Property Map>
    An 128-bit global unique ID of the PSC service attachment.
    reconcileConnections Boolean

    This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.

    If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list.

    region String
    The region in which the resource belongs. If it is not provided, the provider region is used.
    selfLink String
    The URI of the service attachment.
    sendPropagatedConnectionLimitIfZero Boolean
    Controls the behavior of propagated_connection_limit. When false, setting propagatedConnectionLimit to zero causes the provider to use to the API's default value. When true, the provider will set propagatedConnectionLimit to zero. Defaults to false.
    showNatIps Boolean
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. [If true, show NAT IPs of all connected endpoints.]
    targetService String
    The URL of the forwarding rule that represents the service identified by this service attachment.
    tunnelingConfigs List<Property Map>
    Tunneling configuration for this service attachment.

    GetServiceAttachmentsServiceAttachmentConnectedEndpoint

    ConsumerNetwork string
    The url of the consumer network.
    Endpoint string
    The URL of the consumer forwarding rule.
    NatIps List<string>
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. 'The nat IPs of the connected endpoint.'
    PropagatedConnectionCount int
    The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to.
    PscConnectionId string
    The PSC connection id of the connected endpoint.
    Status string
    The status of the connection from the consumer forwarding rule to this service attachment.
    ConsumerNetwork string
    The url of the consumer network.
    Endpoint string
    The URL of the consumer forwarding rule.
    NatIps []string
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. 'The nat IPs of the connected endpoint.'
    PropagatedConnectionCount int
    The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to.
    PscConnectionId string
    The PSC connection id of the connected endpoint.
    Status string
    The status of the connection from the consumer forwarding rule to this service attachment.
    consumer_network string
    The url of the consumer network.
    endpoint string
    The URL of the consumer forwarding rule.
    nat_ips list(string)
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. 'The nat IPs of the connected endpoint.'
    propagated_connection_count number
    The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to.
    psc_connection_id string
    The PSC connection id of the connected endpoint.
    status string
    The status of the connection from the consumer forwarding rule to this service attachment.
    consumerNetwork String
    The url of the consumer network.
    endpoint String
    The URL of the consumer forwarding rule.
    natIps List<String>
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. 'The nat IPs of the connected endpoint.'
    propagatedConnectionCount Integer
    The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to.
    pscConnectionId String
    The PSC connection id of the connected endpoint.
    status String
    The status of the connection from the consumer forwarding rule to this service attachment.
    consumerNetwork string
    The url of the consumer network.
    endpoint string
    The URL of the consumer forwarding rule.
    natIps string[]
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. 'The nat IPs of the connected endpoint.'
    propagatedConnectionCount number
    The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to.
    pscConnectionId string
    The PSC connection id of the connected endpoint.
    status string
    The status of the connection from the consumer forwarding rule to this service attachment.
    consumer_network str
    The url of the consumer network.
    endpoint str
    The URL of the consumer forwarding rule.
    nat_ips Sequence[str]
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. 'The nat IPs of the connected endpoint.'
    propagated_connection_count int
    The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to.
    psc_connection_id str
    The PSC connection id of the connected endpoint.
    status str
    The status of the connection from the consumer forwarding rule to this service attachment.
    consumerNetwork String
    The url of the consumer network.
    endpoint String
    The URL of the consumer forwarding rule.
    natIps List<String>
    NOTE: This field is temporarily non-functional due to an underlying API issue. Any value provided here will be ignored until the API issue is resolved, expected around 2026-03. 'The nat IPs of the connected endpoint.'
    propagatedConnectionCount Number
    The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to.
    pscConnectionId String
    The PSC connection id of the connected endpoint.
    status String
    The status of the connection from the consumer forwarding rule to this service attachment.

    GetServiceAttachmentsServiceAttachmentConsumerAcceptList

    ConnectionLimit int
    The number of consumer forwarding rules the consumer project can create.
    EndpointUrl string
    The endpoint that is allowed to connect to this service attachment. Only one of project_id_or_num, networkUrl and endpointUrl may be set.
    NetworkUrl string
    The network that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    ProjectIdOrNum string
    A project that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    ConnectionLimit int
    The number of consumer forwarding rules the consumer project can create.
    EndpointUrl string
    The endpoint that is allowed to connect to this service attachment. Only one of project_id_or_num, networkUrl and endpointUrl may be set.
    NetworkUrl string
    The network that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    ProjectIdOrNum string
    A project that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    connection_limit number
    The number of consumer forwarding rules the consumer project can create.
    endpoint_url string
    The endpoint that is allowed to connect to this service attachment. Only one of project_id_or_num, networkUrl and endpointUrl may be set.
    network_url string
    The network that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    project_id_or_num string
    A project that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    connectionLimit Integer
    The number of consumer forwarding rules the consumer project can create.
    endpointUrl String
    The endpoint that is allowed to connect to this service attachment. Only one of project_id_or_num, networkUrl and endpointUrl may be set.
    networkUrl String
    The network that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    projectIdOrNum String
    A project that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    connectionLimit number
    The number of consumer forwarding rules the consumer project can create.
    endpointUrl string
    The endpoint that is allowed to connect to this service attachment. Only one of project_id_or_num, networkUrl and endpointUrl may be set.
    networkUrl string
    The network that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    projectIdOrNum string
    A project that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    connection_limit int
    The number of consumer forwarding rules the consumer project can create.
    endpoint_url str
    The endpoint that is allowed to connect to this service attachment. Only one of project_id_or_num, networkUrl and endpointUrl may be set.
    network_url str
    The network that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    project_id_or_num str
    A project that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    connectionLimit Number
    The number of consumer forwarding rules the consumer project can create.
    endpointUrl String
    The endpoint that is allowed to connect to this service attachment. Only one of project_id_or_num, networkUrl and endpointUrl may be set.
    networkUrl String
    The network that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.
    projectIdOrNum String
    A project that is allowed to connect to this service attachment. Only one of projectIdOrNum and networkUrl may be set.

    GetServiceAttachmentsServiceAttachmentPscServiceAttachmentId

    High string
    The high 64 bits of the PSC service attachment ID.
    Low string
    The low 64 bits of the PSC service attachment ID.
    High string
    The high 64 bits of the PSC service attachment ID.
    Low string
    The low 64 bits of the PSC service attachment ID.
    high string
    The high 64 bits of the PSC service attachment ID.
    low string
    The low 64 bits of the PSC service attachment ID.
    high String
    The high 64 bits of the PSC service attachment ID.
    low String
    The low 64 bits of the PSC service attachment ID.
    high string
    The high 64 bits of the PSC service attachment ID.
    low string
    The low 64 bits of the PSC service attachment ID.
    high str
    The high 64 bits of the PSC service attachment ID.
    low str
    The low 64 bits of the PSC service attachment ID.
    high String
    The high 64 bits of the PSC service attachment ID.
    low String
    The low 64 bits of the PSC service attachment ID.

    GetServiceAttachmentsServiceAttachmentTunnelingConfig

    EncapsulationProfile string
    The encapsulation profile for tunneling traffic.
    RoutingMode string
    The routing mode for tunneling traffic.
    EncapsulationProfile string
    The encapsulation profile for tunneling traffic.
    RoutingMode string
    The routing mode for tunneling traffic.
    encapsulation_profile string
    The encapsulation profile for tunneling traffic.
    routing_mode string
    The routing mode for tunneling traffic.
    encapsulationProfile String
    The encapsulation profile for tunneling traffic.
    routingMode String
    The routing mode for tunneling traffic.
    encapsulationProfile string
    The encapsulation profile for tunneling traffic.
    routingMode string
    The routing mode for tunneling traffic.
    encapsulation_profile str
    The encapsulation profile for tunneling traffic.
    routing_mode str
    The routing mode for tunneling traffic.
    encapsulationProfile String
    The encapsulation profile for tunneling traffic.
    routingMode String
    The routing mode for tunneling traffic.

    Package Details

    Repository
    Google Cloud (GCP) Classic pulumi/pulumi-gcp
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the google-beta Terraform Provider.
    gcp logo
    Viewing docs for Google Cloud v10.2.0
    published on Tuesday, Oct 20, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-gcp

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial