1. Packages
  2. Google Cloud (GCP) Classic
  3. API Docs
  4. networkconnectivity
  5. Destination
Google Cloud v9.10.0 published on Friday, Jan 16, 2026 by Pulumi
gcp logo
Google Cloud v9.10.0 published on Friday, Jan 16, 2026 by Pulumi

    ‘Manage Multicloud Data Transfer Destinations’

    To get more information about Destination, see:

    Example Usage

    Network Connectivity Destination Basic

    import * as pulumi from "@pulumi/pulumi";
    import * as gcp from "@pulumi/gcp";
    
    const config = new gcp.networkconnectivity.MulticloudDataTransferConfig("config", {
        name: "basic-config",
        location: "europe-west4",
        description: "A basic multicloud data transfer config for the destination example",
    });
    const example = new gcp.networkconnectivity.Destination("example", {
        name: "basic-destination",
        location: "europe-west4",
        multicloudDataTransferConfig: config.name,
        description: "A basic destination",
        labels: {
            foo: "bar",
        },
        ipPrefix: "10.0.0.0/8",
        endpoints: [{
            asn: "14618",
            csp: "AWS",
        }],
    });
    
    import pulumi
    import pulumi_gcp as gcp
    
    config = gcp.networkconnectivity.MulticloudDataTransferConfig("config",
        name="basic-config",
        location="europe-west4",
        description="A basic multicloud data transfer config for the destination example")
    example = gcp.networkconnectivity.Destination("example",
        name="basic-destination",
        location="europe-west4",
        multicloud_data_transfer_config=config.name,
        description="A basic destination",
        labels={
            "foo": "bar",
        },
        ip_prefix="10.0.0.0/8",
        endpoints=[{
            "asn": "14618",
            "csp": "AWS",
        }])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/networkconnectivity"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		config, err := networkconnectivity.NewMulticloudDataTransferConfig(ctx, "config", &networkconnectivity.MulticloudDataTransferConfigArgs{
    			Name:        pulumi.String("basic-config"),
    			Location:    pulumi.String("europe-west4"),
    			Description: pulumi.String("A basic multicloud data transfer config for the destination example"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = networkconnectivity.NewDestination(ctx, "example", &networkconnectivity.DestinationArgs{
    			Name:                         pulumi.String("basic-destination"),
    			Location:                     pulumi.String("europe-west4"),
    			MulticloudDataTransferConfig: config.Name,
    			Description:                  pulumi.String("A basic destination"),
    			Labels: pulumi.StringMap{
    				"foo": pulumi.String("bar"),
    			},
    			IpPrefix: pulumi.String("10.0.0.0/8"),
    			Endpoints: networkconnectivity.DestinationEndpointArray{
    				&networkconnectivity.DestinationEndpointArgs{
    					Asn: pulumi.String("14618"),
    					Csp: pulumi.String("AWS"),
    				},
    			},
    		})
    		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 config = new Gcp.NetworkConnectivity.MulticloudDataTransferConfig("config", new()
        {
            Name = "basic-config",
            Location = "europe-west4",
            Description = "A basic multicloud data transfer config for the destination example",
        });
    
        var example = new Gcp.NetworkConnectivity.Destination("example", new()
        {
            Name = "basic-destination",
            Location = "europe-west4",
            MulticloudDataTransferConfig = config.Name,
            Description = "A basic destination",
            Labels = 
            {
                { "foo", "bar" },
            },
            IpPrefix = "10.0.0.0/8",
            Endpoints = new[]
            {
                new Gcp.NetworkConnectivity.Inputs.DestinationEndpointArgs
                {
                    Asn = "14618",
                    Csp = "AWS",
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcp.networkconnectivity.MulticloudDataTransferConfig;
    import com.pulumi.gcp.networkconnectivity.MulticloudDataTransferConfigArgs;
    import com.pulumi.gcp.networkconnectivity.Destination;
    import com.pulumi.gcp.networkconnectivity.DestinationArgs;
    import com.pulumi.gcp.networkconnectivity.inputs.DestinationEndpointArgs;
    import java.util.List;
    import java.util.ArrayList;
    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 config = new MulticloudDataTransferConfig("config", MulticloudDataTransferConfigArgs.builder()
                .name("basic-config")
                .location("europe-west4")
                .description("A basic multicloud data transfer config for the destination example")
                .build());
    
            var example = new Destination("example", DestinationArgs.builder()
                .name("basic-destination")
                .location("europe-west4")
                .multicloudDataTransferConfig(config.name())
                .description("A basic destination")
                .labels(Map.of("foo", "bar"))
                .ipPrefix("10.0.0.0/8")
                .endpoints(DestinationEndpointArgs.builder()
                    .asn("14618")
                    .csp("AWS")
                    .build())
                .build());
    
        }
    }
    
    resources:
      config:
        type: gcp:networkconnectivity:MulticloudDataTransferConfig
        properties:
          name: basic-config
          location: europe-west4
          description: A basic multicloud data transfer config for the destination example
      example:
        type: gcp:networkconnectivity:Destination
        properties:
          name: basic-destination
          location: europe-west4
          multicloudDataTransferConfig: ${config.name}
          description: A basic destination
          labels:
            foo: bar
          ipPrefix: 10.0.0.0/8
          endpoints:
            - asn: '14618'
              csp: AWS
    

    Create Destination Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Destination(name: string, args: DestinationArgs, opts?: CustomResourceOptions);
    @overload
    def Destination(resource_name: str,
                    args: DestinationArgs,
                    opts: Optional[ResourceOptions] = None)
    
    @overload
    def Destination(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    endpoints: Optional[Sequence[DestinationEndpointArgs]] = None,
                    ip_prefix: Optional[str] = None,
                    location: Optional[str] = None,
                    multicloud_data_transfer_config: Optional[str] = None,
                    description: Optional[str] = None,
                    labels: Optional[Mapping[str, str]] = None,
                    name: Optional[str] = None,
                    project: Optional[str] = None)
    func NewDestination(ctx *Context, name string, args DestinationArgs, opts ...ResourceOption) (*Destination, error)
    public Destination(string name, DestinationArgs args, CustomResourceOptions? opts = null)
    public Destination(String name, DestinationArgs args)
    public Destination(String name, DestinationArgs args, CustomResourceOptions options)
    
    type: gcp:networkconnectivity:Destination
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args DestinationArgs
    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 DestinationArgs
    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 DestinationArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DestinationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DestinationArgs
    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 destinationResource = new Gcp.NetworkConnectivity.Destination("destinationResource", new()
    {
        Endpoints = new[]
        {
            new Gcp.NetworkConnectivity.Inputs.DestinationEndpointArgs
            {
                Asn = "string",
                Csp = "string",
                State = "string",
                UpdateTime = "string",
            },
        },
        IpPrefix = "string",
        Location = "string",
        MulticloudDataTransferConfig = "string",
        Description = "string",
        Labels = 
        {
            { "string", "string" },
        },
        Name = "string",
        Project = "string",
    });
    
    example, err := networkconnectivity.NewDestination(ctx, "destinationResource", &networkconnectivity.DestinationArgs{
    	Endpoints: networkconnectivity.DestinationEndpointArray{
    		&networkconnectivity.DestinationEndpointArgs{
    			Asn:        pulumi.String("string"),
    			Csp:        pulumi.String("string"),
    			State:      pulumi.String("string"),
    			UpdateTime: pulumi.String("string"),
    		},
    	},
    	IpPrefix:                     pulumi.String("string"),
    	Location:                     pulumi.String("string"),
    	MulticloudDataTransferConfig: pulumi.String("string"),
    	Description:                  pulumi.String("string"),
    	Labels: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	Name:    pulumi.String("string"),
    	Project: pulumi.String("string"),
    })
    
    var destinationResource = new Destination("destinationResource", DestinationArgs.builder()
        .endpoints(DestinationEndpointArgs.builder()
            .asn("string")
            .csp("string")
            .state("string")
            .updateTime("string")
            .build())
        .ipPrefix("string")
        .location("string")
        .multicloudDataTransferConfig("string")
        .description("string")
        .labels(Map.of("string", "string"))
        .name("string")
        .project("string")
        .build());
    
    destination_resource = gcp.networkconnectivity.Destination("destinationResource",
        endpoints=[{
            "asn": "string",
            "csp": "string",
            "state": "string",
            "update_time": "string",
        }],
        ip_prefix="string",
        location="string",
        multicloud_data_transfer_config="string",
        description="string",
        labels={
            "string": "string",
        },
        name="string",
        project="string")
    
    const destinationResource = new gcp.networkconnectivity.Destination("destinationResource", {
        endpoints: [{
            asn: "string",
            csp: "string",
            state: "string",
            updateTime: "string",
        }],
        ipPrefix: "string",
        location: "string",
        multicloudDataTransferConfig: "string",
        description: "string",
        labels: {
            string: "string",
        },
        name: "string",
        project: "string",
    });
    
    type: gcp:networkconnectivity:Destination
    properties:
        description: string
        endpoints:
            - asn: string
              csp: string
              state: string
              updateTime: string
        ipPrefix: string
        labels:
            string: string
        location: string
        multicloudDataTransferConfig: string
        name: string
        project: string
    

    Destination 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 Destination resource accepts the following input properties:

    Endpoints List<DestinationEndpoint>
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    IpPrefix string
    The IP prefix that represents your workload on another CSP.
    Location string
    The location of the destination.
    MulticloudDataTransferConfig string
    The multicloud data transfer config of the destination.
    Description string
    A description of this resource.
    Labels Dictionary<string, string>

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    Name string
    The name of the destination.
    Project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    Endpoints []DestinationEndpointArgs
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    IpPrefix string
    The IP prefix that represents your workload on another CSP.
    Location string
    The location of the destination.
    MulticloudDataTransferConfig string
    The multicloud data transfer config of the destination.
    Description string
    A description of this resource.
    Labels map[string]string

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    Name string
    The name of the destination.
    Project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    endpoints List<DestinationEndpoint>
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    ipPrefix String
    The IP prefix that represents your workload on another CSP.
    location String
    The location of the destination.
    multicloudDataTransferConfig String
    The multicloud data transfer config of the destination.
    description String
    A description of this resource.
    labels Map<String,String>

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    name String
    The name of the destination.
    project String
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    endpoints DestinationEndpoint[]
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    ipPrefix string
    The IP prefix that represents your workload on another CSP.
    location string
    The location of the destination.
    multicloudDataTransferConfig string
    The multicloud data transfer config of the destination.
    description string
    A description of this resource.
    labels {[key: string]: string}

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    name string
    The name of the destination.
    project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    endpoints Sequence[DestinationEndpointArgs]
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    ip_prefix str
    The IP prefix that represents your workload on another CSP.
    location str
    The location of the destination.
    multicloud_data_transfer_config str
    The multicloud data transfer config of the destination.
    description str
    A description of this resource.
    labels Mapping[str, str]

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    name str
    The name of the destination.
    project str
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    endpoints List<Property Map>
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    ipPrefix String
    The IP prefix that represents your workload on another CSP.
    location String
    The location of the destination.
    multicloudDataTransferConfig String
    The multicloud data transfer config of the destination.
    description String
    A description of this resource.
    labels Map<String>

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    name String
    The name of the destination.
    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 Destination resource produces the following output properties:

    CreateTime string
    Time when the Destination resource was created.
    EffectiveLabels Dictionary<string, string>
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    Etag string
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    Id string
    The provider-assigned unique ID for this managed resource.
    PulumiLabels Dictionary<string, string>
    The combination of labels configured directly on the resource and default labels configured on the provider.
    StateTimelines List<DestinationStateTimeline>
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    Uid string
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    UpdateTime string
    Time when the Destination resource was updated.
    CreateTime string
    Time when the Destination resource was created.
    EffectiveLabels map[string]string
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    Etag string
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    Id string
    The provider-assigned unique ID for this managed resource.
    PulumiLabels map[string]string
    The combination of labels configured directly on the resource and default labels configured on the provider.
    StateTimelines []DestinationStateTimeline
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    Uid string
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    UpdateTime string
    Time when the Destination resource was updated.
    createTime String
    Time when the Destination resource was created.
    effectiveLabels Map<String,String>
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    etag String
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    id String
    The provider-assigned unique ID for this managed resource.
    pulumiLabels Map<String,String>
    The combination of labels configured directly on the resource and default labels configured on the provider.
    stateTimelines List<DestinationStateTimeline>
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    uid String
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    updateTime String
    Time when the Destination resource was updated.
    createTime string
    Time when the Destination resource was created.
    effectiveLabels {[key: string]: string}
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    etag string
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    id string
    The provider-assigned unique ID for this managed resource.
    pulumiLabels {[key: string]: string}
    The combination of labels configured directly on the resource and default labels configured on the provider.
    stateTimelines DestinationStateTimeline[]
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    uid string
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    updateTime string
    Time when the Destination resource was updated.
    create_time str
    Time when the Destination resource was created.
    effective_labels Mapping[str, str]
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    etag str
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    id str
    The provider-assigned unique ID for this managed resource.
    pulumi_labels Mapping[str, str]
    The combination of labels configured directly on the resource and default labels configured on the provider.
    state_timelines Sequence[DestinationStateTimeline]
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    uid str
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    update_time str
    Time when the Destination resource was updated.
    createTime String
    Time when the Destination resource was created.
    effectiveLabels Map<String>
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    etag String
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    id String
    The provider-assigned unique ID for this managed resource.
    pulumiLabels Map<String>
    The combination of labels configured directly on the resource and default labels configured on the provider.
    stateTimelines List<Property Map>
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    uid String
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    updateTime String
    Time when the Destination resource was updated.

    Look up Existing Destination Resource

    Get an existing Destination 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?: DestinationState, opts?: CustomResourceOptions): Destination
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            create_time: Optional[str] = None,
            description: Optional[str] = None,
            effective_labels: Optional[Mapping[str, str]] = None,
            endpoints: Optional[Sequence[DestinationEndpointArgs]] = None,
            etag: Optional[str] = None,
            ip_prefix: Optional[str] = None,
            labels: Optional[Mapping[str, str]] = None,
            location: Optional[str] = None,
            multicloud_data_transfer_config: Optional[str] = None,
            name: Optional[str] = None,
            project: Optional[str] = None,
            pulumi_labels: Optional[Mapping[str, str]] = None,
            state_timelines: Optional[Sequence[DestinationStateTimelineArgs]] = None,
            uid: Optional[str] = None,
            update_time: Optional[str] = None) -> Destination
    func GetDestination(ctx *Context, name string, id IDInput, state *DestinationState, opts ...ResourceOption) (*Destination, error)
    public static Destination Get(string name, Input<string> id, DestinationState? state, CustomResourceOptions? opts = null)
    public static Destination get(String name, Output<String> id, DestinationState state, CustomResourceOptions options)
    resources:  _:    type: gcp:networkconnectivity:Destination    get:      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.
    The following state arguments are supported:
    CreateTime string
    Time when the Destination resource was created.
    Description string
    A description of this resource.
    EffectiveLabels Dictionary<string, string>
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    Endpoints List<DestinationEndpoint>
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    Etag string
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    IpPrefix string
    The IP prefix that represents your workload on another CSP.
    Labels Dictionary<string, string>

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    Location string
    The location of the destination.
    MulticloudDataTransferConfig string
    The multicloud data transfer config of the destination.
    Name string
    The name of the destination.
    Project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    PulumiLabels Dictionary<string, string>
    The combination of labels configured directly on the resource and default labels configured on the provider.
    StateTimelines List<DestinationStateTimeline>
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    Uid string
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    UpdateTime string
    Time when the Destination resource was updated.
    CreateTime string
    Time when the Destination resource was created.
    Description string
    A description of this resource.
    EffectiveLabels map[string]string
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    Endpoints []DestinationEndpointArgs
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    Etag string
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    IpPrefix string
    The IP prefix that represents your workload on another CSP.
    Labels map[string]string

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    Location string
    The location of the destination.
    MulticloudDataTransferConfig string
    The multicloud data transfer config of the destination.
    Name string
    The name of the destination.
    Project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    PulumiLabels map[string]string
    The combination of labels configured directly on the resource and default labels configured on the provider.
    StateTimelines []DestinationStateTimelineArgs
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    Uid string
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    UpdateTime string
    Time when the Destination resource was updated.
    createTime String
    Time when the Destination resource was created.
    description String
    A description of this resource.
    effectiveLabels Map<String,String>
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    endpoints List<DestinationEndpoint>
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    etag String
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    ipPrefix String
    The IP prefix that represents your workload on another CSP.
    labels Map<String,String>

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    location String
    The location of the destination.
    multicloudDataTransferConfig String
    The multicloud data transfer config of the destination.
    name String
    The name of the destination.
    project String
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    pulumiLabels Map<String,String>
    The combination of labels configured directly on the resource and default labels configured on the provider.
    stateTimelines List<DestinationStateTimeline>
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    uid String
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    updateTime String
    Time when the Destination resource was updated.
    createTime string
    Time when the Destination resource was created.
    description string
    A description of this resource.
    effectiveLabels {[key: string]: string}
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    endpoints DestinationEndpoint[]
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    etag string
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    ipPrefix string
    The IP prefix that represents your workload on another CSP.
    labels {[key: string]: string}

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    location string
    The location of the destination.
    multicloudDataTransferConfig string
    The multicloud data transfer config of the destination.
    name string
    The name of the destination.
    project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    pulumiLabels {[key: string]: string}
    The combination of labels configured directly on the resource and default labels configured on the provider.
    stateTimelines DestinationStateTimeline[]
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    uid string
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    updateTime string
    Time when the Destination resource was updated.
    create_time str
    Time when the Destination resource was created.
    description str
    A description of this resource.
    effective_labels Mapping[str, str]
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    endpoints Sequence[DestinationEndpointArgs]
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    etag str
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    ip_prefix str
    The IP prefix that represents your workload on another CSP.
    labels Mapping[str, str]

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    location str
    The location of the destination.
    multicloud_data_transfer_config str
    The multicloud data transfer config of the destination.
    name str
    The name of the destination.
    project str
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    pulumi_labels Mapping[str, str]
    The combination of labels configured directly on the resource and default labels configured on the provider.
    state_timelines Sequence[DestinationStateTimelineArgs]
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    uid str
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    update_time str
    Time when the Destination resource was updated.
    createTime String
    Time when the Destination resource was created.
    description String
    A description of this resource.
    effectiveLabels Map<String>
    All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
    endpoints List<Property Map>
    The list of DestinationEndpoint resources configured for the IP prefix. Structure is documented below.
    etag String
    The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
    ipPrefix String
    The IP prefix that represents your workload on another CSP.
    labels Map<String>

    User-defined labels.

    Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

    location String
    The location of the destination.
    multicloudDataTransferConfig String
    The multicloud data transfer config of the destination.
    name String
    The name of the destination.
    project String
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    pulumiLabels Map<String>
    The combination of labels configured directly on the resource and default labels configured on the provider.
    stateTimelines List<Property Map>
    The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified. Structure is documented below.
    uid String
    The Google-generated unique ID for the Destination resource. This value is unique across all Destination resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
    updateTime String
    Time when the Destination resource was updated.

    Supporting Types

    DestinationEndpoint, DestinationEndpointArgs

    Asn string
    The ASN of the remote IP prefix.
    Csp string
    The CSP of the remote IP prefix.
    State string
    (Output) The state of the DestinationEndpoint resource.
    UpdateTime string
    (Output) Time when the DestinationEndpoint resource was updated.
    Asn string
    The ASN of the remote IP prefix.
    Csp string
    The CSP of the remote IP prefix.
    State string
    (Output) The state of the DestinationEndpoint resource.
    UpdateTime string
    (Output) Time when the DestinationEndpoint resource was updated.
    asn String
    The ASN of the remote IP prefix.
    csp String
    The CSP of the remote IP prefix.
    state String
    (Output) The state of the DestinationEndpoint resource.
    updateTime String
    (Output) Time when the DestinationEndpoint resource was updated.
    asn string
    The ASN of the remote IP prefix.
    csp string
    The CSP of the remote IP prefix.
    state string
    (Output) The state of the DestinationEndpoint resource.
    updateTime string
    (Output) Time when the DestinationEndpoint resource was updated.
    asn str
    The ASN of the remote IP prefix.
    csp str
    The CSP of the remote IP prefix.
    state str
    (Output) The state of the DestinationEndpoint resource.
    update_time str
    (Output) Time when the DestinationEndpoint resource was updated.
    asn String
    The ASN of the remote IP prefix.
    csp String
    The CSP of the remote IP prefix.
    state String
    (Output) The state of the DestinationEndpoint resource.
    updateTime String
    (Output) Time when the DestinationEndpoint resource was updated.

    DestinationStateTimeline, DestinationStateTimelineArgs

    States List<DestinationStateTimelineState>
    (Output) The state and activation time details of the resource state. Structure is documented below.
    States []DestinationStateTimelineState
    (Output) The state and activation time details of the resource state. Structure is documented below.
    states List<DestinationStateTimelineState>
    (Output) The state and activation time details of the resource state. Structure is documented below.
    states DestinationStateTimelineState[]
    (Output) The state and activation time details of the resource state. Structure is documented below.
    states Sequence[DestinationStateTimelineState]
    (Output) The state and activation time details of the resource state. Structure is documented below.
    states List<Property Map>
    (Output) The state and activation time details of the resource state. Structure is documented below.

    DestinationStateTimelineState, DestinationStateTimelineStateArgs

    EffectiveTime string
    (Output) Accompanies only the transient states, which include ADDING, DELETING, and SUSPENDING, to denote the time until which the transient state of the resource will be effective. For instance, if the state is ADDING, this field shows the time when the resource state transitions to ACTIVE.
    State string
    (Output) The state of the resource.
    EffectiveTime string
    (Output) Accompanies only the transient states, which include ADDING, DELETING, and SUSPENDING, to denote the time until which the transient state of the resource will be effective. For instance, if the state is ADDING, this field shows the time when the resource state transitions to ACTIVE.
    State string
    (Output) The state of the resource.
    effectiveTime String
    (Output) Accompanies only the transient states, which include ADDING, DELETING, and SUSPENDING, to denote the time until which the transient state of the resource will be effective. For instance, if the state is ADDING, this field shows the time when the resource state transitions to ACTIVE.
    state String
    (Output) The state of the resource.
    effectiveTime string
    (Output) Accompanies only the transient states, which include ADDING, DELETING, and SUSPENDING, to denote the time until which the transient state of the resource will be effective. For instance, if the state is ADDING, this field shows the time when the resource state transitions to ACTIVE.
    state string
    (Output) The state of the resource.
    effective_time str
    (Output) Accompanies only the transient states, which include ADDING, DELETING, and SUSPENDING, to denote the time until which the transient state of the resource will be effective. For instance, if the state is ADDING, this field shows the time when the resource state transitions to ACTIVE.
    state str
    (Output) The state of the resource.
    effectiveTime String
    (Output) Accompanies only the transient states, which include ADDING, DELETING, and SUSPENDING, to denote the time until which the transient state of the resource will be effective. For instance, if the state is ADDING, this field shows the time when the resource state transitions to ACTIVE.
    state String
    (Output) The state of the resource.

    Import

    Destination can be imported using any of these accepted formats:

    • projects/{{project}}/locations/{{location}}/multicloudDataTransferConfigs/{{multicloud_data_transfer_config}}/destinations/{{name}}

    • {{project}}/{{location}}/{{multicloud_data_transfer_config}}/{{name}}

    • {{location}}/{{multicloud_data_transfer_config}}/{{name}}

    When using the pulumi import command, Destination can be imported using one of the formats above. For example:

    $ pulumi import gcp:networkconnectivity/destination:Destination default projects/{{project}}/locations/{{location}}/multicloudDataTransferConfigs/{{multicloud_data_transfer_config}}/destinations/{{name}}
    
    $ pulumi import gcp:networkconnectivity/destination:Destination default {{project}}/{{location}}/{{multicloud_data_transfer_config}}/{{name}}
    
    $ pulumi import gcp:networkconnectivity/destination:Destination default {{location}}/{{multicloud_data_transfer_config}}/{{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-beta Terraform Provider.
    gcp logo
    Google Cloud v9.10.0 published on Friday, Jan 16, 2026 by Pulumi
      Meet Neo: Your AI Platform Teammate