Package com.eqixiac.equinix.design.value.ratecard

package com.eqixiac.equinix.design.value.ratecard

Rate cards: pluggable sources of unit prices for the design-time cost, savings, and TCO models. The central abstraction is RateCard, whose lookups (connection, Cloud Router, cloud egress, colocation) return Optional - an empty result means "this card cannot price that item", which is deliberately distinct from a zero price, so callers fall back to another source instead of treating unknown as free.

Cards are composed into a precedence chain with RateCard.layered(...) - the first card that can price an item wins. The conventional ordering is most-trusted first: CustomRateCard (caller-supplied, e.g. negotiated contract rates), then EquinixRateCard (live Fabric Pricing API, term-aware with labelled substitutions), then ReferenceRateCard (bundled, dated indicative figures). RateCard.standardChain(fabric) builds the default live-then-reference chain the value models use when no card is supplied. Every PriceQuote and EgressRate carries its PriceSource provenance and an optional note flagging substitutions and extrapolations.

Native multicloud links

Beta. RateCard.multicloudLink(MulticloudLinkRequest) prices a native provider-to-provider link (AWS Interconnect - multicloud paired with, for example, a Google Partner Cross-Cloud Interconnect transport). Each provider bills its own side, so the result is a MulticloudLinkQuote holding one optional PriceQuote per side. The method defaults to empty, so cards that predate it are unaffected.

multicloudLink by card

Card	Behavior
ReferenceRateCard	published list prices only, exact size match, no rounding or extrapolation; source URL and retrieval date in every note; AWS free tier on request only
CustomRateCard	the sides declared with multicloudLinkRate(...) / multicloudLinkHourlyRate(...)
RateCard.layered(...)	per side: the earliest card that prices a side supplies it
EquinixRateCard, provider-API adapters	empty

Hourly rates become monthly charges at MulticloudLinkQuote.HOURS_PER_MONTH (730 h). The link's per-GB rate is a separate lookup, egress(provider, region, EgressPath.MULTICLOUD_INTERCONNECT, term).

Two invariants hold across all cards: an unpriceable item yields empty, never a fabricated $0; and quotes in different currencies are never combined - no FX rate is ever invented (PriceQuote.plus throws on a currency mismatch, and the engines route cross-card sums through CurrencyReconciler).

See Also:

• RateCard
• PriceSource
• com.eqixiac.equinix.design.value.ratecard.provider

Related Packages

Package	Description
com.eqixiac.equinix.design.value	The value-realization layer of the design API: design-time cost modelling that puts a money figure on an interconnect decision.
com.eqixiac.equinix.design.value.ratecard.provider	Live cloud-provider pricing adapters: RateCard implementations that source current data-egress list prices from the providers' public pricing APIs - AwsPriceListRateCard (AWS Price List bulk offers), AzureRetailPricesRateCard (Azure Retail Prices), GcpBillingCatalogRateCard (GCP Cloud Billing Catalog; the only one needing an API key), and OracleCloudPriceListRateCard (OCI Price List).
com.eqixiac.equinix.design.value.savings	Cloud-egress savings estimation: how much routing a monthly data volume over an Equinix private interconnect saves versus egressing it to the public internet, net of the Equinix interconnect cost.
com.eqixiac.equinix.design.value.tco	Design-time total-cost-of-ownership comparison across the DeploymentArchetypes - public cloud over the internet, on-premises, Equinix-interconnected, and (for a cloud-to-cloud comparison) the providers' native multicloud link.

Class	Description
ColocationItem	An Equinix colocation cost primitive that a RateCard can price - alongside the interconnection rates (connection / cloud router / egress).
ConnectionModel	How a cloud provider sells the connection a design lands on, which decides the provider-side fee.
CustomRateCard	A RateCard whose prices are supplied by the caller - e.g. negotiated contract rates - instead of published list pricing or built-in heuristics.
CustomRateCard.Builder	Fluent builder for a CustomRateCard.
EgressPath	The network path data egress takes when leaving a cloud provider.
EgressRate	A usage-based data-egress price expressed per gigabyte, tagged with its PriceSource.
EquinixRateCard	A RateCard backed by the live Equinix Fabric Pricing API (fabric.prices()); the authoritative source of Equinix-side connection and Cloud Router prices for the cost, savings, and TCO models.
MulticloudLinkQuote	The price of one native provider-to-provider multicloud link.
MulticloudLinkRequest	The lookup key for RateCard.multicloudLink(MulticloudLinkRequest): one native provider-to-provider multicloud link between two clouds.
PriceLookup<T>	The answer to one rate-card lookup: the figure, or the reason there is none, plus which card answered and why earlier cards declined.
PriceQuote	An immutable price for a single resource, split into its monthly-recurring (MRC) and non-recurring (one-time setup, NRC) components, tagged with the PriceSource it was resolved from.
PriceSource	Identifies where a PriceQuote came from, so every number in a cost estimate or savings calculation is traceable to its origin and disclaimed appropriately.
RateCard	A source of unit prices for the design-time cost, savings, and TCO models.
ReferenceRateCard	A RateCard backed by a bundled, dated table of indicative reference figures - published cloud-provider egress rates, interconnect port fees, and on-prem/colocation midpoints - compiled so the value-realization models work out of the box without a live connection or caller-supplied rates.
Term	Commitment term for a priced resource.