Amazon Lightsail

Amazon Lightsail Container Services API

The Container Services API from Amazon Lightsail — 10 operation(s) for container services.

GitHub OpenAPI

Operations 14

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

GET /ls/api/2016-11-28/container-api-metadata Get Lightsail container API metadata · Returns information about Amazon Lightsail containers, such as the current… #
Ask an LLM
“Which version of the lightsailctl plugin is current?”
“Where do I find metadata about the Lightsail containers API?”
Tell an agent
Get the Lightsail container API metadata.
Show the current lightsailctl plugin version.
POST /ls/api/2016-11-28/container-registry-login Get temporary Docker registry login credentials · Creates a temporary set of log in credentials that you can use to log in to the… #
Ask an LLM
“How do I log my local Docker in so I can push images to a container service?”
“How long do the container registry login credentials last?”
Tell an agent
Create temporary registry login credentials for my local Docker.
Give me a container registry login so I can push images.
GET /ls/api/2016-11-28/container-service-powers List container service power sizes · Returns the list of powers that can be specified for your Amazon Lightsail… #
Ask an LLM
“What power levels (CPU and memory) can a container service use?”
“How much does each container service power cost per month?”
Tell an agent
List the container service powers.
Show the CPU, RAM and price of each container power option.
POST /ls/api/2016-11-28/container-services Create a container service · Creates an Amazon Lightsail container service #
Ask an LLM
“How do I create a Lightsail container service to run my Docker app?”
“Can I set custom domain names and a first deployment when creating the service?”
Tell an agent
Create container service {serviceName} with power {power} and scale {scale}.
Create {serviceName} at {power} power, {scale} nodes, with initial deployment {deployment}.
GET /ls/api/2016-11-28/container-services List container services or get one · Returns information about one or more of your Amazon Lightsail container… #
Ask an LLM
“Which container services am I running and what state are they in?”
“What's the public URL of one of my container services?”
Tell an agent
List my container services.
Get details for container service {serviceName}.
DELETE /ls/api/2016-11-28/container-services/{serviceName} Delete a container service · Deletes your Amazon Lightsail container service #
Ask an LLM
“How do I tear down a container service I'm done with?”
“Does deleting a container service remove its registered images too?”
Tell an agent destructive · confirm first
Delete container service {serviceName}.
Remove {serviceName} and stop billing for it.
PATCH /ls/api/2016-11-28/container-services/{serviceName} Change a container service's power, scale or domains · Updates the configuration of your Amazon Lightsail container service, such as… #
Ask an LLM
“How do I scale my container service to more nodes?”
“Can I disable a container service temporarily without deleting it?”
Tell an agent
Scale container service {serviceName} to {scale} nodes.
Change {serviceName} power to {power}.
GET /ls/api/2016-11-28/container-services/{serviceName}/containers/{containerName}/log Read a container's log events · Returns the log events of a container of your Amazon Lightsail container service #
Ask an LLM
“How do I see the logs from a container in my service?”
“Can I filter container logs for errors in a time window?”
Tell an agent
Show logs for container {containerName} in {serviceName}.
Get {containerName} logs in {serviceName} matching {filterPattern} from {startTime} to {endTime}.
POST /ls/api/2016-11-28/container-services/{serviceName}/deployments Deploy containers to a container service · Creates a deployment for your Amazon Lightsail container service #
Ask an LLM
“How do I deploy a new image version to my container service?”
“Can I set which container and port serve public traffic?”
Tell an agent
Deploy containers {containers} to {serviceName}.
Create a deployment on {serviceName} with {containers} and public endpoint {publicEndpoint}.
GET /ls/api/2016-11-28/container-services/{serviceName}/deployments List a container service's deployments · Returns the deployments for your Amazon Lightsail container service A… #
Ask an LLM
“What deployments has my container service had, and which is active?”
“Did my latest container deployment fail?”
Tell an agent
List deployments for container service {serviceName}.
Show the active and previous deployment versions of {serviceName}.
GET /ls/api/2016-11-28/container-services/{serviceName}/images List images registered to a container service · Returns the container images that are registered to your Amazon Lightsail… #
Ask an LLM
“Which container images have I pushed to my service?”
“What image versions are available to deploy on a service?”
Tell an agent
List container images registered to {serviceName}.
Show the pushed images on {serviceName}.
POST /ls/api/2016-11-28/container-services/{serviceName}/images Register a pushed image to a container service · Registers a container image to your Amazon Lightsail container service #
Ask an LLM
“How do I register an image I pushed so a service can deploy it?”
“Do I need the image digest to register a container image?”
Tell an agent
Register image {digest} as {label} on {serviceName}.
Add container image with label {label} and digest {digest} to {serviceName}.
DELETE /ls/api/2016-11-28/container-services/{serviceName}/images/{image} Delete an image from a container service · Deletes a container image that is registered to your Amazon Lightsail container… #
Ask an LLM
“How do I clean up old container images from my service?”
“Can I delete an image that's no longer deployed?”
Tell an agent destructive · confirm first
Delete image {image} from container service {serviceName}.
Remove the registered image {image} on {serviceName}.
GET /ls/api/2016-11-28/container-services/{serviceName}/metrics Get CPU or memory metrics for a container service · Returns the data points of a specific metric of your Amazon Lightsail container… #
Ask an LLM
“How much CPU is my container service using?”
“Can I pull memory utilization for a container service over the last day?”
Tell an agent
Get {metricName} for {serviceName} from {startTime} to {endTime} every {period} seconds as {statistics}.
Show container service {serviceName} {metricName} utilization since {startTime}.

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-container-services-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-container-services-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-container-services-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Amazon Lightsail Container Services 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 (80 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amazon-lightsail/refs/heads/main/openapi/amazon-lightsail-container-services-api-openapi.yml