Oracle Cloud Infrastructure v2.11.0 published on Thursday, Sep 19, 2024 by Pulumi
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
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testCrossConnectGroup = oci.Core.getCrossConnectGroup({
    crossConnectGroupId: testCrossConnectGroupOciCoreCrossConnectGroup.id,
});
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"])
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
	})
}
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,
    });
});
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());
    }
}
variables:
  testCrossConnectGroup:
    fn::invoke:
      Function: oci:Core:getCrossConnectGroup
      Arguments:
        crossConnectGroupId: ${testCrossConnectGroupOciCoreCrossConnectGroup.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 dictionaryThe following arguments are supported:
- Cross
Connect stringGroup Id  - The OCID of the cross-connect group.
 
- Cross
Connect stringGroup Id  - The OCID of the cross-connect group.
 
- cross
Connect StringGroup Id  - The OCID of the cross-connect group.
 
- cross
Connect stringGroup Id  - The OCID of the cross-connect group.
 
- cross_
connect_ strgroup_ id  - The OCID of the cross-connect group.
 
- cross
Connect StringGroup Id  - The OCID of the cross-connect group.
 
getCrossConnectGroup Result
The following output properties are available:
- Compartment
Id string - The OCID of the compartment containing the cross-connect group.
 - Cross
Connect stringGroup Id  - Customer
Reference stringName  - A reference name or identifier for the physical fiber connection that this cross-connect group uses.
 - 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"} - Display
Name string - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
 - 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).
 - Macsec
Properties List<GetCross Connect Group Macsec Property>  - Properties used for MACsec (if capable).
 - Oci
Logical stringDevice Name  - The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
 - Oci
Physical stringDevice Name  - The FastConnect device that terminates the physical connection.
 - State string
 - The cross-connect group's current state.
 - Time
Created 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 string - The OCID of the compartment containing the cross-connect group.
 - Cross
Connect stringGroup Id  - Customer
Reference stringName  - A reference name or identifier for the physical fiber connection that this cross-connect group uses.
 - 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"} - Display
Name string - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
 - 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).
 - Macsec
Properties []GetCross Connect Group Macsec Property  - Properties used for MACsec (if capable).
 - Oci
Logical stringDevice Name  - The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
 - Oci
Physical stringDevice Name  - The FastConnect device that terminates the physical connection.
 - State string
 - The cross-connect group's current state.
 - Time
Created 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 String - The OCID of the compartment containing the cross-connect group.
 - cross
Connect StringGroup Id  - customer
Reference StringName  - A reference name or identifier for the physical fiber connection that this cross-connect group uses.
 - 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"} - display
Name String - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
 - 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).
 - macsec
Properties List<GetCross Connect Group Macsec Property>  - Properties used for MACsec (if capable).
 - oci
Logical StringDevice Name  - The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
 - oci
Physical StringDevice Name  - The FastConnect device that terminates the physical connection.
 - state String
 - The cross-connect group's current state.
 - time
Created 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 string - The OCID of the compartment containing the cross-connect group.
 - cross
Connect stringGroup Id  - customer
Reference stringName  - A reference name or identifier for the physical fiber connection that this cross-connect group uses.
 - {[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"} - display
Name string - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
 - {[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).
 - macsec
Properties GetCross Connect Group Macsec Property[]  - Properties used for MACsec (if capable).
 - oci
Logical stringDevice Name  - The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
 - oci
Physical stringDevice Name  - The FastConnect device that terminates the physical connection.
 - state string
 - The cross-connect group's current state.
 - time
Created 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_ strgroup_ id  - customer_
reference_ strname  - A reference name or identifier for the physical fiber connection that this cross-connect group uses.
 - 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.
 - 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.Get Cross Connect Group Macsec Property]  - Properties used for MACsec (if capable).
 - oci_
logical_ strdevice_ name  - The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
 - oci_
physical_ strdevice_ name  - 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 
- compartment
Id String - The OCID of the compartment containing the cross-connect group.
 - cross
Connect StringGroup Id  - customer
Reference StringName  - A reference name or identifier for the physical fiber connection that this cross-connect group uses.
 - 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"} - display
Name String - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
 - 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).
 - macsec
Properties List<Property Map> - Properties used for MACsec (if capable).
 - oci
Logical StringDevice Name  - The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
 - oci
Physical StringDevice Name  - The FastConnect device that terminates the physical connection.
 - state String
 - The cross-connect group's current state.
 - time
Created 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     
- Encryption
Cipher string - Type of encryption cipher suite to use for the MACsec connection.
 - Is
Unprotected boolTraffic Allowed  - Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
 - Primary
Keys List<GetCross Connect Group Macsec Property Primary Key>  - An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
 - State string
 - The cross-connect group's current state.
 
- Encryption
Cipher string - Type of encryption cipher suite to use for the MACsec connection.
 - Is
Unprotected boolTraffic Allowed  - Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
 - Primary
Keys []GetCross Connect Group Macsec Property Primary Key  - An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
 - State string
 - The cross-connect group's current state.
 
- encryption
Cipher String - Type of encryption cipher suite to use for the MACsec connection.
 - is
Unprotected BooleanTraffic Allowed  - Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
 - primary
Keys List<GetCross Connect Group Macsec Property Primary Key>  - An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
 - state String
 - The cross-connect group's current state.
 
- encryption
Cipher string - Type of encryption cipher suite to use for the MACsec connection.
 - is
Unprotected booleanTraffic Allowed  - Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
 - primary
Keys GetCross Connect Group Macsec Property Primary Key[]  - 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.
 - is_
unprotected_ booltraffic_ allowed  - Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
 - primary_
keys Sequence[core.Get Cross Connect Group Macsec Property Primary Key]  - An object defining the Secrets-in-Vault OCIDs representing the MACsec key.
 - state str
 - The cross-connect group's current state.
 
- encryption
Cipher String - Type of encryption cipher suite to use for the MACsec connection.
 - is
Unprotected BooleanTraffic Allowed  - Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
 - primary
Keys 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       
- Connectivity
Association stringKey Secret Id  - Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
 - Connectivity
Association stringKey Secret Version  - The secret version of the 
connectivityAssociationKeysecret in Vault. - Connectivity
Association stringName Secret Id  - Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
 - Connectivity
Association stringName Secret Version  - The secret version of the connectivity association name secret in Vault.
 
- Connectivity
Association stringKey Secret Id  - Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
 - Connectivity
Association stringKey Secret Version  - The secret version of the 
connectivityAssociationKeysecret in Vault. - Connectivity
Association stringName Secret Id  - Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
 - Connectivity
Association stringName Secret Version  - The secret version of the connectivity association name secret in Vault.
 
- connectivity
Association StringKey Secret Id  - Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
 - connectivity
Association StringKey Secret Version  - The secret version of the 
connectivityAssociationKeysecret in Vault. - connectivity
Association StringName Secret Id  - Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
 - connectivity
Association StringName Secret Version  - The secret version of the connectivity association name secret in Vault.
 
- connectivity
Association stringKey Secret Id  - Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
 - connectivity
Association stringKey Secret Version  - The secret version of the 
connectivityAssociationKeysecret in Vault. - connectivity
Association stringName Secret Id  - Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
 - connectivity
Association stringName Secret Version  - The secret version of the connectivity association name secret in Vault.
 
- connectivity_
association_ strkey_ secret_ id  - Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
 - connectivity_
association_ strkey_ secret_ version  - The secret version of the 
connectivityAssociationKeysecret in Vault. - connectivity_
association_ strname_ secret_ id  - Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
 - connectivity_
association_ strname_ secret_ version  - The secret version of the connectivity association name secret in Vault.
 
- connectivity
Association StringKey Secret Id  - Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
 - connectivity
Association StringKey Secret Version  - The secret version of the 
connectivityAssociationKeysecret in Vault. - connectivity
Association StringName Secret Id  - Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
 - connectivity
Association StringName Secret Version  - 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 
ociTerraform Provider.