» oci_core_cross_connect

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 

resource "oci_core_cross_connect" "test_cross_connect" {
    #Required
    compartment_id = "${var.compartment_id}"
    location_name = "${var.cross_connect_location_name}"
    port_speed_shape_name = "${var.cross_connect_port_speed_shape_name}"

    #Optional
    cross_connect_group_id = "${oci_core_cross_connect_group.test_cross_connect_group.id}"
    customer_reference_name = "${var.cross_connect_customer_reference_name}"
    display_name = "${var.cross_connect_display_name}"
    far_cross_connect_or_cross_connect_group_id = "${oci_core_far_cross_connect_or_cross_connect_group.test_far_cross_connect_or_cross_connect_group.id}"
    near_cross_connect_or_cross_connect_group_id = "${oci_core_near_cross_connect_or_cross_connect_group.test_near_cross_connect_or_cross_connect_group.id}"
}

» Argument Reference

The following arguments are supported:

  • compartment_id - (Required) The OCID of the compartment to contain the cross-connect.
  • cross_connect_group_id - (Optional) The OCID of the cross-connect group to put this cross-connect in.
  • customer_reference_name - (Optional) (Updatable) A reference name or identifier for the physical fiber connection that this cross-connect uses.
  • display_name - (Optional) (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 - (Optional) 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.
  • is_active - (Optional) (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 - (Required) 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
  • near_cross_connect_or_cross_connect_group_id - (Optional) 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.
  • port_speed_shape_name - (Required) 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

» Attributes Reference

The following attributes are exported:

  • compartment_id - The OCID of the compartment containing the cross-connect group.
  • cross_connect_group_id - The OCID of the cross-connect group this cross-connect belongs to (if any).
  • customer_reference_name - A reference name or identifier for the physical fiber connection that this cross-connect uses.
  • display_name - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
  • id - The cross-connect's Oracle ID (OCID).
  • location_name - The name of the FastConnect location where this cross-connect is installed.
  • port_name - A string identifying the meet-me room port for this cross-connect.
  • port_speed_shape_name - The port speed for this cross-connect. Example: 10 Gbps
  • state - The cross-connect's current state.
  • time_created - The date and time the cross-connect was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

» Import

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

$ terraform import oci_core_cross_connect.test_cross_connect "id"