ActionTrail は、視覚的なコンソールを提供し、OpenAPI Explorer によるオンラインデバッグ、Alibaba Cloud SDK、Resource Orchestration Service (ROS) など、複数の API 呼び出し方法をサポートしています。最適な連携方法を選択することで、開発効率を向上させることができます。
OpenAPI Explorer
OpenAPI Explorer は、開発者が API を迅速に学習し、使用できるようにするための包括的な Alibaba Cloud ツールです。インテリジェントな API 検索、ドキュメント、オンラインデバッグ、SDK 取得、コードサンプル、API 呼び出しエラーの診断、呼び出し統計を統合しています。OpenAPI Explorer を使用して、Alibaba Cloud サービスの API を呼び出し、API リクエストとレスポンスを確認できます。OpenAPI Explorer は、Alibaba Cloud 製品の利用を開始するための SDK サンプルコードも自動的に生成します。詳細については、「OpenAPI とは」をご参照ください。
バージョン
Alibaba Cloud は、主要な製品リリースの API を管理するためにバージョンを使用しています。ActionTrail は現在、API バージョン 2020-07-06 をサポートしています。文字列 2020-07-06 はバージョン識別子であり、日付ではありません。この識別子は最新の API 操作セットを表しており、API が廃止されたことを意味するものではありません。
|
バージョン |
説明 |
|
推奨 |
オンラインデバッグ
ActionTrail は、OpenAPI Explorer で API デバッグ機能を提供しています。API を呼び出す前に、ActionTrail で利用可能なバージョン、エンドポイント、連携方法を理解する必要があります。
OpenAPI Explorer の ActionTrail ページでは、左側メニューに、リージョン用の DescribeRegions やトレイル用の CreateTrail/DeleteTrail など、カテゴリ別に利用可能な API が一覧表示されます。中央のデバッグパネルでは、中国 (上海) などの [エンドポイント] を選択し、[AcceptLanguage] などのリクエストパラメータを設定してから、[呼び出しの開始] をクリックして API をオンラインでデバッグできます。右側のペインには、API の説明とパラメータのドキュメントが表示されます。
デバッグポータル
API デバッグポータルには、次の URL からアクセスできます：ActionTrail API デバッグリスト
エンドポイント
レイテンシーを最小限に抑えるため、リソースと同じリージョンのエンドポイントを選択してください。たとえば、中国 (張家口) リージョンでは、ActionTrail のパブリックエンドポイントは actiontrail.cn-zhangjiakou.aliyuncs.com で、VPC エンドポイントは actiontrail-vpc.cn-zhangjiakou.aliyuncs.com です。
-
パブリックエンドポイントは、グローバルにアクセス可能です。
-
VPC エンドポイントは、特定の Alibaba Cloud リージョンの VPC 内からのみアクセス可能です。メリット：
-
高いセキュリティ：VPC エンドポイントは VPC 内からのみアクセス可能です。
-
より高速なレスポンス：VPC エンドポイント経由のトラフィックは内部ネットワークを使用するため、レスポンスが通常より高速になり、パブリックネットワークのレイテンシーや帯域幅制限などの問題を回避できます。
-
低コスト：VPC エンドポイントは内部ネットワーク通信を使用します。
-
詳細については、「エンドポイント」をご参照ください。
アイデンティティ
Alibaba Cloud アカウントは完全な API アクセス権を持っていますが、セキュリティリスクが伴います。セキュリティを強化するため、API 呼び出しと日常的な運用保守には RAM ユーザーを使用することを推奨します。API を呼び出す前に、ビジネス要件に基づいて RAM ユーザーに権限を付与してください。RAM ユーザーには、ActionTrail リソースを管理する権限が必要です。詳細については、「RAM によるアクセス制御の使用」をご参照ください。
|
アイデンティティ |
サポート状況 |
|
はい |
|
|
RAM ユーザー (推奨) |
はい |
|
RAM ロール (推奨) |
はい |
関連情報
連携方法
Alibaba Cloud 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」をご参照ください。
-
Alibaba Cloud SDK を使用して、OpenAPI Explorer で ActionTrail API を呼び出すことができます。サポートされている言語と依存関係のインストール方法については、「ActionTrail SDK」をご参照ください。
-
-
Alibaba Cloud CLI
-
Alibaba Cloud CLI は、API 上に構築された汎用コマンドラインツールです。Alibaba Cloud CLI を使用して、Alibaba Cloud サービスを操作し、シェルで Alibaba Cloud リソースを管理できます。Alibaba Cloud CLI の詳細については、「Alibaba Cloud CLI とは」をご参照ください。
-
Alibaba Cloud CLI を使用して ActionTrail API を呼び出すことができます。
-
-
Resource Orchestration Service (ROS)
-
ROS は、クラウドリソース管理を簡素化する Alibaba Cloud サービスです。開発者と管理者は、テンプレートを記述して、Elastic Compute Service (ECS) インスタンスや ApsaraDB RDS インスタンスなどの必要な Alibaba Cloud リソースと、これらのリソース間の依存関係を定義できます。ROS オーケストレーションエンジンは、テンプレートに基づいてすべてのリソースを自動的に作成および設定し、自動化されたデプロイと運用保守を実現します。詳細については、「Resource Orchestration Service とは」をご参照ください。
-
ROS を使用して ActionTrail API を呼び出すことができます。詳細については、「ROS 連携の例」をご参照ください。
-
-
HTTP リクエストの直接送信
HTTP リクエストを直接送信する場合は、署名アルゴリズムを実装し、HTTP リクエストを自分で構築する必要があります。署名メカニズムの詳細については、「API の概要」および「V3 リクエストボディと署名メカニズム」をご参照ください。
注意事項
API 呼び出しが失敗した場合は、返されたエラーコードを使用して、リクエストパラメータとその値を確認してください。
また、OpenAPI Troubleshoot ページで、レスポンスのリクエスト ID または SDK エラー情報を使用してエラーを診断することもできます。
よくある質問
-
ActionTrail は、Alibaba Cloud アカウントのアクティビティを監視および記録するのに役立ちます。行動分析、セキュリティ分析、リソース変更追跡、コンプライアンス監査をサポートしています。詳細については、「ActionTrail とは」をご参照ください。
-
Java SDK に加えて、ActionTrail は C#、Go、Python、Node.js/TypeScript、PHP、C++ などの他のプログラミング言語向けの SDK もサポートしています。詳細については、「SDK リファレンス」をご参照ください。