Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Konnect Provider
  3. API Docs
  4. MeshControlPlane
konnect 2.4.1 published on Thursday, Mar 13, 2025 by kong
kong/terraform-provider-konnect

konnect.MeshControlPlane

Explore with Pulumi AI

konnect logo
konnect 2.4.1 published on Thursday, Mar 13, 2025 by kong
kong/terraform-provider-konnect

    MeshControlPlane Resource

    Example Usage

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

const myMeshcontrolplane = new konnect.MeshControlPlane("myMeshcontrolplane", {
    description: "A control plane to handle traffic on development environment.",
    features: [{
        hostnameGeneratorCreation: {
            enabled: false,
        },
        meshCreation: {
            enabled: false,
        },
        type: "MeshCreation",
    }],
    labels: {
        key: "value",
    },
});

    import pulumi
import pulumi_konnect as konnect

my_meshcontrolplane = konnect.MeshControlPlane("myMeshcontrolplane",
    description="A control plane to handle traffic on development environment.",
    features=[{
        "hostname_generator_creation": {
            "enabled": False,
        },
        "mesh_creation": {
            "enabled": False,
        },
        "type": "MeshCreation",
    }],
    labels={
        "key": "value",
    })

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/konnect/v2/konnect"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := konnect.NewMeshControlPlane(ctx, "myMeshcontrolplane", &konnect.MeshControlPlaneArgs{
			Description: pulumi.String("A control plane to handle traffic on development environment."),
			Features: konnect.MeshControlPlaneFeatureArray{
				&konnect.MeshControlPlaneFeatureArgs{
					HostnameGeneratorCreation: &konnect.MeshControlPlaneFeatureHostnameGeneratorCreationArgs{
						Enabled: pulumi.Bool(false),
					},
					MeshCreation: &konnect.MeshControlPlaneFeatureMeshCreationArgs{
						Enabled: pulumi.Bool(false),
					},
					Type: pulumi.String("MeshCreation"),
				},
			},
			Labels: pulumi.StringMap{
				"key": pulumi.String("value"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var myMeshcontrolplane = new Konnect.MeshControlPlane("myMeshcontrolplane", new()
    {
        Description = "A control plane to handle traffic on development environment.",
        Features = new[]
        {
            new Konnect.Inputs.MeshControlPlaneFeatureArgs
            {
                HostnameGeneratorCreation = new Konnect.Inputs.MeshControlPlaneFeatureHostnameGeneratorCreationArgs
                {
                    Enabled = false,
                },
                MeshCreation = new Konnect.Inputs.MeshControlPlaneFeatureMeshCreationArgs
                {
                    Enabled = false,
                },
                Type = "MeshCreation",
            },
        },
        Labels = 
        {
            { "key", "value" },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.konnect.MeshControlPlane;
import com.pulumi.konnect.MeshControlPlaneArgs;
import com.pulumi.konnect.inputs.MeshControlPlaneFeatureArgs;
import com.pulumi.konnect.inputs.MeshControlPlaneFeatureHostnameGeneratorCreationArgs;
import com.pulumi.konnect.inputs.MeshControlPlaneFeatureMeshCreationArgs;
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 myMeshcontrolplane = new MeshControlPlane("myMeshcontrolplane", MeshControlPlaneArgs.builder()
            .description("A control plane to handle traffic on development environment.")
            .features(MeshControlPlaneFeatureArgs.builder()
                .hostnameGeneratorCreation(MeshControlPlaneFeatureHostnameGeneratorCreationArgs.builder()
                    .enabled(false)
                    .build())
                .meshCreation(MeshControlPlaneFeatureMeshCreationArgs.builder()
                    .enabled(false)
                    .build())
                .type("MeshCreation")
                .build())
            .labels(Map.of("key", "value"))
            .build());

    }
}

    resources:
  myMeshcontrolplane:
    type: konnect:MeshControlPlane
    properties:
      description: A control plane to handle traffic on development environment.
      features:
        - hostnameGeneratorCreation:
            enabled: false
          meshCreation:
            enabled: false
          type: MeshCreation
      labels:
        key: value

    Create MeshControlPlane Resource

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

    Constructor syntax

    new MeshControlPlane(name: string, args?: MeshControlPlaneArgs, opts?: CustomResourceOptions);
    @overload
def MeshControlPlane(resource_name: str,
                     args: Optional[MeshControlPlaneArgs] = None,
                     opts: Optional[ResourceOptions] = None)

@overload
def MeshControlPlane(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     description: Optional[str] = None,
                     features: Optional[Sequence[MeshControlPlaneFeatureArgs]] = None,
                     labels: Optional[Mapping[str, str]] = None,
                     name: Optional[str] = None)
    func NewMeshControlPlane(ctx *Context, name string, args *MeshControlPlaneArgs, opts ...ResourceOption) (*MeshControlPlane, error)
    public MeshControlPlane(string name, MeshControlPlaneArgs? args = null, CustomResourceOptions? opts = null)
    public MeshControlPlane(String name, MeshControlPlaneArgs args)
public MeshControlPlane(String name, MeshControlPlaneArgs args, CustomResourceOptions options)

    type: konnect:MeshControlPlane
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 MeshControlPlaneArgs
    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 MeshControlPlaneArgs
    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 MeshControlPlaneArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MeshControlPlaneArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MeshControlPlaneArgs
    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 meshControlPlaneResource = new Konnect.MeshControlPlane("meshControlPlaneResource", new()
{
    Description = "string",
    Features = new[]
    {
        new Konnect.Inputs.MeshControlPlaneFeatureArgs
        {
            HostnameGeneratorCreation = new Konnect.Inputs.MeshControlPlaneFeatureHostnameGeneratorCreationArgs
            {
                Enabled = false,
            },
            MeshCreation = new Konnect.Inputs.MeshControlPlaneFeatureMeshCreationArgs
            {
                Enabled = false,
            },
            Type = "string",
        },
    },
    Labels = 
    {
        { "string", "string" },
    },
    Name = "string",
});

    example, err := konnect.NewMeshControlPlane(ctx, "meshControlPlaneResource", &konnect.MeshControlPlaneArgs{
Description: pulumi.String("string"),
Features: .MeshControlPlaneFeatureArray{
&.MeshControlPlaneFeatureArgs{
HostnameGeneratorCreation: &.MeshControlPlaneFeatureHostnameGeneratorCreationArgs{
Enabled: pulumi.Bool(false),
},
MeshCreation: &.MeshControlPlaneFeatureMeshCreationArgs{
Enabled: pulumi.Bool(false),
},
Type: pulumi.String("string"),
},
},
Labels: pulumi.StringMap{
"string": pulumi.String("string"),
},
Name: pulumi.String("string"),
})

    var meshControlPlaneResource = new MeshControlPlane("meshControlPlaneResource", MeshControlPlaneArgs.builder()
    .description("string")
    .features(MeshControlPlaneFeatureArgs.builder()
        .hostnameGeneratorCreation(MeshControlPlaneFeatureHostnameGeneratorCreationArgs.builder()
            .enabled(false)
            .build())
        .meshCreation(MeshControlPlaneFeatureMeshCreationArgs.builder()
            .enabled(false)
            .build())
        .type("string")
        .build())
    .labels(Map.of("string", "string"))
    .name("string")
    .build());

    mesh_control_plane_resource = konnect.MeshControlPlane("meshControlPlaneResource",
    description="string",
    features=[{
        "hostname_generator_creation": {
            "enabled": False,
        },
        "mesh_creation": {
            "enabled": False,
        },
        "type": "string",
    }],
    labels={
        "string": "string",
    },
    name="string")

    const meshControlPlaneResource = new konnect.MeshControlPlane("meshControlPlaneResource", {
    description: "string",
    features: [{
        hostnameGeneratorCreation: {
            enabled: false,
        },
        meshCreation: {
            enabled: false,
        },
        type: "string",
    }],
    labels: {
        string: "string",
    },
    name: "string",
});

    type: konnect:MeshControlPlane
properties:
    description: string
    features:
        - hostnameGeneratorCreation:
            enabled: false
          meshCreation:
            enabled: false
          type: string
    labels:
        string: string
    name: string

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

    Description string
    Features List<MeshControlPlaneFeature>
    Requires replacement if changed.
    Labels Dictionary<string, string>
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    Name string
    The name of the control plane.
    Description string
    Features []MeshControlPlaneFeatureArgs
    Requires replacement if changed.
    Labels map[string]string
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    Name string
    The name of the control plane.
    description String
    features List<MeshControlPlaneFeature>
    Requires replacement if changed.
    labels Map<String,String>
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    name String
    The name of the control plane.
    description string
    features MeshControlPlaneFeature[]
    Requires replacement if changed.
    labels {[key: string]: string}
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    name string
    The name of the control plane.
    description str
    features Sequence[MeshControlPlaneFeatureArgs]
    Requires replacement if changed.
    labels Mapping[str, str]
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    name str
    The name of the control plane.
    description String
    features List<Property Map>
    Requires replacement if changed.
    labels Map<String>
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    name String
    The name of the control plane.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the MeshControlPlane resource produces the following output properties:

    CreatedAt string
    Id string
    The provider-assigned unique ID for this managed resource.
    UpdatedAt string
    CreatedAt string
    Id string
    The provider-assigned unique ID for this managed resource.
    UpdatedAt string
    createdAt String
    id String
    The provider-assigned unique ID for this managed resource.
    updatedAt String
    createdAt string
    id string
    The provider-assigned unique ID for this managed resource.
    updatedAt string
    created_at str
    id str
    The provider-assigned unique ID for this managed resource.
    updated_at str
    createdAt String
    id String
    The provider-assigned unique ID for this managed resource.
    updatedAt String

    Look up Existing MeshControlPlane Resource

    Get an existing MeshControlPlane 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?: MeshControlPlaneState, opts?: CustomResourceOptions): MeshControlPlane
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        created_at: Optional[str] = None,
        description: Optional[str] = None,
        features: Optional[Sequence[MeshControlPlaneFeatureArgs]] = None,
        labels: Optional[Mapping[str, str]] = None,
        name: Optional[str] = None,
        updated_at: Optional[str] = None) -> MeshControlPlane
    func GetMeshControlPlane(ctx *Context, name string, id IDInput, state *MeshControlPlaneState, opts ...ResourceOption) (*MeshControlPlane, error)
    public static MeshControlPlane Get(string name, Input<string> id, MeshControlPlaneState? state, CustomResourceOptions? opts = null)
    public static MeshControlPlane get(String name, Output<String> id, MeshControlPlaneState state, CustomResourceOptions options)
    resources:  _:    type: konnect:MeshControlPlane    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:
    CreatedAt string
    Description string
    Features List<MeshControlPlaneFeature>
    Requires replacement if changed.
    Labels Dictionary<string, string>
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    Name string
    The name of the control plane.
    UpdatedAt string
    CreatedAt string
    Description string
    Features []MeshControlPlaneFeatureArgs
    Requires replacement if changed.
    Labels map[string]string
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    Name string
    The name of the control plane.
    UpdatedAt string
    createdAt String
    description String
    features List<MeshControlPlaneFeature>
    Requires replacement if changed.
    labels Map<String,String>
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    name String
    The name of the control plane.
    updatedAt String
    createdAt string
    description string
    features MeshControlPlaneFeature[]
    Requires replacement if changed.
    labels {[key: string]: string}
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    name string
    The name of the control plane.
    updatedAt string
    created_at str
    description str
    features Sequence[MeshControlPlaneFeatureArgs]
    Requires replacement if changed.
    labels Mapping[str, str]
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    name str
    The name of the control plane.
    updated_at str
    createdAt String
    description String
    features List<Property Map>
    Requires replacement if changed.
    labels Map<String>
    Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    name String
    The name of the control plane.
    updatedAt String

    Supporting Types

    MeshControlPlaneFeature, MeshControlPlaneFeatureArgs

    HostnameGeneratorCreation MeshControlPlaneFeatureHostnameGeneratorCreation
    Requires replacement if changed.
    MeshCreation MeshControlPlaneFeatureMeshCreation
    Requires replacement if changed.
    Type string
    Not Null; must be one of ["MeshCreation", "HostnameGeneratorCreation"]; Requires replacement if changed.
    HostnameGeneratorCreation MeshControlPlaneFeatureHostnameGeneratorCreation
    Requires replacement if changed.
    MeshCreation MeshControlPlaneFeatureMeshCreation
    Requires replacement if changed.
    Type string
    Not Null; must be one of ["MeshCreation", "HostnameGeneratorCreation"]; Requires replacement if changed.
    hostnameGeneratorCreation MeshControlPlaneFeatureHostnameGeneratorCreation
    Requires replacement if changed.
    meshCreation MeshControlPlaneFeatureMeshCreation
    Requires replacement if changed.
    type String
    Not Null; must be one of ["MeshCreation", "HostnameGeneratorCreation"]; Requires replacement if changed.
    hostnameGeneratorCreation MeshControlPlaneFeatureHostnameGeneratorCreation
    Requires replacement if changed.
    meshCreation MeshControlPlaneFeatureMeshCreation
    Requires replacement if changed.
    type string
    Not Null; must be one of ["MeshCreation", "HostnameGeneratorCreation"]; Requires replacement if changed.
    hostname_generator_creation MeshControlPlaneFeatureHostnameGeneratorCreation
    Requires replacement if changed.
    mesh_creation MeshControlPlaneFeatureMeshCreation
    Requires replacement if changed.
    type str
    Not Null; must be one of ["MeshCreation", "HostnameGeneratorCreation"]; Requires replacement if changed.
    hostnameGeneratorCreation Property Map
    Requires replacement if changed.
    meshCreation Property Map
    Requires replacement if changed.
    type String
    Not Null; must be one of ["MeshCreation", "HostnameGeneratorCreation"]; Requires replacement if changed.

    MeshControlPlaneFeatureHostnameGeneratorCreation, MeshControlPlaneFeatureHostnameGeneratorCreationArgs

    Enabled bool
    Not Null; Requires replacement if changed.
    Enabled bool
    Not Null; Requires replacement if changed.
    enabled Boolean
    Not Null; Requires replacement if changed.
    enabled boolean
    Not Null; Requires replacement if changed.
    enabled bool
    Not Null; Requires replacement if changed.
    enabled Boolean
    Not Null; Requires replacement if changed.

    MeshControlPlaneFeatureMeshCreation, MeshControlPlaneFeatureMeshCreationArgs

    Enabled bool
    Not Null; Requires replacement if changed.
    Enabled bool
    Not Null; Requires replacement if changed.
    enabled Boolean
    Not Null; Requires replacement if changed.
    enabled boolean
    Not Null; Requires replacement if changed.
    enabled bool
    Not Null; Requires replacement if changed.
    enabled Boolean
    Not Null; Requires replacement if changed.

    Import

    $ pulumi import konnect:index/meshControlPlane:MeshControlPlane my_konnect_mesh_control_plane "d32d905a-ed33-46a3-a093-d8f536af9a8a"

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    konnect kong/terraform-provider-konnect
    License
    Notes
    This Pulumi package is based on the konnect Terraform Provider.
    konnect logo
    konnect 2.4.1 published on Thursday, Mar 13, 2025 by kong
    kong/terraform-provider-konnect