Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Core
  5. getCrossConnectGroup
Oracle Cloud Infrastructure v2.31.0 published on Thursday, Apr 17, 2025 by Pulumi
pulumi/pulumi-oci

oci.Core.getCrossConnectGroup

Explore with Pulumi AI

Oracle Cloud Infrastructure v2.31.0 published on Thursday, Apr 17, 2025 by Pulumi
pulumi/pulumi-oci

This data source provides details about a specific Cross Connect Group resource in Oracle Cloud Infrastructure Core service.

Gets the specified cross-connect group’s information.

Example Usage

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

const testCrossConnectGroup = oci.Core.getCrossConnectGroup({
    crossConnectGroupId: testCrossConnectGroupOciCoreCrossConnectGroup.id,
});
Copy
import pulumi
import pulumi_oci as oci

test_cross_connect_group = oci.Core.get_cross_connect_group(cross_connect_group_id=test_cross_connect_group_oci_core_cross_connect_group["id"])
Copy
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.GetCrossConnectGroup(ctx, &core.GetCrossConnectGroupArgs{
			CrossConnectGroupId: testCrossConnectGroupOciCoreCrossConnectGroup.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testCrossConnectGroup = Oci.Core.GetCrossConnectGroup.Invoke(new()
    {
        CrossConnectGroupId = testCrossConnectGroupOciCoreCrossConnectGroup.Id,
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.CoreFunctions;
import com.pulumi.oci.Core.inputs.GetCrossConnectGroupArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var testCrossConnectGroup = CoreFunctions.getCrossConnectGroup(GetCrossConnectGroupArgs.builder()
            .crossConnectGroupId(testCrossConnectGroupOciCoreCrossConnectGroup.id())
            .build());

    }
}
Copy
variables:
  testCrossConnectGroup:
    fn::invoke:
      function: oci:Core:getCrossConnectGroup
      arguments:
        crossConnectGroupId: ${testCrossConnectGroupOciCoreCrossConnectGroup.id}
Copy

Using getCrossConnectGroup

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getCrossConnectGroup(args: GetCrossConnectGroupArgs, opts?: InvokeOptions): Promise<GetCrossConnectGroupResult>
function getCrossConnectGroupOutput(args: GetCrossConnectGroupOutputArgs, opts?: InvokeOptions): Output<GetCrossConnectGroupResult>
Copy
def get_cross_connect_group(cross_connect_group_id: Optional[str] = None,
                            opts: Optional[InvokeOptions] = None) -> GetCrossConnectGroupResult
def get_cross_connect_group_output(cross_connect_group_id: Optional[pulumi.Input[str]] = None,
                            opts: Optional[InvokeOptions] = None) -> Output[GetCrossConnectGroupResult]
Copy
func GetCrossConnectGroup(ctx *Context, args *GetCrossConnectGroupArgs, opts ...InvokeOption) (*GetCrossConnectGroupResult, error)
func GetCrossConnectGroupOutput(ctx *Context, args *GetCrossConnectGroupOutputArgs, opts ...InvokeOption) GetCrossConnectGroupResultOutput
Copy

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

public static class GetCrossConnectGroup 
{
    public static Task<GetCrossConnectGroupResult> InvokeAsync(GetCrossConnectGroupArgs args, InvokeOptions? opts = null)
    public static Output<GetCrossConnectGroupResult> Invoke(GetCrossConnectGroupInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetCrossConnectGroupResult> getCrossConnectGroup(GetCrossConnectGroupArgs args, InvokeOptions options)
public static Output<GetCrossConnectGroupResult> getCrossConnectGroup(GetCrossConnectGroupArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: oci:Core/getCrossConnectGroup:getCrossConnectGroup
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

CrossConnectGroupId This property is required. string
The OCID of the cross-connect group.
CrossConnectGroupId This property is required. string
The OCID of the cross-connect group.
crossConnectGroupId This property is required. String
The OCID of the cross-connect group.
crossConnectGroupId This property is required. string
The OCID of the cross-connect group.
cross_connect_group_id This property is required. str
The OCID of the cross-connect group.
crossConnectGroupId This property is required. String
The OCID of the cross-connect group.

getCrossConnectGroup Result

The following output properties are available:

CompartmentId string
The OCID of the compartment containing the cross-connect group.
CrossConnectGroupId string
CustomerReferenceName string
A reference name or identifier for the physical fiber connection that this cross-connect group uses.
DefinedTags Dictionary<string, string>
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
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
FreeformTags Dictionary<string, string>
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"}
Id string
The cross-connect group's Oracle ID (OCID).
MacsecProperties List<GetCrossConnectGroupMacsecProperty>
Properties used for MACsec (if capable).
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.
State string
The cross-connect group's current state.
TimeCreated string
The date and time the cross-connect group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
CompartmentId string
The OCID of the compartment containing the cross-connect group.
CrossConnectGroupId string
CustomerReferenceName string
A reference name or identifier for the physical fiber connection that this cross-connect group uses.
DefinedTags map[string]string
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
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
FreeformTags map[string]string
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"}
Id string
The cross-connect group's Oracle ID (OCID).
MacsecProperties []GetCrossConnectGroupMacsecProperty
Properties used for MACsec (if capable).
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.
State string
The cross-connect group's current state.
TimeCreated string
The date and time the cross-connect group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
compartmentId String
The OCID of the compartment containing the cross-connect group.
crossConnectGroupId String
customerReferenceName String
A reference name or identifier for the physical fiber connection that this cross-connect group uses.
definedTags Map<String,String>
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
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
freeformTags Map<String,String>
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"}
id String
The cross-connect group's Oracle ID (OCID).
macsecProperties List<GetCrossConnectGroupMacsecProperty>
Properties used for MACsec (if capable).
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.
state String
The cross-connect group's current state.
timeCreated String
The date and time the cross-connect group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
compartmentId string
The OCID of the compartment containing the cross-connect group.
crossConnectGroupId string
customerReferenceName string
A reference name or identifier for the physical fiber connection that this cross-connect group uses.
definedTags {[key: string]: string}
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
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
freeformTags {[key: string]: string}
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"}
id string
The cross-connect group's Oracle ID (OCID).
macsecProperties GetCrossConnectGroupMacsecProperty[]
Properties used for MACsec (if capable).
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.
state string
The cross-connect group's current state.
timeCreated string
The date and time the cross-connect group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
compartment_id str
The OCID of the compartment containing the cross-connect group.
cross_connect_group_id str
customer_reference_name str
A reference name or identifier for the physical fiber connection that this cross-connect group uses.
defined_tags Mapping[str, str]
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
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
freeform_tags Mapping[str, str]
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"}
id str
The cross-connect group's Oracle ID (OCID).
macsec_properties Sequence[core.GetCrossConnectGroupMacsecProperty]
Properties used for MACsec (if capable).
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.
state str
The cross-connect group's current state.
time_created str
The date and time the cross-connect group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
compartmentId String
The OCID of the compartment containing the cross-connect group.
crossConnectGroupId String
customerReferenceName String
A reference name or identifier for the physical fiber connection that this cross-connect group uses.
definedTags Map<String>
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
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
freeformTags Map<String>
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"}
id String
The cross-connect group's Oracle ID (OCID).
macsecProperties List<Property Map>
Properties used for MACsec (if capable).
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.
state String
The cross-connect group's current state.
timeCreated String
The date and time the cross-connect group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

Supporting Types

GetCrossConnectGroupMacsecProperty

EncryptionCipher This property is required. string
Type of encryption cipher suite to use for the MACsec connection.
IsUnprotectedTrafficAllowed This property is required. bool
Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
PrimaryKeys This property is required. List<GetCrossConnectGroupMacsecPropertyPrimaryKey>
An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
State This property is required. string
The cross-connect group's current state.
EncryptionCipher This property is required. string
Type of encryption cipher suite to use for the MACsec connection.
IsUnprotectedTrafficAllowed This property is required. bool
Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
PrimaryKeys This property is required. []GetCrossConnectGroupMacsecPropertyPrimaryKey
An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
State This property is required. string
The cross-connect group's current state.
encryptionCipher This property is required. String
Type of encryption cipher suite to use for the MACsec connection.
isUnprotectedTrafficAllowed This property is required. Boolean
Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
primaryKeys This property is required. List<GetCrossConnectGroupMacsecPropertyPrimaryKey>
An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
state This property is required. String
The cross-connect group's current state.
encryptionCipher This property is required. string
Type of encryption cipher suite to use for the MACsec connection.
isUnprotectedTrafficAllowed This property is required. boolean
Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
primaryKeys This property is required. GetCrossConnectGroupMacsecPropertyPrimaryKey[]
An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
state This property is required. string
The cross-connect group's current state.
encryption_cipher This property is required. str
Type of encryption cipher suite to use for the MACsec connection.
is_unprotected_traffic_allowed This property is required. bool
Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
primary_keys This property is required. Sequence[core.GetCrossConnectGroupMacsecPropertyPrimaryKey]
An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
state This property is required. str
The cross-connect group's current state.
encryptionCipher This property is required. String
Type of encryption cipher suite to use for the MACsec connection.
isUnprotectedTrafficAllowed This property is required. Boolean
Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
primaryKeys This property is required. List<Property Map>
An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
state This property is required. String
The cross-connect group's current state.

GetCrossConnectGroupMacsecPropertyPrimaryKey

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

Package Details

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