Resource Projection

AISIX Cloud stores environment-scoped resources in the control plane and projects them into the managed gateway. Projection is the Cloud-managed path that turns saved Cloud resource state into live gateway behavior.

This matters because a successful save in AISIX Cloud confirms that the control plane accepted the change. It does not by itself prove that every managed gateway instance is already serving the new state.

Projection Flow

Projection follows the environment attached to the managed gateway. A model, caller API key, policy, or cache policy affects live traffic only after the resource is saved in the correct environment, projected to the gateway, and used by a request sent through that gateway.

Because projection is asynchronous, validate live behavior through the managed gateway, not only through the Cloud UI or API response.

Projection Behavior

During temporary control-plane connectivity issues, a managed gateway can continue serving from its latest projected configuration. If multiple gateway instances are attached to the same environment, they can briefly converge at different times.

Verify Live Behavior

When Cloud state and managed gateway behavior do not line up, first confirm the resource belongs to the same environment as the target gateway. Then confirm the gateway is healthy and connected, the projected configuration has reached the gateway, and the request is sent to the managed gateway rather than only to a Cloud UI check.

If the resource is a model, also confirm the caller is using the expected model alias. If the resource is a provider key or policy, confirm the model references the updated resource.

Next Steps

You have now seen how Cloud resources are projected into managed gateways. Continue with Offline Resilience for temporary Cloud connectivity loss.