Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Core
  5. CrossConnect
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

oci.Core.CrossConnect

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

    This resource provides the Cross Connect resource in Oracle Cloud Infrastructure Core service.

    Creates a new cross-connect. Oracle recommends you create each cross-connect in a CrossConnectGroup so you can use link aggregation with the connection.

    After creating the CrossConnect object, you need to go the FastConnect location and request to have the physical cable installed. For more information, see FastConnect Overview.

    For the purposes of access control, you must provide the OCID of the compartment where you want the cross-connect to reside. If you’re not sure which compartment to use, put the cross-connect in the same compartment with your VCN. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.

    You may optionally specify a display name for the cross-connect. It does not have to be unique, and you can change it. Avoid entering confidential information.

    Example Usage

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

const testCrossConnect = new oci.core.CrossConnect("test_cross_connect", {
    compartmentId: compartmentId,
    locationName: crossConnectLocationName,
    portSpeedShapeName: crossConnectPortSpeedShapeName,
    crossConnectGroupId: testCrossConnectGroup.id,
    customerReferenceName: crossConnectCustomerReferenceName,
    definedTags: {
        "Operations.CostCenter": "42",
    },
    displayName: crossConnectDisplayName,
    farCrossConnectOrCrossConnectGroupId: testCrossConnectGroup.id,
    freeformTags: {
        Department: "Finance",
    },
    macsecProperties: {
        state: crossConnectMacsecPropertiesState,
        encryptionCipher: crossConnectMacsecPropertiesEncryptionCipher,
        isUnprotectedTrafficAllowed: crossConnectMacsecPropertiesIsUnprotectedTrafficAllowed,
        primaryKey: {
            connectivityAssociationKeySecretId: testSecret.id,
            connectivityAssociationNameSecretId: testSecret.id,
        },
    },
    nearCrossConnectOrCrossConnectGroupId: testCrossConnectGroup.id,
});

    import pulumi
import pulumi_oci as oci

test_cross_connect = oci.core.CrossConnect("test_cross_connect",
    compartment_id=compartment_id,
    location_name=cross_connect_location_name,
    port_speed_shape_name=cross_connect_port_speed_shape_name,
    cross_connect_group_id=test_cross_connect_group["id"],
    customer_reference_name=cross_connect_customer_reference_name,
    defined_tags={
        "Operations.CostCenter": "42",
    },
    display_name=cross_connect_display_name,
    far_cross_connect_or_cross_connect_group_id=test_cross_connect_group["id"],
    freeform_tags={
        "Department": "Finance",
    },
    macsec_properties={
        "state": cross_connect_macsec_properties_state,
        "encryption_cipher": cross_connect_macsec_properties_encryption_cipher,
        "is_unprotected_traffic_allowed": cross_connect_macsec_properties_is_unprotected_traffic_allowed,
        "primary_key": {
            "connectivity_association_key_secret_id": test_secret["id"],
            "connectivity_association_name_secret_id": test_secret["id"],
        },
    },
    near_cross_connect_or_cross_connect_group_id=test_cross_connect_group["id"])

    package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := core.NewCrossConnect(ctx, "test_cross_connect", &core.CrossConnectArgs{
			CompartmentId:         pulumi.Any(compartmentId),
			LocationName:          pulumi.Any(crossConnectLocationName),
			PortSpeedShapeName:    pulumi.Any(crossConnectPortSpeedShapeName),
			CrossConnectGroupId:   pulumi.Any(testCrossConnectGroup.Id),
			CustomerReferenceName: pulumi.Any(crossConnectCustomerReferenceName),
			DefinedTags: pulumi.StringMap{
				"Operations.CostCenter": pulumi.String("42"),
			},
			DisplayName:                          pulumi.Any(crossConnectDisplayName),
			FarCrossConnectOrCrossConnectGroupId: pulumi.Any(testCrossConnectGroup.Id),
			FreeformTags: pulumi.StringMap{
				"Department": pulumi.String("Finance"),
			},
			MacsecProperties: &core.CrossConnectMacsecPropertiesArgs{
				State:                       pulumi.Any(crossConnectMacsecPropertiesState),
				EncryptionCipher:            pulumi.Any(crossConnectMacsecPropertiesEncryptionCipher),
				IsUnprotectedTrafficAllowed: pulumi.Any(crossConnectMacsecPropertiesIsUnprotectedTrafficAllowed),
				PrimaryKey: &core.CrossConnectMacsecPropertiesPrimaryKeyArgs{
					ConnectivityAssociationKeySecretId:  pulumi.Any(testSecret.Id),
					ConnectivityAssociationNameSecretId: pulumi.Any(testSecret.Id),
				},
			},
			NearCrossConnectOrCrossConnectGroupId: pulumi.Any(testCrossConnectGroup.Id),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var testCrossConnect = new Oci.Core.CrossConnect("test_cross_connect", new()
    {
        CompartmentId = compartmentId,
        LocationName = crossConnectLocationName,
        PortSpeedShapeName = crossConnectPortSpeedShapeName,
        CrossConnectGroupId = testCrossConnectGroup.Id,
        CustomerReferenceName = crossConnectCustomerReferenceName,
        DefinedTags = 
        {
            { "Operations.CostCenter", "42" },
        },
        DisplayName = crossConnectDisplayName,
        FarCrossConnectOrCrossConnectGroupId = testCrossConnectGroup.Id,
        FreeformTags = 
        {
            { "Department", "Finance" },
        },
        MacsecProperties = new Oci.Core.Inputs.CrossConnectMacsecPropertiesArgs
        {
            State = crossConnectMacsecPropertiesState,
            EncryptionCipher = crossConnectMacsecPropertiesEncryptionCipher,
            IsUnprotectedTrafficAllowed = crossConnectMacsecPropertiesIsUnprotectedTrafficAllowed,
            PrimaryKey = new Oci.Core.Inputs.CrossConnectMacsecPropertiesPrimaryKeyArgs
            {
                ConnectivityAssociationKeySecretId = testSecret.Id,
                ConnectivityAssociationNameSecretId = testSecret.Id,
            },
        },
        NearCrossConnectOrCrossConnectGroupId = testCrossConnectGroup.Id,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.CrossConnect;
import com.pulumi.oci.Core.CrossConnectArgs;
import com.pulumi.oci.Core.inputs.CrossConnectMacsecPropertiesArgs;
import com.pulumi.oci.Core.inputs.CrossConnectMacsecPropertiesPrimaryKeyArgs;
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 testCrossConnect = new CrossConnect("testCrossConnect", CrossConnectArgs.builder()
            .compartmentId(compartmentId)
            .locationName(crossConnectLocationName)
            .portSpeedShapeName(crossConnectPortSpeedShapeName)
            .crossConnectGroupId(testCrossConnectGroup.id())
            .customerReferenceName(crossConnectCustomerReferenceName)
            .definedTags(Map.of("Operations.CostCenter", "42"))
            .displayName(crossConnectDisplayName)
            .farCrossConnectOrCrossConnectGroupId(testCrossConnectGroup.id())
            .freeformTags(Map.of("Department", "Finance"))
            .macsecProperties(CrossConnectMacsecPropertiesArgs.builder()
                .state(crossConnectMacsecPropertiesState)
                .encryptionCipher(crossConnectMacsecPropertiesEncryptionCipher)
                .isUnprotectedTrafficAllowed(crossConnectMacsecPropertiesIsUnprotectedTrafficAllowed)
                .primaryKey(CrossConnectMacsecPropertiesPrimaryKeyArgs.builder()
                    .connectivityAssociationKeySecretId(testSecret.id())
                    .connectivityAssociationNameSecretId(testSecret.id())
                    .build())
                .build())
            .nearCrossConnectOrCrossConnectGroupId(testCrossConnectGroup.id())
            .build());

    }
}

    resources:
  testCrossConnect:
    type: oci:Core:CrossConnect
    name: test_cross_connect
    properties:
      compartmentId: ${compartmentId}
      locationName: ${crossConnectLocationName}
      portSpeedShapeName: ${crossConnectPortSpeedShapeName}
      crossConnectGroupId: ${testCrossConnectGroup.id}
      customerReferenceName: ${crossConnectCustomerReferenceName}
      definedTags:
        Operations.CostCenter: '42'
      displayName: ${crossConnectDisplayName}
      farCrossConnectOrCrossConnectGroupId: ${testCrossConnectGroup.id}
      freeformTags:
        Department: Finance
      macsecProperties:
        state: ${crossConnectMacsecPropertiesState}
        encryptionCipher: ${crossConnectMacsecPropertiesEncryptionCipher}
        isUnprotectedTrafficAllowed: ${crossConnectMacsecPropertiesIsUnprotectedTrafficAllowed}
        primaryKey:
          connectivityAssociationKeySecretId: ${testSecret.id}
          connectivityAssociationNameSecretId: ${testSecret.id}
      nearCrossConnectOrCrossConnectGroupId: ${testCrossConnectGroup.id}

    Create CrossConnect Resource

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

    Constructor syntax

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

@overload
def CrossConnect(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 compartment_id: Optional[str] = None,
                 location_name: Optional[str] = None,
                 port_speed_shape_name: Optional[str] = None,
                 cross_connect_group_id: Optional[str] = None,
                 customer_reference_name: Optional[str] = None,
                 defined_tags: Optional[Mapping[str, str]] = None,
                 display_name: Optional[str] = None,
                 far_cross_connect_or_cross_connect_group_id: Optional[str] = None,
                 freeform_tags: Optional[Mapping[str, str]] = None,
                 is_active: Optional[bool] = None,
                 macsec_properties: Optional[CrossConnectMacsecPropertiesArgs] = None,
                 near_cross_connect_or_cross_connect_group_id: Optional[str] = None)
    func NewCrossConnect(ctx *Context, name string, args CrossConnectArgs, opts ...ResourceOption) (*CrossConnect, error)
    public CrossConnect(string name, CrossConnectArgs args, CustomResourceOptions? opts = null)
    public CrossConnect(String name, CrossConnectArgs args)
public CrossConnect(String name, CrossConnectArgs args, CustomResourceOptions options)

    type: oci:Core:CrossConnect
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 CrossConnectArgs
    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 CrossConnectArgs
    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 CrossConnectArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args CrossConnectArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args CrossConnectArgs
    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 crossConnectResource = new Oci.Core.CrossConnect("crossConnectResource", new()
{
    CompartmentId = "string",
    LocationName = "string",
    PortSpeedShapeName = "string",
    CrossConnectGroupId = "string",
    CustomerReferenceName = "string",
    DefinedTags = 
    {
        { "string", "string" },
    },
    DisplayName = "string",
    FarCrossConnectOrCrossConnectGroupId = "string",
    FreeformTags = 
    {
        { "string", "string" },
    },
    IsActive = false,
    MacsecProperties = new Oci.Core.Inputs.CrossConnectMacsecPropertiesArgs
    {
        State = "string",
        EncryptionCipher = "string",
        IsUnprotectedTrafficAllowed = false,
        PrimaryKey = new Oci.Core.Inputs.CrossConnectMacsecPropertiesPrimaryKeyArgs
        {
            ConnectivityAssociationKeySecretId = "string",
            ConnectivityAssociationNameSecretId = "string",
            ConnectivityAssociationKeySecretVersion = "string",
            ConnectivityAssociationNameSecretVersion = "string",
        },
    },
    NearCrossConnectOrCrossConnectGroupId = "string",
});

    example, err := core.NewCrossConnect(ctx, "crossConnectResource", &core.CrossConnectArgs{
	CompartmentId:         pulumi.String("string"),
	LocationName:          pulumi.String("string"),
	PortSpeedShapeName:    pulumi.String("string"),
	CrossConnectGroupId:   pulumi.String("string"),
	CustomerReferenceName: pulumi.String("string"),
	DefinedTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	DisplayName:                          pulumi.String("string"),
	FarCrossConnectOrCrossConnectGroupId: pulumi.String("string"),
	FreeformTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	IsActive: pulumi.Bool(false),
	MacsecProperties: &core.CrossConnectMacsecPropertiesArgs{
		State:                       pulumi.String("string"),
		EncryptionCipher:            pulumi.String("string"),
		IsUnprotectedTrafficAllowed: pulumi.Bool(false),
		PrimaryKey: &core.CrossConnectMacsecPropertiesPrimaryKeyArgs{
			ConnectivityAssociationKeySecretId:       pulumi.String("string"),
			ConnectivityAssociationNameSecretId:      pulumi.String("string"),
			ConnectivityAssociationKeySecretVersion:  pulumi.String("string"),
			ConnectivityAssociationNameSecretVersion: pulumi.String("string"),
		},
	},
	NearCrossConnectOrCrossConnectGroupId: pulumi.String("string"),
})

    var crossConnectResource = new CrossConnect("crossConnectResource", CrossConnectArgs.builder()
    .compartmentId("string")
    .locationName("string")
    .portSpeedShapeName("string")
    .crossConnectGroupId("string")
    .customerReferenceName("string")
    .definedTags(Map.of("string", "string"))
    .displayName("string")
    .farCrossConnectOrCrossConnectGroupId("string")
    .freeformTags(Map.of("string", "string"))
    .isActive(false)
    .macsecProperties(CrossConnectMacsecPropertiesArgs.builder()
        .state("string")
        .encryptionCipher("string")
        .isUnprotectedTrafficAllowed(false)
        .primaryKey(CrossConnectMacsecPropertiesPrimaryKeyArgs.builder()
            .connectivityAssociationKeySecretId("string")
            .connectivityAssociationNameSecretId("string")
            .connectivityAssociationKeySecretVersion("string")
            .connectivityAssociationNameSecretVersion("string")
            .build())
        .build())
    .nearCrossConnectOrCrossConnectGroupId("string")
    .build());

    cross_connect_resource = oci.core.CrossConnect("crossConnectResource",
    compartment_id="string",
    location_name="string",
    port_speed_shape_name="string",
    cross_connect_group_id="string",
    customer_reference_name="string",
    defined_tags={
        "string": "string",
    },
    display_name="string",
    far_cross_connect_or_cross_connect_group_id="string",
    freeform_tags={
        "string": "string",
    },
    is_active=False,
    macsec_properties={
        "state": "string",
        "encryption_cipher": "string",
        "is_unprotected_traffic_allowed": False,
        "primary_key": {
            "connectivity_association_key_secret_id": "string",
            "connectivity_association_name_secret_id": "string",
            "connectivity_association_key_secret_version": "string",
            "connectivity_association_name_secret_version": "string",
        },
    },
    near_cross_connect_or_cross_connect_group_id="string")

    const crossConnectResource = new oci.core.CrossConnect("crossConnectResource", {
    compartmentId: "string",
    locationName: "string",
    portSpeedShapeName: "string",
    crossConnectGroupId: "string",
    customerReferenceName: "string",
    definedTags: {
        string: "string",
    },
    displayName: "string",
    farCrossConnectOrCrossConnectGroupId: "string",
    freeformTags: {
        string: "string",
    },
    isActive: false,
    macsecProperties: {
        state: "string",
        encryptionCipher: "string",
        isUnprotectedTrafficAllowed: false,
        primaryKey: {
            connectivityAssociationKeySecretId: "string",
            connectivityAssociationNameSecretId: "string",
            connectivityAssociationKeySecretVersion: "string",
            connectivityAssociationNameSecretVersion: "string",
        },
    },
    nearCrossConnectOrCrossConnectGroupId: "string",
});

    type: oci:Core:CrossConnect
properties:
    compartmentId: string
    crossConnectGroupId: string
    customerReferenceName: string
    definedTags:
        string: string
    displayName: string
    farCrossConnectOrCrossConnectGroupId: string
    freeformTags:
        string: string
    isActive: false
    locationName: string
    macsecProperties:
        encryptionCipher: string
        isUnprotectedTrafficAllowed: false
        primaryKey:
            connectivityAssociationKeySecretId: string
            connectivityAssociationKeySecretVersion: string
            connectivityAssociationNameSecretId: string
            connectivityAssociationNameSecretVersion: string
        state: string
    nearCrossConnectOrCrossConnectGroupId: string
    portSpeedShapeName: string

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

    CompartmentId string
    (Updatable) The OCID of the compartment to contain the cross-connect.
    LocationName string
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    PortSpeedShapeName string

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    CrossConnectGroupId string
    The OCID of the cross-connect group to put this cross-connect in.
    CustomerReferenceName string
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    DefinedTags Dictionary<string, string>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    DisplayName string
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    FarCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    FreeformTags Dictionary<string, string>
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    IsActive bool
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    MacsecProperties CrossConnectMacsecProperties
    (Updatable) Properties used to configure MACsec (if capable).
    NearCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    CompartmentId string
    (Updatable) The OCID of the compartment to contain the cross-connect.
    LocationName string
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    PortSpeedShapeName string

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    CrossConnectGroupId string
    The OCID of the cross-connect group to put this cross-connect in.
    CustomerReferenceName string
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    DefinedTags map[string]string
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    DisplayName string
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    FarCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    FreeformTags map[string]string
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    IsActive bool
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    MacsecProperties CrossConnectMacsecPropertiesArgs
    (Updatable) Properties used to configure MACsec (if capable).
    NearCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    compartmentId String
    (Updatable) The OCID of the compartment to contain the cross-connect.
    locationName String
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    portSpeedShapeName String

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    crossConnectGroupId String
    The OCID of the cross-connect group to put this cross-connect in.
    customerReferenceName String
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    definedTags Map<String,String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName String
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    farCrossConnectOrCrossConnectGroupId String
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    freeformTags Map<String,String>
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    isActive Boolean
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    macsecProperties CrossConnectMacsecProperties
    (Updatable) Properties used to configure MACsec (if capable).
    nearCrossConnectOrCrossConnectGroupId String
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    compartmentId string
    (Updatable) The OCID of the compartment to contain the cross-connect.
    locationName string
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    portSpeedShapeName string

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    crossConnectGroupId string
    The OCID of the cross-connect group to put this cross-connect in.
    customerReferenceName string
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    definedTags {[key: string]: string}
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName string
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    farCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    freeformTags {[key: string]: string}
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    isActive boolean
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    macsecProperties CrossConnectMacsecProperties
    (Updatable) Properties used to configure MACsec (if capable).
    nearCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    compartment_id str
    (Updatable) The OCID of the compartment to contain the cross-connect.
    location_name str
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    port_speed_shape_name str

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    cross_connect_group_id str
    The OCID of the cross-connect group to put this cross-connect in.
    customer_reference_name str
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    defined_tags Mapping[str, str]
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    display_name str
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    far_cross_connect_or_cross_connect_group_id str
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    freeform_tags Mapping[str, str]
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    is_active bool
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    macsec_properties CrossConnectMacsecPropertiesArgs
    (Updatable) Properties used to configure MACsec (if capable).
    near_cross_connect_or_cross_connect_group_id str
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    compartmentId String
    (Updatable) The OCID of the compartment to contain the cross-connect.
    locationName String
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    portSpeedShapeName String

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    crossConnectGroupId String
    The OCID of the cross-connect group to put this cross-connect in.
    customerReferenceName String
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    definedTags Map<String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName String
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    farCrossConnectOrCrossConnectGroupId String
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    freeformTags Map<String>
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    isActive Boolean
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    macsecProperties Property Map
    (Updatable) Properties used to configure MACsec (if capable).
    nearCrossConnectOrCrossConnectGroupId String
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    OciLogicalDeviceName string
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    OciPhysicalDeviceName string
    The FastConnect device that terminates the physical connection.
    PortName string
    A string identifying the meet-me room port for this cross-connect.
    State string
    The cross-connect's current state.
    TimeCreated string
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    Id string
    The provider-assigned unique ID for this managed resource.
    OciLogicalDeviceName string
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    OciPhysicalDeviceName string
    The FastConnect device that terminates the physical connection.
    PortName string
    A string identifying the meet-me room port for this cross-connect.
    State string
    The cross-connect's current state.
    TimeCreated string
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    id String
    The provider-assigned unique ID for this managed resource.
    ociLogicalDeviceName String
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    ociPhysicalDeviceName String
    The FastConnect device that terminates the physical connection.
    portName String
    A string identifying the meet-me room port for this cross-connect.
    state String
    The cross-connect's current state.
    timeCreated String
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    id string
    The provider-assigned unique ID for this managed resource.
    ociLogicalDeviceName string
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    ociPhysicalDeviceName string
    The FastConnect device that terminates the physical connection.
    portName string
    A string identifying the meet-me room port for this cross-connect.
    state string
    The cross-connect's current state.
    timeCreated string
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    id str
    The provider-assigned unique ID for this managed resource.
    oci_logical_device_name str
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    oci_physical_device_name str
    The FastConnect device that terminates the physical connection.
    port_name str
    A string identifying the meet-me room port for this cross-connect.
    state str
    The cross-connect's current state.
    time_created str
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    id String
    The provider-assigned unique ID for this managed resource.
    ociLogicalDeviceName String
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    ociPhysicalDeviceName String
    The FastConnect device that terminates the physical connection.
    portName String
    A string identifying the meet-me room port for this cross-connect.
    state String
    The cross-connect's current state.
    timeCreated String
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

    Look up Existing CrossConnect Resource

    Get an existing CrossConnect 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?: CrossConnectState, opts?: CustomResourceOptions): CrossConnect
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        compartment_id: Optional[str] = None,
        cross_connect_group_id: Optional[str] = None,
        customer_reference_name: Optional[str] = None,
        defined_tags: Optional[Mapping[str, str]] = None,
        display_name: Optional[str] = None,
        far_cross_connect_or_cross_connect_group_id: Optional[str] = None,
        freeform_tags: Optional[Mapping[str, str]] = None,
        is_active: Optional[bool] = None,
        location_name: Optional[str] = None,
        macsec_properties: Optional[CrossConnectMacsecPropertiesArgs] = None,
        near_cross_connect_or_cross_connect_group_id: Optional[str] = None,
        oci_logical_device_name: Optional[str] = None,
        oci_physical_device_name: Optional[str] = None,
        port_name: Optional[str] = None,
        port_speed_shape_name: Optional[str] = None,
        state: Optional[str] = None,
        time_created: Optional[str] = None) -> CrossConnect
    func GetCrossConnect(ctx *Context, name string, id IDInput, state *CrossConnectState, opts ...ResourceOption) (*CrossConnect, error)
    public static CrossConnect Get(string name, Input<string> id, CrossConnectState? state, CustomResourceOptions? opts = null)
    public static CrossConnect get(String name, Output<String> id, CrossConnectState state, CustomResourceOptions options)
    resources:  _:    type: oci:Core:CrossConnect    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:
    CompartmentId string
    (Updatable) The OCID of the compartment to contain the cross-connect.
    CrossConnectGroupId string
    The OCID of the cross-connect group to put this cross-connect in.
    CustomerReferenceName string
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    DefinedTags Dictionary<string, string>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    DisplayName string
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    FarCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    FreeformTags Dictionary<string, string>
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    IsActive bool
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    LocationName string
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    MacsecProperties CrossConnectMacsecProperties
    (Updatable) Properties used to configure MACsec (if capable).
    NearCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    OciLogicalDeviceName string
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    OciPhysicalDeviceName string
    The FastConnect device that terminates the physical connection.
    PortName string
    A string identifying the meet-me room port for this cross-connect.
    PortSpeedShapeName string

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    State string
    The cross-connect's current state.
    TimeCreated string
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    CompartmentId string
    (Updatable) The OCID of the compartment to contain the cross-connect.
    CrossConnectGroupId string
    The OCID of the cross-connect group to put this cross-connect in.
    CustomerReferenceName string
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    DefinedTags map[string]string
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    DisplayName string
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    FarCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    FreeformTags map[string]string
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    IsActive bool
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    LocationName string
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    MacsecProperties CrossConnectMacsecPropertiesArgs
    (Updatable) Properties used to configure MACsec (if capable).
    NearCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    OciLogicalDeviceName string
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    OciPhysicalDeviceName string
    The FastConnect device that terminates the physical connection.
    PortName string
    A string identifying the meet-me room port for this cross-connect.
    PortSpeedShapeName string

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    State string
    The cross-connect's current state.
    TimeCreated string
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    compartmentId String
    (Updatable) The OCID of the compartment to contain the cross-connect.
    crossConnectGroupId String
    The OCID of the cross-connect group to put this cross-connect in.
    customerReferenceName String
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    definedTags Map<String,String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName String
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    farCrossConnectOrCrossConnectGroupId String
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    freeformTags Map<String,String>
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    isActive Boolean
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    locationName String
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    macsecProperties CrossConnectMacsecProperties
    (Updatable) Properties used to configure MACsec (if capable).
    nearCrossConnectOrCrossConnectGroupId String
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    ociLogicalDeviceName String
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    ociPhysicalDeviceName String
    The FastConnect device that terminates the physical connection.
    portName String
    A string identifying the meet-me room port for this cross-connect.
    portSpeedShapeName String

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    state String
    The cross-connect's current state.
    timeCreated String
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    compartmentId string
    (Updatable) The OCID of the compartment to contain the cross-connect.
    crossConnectGroupId string
    The OCID of the cross-connect group to put this cross-connect in.
    customerReferenceName string
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    definedTags {[key: string]: string}
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName string
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    farCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    freeformTags {[key: string]: string}
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    isActive boolean
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    locationName string
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    macsecProperties CrossConnectMacsecProperties
    (Updatable) Properties used to configure MACsec (if capable).
    nearCrossConnectOrCrossConnectGroupId string
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    ociLogicalDeviceName string
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    ociPhysicalDeviceName string
    The FastConnect device that terminates the physical connection.
    portName string
    A string identifying the meet-me room port for this cross-connect.
    portSpeedShapeName string

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    state string
    The cross-connect's current state.
    timeCreated string
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    compartment_id str
    (Updatable) The OCID of the compartment to contain the cross-connect.
    cross_connect_group_id str
    The OCID of the cross-connect group to put this cross-connect in.
    customer_reference_name str
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    defined_tags Mapping[str, str]
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    display_name str
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    far_cross_connect_or_cross_connect_group_id str
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    freeform_tags Mapping[str, str]
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    is_active bool
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    location_name str
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    macsec_properties CrossConnectMacsecPropertiesArgs
    (Updatable) Properties used to configure MACsec (if capable).
    near_cross_connect_or_cross_connect_group_id str
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    oci_logical_device_name str
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    oci_physical_device_name str
    The FastConnect device that terminates the physical connection.
    port_name str
    A string identifying the meet-me room port for this cross-connect.
    port_speed_shape_name str

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    state str
    The cross-connect's current state.
    time_created str
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    compartmentId String
    (Updatable) The OCID of the compartment to contain the cross-connect.
    crossConnectGroupId String
    The OCID of the cross-connect group to put this cross-connect in.
    customerReferenceName String
    (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
    definedTags Map<String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName String
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    farCrossConnectOrCrossConnectGroupId String
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on a different router (for the purposes of redundancy), provide the OCID of that existing cross-connect or cross-connect group.
    freeformTags Map<String>
    (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    isActive Boolean
    (Updatable) Set to true to activate the cross-connect. You activate it after the physical cabling is complete, and you've confirmed the cross-connect's light levels are good and your side of the interface is up. Activation indicates to Oracle that the physical connection is ready.
    locationName String
    The name of the FastConnect location where this cross-connect will be installed. To get a list of the available locations, see ListCrossConnectLocations. Example: CyrusOne, Chandler, AZ
    macsecProperties Property Map
    (Updatable) Properties used to configure MACsec (if capable).
    nearCrossConnectOrCrossConnectGroupId String
    If you already have an existing cross-connect or cross-connect group at this FastConnect location, and you want this new cross-connect to be on the same router, provide the OCID of that existing cross-connect or cross-connect group.
    ociLogicalDeviceName String
    The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
    ociPhysicalDeviceName String
    The FastConnect device that terminates the physical connection.
    portName String
    A string identifying the meet-me room port for this cross-connect.
    portSpeedShapeName String

    The port speed for this cross-connect. To get a list of the available port speeds, see ListCrossConnectPortSpeedShapes. Example: 10 Gbps

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    state String
    The cross-connect's current state.
    timeCreated String
    The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

    Supporting Types

    CrossConnectMacsecProperties, CrossConnectMacsecPropertiesArgs

    State string
    The cross-connect's current state.
    EncryptionCipher string
    (Updatable) Type of encryption cipher suite to use for the MACsec connection.
    IsUnprotectedTrafficAllowed bool
    (Updatable) Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
    PrimaryKey CrossConnectMacsecPropertiesPrimaryKey
    (Updatable) Defines the secret OCIDs held in Vault that represent the MACsec key.
    State string
    The cross-connect's current state.
    EncryptionCipher string
    (Updatable) Type of encryption cipher suite to use for the MACsec connection.
    IsUnprotectedTrafficAllowed bool
    (Updatable) Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
    PrimaryKey CrossConnectMacsecPropertiesPrimaryKey
    (Updatable) Defines the secret OCIDs held in Vault that represent the MACsec key.
    state String
    The cross-connect's current state.
    encryptionCipher String
    (Updatable) Type of encryption cipher suite to use for the MACsec connection.
    isUnprotectedTrafficAllowed Boolean
    (Updatable) Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
    primaryKey CrossConnectMacsecPropertiesPrimaryKey
    (Updatable) Defines the secret OCIDs held in Vault that represent the MACsec key.
    state string
    The cross-connect's current state.
    encryptionCipher string
    (Updatable) Type of encryption cipher suite to use for the MACsec connection.
    isUnprotectedTrafficAllowed boolean
    (Updatable) Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
    primaryKey CrossConnectMacsecPropertiesPrimaryKey
    (Updatable) Defines the secret OCIDs held in Vault that represent the MACsec key.
    state str
    The cross-connect's current state.
    encryption_cipher str
    (Updatable) Type of encryption cipher suite to use for the MACsec connection.
    is_unprotected_traffic_allowed bool
    (Updatable) Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
    primary_key CrossConnectMacsecPropertiesPrimaryKey
    (Updatable) Defines the secret OCIDs held in Vault that represent the MACsec key.
    state String
    The cross-connect's current state.
    encryptionCipher String
    (Updatable) Type of encryption cipher suite to use for the MACsec connection.
    isUnprotectedTrafficAllowed Boolean
    (Updatable) Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
    primaryKey Property Map
    (Updatable) Defines the secret OCIDs held in Vault that represent the MACsec key.

    CrossConnectMacsecPropertiesPrimaryKey, CrossConnectMacsecPropertiesPrimaryKeyArgs

    ConnectivityAssociationKeySecretId string
    (Updatable) Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
    ConnectivityAssociationNameSecretId string
    Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
    ConnectivityAssociationKeySecretVersion string
    The secret version of the connectivityAssociationKey secret in Vault.
    ConnectivityAssociationNameSecretVersion string
    The secret version of the connectivity association name secret in Vault.
    ConnectivityAssociationKeySecretId string
    (Updatable) Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
    ConnectivityAssociationNameSecretId string
    Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
    ConnectivityAssociationKeySecretVersion string
    The secret version of the connectivityAssociationKey secret in Vault.
    ConnectivityAssociationNameSecretVersion string
    The secret version of the connectivity association name secret in Vault.
    connectivityAssociationKeySecretId String
    (Updatable) Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
    connectivityAssociationNameSecretId String
    Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
    connectivityAssociationKeySecretVersion String
    The secret version of the connectivityAssociationKey secret in Vault.
    connectivityAssociationNameSecretVersion String
    The secret version of the connectivity association name secret in Vault.
    connectivityAssociationKeySecretId string
    (Updatable) Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
    connectivityAssociationNameSecretId string
    Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
    connectivityAssociationKeySecretVersion string
    The secret version of the connectivityAssociationKey secret in Vault.
    connectivityAssociationNameSecretVersion string
    The secret version of the connectivity association name secret in Vault.
    connectivity_association_key_secret_id str
    (Updatable) Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
    connectivity_association_name_secret_id str
    Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
    connectivity_association_key_secret_version str
    The secret version of the connectivityAssociationKey secret in Vault.
    connectivity_association_name_secret_version str
    The secret version of the connectivity association name secret in Vault.
    connectivityAssociationKeySecretId String
    (Updatable) Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
    connectivityAssociationNameSecretId String
    Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
    connectivityAssociationKeySecretVersion String
    The secret version of the connectivityAssociationKey secret in Vault.
    connectivityAssociationNameSecretVersion String
    The secret version of the connectivity association name secret in Vault.

    Import

    CrossConnects can be imported using the id, e.g.

    $ pulumi import oci:Core/crossConnect:CrossConnect test_cross_connect "id"

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

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo
    Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
    pulumi/pulumi-oci