Amazon Lightsail

Amazon Lightsail Distributions API

The Distributions API from Amazon Lightsail — 11 operation(s) for distributions.

GitHub OpenAPI
Business capability
IT Infrastructure Management BC-600.50

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /ls/api/2016-11-28/AttachCertificateToDistribution Attach a certificate to a CDN distribution · Attaches an SSL/TLS certificate to your Amazon Lightsail content delivery… #
Ask an LLM
“How do I use my custom domain with HTTPS on a Lightsail CDN distribution?”
“Can I attach a validated certificate to an existing distribution?”
Tell an agent
Attach certificate {certificateName} to distribution {distributionName}.
Enable custom-domain HTTPS on {distributionName} with {certificateName}.
POST /ls/api/2016-11-28/CreateDistribution Create a CDN distribution · Creates an Amazon Lightsail content delivery network (CDN) distribution #
Ask an LLM
“How do I put a CDN in front of my Lightsail instance or bucket?”
“Can I set caching rules per path when creating a distribution?”
Tell an agent
Create distribution {distributionName} for origin {origin} with cache behavior {defaultCacheBehavior} on plan {bundleId}.
Set up a CDN {distributionName} for {origin}, caching {defaultCacheBehavior}, plan {bundleId}, cert {certificateName}.
POST /ls/api/2016-11-28/DeleteDistribution Delete a CDN distribution · Deletes your Amazon Lightsail content delivery network (CDN) distribution #
Ask an LLM
“How do I delete a CDN distribution I no longer need?”
“Will deleting the distribution affect my origin instance?”
Tell an agent destructive · confirm first
Delete distribution {distributionName}.
Tear down the CDN named {distributionName}.
POST /ls/api/2016-11-28/DetachCertificateFromDistribution Remove the certificate from a distribution · Detaches an SSL/TLS certificate from your Amazon Lightsail content delivery… #
Ask an LLM
“How do I stop using my custom-domain certificate on a distribution?”
“Does detaching a certificate revert the distribution to its default domain?”
Tell an agent
Detach the certificate from distribution {distributionName}.
Remove custom-domain TLS from {distributionName}.
POST /ls/api/2016-11-28/GetDistributionBundles List CDN distribution plans · Returns the bundles that can be applied to your Amazon Lightsail content… #
Ask an LLM
“What CDN plans are available and how much transfer do they include?”
“Which distribution bundle should cover 500 GB a month?”
Tell an agent
List the distribution bundles.
Show CDN plan prices and data transfer quotas.
POST /ls/api/2016-11-28/GetDistributionLatestCacheReset Check the last CDN cache reset · Returns the timestamp and status of the last cache reset of a specific Amazon… #
Ask an LLM
“When was my distribution's cache last cleared?”
“Has my most recent cache reset finished?”
Tell an agent
Get the latest cache reset for {distributionName}.
Check the status of the last cache purge on {distributionName}.
POST /ls/api/2016-11-28/GetDistributionMetricData Get traffic metrics for a distribution · Returns the data points of a specific metric for an Amazon Lightsail content… #
Ask an LLM
“How many requests is my CDN distribution serving?”
“Can I see bytes downloaded or error rates for a distribution?”
Tell an agent
Get {metricName} for distribution {distributionName} from {startTime} to {endTime} every {period} seconds as {statistics} in {unit}.
Chart CDN {distributionName} {metricName} since {startTime}.
POST /ls/api/2016-11-28/GetDistributions List CDN distributions · Returns information about one or more of your Amazon Lightsail content delivery… #
Ask an LLM
“What CDN distributions do I have and what domains do they serve?”
“Can I look up just one distribution's configuration?”
Tell an agent
List my CDN distributions.
Get the configuration of distribution {distributionName}.
POST /ls/api/2016-11-28/ResetDistributionCache Purge a distribution's cached content · Deletes currently cached content from your Amazon Lightsail content delivery… #
Ask an LLM
“How do I clear the CDN cache after deploying new files?”
“Can I force the distribution to fetch fresh content from the origin?”
Tell an agent
Reset the cache of distribution {distributionName}.
Purge everything cached on {distributionName}.
POST /ls/api/2016-11-28/UpdateDistribution Change a CDN distribution's settings · Updates an existing Amazon Lightsail content delivery network (CDN) distribution #
Ask an LLM
“How do I change the origin or caching behavior of an existing distribution?”
“Can I temporarily disable a distribution?”
Tell an agent
Point distribution {distributionName} at origin {origin}.
Set {distributionName} enabled to {isEnabled}.
POST /ls/api/2016-11-28/UpdateDistributionBundle Change a distribution's CDN plan · Updates the bundle of your Amazon Lightsail content delivery network (CDN)… #
Ask an LLM
“How do I upgrade my CDN distribution to a larger transfer plan?”
“Can I downgrade a distribution's bundle?”
Tell an agent
Move distribution {distributionName} to bundle {bundleId}.
Change the CDN plan of {distributionName} to {bundleId}.

Documentation

📖
APIReference
https://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/Welcome.html
📖
Documentation
https://docs.aws.amazon.com/lightsail/latest/userguide/what-is-amazon-lightsail.html
📖
GettingStarted
https://aws.amazon.com/lightsail/getting-started/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/amazon-lightsail/refs/heads/main/openapi/amazon-lightsail-distributions-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amazon-lightsail/refs/heads/main/json-schema/amazon-lightsail-instance-schema.json

Other Resources

🔗
Smithy
https://raw.githubusercontent.com/api-evangelist/amazon-lightsail/refs/heads/main/smithy/amazon-lightsail-2016-11-28.json
🔗
Pricing
https://aws.amazon.com/lightsail/pricing/
🔗
FAQ
https://aws.amazon.com/lightsail/faq/
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/amazon-lightsail/refs/heads/main/json-ld/amazon-lightsail-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/amazon-lightsail:amazon-lightsail-distributions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amazon-lightsail-distributions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Amazon Lightsail Distributions API
  description: Amazon Lightsail is the easiest way to get started with Amazon Web Services (AWS) for developers who need to build websites or web applications.
  version: '2016-11-28'
  contact:
    name: AWS Support
    url: https://aws.amazon.com/premiumsupport/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  x-logo:
    url: https://a0.awsstatic.com/libra-css/images/logos/aws_logo_smile_1200x630.png
  x-generated-from: AWS Smithy 2.0 service model (https://github.com/aws/api-models-aws) — mechanical transform, no hand-authored operations
servers:
- url: https://lightsail.us-east-1.amazonaws.com
  description: Amazon Lightsail regional endpoint (us-east-1). Lightsail is regional — one endpoint per AWS Region, lightsail.{region}.amazonaws.com (IPv4) or lightsail.{region}.api.aws (dual-stack). See https://docs.aws.amazon.com/general/latest/gr/lightsail.html
security:
- sigv4: []
tags:


# --- truncated at 32 KB (79 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amazon-lightsail/refs/heads/main/openapi/amazon-lightsail-distributions-api-openapi.yml