Package com.eqixiac.equinix.fabric.model.implementation.cloud

package com.eqixiac.equinix.fabric.model.implementation.cloud
Cloud provider SDK interoperability layer for Equinix Fabric connections.

This package provides the Adapter Pattern for bridging cloud provider SDK objects (AWS Direct Connect, Azure ExpressRoute, Google Cloud Interconnect, Oracle FastConnect) with the Equinix Fabric ConnectionBuilder.

Architecture

The central interface CloudProviderConnectionAdapter defines the contract for extracting connection parameters from any cloud provider SDK object. Four built-in reference implementations are provided:

Quick Start

// Option 1: Wrap a cloud provider SDK object
AwsDirectConnectAdapter<Connection> adapter = new AwsDirectConnectAdapter<>(
    awsConnection, awsAccountId, "us-east-1", equinixProfileUuid, "DC");

// Option 2: Manual construction without a provider SDK
AwsDirectConnectAdapter<?> adapter = AwsDirectConnectAdapter.of(
    "123456789012", "us-east-1", equinixProfileUuid, "DC");

// Use the adapter with the Fabric ConnectionBuilder
Connection conn = fabric.connections()
    .define(ConnectionType.EVPL_VC)
    .name("My-Cloud-Connection")
    .bandwidth(100)
    .aSideAccessPointPort(portUuid, LinkProtocol.dot1q().vlanTag(1000).create())
    .zSideCloudProvider(adapter)
    .notification("ops@example.com")
    .create();

Custom Adapters

Implement CloudProviderConnectionAdapter for any cloud provider or service not covered by the built-in adapters. The interface defines required methods for service profile UUID, authentication key, and seller region, plus optional defaults for connection type, link protocol, and peering type.

Authentication key and activation key

The Fabric v4 AccessPoint schema defines two string properties, and the adapter exposes one method for each. Neither is derived from, or substituted for, the other.

Key properties on an access point
Wire propertyAdapter methodContentStatus
authenticationKeygetAuthenticationKey() (abstract) Provider-defined identifier: AWS account id, ExpressRoute service key, GCP pairing key, OCI virtual circuit OCID.GA
activationKeygetActivationKey() (default null) Provider-encoded activation key, sent unmodified. It can be checked first with ServiceProfiles.validateActivationKey(...). Beta: defined in the catalog fetched 2026-09-21; the catalog has no connection-create example that sets it.

The four built-in adapters do not override getActivationKey(), so the request bodies they produce contain no activationKey property.

See Also: