Oracle Cloud Infrastructure v2.17.0 published on Friday, Nov 15, 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:
- CrossConnect stringGroup Id 
- The OCID of the cross-connect group.
- CrossConnect stringGroup Id 
- The OCID of the cross-connect group.
- crossConnect StringGroup Id 
- The OCID of the cross-connect group.
- crossConnect stringGroup Id 
- The OCID of the cross-connect group.
- cross_connect_ strgroup_ id 
- The OCID of the cross-connect group.
- crossConnect StringGroup Id 
- 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.
- CrossConnect stringGroup Id 
- CustomerReference 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"}
- DisplayName 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).
- MacsecProperties List<GetCross Connect Group Macsec Property> 
- Properties used for MACsec (if capable).
- OciLogical stringDevice Name 
- The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
- OciPhysical stringDevice Name 
- 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.
- CrossConnect stringGroup Id 
- CustomerReference 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"}
- DisplayName 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).
- MacsecProperties []GetCross Connect Group Macsec Property 
- Properties used for MACsec (if capable).
- OciLogical stringDevice Name 
- The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
- OciPhysical stringDevice Name 
- 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.
- crossConnect StringGroup Id 
- customerReference 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"}
- displayName 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).
- macsecProperties List<GetCross Connect Group Macsec Property> 
- Properties used for MACsec (if capable).
- ociLogical StringDevice Name 
- The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
- ociPhysical StringDevice Name 
- 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.
- crossConnect stringGroup Id 
- customerReference 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"}
- displayName 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).
- macsecProperties GetCross Connect Group Macsec Property[] 
- Properties used for MACsec (if capable).
- ociLogical stringDevice Name 
- The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
- ociPhysical stringDevice Name 
- 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_ 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
- compartmentId String
- The OCID of the compartment containing the cross-connect group.
- crossConnect StringGroup Id 
- customerReference 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"}
- displayName 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).
- macsecProperties List<Property Map>
- Properties used for MACsec (if capable).
- ociLogical StringDevice Name 
- The FastConnect device that terminates the logical connection. This device might be different than the device that terminates the physical connection.
- ociPhysical StringDevice Name 
- 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.
- IsUnprotected boolTraffic Allowed 
- Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
- PrimaryKeys 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.
- EncryptionCipher string
- Type of encryption cipher suite to use for the MACsec connection.
- IsUnprotected boolTraffic Allowed 
- Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
- PrimaryKeys []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.
- encryptionCipher String
- Type of encryption cipher suite to use for the MACsec connection.
- isUnprotected BooleanTraffic Allowed 
- Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
- primaryKeys 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.
- encryptionCipher string
- Type of encryption cipher suite to use for the MACsec connection.
- isUnprotected booleanTraffic Allowed 
- Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
- primaryKeys 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.
- encryptionCipher String
- Type of encryption cipher suite to use for the MACsec connection.
- isUnprotected BooleanTraffic Allowed 
- Indicates whether unencrypted traffic is allowed if MACsec Key Agreement protocol (MKA) fails.
- 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       
- ConnectivityAssociation stringKey Secret Id 
- Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
- ConnectivityAssociation stringKey Secret Version 
- The secret version of the connectivityAssociationKeysecret in Vault.
- ConnectivityAssociation stringName Secret Id 
- Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
- ConnectivityAssociation stringName Secret Version 
- The secret version of the connectivity association name secret in Vault.
- ConnectivityAssociation stringKey Secret Id 
- Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
- ConnectivityAssociation stringKey Secret Version 
- The secret version of the connectivityAssociationKeysecret in Vault.
- ConnectivityAssociation stringName Secret Id 
- Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
- ConnectivityAssociation stringName Secret Version 
- The secret version of the connectivity association name secret in Vault.
- connectivityAssociation StringKey Secret Id 
- Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
- connectivityAssociation StringKey Secret Version 
- The secret version of the connectivityAssociationKeysecret in Vault.
- connectivityAssociation StringName Secret Id 
- Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
- connectivityAssociation StringName Secret Version 
- The secret version of the connectivity association name secret in Vault.
- connectivityAssociation stringKey Secret Id 
- Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
- connectivityAssociation stringKey Secret Version 
- The secret version of the connectivityAssociationKeysecret in Vault.
- connectivityAssociation stringName Secret Id 
- Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
- connectivityAssociation 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.
- connectivityAssociation StringKey Secret Id 
- Secret OCID containing the Connectivity Association Key (CAK) of this MACsec key.
- connectivityAssociation StringKey Secret Version 
- The secret version of the connectivityAssociationKeysecret in Vault.
- connectivityAssociation StringName Secret Id 
- Secret OCID containing the Connectivity association Key Name (CKN) of this MACsec key.
- connectivityAssociation 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.