Join us from October 8-10 in New York City to learn the latest tips, trends, and news about GraphQL Federation and API platform engineering.Join us for GraphQL Summit 2024 in NYC
Docs
Start for Free

Cloud Serverless Overview

Learn about Serverless cloud routing use cases and limitations


NOTE

is moving to AWS. If you initialized your Serverless before May 21, 2024, you may need to migrate to keep your cloud router running. Learn more.

Serverless run on shared infrastructure that Apollo manages. Serverless is for demos, proof-of-concepts, and small production apps that don't need more than ten requests per second (RPS).

Serverless compute limitations

The following circumstances can exhaust Serverless capacity:

  • Complex schemas can exceed available machine memory for Serverless . For example, Serverless routers don't support schemas with over 1,000 input types.
  • Too many requests at once can overload your Serverless cloud router. It will return 429 errors to your clients.

Because of these limitations, certain workloads might require you to upgrade to . Contact Sales for a free trial.

Automatic deletion of unused routers

When a Serverless cloud router goes 30 days without a request, Apollo deletes the router. To avoid deletion, run a on the router before the 30-day limit.

Learn more about Serverless statuses leading up to deletion in the next section.

Serverless router status

All cloud routers can have Initializing, Running, and Error statuses. Serverless cloud routers have these additional statuses:

StatusDescription
Running, will sleep soonYour cloud router hasn't received requests for six days and is scheduled to go to sleep soon.
SleepingYour cloud router hasn't received requests for seven days and is now sleeping. Learn more.
WakingYour cloud router was asleep and recently received requests. You may experience API downtime for approximately one minute and up to five minutes.
Sleeping, will delete soonYour cloud router has been asleep for almost 30 days and will be deleted soon.
DeletedYour cloud router has been deleted but the associated graph variant remains. You can recreate a cloud router at anytime. Learn more.

Sleeping

Serverless cloud routers go to sleep if they haven't received requests for seven days. While sleeping, your cloud router can't serve requests.

Sleeping cloud routers automatically wake up once they receive requests. While waking, your cloud router can't process incoming requests. It typically takes about one minute to wake up.

Deleted

If a cloud router has been sleeping for 30 days, Apollo automatically deletes it. Router deletion doesn't delete the associated from , but it does spin down the infrastructure powering your cloud router.

You can access a deleted router's config and its variant's schema, but you can't recover any secrets that were stored in GraphOS Studio. The variant's metrics are only kept for a day after deletion per the Serverless data retention policy.

Previous
Configuration
Next
Overview
Rate articleRateEdit on GitHubEditForumsDiscord

© 2024 Apollo Graph Inc., d/b/a Apollo GraphQL.

Privacy Policy

Company