Database Autonomy Service (DAS) は、ビジュアルコンソールと、OpenAPI Explorer、Alibaba Cloud SDK、Resource Orchestration Service (ROS) などのさまざまな統合方法を提供します。要件に最も適した方法を選択してください。
OpenAPI Explorer
OpenAPI Explorer は、API 検索、ドキュメント、オンラインデバッグ、SDK コードサンプル、エラー診断、および呼び出し統計を統合したプラットフォームです。さまざまな Alibaba Cloud サービスの API を呼び出し、リクエストとレスポンスを表示し、自動生成された SDK サンプルを使用してすぐに使い始めることができます。詳細については、「OpenAPI とは」をご参照ください。
バージョン
Alibaba Cloud OpenAPI は、バージョン番号を使用して、製品のメジャーバージョンごとに API を管理します。たとえば、DAS は現在、API バージョン 2020-01-16 をサポートしています。文字列 2020-01-16 は API バージョン番号を表し、日付ではありません。このバージョンは最新のパブリック API データを提供しており、2020-01-16 以降に API が更新されていないという意味ではありません。
|
バージョン番号 |
説明 |
|
推奨 |
オンラインデバッグ
DAS は、OpenAPI Explorer での API デバッグをサポートしています。API を呼び出す前に、バージョン、エンドポイント、統合方法の情報を確認してください。
OpenAPI Explorer では、左側メニューに API がカテゴリ別にリスト表示されます (例：[インスタンスアクセス] 配下の [AddHDMInstance])。中央のパネルでは、リージョン (例：[China (Shanghai)]) を選択し、リクエストパラメーターを設定できます。[呼び出しの開始] をクリックして、API をオンラインでデバッグします。右側のペインには、API ドキュメント、SDK サンプル、呼び出し結果が表示されます。
デバッグポータル
API をデバッグするには、オンラインデバッグページにアクセスしてください。
エンドポイント
DAS のサービスエンドポイントは、現在 China (Shanghai) リージョンでのみ利用可能です。パブリックエンドポイントは das.cn-shanghai.aliyuncs.com です。
-
パブリックエンドポイントは、グローバルにアクセス可能です。
-
Virtual Private Cloud (VPC) は、分離された仮想ネットワークです。VPC エンドポイントを使用すると、次のメリットがあります。
-
高いセキュリティ：VPC エンドポイントは VPC 内からのみアクセスできるため、セキュリティとプライバシーが強化されます。
-
高速なレスポンス時間：内部ネットワークを使用することで、VPC エンドポイントはパブリックエンドポイントよりも高速に応答し、パブリックネットワークの遅延や帯域幅の制限を回避できます。
-
低コスト：VPC エンドポイント経由の通信は内部ネットワーク上で行われるため、データ転送コストを削減できます。
-
サポート対象のユーザーアイデンティティ
デフォルトでは、OpenAPI Explorer はログイン中の Alibaba Cloud アカウントの権限を使用します。このアカウントは API への完全なアクセス権限を持つため、セキュリティ上のリスクがあります。API アクセスと日々の O&M のために RAM ユーザーを作成し、そのユーザーに DAS リソースの管理に必要な権限を付与することをお勧めします。詳細については、「RAM ユーザーとして DAS を使用する方法」をご参照ください。
|
ユーザーアイデンティティ |
サポート |
|
はい |
|
|
RAM ユーザー (推奨) |
はい |
|
RAM ロール (推奨) |
はい |
詳細情報
統合方法
DAS は、Alibaba Cloud SDK とカスタムカプセル化の 2 つの統合方法をサポートしています。
|
統合方法 |
サポート |
|
はい |
|
|
いいえ |
|
|
いいえ |
|
|
いいえ |
|
|
カスタムカプセル化 |
はい |
SDK の使用は、API 統合において最も簡単で、サポートも充実している方法です。このアプローチを強く推奨します。
-
Alibaba Cloud SDK
-
Alibaba Cloud は、Java、C#、Go、Python、Node.js/TypeScript、PHP、C++ などの複数のプログラミング言語向けの SDK を提供しています。SDK を統合すると、公開されているメソッドを使用して API を直接呼び出すことができます。SDK はリクエスト署名、タイムアウト、再試行を自動的に処理し、構造化されたレスポンスオブジェクトを返すことで、開発を簡素化します。詳細については、「Alibaba Cloud SDK」をご参照ください。
-
Alibaba Cloud SDK を使用して、DAS API を呼び出すことができます。対応言語と依存関係のインストール方法については、Database Autonomy Service (DAS) SDK をご参照ください。
-
-
Alibaba Cloud CLI
-
Alibaba Cloud CLI を使用すると、ターミナルで
aliyunコマンドを使用して Alibaba Cloud サービスを操作し、クラウドリソースを管理できます。 詳細については、「Alibaba Cloud CLI とは」をご参照ください。 -
Alibaba Cloud CLI を使用して DAS API を呼び出すことはできません。
-
-
Resource Orchestration Service (ROS)
-
リソースオーケストレーションサービス (ROS) は、クラウドリソースの管理を簡素化する Alibaba Cloud サービスです。 開発者および管理者は、テンプレートを作成して、ECS インスタンスや ApsaraDB for RDS インスタンスなどの必要な Alibaba Cloud リソースと、それらのリソース間の依存関係を定義できます。 ROS エンジンは、テンプレートに基づいてすべてのリソースを自動的に作成および設定し、デプロイと O&M を自動化します。 詳細については、「リソースオーケストレーションサービスとは」をご参照ください。
-
ROS を使用して DAS API を呼び出すことはできません。
-
-
カスタムカプセル化
この方法では、署名アルゴリズムを手動で実装し、カスタムリクエストを構築し、ネイティブ HTTP コールを行う必要があります。署名メカニズムの詳細については、「API 概要」および「V3 リクエストボディ & 署名メカニズム」をご参照ください。
注意事項
Database Autonomy Service (DAS) API コールがエラーを返した場合は、返されたエラーコードと照らし合わせてリクエストパラメーターを確認してください。 詳細については、「共通エラーコード」をご参照ください。
また、返されたリクエスト ID や SDK のエラー詳細を Alibaba Cloud OpenAPI Diagnostics で使用し、セルフサービスでのトラブルシューティングを行うこともできます。