Cloud Config は、GUI コンソールを提供するだけでなく、OpenAPI、Alibaba Cloud SDK、Alibaba Cloud CLI などの操作方法も提供します。開発効率を向上させるために、要件に最適な操作および統合方法を選択することを推奨します。
OpenAPI Explorer
Alibaba Cloud は、クラウドサービス API を迅速に学習し、使用できるように OpenAPI Explorer を提供しています。このオールインワンプラットフォームは、API 検索、ドキュメント、オンラインデバッグ、SDK 生成、コードサンプル、エラー診断、および呼び出し統計を統合しています。OpenAPI Explorer を使用して、さまざまな Alibaba Cloud サービスの API を呼び出し、リクエストとレスポンスを確認できます。このプラットフォームは、SDK サンプルコードを自動的に生成し、迅速な利用開始を支援します。詳細については、「OpenAPI とは」をご参照ください。
バージョン
Alibaba Cloud API は、異なるリリースを管理するためにバージョン管理を行っています。Cloud Config は現在、API バージョン 2020-09-07 をサポートしています。この値はバージョン識別子であり、日付ではありません。このバージョンの API は常に最新のデータを提供し、2020-09-07 に固定されたものではありません。
|
バージョン |
説明 |
|
推奨 |
オンラインデバッグ
OpenAPI Explorer を使用して、Cloud Config API をオンラインでデバッグできます。API を呼び出す前に、API バージョン、エンドポイント、および利用可能な統合方法を把握しておく必要があります。
例えば、ListSupportedProducts 操作をデバッグするには、OpenAPI Explorer の左側のナビゲーションペインから選択します。中央のパネルで、[Service endpoint] ドロップダウンリストから中国 (上海) などのリージョンを選択します。パラメーターセクションで、ページネーション用の NextToken に文字列を入力し、MaxResults に最大 500 までの整数を入力します。[Send Request] をクリックして API をデバッグします。
デバッグポータル
Cloud Config API をデバッグするには、次のページにアクセスしてください：Cloud Config API デバッグ
エンドポイント
Cloud Config のエンドポイントは、リージョンではなく、ご利用のアカウントのサイトによって異なります。次の表に、利用可能なエンドポイントを示します。
|
サイト |
リージョン |
リージョン ID |
パブリックエンドポイント |
VPC エンドポイント |
IPv6 |
|
中国サイト |
中国 (上海) |
cn-shanghai |
config.cn-shanghai.aliyuncs.com |
config-vpc.cn-shanghai.aliyuncs.com |
config-dualstack.cn-shanghai.aliyuncs.com |
|
国際サイト |
シンガポール |
ap-southeast-1 |
config.ap-southeast-1.aliyuncs.com |
config-vpc.ap-southeast-1.aliyuncs.com |
サポートされていません |
ユーザーアイデンティティ
Alibaba Cloud アカウントで OpenAPI Explorer にログインすると、API の呼び出しでは、デフォルトでそのアカウントが使用されます。Alibaba Cloud アカウントはリソースへのフルアクセス権限を持つため、セキュリティリスクが生じます。API 呼び出しと日常的な操作には、制限された権限を持つ RAM ユーザーを作成して使用することを強く推奨します。API を呼び出す前に、RAM ユーザーには Cloud Config リソースを管理するために必要な権限を付与しておく必要があります。詳細については、「RAM を使用したアクセス制御」をご参照ください。
|
アイデンティティ |
サポート状況 |
|
サポート |
|
|
RAM ユーザー (推奨) |
サポート |
|
RAM ロール (推奨) |
サポート |
詳細情報
統合方法
API を呼び出すには、SDK を使用することを推奨します。SDK は、最も簡単な統合方法と最も包括的なサポートを提供します。
サポートされている方法
|
方法 |
サポート状況 |
|
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 を使用して Cloud Config API を呼び出すことができます。サポートされている言語のリストと依存関係のインストール手順については、Cloud Config SDK をご参照ください。
-
-
Alibaba Cloud CLI
-
Alibaba Cloud CLI (コマンドラインインターフェイス) は、API をベースに構築された汎用ツールであり、コマンドラインから Alibaba Cloud サービスを管理できます。Alibaba Cloud CLI を使用して、サービスを操作し、スクリプト内でタスクを自動化できます。詳細については、「Alibaba Cloud CLI とは」をご参照ください。
-
Alibaba Cloud CLI を使用して Cloud Config API を呼び出すことができます。
-
-
Resource Orchestration Service (ROS)
-
Resource Orchestration Service (ROS) は、クラウドリソース管理を簡素化する Alibaba Cloud サービスです。開発者と管理者は、テンプレートを作成し、ECS インスタンスや RDS データベースインスタンスなどの必要な Alibaba Cloud リソース、およびリソース間の依存関係を定義できます。ROS オーケストレーションエンジンは、テンプレートに基づいてすべてのリソースを自動的に作成および設定し、自動化されたデプロイと運用管理を実現します。詳細については、「Resource Orchestration Service とは」をご参照ください。
-
Resource Orchestration Service (ROS) は、Cloud Config API の呼び出しをサポートしていません。
-
-
直接 HTTP リクエスト
直接 HTTP リクエストを行う場合は、署名アルゴリズムを実装し、リクエストを構築して、HTTP リクエストを送信する必要があります。署名メカニズムの詳細については、「Cloud Config API の概要」および「V3 リクエストボディと署名メカニズム」をご参照ください。
注意事項
Cloud Config API 呼び出しでエラーが返された場合は、返されたエラーコードを使用して、リクエストパラメーターと値を確認してください。
また、レスポンスに含まれるリクエスト ID または SDK エラーメッセージを使用して、Alibaba Cloud OpenAPI 診断プラットフォーム でセルフサービス診断を実行することもできます。
よくある質問
-
Cloud Config は、クラウドリソースの監査を支援するサービスです。設定履歴を追跡し、ポリシーへの準拠状況を評価できます。これにより、インフラストラクチャを監視し、継続的なコンプライアンスを維持することが可能になります。詳細については、「Cloud Config とは」をご参照ください。
-
Java に加えて、C#、Go、Python、Node.js/TypeScript、PHP、C++ 向けの SDK も利用できます。詳細については、「SDK リファレンス」をご参照ください。