Class OracleCloudPriceListRateCard

java.lang.Object
com.eqixiac.equinix.design.value.ratecard.provider.OracleCloudPriceListRateCard
All Implemented Interfaces:
RateCard
public final class OracleCloudPriceListRateCard extends Object implements RateCard
A RateCard that sources Oracle Cloud (OCI) internet data-egress rates from the public OCI Price List API (https://apexapps.oracle.com/pls/apex/cetools/api/v1/products/). The API is unauthenticated, so this adapter needs no credentials.

OCI prices outbound data transfer by source geography ("Originating in North America, Europe, and UK" / "APAC, Japan, and South America" / "Middle East and Africa"), not by individual region, so this adapter maps the supplied region to a geography and selects the matching "Outbound Data Transfer" SKU. The per-GB figure is the first paid tier (the generous free allowance, priced at 0, is skipped). It prices EgressPath.INTERNET for CloudProviderType.ORACLE_CLOUD; EgressPath.PRIVATE (FastConnect) is port-based rather than a per-GB egress SKU, so a PRIVATE lookup returns empty and a layered card falls back to another source. Every rate it returns is tagged PriceSource.PROVIDER_API.

The price list is fetched once and cached for the adapter's lifetime — but only when the fetch completed. An incomplete fetch (a transport failure, or pagination cut short) is never memoized: a SKU found in the retrieved pages is still a real datum and is cached, but a miss over an incomplete catalogue is not authoritative and is retried on the next lookup. The adapter is fault-tolerant — any fetch or parse failure yields no rate rather than an exception.

  • Field Details

  • Method Details

    • create

      public static OracleCloudPriceListRateCard create()
      Creates an adapter against the public OCI Price List endpoint (DEFAULT_ENDPOINT). No credentials required; note it prices INTERNET egress only (PRIVATE/FastConnect is port-based).
      Returns:
      a new OCI pricing adapter

    • create

      public static OracleCloudPriceListRateCard create(String endpoint)
      Creates an adapter against a custom endpoint — for a proxy or testing.
      Parameters:
      endpoint - the full OCI Price List products URL

    • connection

      public Optional<PriceQuote> connection(ConnectionType type, int bandwidthMbps, MetroCode metro, Term term)
      Description copied from interface: RateCard
      Resolves the price of a single Fabric connection / virtual connection.

      Implementation contract. The matching strategy is implementation-specific, and a card whose data lacks an axis (metro, term, type) still returns its best figure — or empty — rather than failing; callers must not assume every card is sensitive to every parameter. Of the bundled cards: CustomRateCard resolves the most specific declared entry (exact metro+term down to metro/term-agnostic, then a declared default); EquinixRateCard matches bandwidth and type against the live catalogue, honours a requested metro strictly (a wrong-metro row is never returned), and prefers a term-matched row — a different-term row is only ever returned with a note naming the substitution; ReferenceRateCard matches on bandwidth alone (smallest tabulated tier at or above the request, linearly extrapolated with an EXTRAPOLATED note above the top tier) and ignores type, metro, and term entirely.

      Specified by:
      connection in interface RateCard
      Parameters:
      type - the connection type (e.g. EVPL_VC); may be null for any type
      bandwidthMbps - the provisioned bandwidth in Mbps
      metro - the metro the connection originates in (may be null if metro-agnostic)
      term - the commitment term (may be null if term-agnostic)
      Returns:
      the resolved quote, or Optional.empty() if this card cannot price the connection

    • cloudRouter

      public Optional<PriceQuote> cloudRouter(String packageCode, MetroCode metro, Term term)
      Description copied from interface: RateCard
      Resolves the price of a single Fabric Cloud Router instance.

      Implementation contract. As with RateCard.connection(ConnectionType, int, MetroCode, Term), matching is implementation-specific and cards without a metro/term axis return their best figure regardless. Of the bundled cards: CustomRateCard resolves the most specific declared (packageCode, metro, term) entry; EquinixRateCard matches the package code and metro structurally against the row's own descriptor (exact package equality, the row's own metro code) and prefers a term-matched row, labelling any term substitution; ReferenceRateCard ignores metro and term, and substitutes its STANDARD figure for an unlisted package with a note naming the substitution.

      Specified by:
      cloudRouter in interface RateCard
      Parameters:
      packageCode - the router package / tier code (e.g. "STANDARD"); may be null for any
      metro - the metro the router is deployed in (may be null if metro-agnostic)
      term - the commitment term (may be null if term-agnostic)
      Returns:
      the resolved quote, or Optional.empty() if this card cannot price the router

    • egress

      public Optional<EgressRate> egress(CloudProviderType provider, String region, EgressPath path, Term term)
      Description copied from interface: RateCard
      Resolves the per-GB data-egress rate for a cloud provider over a given path.

      Equinix does not sell cloud egress, so EquinixRateCard returns Optional.empty() here (the default); egress rates come from a CustomRateCard (your figures), a ReferenceRateCard (bundled indicative figures), or a provider-pricing-API card. The default returns empty so cards that do not model egress need not override it. Cards whose data has no region or term axis ignore those parameters — the custom and reference cards match on provider + path alone; only the provider-API adapters are region-sensitive.

      Specified by:
      egress in interface RateCard
      Parameters:
      provider - the cloud provider the data is leaving
      region - the provider region (may be null for a provider-wide rate)
      path - internet vs. private interconnect
      term - the commitment term (may be null; ignored by term-agnostic cards)
      Returns:
      the resolved egress rate, or Optional.empty() if this card cannot price it

    • source

      public PriceSource source()
      Description copied from interface: RateCard
      The dominant provenance of prices this card produces. Aggregating cards report PriceSource.COMPOSITE.
      Specified by:
      source in interface RateCard
      Returns:
      the price source