Amazon Lightsail

Amazon Lightsail Blockstorage API

The blockstorage API from Amazon Lightsail — 6 operation(s) for blockstorage.

GitHub OpenAPI
Business capability
IT Infrastructure Management BC-600.50

Operations 6

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/AttachDisk Attach a block storage disk to an instance · Attaches a block storage disk to a running or stopped Lightsail instance and… #
Ask an LLM
“How do I add extra storage to my Lightsail instance?”
“Can a disk be mounted automatically when I attach it?”
Tell an agent
Attach disk {diskName} to {instanceName} at {diskPath}.
Attach {diskName} to {instanceName} at {diskPath} with auto-mounting {autoMounting}.
POST /ls/api/2016-11-28/CreateDisk Create a new empty block storage disk · Creates a block storage disk that can be attached to an Amazon Lightsail… #
Ask an LLM
“How do I create a new blank SSD disk for an instance?”
“Does a new disk have to be in the same Availability Zone as the instance?”
Tell an agent
Create a {sizeInGb} GB disk named {diskName} in {availabilityZone}.
Create empty disk {diskName} of {sizeInGb} GB in {availabilityZone} tagged {tags}.
POST /ls/api/2016-11-28/DeleteDisk Delete a block storage disk · Deletes the specified block storage disk #
Ask an LLM
“How do I permanently delete a disk I no longer use?”
“Can I delete a disk that still has automatic snapshots enabled?”
Tell an agent destructive · confirm first
Delete disk {diskName}.
Delete disk {diskName} and force-delete its add-ons ({forceDeleteAddOns}).
POST /ls/api/2016-11-28/DetachDisk Detach a disk from its instance · Detaches a stopped block storage disk from a Lightsail instance #
Ask an LLM
“How do I unplug a disk from an instance without deleting it?”
“Does the instance need to be stopped before I detach a disk?”
Tell an agent
Detach disk {diskName} from its instance.
Unattach {diskName} so I can move it to another server.
POST /ls/api/2016-11-28/GetDisk Get details of one block storage disk · Returns information about a specific block storage disk #
Ask an LLM
“What size and state is a particular disk in?”
“Which instance is a given disk attached to?”
Tell an agent
Get details for disk {diskName}.
Show the attachment and size of {diskName}.
POST /ls/api/2016-11-28/GetDisks List all block storage disks · Returns information about all block storage disks in your AWS account and region #
Ask an LLM
“Which block storage disks do I have in this region?”
“Is there a way to page through all my disks?”
Tell an agent
List all my block storage disks.
Get the next page of disks using {pageToken}.

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