Oracle Cloud Infrastructure v0.20.0, May 31 23

oci.Core.getCrossConnectGroup

Explore with Pulumi AI

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

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 = oci_core_cross_connect_group.Test_cross_connect_group.Id,
    });

});

package main

import (
	"github.com/pulumi/pulumi-oci/sdk/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: oci_core_cross_connect_group.Test_cross_connect_group.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

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(oci_core_cross_connect_group.test_cross_connect_group().id())
            .build());

    }
}

import pulumi
import pulumi_oci as oci

test_cross_connect_group = oci.Core.get_cross_connect_group(cross_connect_group_id=%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference))

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

const testCrossConnectGroup = oci.Core.getCrossConnectGroup({
    crossConnectGroupId: oci_core_cross_connect_group.test_cross_connect_group.id,
});

variables:
  testCrossConnectGroup:
    fn::invoke:
      Function: oci:Core:getCrossConnectGroup
      Arguments:
        crossConnectGroupId: ${oci_core_cross_connect_group.test_cross_connect_group.id}

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>

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]

func GetCrossConnectGroup(ctx *Context, args *GetCrossConnectGroupArgs, opts ...InvokeOption) (*GetCrossConnectGroupResult, error)
func GetCrossConnectGroupOutput(ctx *Context, args *GetCrossConnectGroupOutputArgs, opts ...InvokeOption) GetCrossConnectGroupResultOutput

> 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)
}

public static CompletableFuture<GetCrossConnectGroupResult> getCrossConnectGroup(GetCrossConnectGroupArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet

fn::invoke:
  function: oci:Core/getCrossConnectGroup:getCrossConnectGroup
  arguments:
    # arguments dictionary

The following arguments are supported:

CrossConnectGroupId string: The OCID of the cross-connect group.

CrossConnectGroupId string: The OCID of the cross-connect group.

crossConnectGroupId String: The OCID of the cross-connect group.

crossConnectGroupId string: The OCID of the cross-connect group.

cross_connect_group_id str: The OCID of the cross-connect group.

crossConnectGroupId 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, object>: 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, object>: 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]interface{}: 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]interface{}: 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,Object>: 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,Object>: 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]: any}: 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]: any}: 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, Any]: 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, Any]: 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 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<Any>: 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<Any>: 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 string: Type of encryption cipher suite to use for the MACsec connection.
PrimaryKeys List<GetCrossConnectGroupMacsecPropertyPrimaryKey>: An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
State string: The cross-connect group's current state.

EncryptionCipher string: Type of encryption cipher suite to use for the MACsec connection.
PrimaryKeys []GetCrossConnectGroupMacsecPropertyPrimaryKey: An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
State string: The cross-connect group's current state.

encryptionCipher String: Type of encryption cipher suite to use for the MACsec connection.
primaryKeys List<GetCrossConnectGroupMacsecPropertyPrimaryKey>: An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
state String: The cross-connect group's current state.

encryptionCipher string: Type of encryption cipher suite to use for the MACsec connection.
primaryKeys GetCrossConnectGroupMacsecPropertyPrimaryKey[]: An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
state string: The cross-connect group's current state.

encryption_cipher str: Type of encryption cipher suite to use for the MACsec connection.
primary_keys GetCrossConnectGroupMacsecPropertyPrimaryKey]: An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
state str: The cross-connect group's current state.

encryptionCipher String: Type of encryption cipher suite to use for the MACsec connection.
primaryKeys List<Property Map>: An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
state String: The cross-connect group's current state.

GetCrossConnectGroupMacsecPropertyPrimaryKey

ConnectivityAssociationKeySecretId string: Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
ConnectivityAssociationKeySecretVersion string: The secret version of the connectivityAssociationKey secret in Vault.
ConnectivityAssociationNameSecretId string: Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
ConnectivityAssociationNameSecretVersion string: The secret version of the connectivity association name secret in Vault.

ConnectivityAssociationKeySecretId string: Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
ConnectivityAssociationKeySecretVersion string: The secret version of the connectivityAssociationKey secret in Vault.
ConnectivityAssociationNameSecretId string: Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
ConnectivityAssociationNameSecretVersion string: The secret version of the connectivity association name secret in Vault.

connectivityAssociationKeySecretId String: Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
connectivityAssociationKeySecretVersion String: The secret version of the connectivityAssociationKey secret in Vault.
connectivityAssociationNameSecretId String: Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
connectivityAssociationNameSecretVersion String: The secret version of the connectivity association name secret in Vault.

connectivityAssociationKeySecretId string: Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
connectivityAssociationKeySecretVersion string: The secret version of the connectivityAssociationKey secret in Vault.
connectivityAssociationNameSecretId string: Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
connectivityAssociationNameSecretVersion string: The secret version of the connectivity association name secret in Vault.

connectivity_association_key_secret_id str: Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
connectivity_association_key_secret_version str: The secret version of the connectivityAssociationKey secret in Vault.
connectivity_association_name_secret_id str: Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
connectivity_association_name_secret_version str: The secret version of the connectivity association name secret in Vault.

connectivityAssociationKeySecretId String: Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
connectivityAssociationKeySecretVersion String: The secret version of the connectivityAssociationKey secret in Vault.
connectivityAssociationNameSecretId String: Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
connectivityAssociationNameSecretVersion 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.