Control Plane v0.0.53, Mar 13 25

Control Plane v0.0.53 published on Thursday, Mar 13, 2025 by pulumiverse

cpln.getGvc

Explore with Pulumi AI

Control Plane v0.0.53 published on Thursday, Mar 13, 2025 by pulumiverse

pulumiverse/pulumi-cpln

Required

name (String) Name of the GVC.

Outputs

The following attributes are exported:

cpln_id (String) The ID, in GUID format, of the GVC.
name (String) Name of the GVC.
alias (String) The alias name of the GVC.
description (String) Description of the GVC.
tags (Map of String) Key-value map of resource tags.
self_link (String) Full link to this resource. Can be referenced by other resources.
domain (String) Custom domain name used by associated workloads.
locations (List of String) A list of locations making up the Global Virtual Cloud.
pull_secrets (List of String) A list of pull secret names used to authenticate to any private image repository referenced by Workloads within the GVC.
lightstep_tracing (Block List, Max: 1) (see below).
otel_tracing (Block List, Max: 1) (see below).
controlplane_tracing (Block List, Max: 1) (see below).
load_balancer (Block List, Max: 1) (see below).

`lightstep_tracing`

sampling (Int) Sampling percentage.
endpoint (String) Tracing Endpoint Workload. Either the canonical endpoint or the internal endpoint.
credentials (String) Full link to referenced Opaque Secret.

`otel_tracing`

sampling (Int) Determines what percentage of requests should be traced.
endpoint (String) Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
custom_tags (Map of String) Key-value map of custom tags.

`controlplane_tracing`

sampling (Int) Determines what percentage of requests should be traced.
custom_tags (Map of String) Key-value map of custom tags.

`load_balancer`

dedicated (Boolean) Creates a dedicated load balancer in each location and enables additional Domain features: custom ports, protocols and wildcard hostnames. Charges apply for each location.
trusted_proxies (Int) Controls the address used for request logging and for setting the X-Envoy-External-Address header. If set to 1, then the last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If set to 2, then the second to last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If the XFF header does not have at least two addresses or does not exist then the source client IP address will be used instead.

Example Usage

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

const gvc = cpln.getGvc({
    name: "gvc-example",
});
export const gvcId = gvc.then(gvc => gvc.id);
export const gvcLocations = gvc.then(gvc => gvc.locations);

import pulumi
import pulumi_cpln as cpln

gvc = cpln.get_gvc(name="gvc-example")
pulumi.export("gvcId", gvc.id)
pulumi.export("gvcLocations", gvc.locations)

package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-cpln/sdk/go/cpln"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		gvc, err := cpln.LookupGvc(ctx, &cpln.LookupGvcArgs{
			Name: "gvc-example",
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("gvcId", gvc.Id)
		ctx.Export("gvcLocations", gvc.Locations)
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Cpln = Pulumi.Cpln;

return await Deployment.RunAsync(() => 
{
    var gvc = Cpln.GetGvc.Invoke(new()
    {
        Name = "gvc-example",
    });

    return new Dictionary<string, object?>
    {
        ["gvcId"] = gvc.Apply(getGvcResult => getGvcResult.Id),
        ["gvcLocations"] = gvc.Apply(getGvcResult => getGvcResult.Locations),
    };
});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.cpln.CplnFunctions;
import com.pulumi.cpln.inputs.GetGvcArgs;
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) {
        final var gvc = CplnFunctions.getGvc(GetGvcArgs.builder()
            .name("gvc-example")
            .build());

        ctx.export("gvcId", gvc.applyValue(getGvcResult -> getGvcResult.id()));
        ctx.export("gvcLocations", gvc.applyValue(getGvcResult -> getGvcResult.locations()));
    }
}

variables:
  gvc:
    fn::invoke:
      function: cpln:getGvc
      arguments:
        name: gvc-example
outputs:
  gvcId: ${gvc.id}
  gvcLocations: ${gvc.locations}

Using getGvc

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 getGvc(args: GetGvcArgs, opts?: InvokeOptions): Promise<GetGvcResult>
function getGvcOutput(args: GetGvcOutputArgs, opts?: InvokeOptions): Output<GetGvcResult>

def get_gvc(controlplane_tracing: Optional[GetGvcControlplaneTracing] = None,
            description: Optional[str] = None,
            domain: Optional[str] = None,
            env: Optional[Mapping[str, str]] = None,
            lightstep_tracing: Optional[GetGvcLightstepTracing] = None,
            load_balancer: Optional[GetGvcLoadBalancer] = None,
            locations: Optional[Sequence[str]] = None,
            name: Optional[str] = None,
            otel_tracing: Optional[GetGvcOtelTracing] = None,
            pull_secrets: Optional[Sequence[str]] = None,
            sidecar: Optional[GetGvcSidecar] = None,
            tags: Optional[Mapping[str, str]] = None,
            opts: Optional[InvokeOptions] = None) -> GetGvcResult
def get_gvc_output(controlplane_tracing: Optional[pulumi.Input[GetGvcControlplaneTracingArgs]] = None,
            description: Optional[pulumi.Input[str]] = None,
            domain: Optional[pulumi.Input[str]] = None,
            env: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
            lightstep_tracing: Optional[pulumi.Input[GetGvcLightstepTracingArgs]] = None,
            load_balancer: Optional[pulumi.Input[GetGvcLoadBalancerArgs]] = None,
            locations: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
            name: Optional[pulumi.Input[str]] = None,
            otel_tracing: Optional[pulumi.Input[GetGvcOtelTracingArgs]] = None,
            pull_secrets: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
            sidecar: Optional[pulumi.Input[GetGvcSidecarArgs]] = None,
            tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
            opts: Optional[InvokeOptions] = None) -> Output[GetGvcResult]

func LookupGvc(ctx *Context, args *LookupGvcArgs, opts ...InvokeOption) (*LookupGvcResult, error)
func LookupGvcOutput(ctx *Context, args *LookupGvcOutputArgs, opts ...InvokeOption) LookupGvcResultOutput

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

public static class GetGvc 
{
    public static Task<GetGvcResult> InvokeAsync(GetGvcArgs args, InvokeOptions? opts = null)
    public static Output<GetGvcResult> Invoke(GetGvcInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetGvcResult> getGvc(GetGvcArgs args, InvokeOptions options)
public static Output<GetGvcResult> getGvc(GetGvcArgs args, InvokeOptions options)

fn::invoke:
  function: cpln:index/getGvc:getGvc
  arguments:
    # arguments dictionary

The following arguments are supported:

Name string
ControlplaneTracing Pulumiverse.Cpln.Inputs.GetGvcControlplaneTracing
Description string
Domain string: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
Env Dictionary<string, string>
LightstepTracing Pulumiverse.Cpln.Inputs.GetGvcLightstepTracing
LoadBalancer Pulumiverse.Cpln.Inputs.GetGvcLoadBalancer
Locations List<string>
OtelTracing Pulumiverse.Cpln.Inputs.GetGvcOtelTracing
PullSecrets List<string>
Sidecar Pulumiverse.Cpln.Inputs.GetGvcSidecar
Tags Dictionary<string, string>

Name string
ControlplaneTracing GetGvcControlplaneTracing
Description string
Domain string: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
Env map[string]string
LightstepTracing GetGvcLightstepTracing
LoadBalancer GetGvcLoadBalancer
Locations []string
OtelTracing GetGvcOtelTracing
PullSecrets []string
Sidecar GetGvcSidecar
Tags map[string]string

name String
controlplaneTracing GetGvcControlplaneTracing
description String
domain String: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
env Map<String,String>
lightstepTracing GetGvcLightstepTracing
loadBalancer GetGvcLoadBalancer
locations List<String>
otelTracing GetGvcOtelTracing
pullSecrets List<String>
sidecar GetGvcSidecar
tags Map<String,String>

name string
controlplaneTracing GetGvcControlplaneTracing
description string
domain string: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
env {[key: string]: string}
lightstepTracing GetGvcLightstepTracing
loadBalancer GetGvcLoadBalancer
locations string[]
otelTracing GetGvcOtelTracing
pullSecrets string[]
sidecar GetGvcSidecar
tags {[key: string]: string}

name str
controlplane_tracing GetGvcControlplaneTracing
description str
domain str: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
env Mapping[str, str]
lightstep_tracing GetGvcLightstepTracing
load_balancer GetGvcLoadBalancer
locations Sequence[str]
otel_tracing GetGvcOtelTracing
pull_secrets Sequence[str]
sidecar GetGvcSidecar
tags Mapping[str, str]

name String
controlplaneTracing Property Map
description String
domain String: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
env Map<String>
lightstepTracing Property Map
loadBalancer Property Map
locations List<String>
otelTracing Property Map
pullSecrets List<String>
sidecar Property Map
tags Map<String>

getGvc Result

The following output properties are available:

Alias string
CplnId string
Id string: The provider-assigned unique ID for this managed resource.
Name string
SelfLink string
ControlplaneTracing Pulumiverse.Cpln.Outputs.GetGvcControlplaneTracing
Description string
Domain string: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
Env Dictionary<string, string>
LightstepTracing Pulumiverse.Cpln.Outputs.GetGvcLightstepTracing
LoadBalancer Pulumiverse.Cpln.Outputs.GetGvcLoadBalancer
Locations List<string>
OtelTracing Pulumiverse.Cpln.Outputs.GetGvcOtelTracing
PullSecrets List<string>
Sidecar Pulumiverse.Cpln.Outputs.GetGvcSidecar
Tags Dictionary<string, string>

Alias string
CplnId string
Id string: The provider-assigned unique ID for this managed resource.
Name string
SelfLink string
ControlplaneTracing GetGvcControlplaneTracing
Description string
Domain string: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
Env map[string]string
LightstepTracing GetGvcLightstepTracing
LoadBalancer GetGvcLoadBalancer
Locations []string
OtelTracing GetGvcOtelTracing
PullSecrets []string
Sidecar GetGvcSidecar
Tags map[string]string

alias String
cplnId String
id String: The provider-assigned unique ID for this managed resource.
name String
selfLink String
controlplaneTracing GetGvcControlplaneTracing
description String
domain String: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
env Map<String,String>
lightstepTracing GetGvcLightstepTracing
loadBalancer GetGvcLoadBalancer
locations List<String>
otelTracing GetGvcOtelTracing
pullSecrets List<String>
sidecar GetGvcSidecar
tags Map<String,String>

alias string
cplnId string
id string: The provider-assigned unique ID for this managed resource.
name string
selfLink string
controlplaneTracing GetGvcControlplaneTracing
description string
domain string: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
env {[key: string]: string}
lightstepTracing GetGvcLightstepTracing
loadBalancer GetGvcLoadBalancer
locations string[]
otelTracing GetGvcOtelTracing
pullSecrets string[]
sidecar GetGvcSidecar
tags {[key: string]: string}

alias str
cpln_id str
id str: The provider-assigned unique ID for this managed resource.
name str
self_link str
controlplane_tracing GetGvcControlplaneTracing
description str
domain str: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
env Mapping[str, str]
lightstep_tracing GetGvcLightstepTracing
load_balancer GetGvcLoadBalancer
locations Sequence[str]
otel_tracing GetGvcOtelTracing
pull_secrets Sequence[str]
sidecar GetGvcSidecar
tags Mapping[str, str]

alias String
cplnId String
id String: The provider-assigned unique ID for this managed resource.
name String
selfLink String
controlplaneTracing Property Map
description String
domain String: Deprecated: Selecting a domain on a GVC will be deprecated in the future. Use the 'cpln_domain resource' instead.
env Map<String>
lightstepTracing Property Map
loadBalancer Property Map
locations List<String>
otelTracing Property Map
pullSecrets List<String>
sidecar Property Map
tags Map<String>

Supporting Types

GetGvcControlplaneTracing

Sampling double: Determines what percentage of requests should be traced.
CustomTags Dictionary<string, string>: Key-value map of custom tags.

Sampling float64: Determines what percentage of requests should be traced.
CustomTags map[string]string: Key-value map of custom tags.

sampling Double: Determines what percentage of requests should be traced.
customTags Map<String,String>: Key-value map of custom tags.

sampling number: Determines what percentage of requests should be traced.
customTags {[key: string]: string}: Key-value map of custom tags.

sampling float: Determines what percentage of requests should be traced.
custom_tags Mapping[str, str]: Key-value map of custom tags.

sampling Number: Determines what percentage of requests should be traced.
customTags Map<String>: Key-value map of custom tags.

GetGvcLightstepTracing

Endpoint string: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
Sampling double: Determines what percentage of requests should be traced.
Credentials string: Full link to referenced Opaque Secret.
CustomTags Dictionary<string, string>: Key-value map of custom tags.

Endpoint string: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
Sampling float64: Determines what percentage of requests should be traced.
Credentials string: Full link to referenced Opaque Secret.
CustomTags map[string]string: Key-value map of custom tags.

endpoint String: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
sampling Double: Determines what percentage of requests should be traced.
credentials String: Full link to referenced Opaque Secret.
customTags Map<String,String>: Key-value map of custom tags.

endpoint string: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
sampling number: Determines what percentage of requests should be traced.
credentials string: Full link to referenced Opaque Secret.
customTags {[key: string]: string}: Key-value map of custom tags.

endpoint str: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
sampling float: Determines what percentage of requests should be traced.
credentials str: Full link to referenced Opaque Secret.
custom_tags Mapping[str, str]: Key-value map of custom tags.

endpoint String: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
sampling Number: Determines what percentage of requests should be traced.
credentials String: Full link to referenced Opaque Secret.
customTags Map<String>: Key-value map of custom tags.

GetGvcLoadBalancer

Dedicated bool: Creates a dedicated load balancer in each location and enables additional Domain features: custom ports, protocols and wildcard hostnames. Charges apply for each location.
Redirect Pulumiverse.Cpln.Inputs.GetGvcLoadBalancerRedirect: Specify the url to be redirected to for different http status codes.
TrustedProxies int: Controls the address used for request logging and for setting the X-Envoy-External-Address header. If set to 1, then the last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If set to 2, then the second to last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If the XFF header does not have at least two addresses or does not exist then the source client IP address will be used instead.

Dedicated bool: Creates a dedicated load balancer in each location and enables additional Domain features: custom ports, protocols and wildcard hostnames. Charges apply for each location.
Redirect GetGvcLoadBalancerRedirect: Specify the url to be redirected to for different http status codes.
TrustedProxies int: Controls the address used for request logging and for setting the X-Envoy-External-Address header. If set to 1, then the last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If set to 2, then the second to last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If the XFF header does not have at least two addresses or does not exist then the source client IP address will be used instead.

dedicated Boolean: Creates a dedicated load balancer in each location and enables additional Domain features: custom ports, protocols and wildcard hostnames. Charges apply for each location.
redirect GetGvcLoadBalancerRedirect: Specify the url to be redirected to for different http status codes.
trustedProxies Integer: Controls the address used for request logging and for setting the X-Envoy-External-Address header. If set to 1, then the last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If set to 2, then the second to last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If the XFF header does not have at least two addresses or does not exist then the source client IP address will be used instead.

dedicated boolean: Creates a dedicated load balancer in each location and enables additional Domain features: custom ports, protocols and wildcard hostnames. Charges apply for each location.
redirect GetGvcLoadBalancerRedirect: Specify the url to be redirected to for different http status codes.
trustedProxies number: Controls the address used for request logging and for setting the X-Envoy-External-Address header. If set to 1, then the last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If set to 2, then the second to last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If the XFF header does not have at least two addresses or does not exist then the source client IP address will be used instead.

dedicated bool: Creates a dedicated load balancer in each location and enables additional Domain features: custom ports, protocols and wildcard hostnames. Charges apply for each location.
redirect GetGvcLoadBalancerRedirect: Specify the url to be redirected to for different http status codes.
trusted_proxies int: Controls the address used for request logging and for setting the X-Envoy-External-Address header. If set to 1, then the last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If set to 2, then the second to last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If the XFF header does not have at least two addresses or does not exist then the source client IP address will be used instead.

dedicated Boolean: Creates a dedicated load balancer in each location and enables additional Domain features: custom ports, protocols and wildcard hostnames. Charges apply for each location.
redirect Property Map: Specify the url to be redirected to for different http status codes.
trustedProxies Number: Controls the address used for request logging and for setting the X-Envoy-External-Address header. If set to 1, then the last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If set to 2, then the second to last address in an existing X-Forwarded-For header will be used in place of the source client IP address. If the XFF header does not have at least two addresses or does not exist then the source client IP address will be used instead.

GetGvcLoadBalancerRedirect

Class Pulumiverse.Cpln.Inputs.GetGvcLoadBalancerRedirectClass: Specify the redirect url for all status codes in a class.
PlaceholderAttribute bool

Class GetGvcLoadBalancerRedirectClass: Specify the redirect url for all status codes in a class.
PlaceholderAttribute bool

class_ GetGvcLoadBalancerRedirectClass: Specify the redirect url for all status codes in a class.
placeholderAttribute Boolean

class GetGvcLoadBalancerRedirectClass: Specify the redirect url for all status codes in a class.
placeholderAttribute boolean

class_ GetGvcLoadBalancerRedirectClass: Specify the redirect url for all status codes in a class.
placeholder_attribute bool

class Property Map: Specify the redirect url for all status codes in a class.
placeholderAttribute Boolean

GetGvcLoadBalancerRedirectClass

PlaceholderAttribute bool
Status5xx string: Specify the redirect url for any 500 level status code.

PlaceholderAttribute bool
Status5xx string: Specify the redirect url for any 500 level status code.

placeholderAttribute Boolean
status5xx String: Specify the redirect url for any 500 level status code.

placeholderAttribute boolean
status5xx string: Specify the redirect url for any 500 level status code.

placeholder_attribute bool
status5xx str: Specify the redirect url for any 500 level status code.

placeholderAttribute Boolean
status5xx String: Specify the redirect url for any 500 level status code.

GetGvcOtelTracing

Endpoint string: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
Sampling double: Determines what percentage of requests should be traced.
CustomTags Dictionary<string, string>: Key-value map of custom tags.

Endpoint string: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
Sampling float64: Determines what percentage of requests should be traced.
CustomTags map[string]string: Key-value map of custom tags.

endpoint String: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
sampling Double: Determines what percentage of requests should be traced.
customTags Map<String,String>: Key-value map of custom tags.

endpoint string: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
sampling number: Determines what percentage of requests should be traced.
customTags {[key: string]: string}: Key-value map of custom tags.

endpoint str: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
sampling float: Determines what percentage of requests should be traced.
custom_tags Mapping[str, str]: Key-value map of custom tags.

endpoint String: Tracing Endpoint Workload. Either the canonical endpoint or internal endpoint.
sampling Number: Determines what percentage of requests should be traced.
customTags Map<String>: Key-value map of custom tags.

GetGvcSidecar

Envoy string

Envoy string

envoy String

envoy string

envoy str

envoy String

Package Details

Repository: cpln pulumiverse/pulumi-cpln
License: Apache-2.0
Notes: This Pulumi package is based on the cpln Terraform Provider.

Control Plane v0.0.53 published on Thursday, Mar 13, 2025 by pulumiverse

pulumiverse/pulumi-cpln

cpln.getGvc

On this page

On this page

Required

Outputs

`lightstep_tracing`

`otel_tracing`

`controlplane_tracing`

`load_balancer`

Example Usage

Using getGvc

getGvc Result

Supporting Types

GetGvcControlplaneTracing

GetGvcLightstepTracing

GetGvcLoadBalancer

GetGvcLoadBalancerRedirect

GetGvcLoadBalancerRedirectClass

GetGvcOtelTracing

GetGvcSidecar

Package Details

On this page

On this page