Simple Application Server (SAS)は、視覚化された管理コンソールを提供し、OpenAPI Explorer または SDK を使用して API 操作を呼び出すことができます。 Simple Application Serverを使用して開発効率を向上させるには、ビジネス要件に基づいて適切な API 操作と統合方法を使用することをお勧めします。このトピックでは、シンプルアプリケーションサーバー API と API の統合方法について説明します。
OpenAPI Explorer の概要
Alibaba Cloud は、開発者がさまざまな Alibaba Cloud サービスの API 操作を迅速かつ効率的に理解して使用できるように、OpenAPI Explorer を提供しています。 OpenAPI Explorer は、インテリジェント検索、ドキュメント、オンラインデバッグ、SDK ダウンロード、サンプルコード、エラー診断、呼び出し統計など、API 操作に関連する複数の機能を統合しています。 OpenAPI Explorer では、Alibaba Cloud サービスの API 操作を呼び出し、API リクエストとレスポンスを表示できます。 さらに、OpenAPI Explorer は、Alibaba Cloud サービスの使用を容易にするために、対応する SDK サンプルコードを自動的に生成します。 Simple Application Serverは、サーバー、ディスク、イメージ、キーペア、ファイアウォールに関連する API 操作を提供します。 OpenAPI Explorer を使用して、Alibaba Cloud リソースを管理できます。 詳細については、API とは を参照してください。
バージョンの説明
Alibaba Cloud OpenAPI は、バージョン番号管理メカニズムを使用して、さまざまな段階でのクラウドサービス API の反復を制御します。 たとえば、シンプルアプリケーションサーバーは、バージョン 2020-06-01 の API 操作のリストをサポートしています。 2020-06-01 はバージョン番号であり、API 操作の実際のリリース日ではありません。 バージョンの API データは最新であり、継続的に更新され、これまでのすべての改善と追加が含まれています。
バージョン | 説明 |
推奨 |
オンラインデバッグ
OpenAPI Explorer は、Simple Application Server API のオンラインデバッグを提供します。 API 操作を呼び出す前に、Simple Application Server API 操作のバージョン、エンドポイント、および統合方法を理解する必要があります。
デバッグページ
API デバッグページ：https://api.alibabacloud.com/document/SWAS-OPEN/2020-06-01/overview
エンドポイント
シンプルアプリケーションサーバーは、複数のリージョンでサポートされています。 関連リソースが配置されているリージョンに基づいてサービスエンドポイントを選択して、最低のレイテンシを実現できます。 たとえば、中国 (青島) の Simple Application Server のパブリックエンドポイントは swas.cn-qingdao.aliyuncs.com で、VPC エンドポイントは swas-vpc.cn-qingdao.aliyuncs.com です。
パブリックエンドポイントはグローバルにアクセスできます。
VPC エンドポイントは、対応する Alibaba Cloud リージョンの VPC 内からのみアクセスできます。 VPC エンドポイントには、次の利点があります。
高いセキュリティ：VPC エンドポイントは、VPC 内からのみアクセスできます。 これにより、セキュリティとプライバシーが向上します。
高速応答：VPC エンドポイントは、VPC 経由でデータを送信できるため、パブリックエンドポイントよりも高速な応答を提供します。 さらに、ネットワークレイテンシや帯域幅の制限などの問題を防ぐことができます。
低コスト：VPC エンドポイントは、内部ネットワーク経由でアクセスされます。
詳細については、エンドポイント を参照してください。
ユーザー ID
デフォルトでは、Alibaba Cloud アカウントを使用して OpenAPI Explorer にログオンすると、Alibaba Cloud アカウントを使用してオンラインデバッグが実行されます。 Alibaba Cloud アカウントは、すべての API 操作に対する権限を持っています。 Alibaba Cloud アカウントを使用して API 操作を呼び出すと、セキュリティリスクが発生する可能性があります。 RAM ユーザー または RAM ロール を作成して使用して、API 操作を呼び出したり、日常的な O&M を実行することをお勧めします。 RAM ユーザーとして API 操作を呼び出す前に、ビジネス要件に基づいて RAM ユーザーに必要な権限を付与します。 RAM ユーザーは、クラウドバックアップリソースを管理するための権限を持っている必要があります。 詳細については、RAM ユーザーの作成とクラウドバックアップへのアクセス権限の付与 を参照してください。
ID | サポートされている |
はい | |
RAM ユーザー (推奨) | はい |
RAM ロール (推奨) | はい |
参照
統合方法
SDK はアプリケーションと簡単に統合でき、最も幅広い API 操作をカバーしています。 SDK を使用して API 操作を呼び出すことをお勧めします。
統合方法の概要
呼び出し方法 | サポートされている |
Alibaba Cloud SDK (推奨) | はい |
いいえ | |
はい | |
いいえ | |
はい |
Alibaba Cloud SDK
Alibaba Cloud は、Java、C#、Go、Python、Node.js、TypeScript、PHP、C++ など、複数のプログラミング言語で SDK を提供しています。 SDK をアプリケーションと統合して、API 操作を直接呼び出すことができます。 SDK は、署名ロジック、タイムアウトメカニズム、再試行メカニズムなどの情報をカプセル化し、仕様に基づいて構造化されたレスポンスオブジェクトを返します。 これにより、開発者の利便性が向上します。 詳細については、Alibaba Cloud SDK を参照してください。
Alibaba Cloud SDK を使用して、Simple Application Server の API 操作を呼び出すことができます。 サポートされているプログラミング言語と依存関係のインストール方法については、シンプルアプリケーションサーバー SDK を参照してください。
Alibaba Cloud CLI
Alibaba Cloud CLI を使用すると、
aliyunコマンドを実行して Alibaba Cloud サービスと対話し、クラウドサーバッチリソースを管理できます。 詳細については、Alibaba Cloud CLI とは を参照してください。Alibaba Cloud CLI は、Simple Application Server API 操作の呼び出しをサポートしていません。 Alibaba Cloud CLI を使用する場合は、チケットを送信してください。
ROS
ROS は、クラウドコンピューティングリソースの管理を簡素化する Alibaba Cloud サービスです。 テンプレートを作成して、Elastic Compute Service (ECS) インスタンスや ApsaraDB RDS インスタンスなどの必要なクラウドコンピューティングリソースと、リソース間の依存関係を記述できます。 ROS は、テンプレートに基づいてすべてのリソースを自動的に作成および構成し、自動化されたデプロイと O&M を実装します。 詳細については、ROS とは を参照してください。
ROS は、Simple Application Server API 操作の呼び出しをサポートしていません。
カスタム API カプセル化
上記のソリューションのいずれも要件を満たしていない場合は、API リクエストをカプセル化できます。 ネイティブ HTTP 呼び出しを行うには、カスタムリクエストを作成し、リクエストに署名する必要があります。 署名メカニズムの詳細については、関数別の操作リスト と リクエスト構文と署名方式 V3 を参照してください。 カスタム API カプセル化の詳細については、カスタムカプセル化 を参照してください。
使用上の注意
Simple Application Server API 操作の呼び出し後にエラーが返された場合は、エラーコードに基づいて、リクエストパラメーターとその値が正しいかどうかを確認する必要があります。 詳細については、シンプルアプリケーションサーバー - エラーコード を参照してください。
返されたリクエスト ID または SDK エラー情報に基づいて、OpenAPI 問題診断 ページでセルフサービス診断を実行することもできます。
参照
シンプルアプリケーションサーバーの詳細については、シンプルアプリケーションサーバーとは を参照してください。
シンプルアプリケーションサーバーでサポートされている機能の詳細については、機能 を参照してください。