Amazon Lightsail

Amazon Lightsail Regions API

The Regions API from Amazon Lightsail — 1 operation(s) for regions.

GitHub OpenAPI

Operations 1

POST /#GetRegions Get Regions #

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://artifacts.apis.io/amazon-lightsail/openapi/amazon-lightsail-regions-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/amazon-lightsail/json-schema/amazon-lightsail-get-regions-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/amazon-lightsail/json-schema/amazon-lightsail-get-regions-result-schema.json

Other Resources

🔗
Smithy
https://artifacts.apis.io/amazon-lightsail/smithy/amazon-lightsail-2016-11-28.json
🔗
Pricing
https://aws.amazon.com/lightsail/pricing/
🔗
FAQ
https://aws.amazon.com/lightsail/faq/
🔗
JSONLD
https://artifacts.apis.io/amazon-lightsail/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-regions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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-regions-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Amazon Lightsail Regions API
  version: '2016-11-28'
  description: Generated from AWS's published Smithy model for Amazon Lightsail. 1 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://lightsail.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /#GetRegions:
    post:
      operationId: GetRegions
      summary: Get Regions
      description: Returns a list of all valid regions for Amazon Lightsail. Use the include availability zones parameter
        to also return the Availability Zones in a region.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/GetRegionsResult'
        '403':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '428':
          description: AccountSetupInProgressException; RegionSetupInProgressException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AccountSetupInProgressException'
        '400':
          description: InvalidInputException; OperationFailureException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InvalidInputException'
        '404':
          description: NotFoundException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/NotFoundException'
        '500':
          description: ServiceException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ServiceException'
        '401':
          description: UnauthenticatedException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/UnauthenticatedException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - Lightsail_20161128.GetRegions
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/GetRegionsRequest'
      tags:
      - Regions
components:
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
        request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: lightsail
  schemas:
    AccessDeniedException:
      type: object
      properties:
        code:
          type: string
        docs:
          type: string
        message:
          type: string
        tip:
          type: string
    AccountSetupInProgressException:
      type: object
      properties:
        code:
          type: string
        docs:
          type: string
        message:
          type: string
        tip:
          type: string
    AvailabilityZone:
      type: object
      properties:
        zoneName:
          type: string
          description: The name of the Availability Zone. The format is us-east-2a (case-sensitive).
        state:
          type: string
          description: The state of the Availability Zone.
    GetRegionsRequest:
      type: object
      properties:
        includeAvailabilityZones:
          type: boolean
          description: 'A Boolean value indicating whether to also include Availability Zones in your get regions request.
            Availability Zones are indicated with a letter: us-east-2a.'
        includeRelationalDatabaseAvailabilityZones:
          type: boolean
          description: A Boolean value indicating whether to also include Availability Zones for databases in your get regions
            request. Availability Zones are indicated with a letter (us-east-2a).
    GetRegionsResult:
      type: object
      properties:
        regions:
          type: array
          items:
            $ref: '#/components/schemas/Region'
          description: An array of key-value pairs containing information about your get regions request.
    InvalidInputException:
      type: object
      properties:
        code:
          type: string
        docs:
          type: string
        message:
          type: string
        tip:
          type: string
    NotFoundException:
      type: object
      properties:
        code:
          type: string
        docs:
          type: string
        message:
          type: string
        tip:
          type: string
    Region:
      type: object
      properties:
        continentCode:
          type: string
          description: The continent code (NA, meaning North America).
        description:
          type: string
          description: The description of the Amazon Web Services Region (This region is recommended to serve users in the
            eastern United States and eastern Canada).
        displayName:
          type: string
          description: The display name (Ohio).
        name:
          type: string
          enum:
          - us-east-1
          - us-east-2
          - us-west-1
          - us-west-2
          - eu-west-1
          - eu-west-2
          - eu-west-3
          - eu-central-1
          - eu-north-1
          - eu-south-2
          - ca-central-1
          - ap-east-1
          - ap-south-1
          - ap-southeast-1
          - ap-southeast-2
          - ap-northeast-1
          - ap-northeast-2
          - ap-southeast-3
          - ap-southeast-5
          - sa-east-1
          description: The region name (us-east-2).
        availabilityZones:
          type: array
          items:
            $ref: '#/components/schemas/AvailabilityZone'
          description: The Availability Zones. Follows the format us-east-2a (case-sensitive).
        relationalDatabaseAvailabilityZones:
          type: array
          items:
            $ref: '#/components/schemas/AvailabilityZone'
          description: The Availability Zones for databases. Follows the format us-east-2a (case-sensitive).
    ServiceException:
      type: object
      properties:
        code:
          type: string
        docs:
          type: string
        message:
          type: string
        tip:
          type: string
    UnauthenticatedException:
      type: object
      properties:
        code:
          type: string
        docs:
          type: string
        message:
          type: string
        tip:
          type: string
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/lightsail/service/2016-11-28/lightsail-2016-11-28.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)