All Products
Search

This Product

    Simple Application Server:Integration overview

    Document Center

    Simple Application Server:Integration overview

    Last Updated:Jun 08, 2026

    Simple Application Server (SAS) supports a web console, OpenAPI Explorer, Alibaba Cloud SDKs, and . Choose the integration method that fits your workflow.

    OpenAPI

    Alibaba Cloud provides OpenAPI Explorer, a tool that integrates API search, documentation, online debugging, SDK generation, code samples, error diagnostics, and call statistics. Use OpenAPI Explorer to call APIs, inspect requests and responses, and generate SDK sample code. Simple Application Server provides APIs for managing instances, disks, images, key pairs, and firewalls. What is OpenAPI?.

    Version information

    SAS currently supports API version 2020-06-01. This is a version identifier, not a calendar date. It includes the latest API updates and receives all future improvements.

    Version

    Description

    2020-06-01

    Recommended

    Online debugging

    Simple Application Server supports online API debugging in OpenAPI Explorer. Before calling an API, review the API version, endpoints, and available integration methods.

    For example, to call CreateInstances, select it from the API list in OpenAPI Explorer. Choose a region (such as cn-hangzhou) from the Service Address drop-down list. Configure parameters such as RegionId, ImageId, PlanId, Period (purchase duration), and AutoRenew, then click Initiate Call. The documentation pane displays API details, including billing, the 20-instance-per-account limit, and the QPS limit (10 calls per minute).

    Debugging page

    You can debug APIs at the following URL: https://api.alibabacloud.com/document/SWAS-OPEN/2020-06-01/overview

    Endpoints

    Simple Application Server is deployed across regions. Select the endpoint closest to your resources for the lowest latency. For example, in China (Qingdao), the public endpoint is swas.cn-qingdao.aliyuncs.com and the VPC endpoint is swas-vpc.cn-qingdao.aliyuncs.com.

    • Public endpoints are accessible from anywhere.

    • VPC endpoints are accessible only from within a VPC in the same region. Benefits:

      • Security: Traffic stays within the VPC.

      • Lower latency: Internal network routing avoids public internet congestion.

      • Lower cost: Internal network traffic only.

    Endpoints.

    Authentication

    When you log on to OpenAPI Explorer with your Alibaba Cloud account, API calls use that account's permissions by default. Your Alibaba Cloud account has full resource access, which poses a security risk. For routine API access, create and use a RAM user or RAM role with least-privilege permissions. The RAM user must have the required permissions to manage Simple Application Server resources. Create a RAM user.

    Identity

    Supported

    Alibaba Cloud account

    Yes

    RAM user (Recommended)

    Yes

    RAM role (Recommended)

    Yes

    Related topics

    Integration methods

    Note

    We recommend Alibaba Cloud SDKs as the easiest and best-supported integration method.

    Overview

    Calling method

    Supported

    Alibaba Cloud SDKs (Recommended)

    Yes

    Alibaba Cloud CLI

    No

    Terraform

    Yes

    Resource Orchestration Service (ROS)

    No

    Custom encapsulation

    Yes

    • Alibaba Cloud SDKs

      • Alibaba Cloud provides SDKs for Java, C#, Go, Python, Node.js/TypeScript, PHP, and C++. SDKs handle request signing, timeout management, and retries, and return structured response objects. Alibaba Cloud SDKs.

      • For supported languages and dependency installation, see Simple Application Server SDK.

    • Alibaba Cloud CLI

      • Alibaba Cloud CLI lets you manage resources from a terminal using aliyun commands. What is Alibaba Cloud CLI?.

      • Simple Application Server does not currently support Alibaba Cloud CLI. To request CLI support, submit a ticket.

    • Resource Orchestration Service

      • Resource Orchestration Service (ROS) simplifies cloud resource management through templates. Define your resources (such as ECS instances and ApsaraDB RDS instances) and their dependencies in a template, and ROS automatically provisions and configures them. What is Resource Orchestration Service?.

      • ROS does not currently support Simple Application Server.

    • Custom API encapsulation

      If the preceding methods do not meet your needs, you can construct HTTP requests and implement the request signature algorithm directly. See the API overview, V3 request structure and signature, and Custom encapsulation.

    Error handling

    If an API call returns an error, verify the request parameters against the error code. Simple Application Server - Error codes.

    For self-service troubleshooting, use the OpenAPI diagnostics tool with the request ID or SDK error message from the response.

    FAQ