Cloud Config は、視覚的な操作のためのコンソールと、OpenAPI Explorer、Alibaba Cloud SDK、Alibaba Cloud Command Line Interface (CLI) を含む、API 操作を呼び出すための複数の方法を提供します。Cloud Config を使用して開発効率を向上させるには、ビジネス要件に基づいて適切な 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 サンプルコードを自動的に生成します。詳細については、「API とは」をご参照ください。
バージョンの説明
Alibaba Cloud API は、バージョン番号を使用してクラウドサービス API のバージョンを管理します。たとえば、Cloud Config は 2020-09-07 バージョンの API をサポートしています。2020-09-07 は日付ではなく API バージョン番号です。ユーザーには、API に関する最新の公開情報が提供されます。2020-09-07 は Cloud Config API の最新バージョンです。
バージョン | 説明 |
推奨 |
オンラインデバッグ
Cloud Config は、OpenAPI Explorer で API デバッグなどの機能を提供します。API 操作を呼び出す前に、Cloud Config によって提供される次の情報に注意してください。バージョン、エンドポイント、および統合方法。
デバッグページ
OpenAPI Explorer にアクセスします。
エンドポイント
Cloud Config エンドポイントは、リージョンではなく、中国サイトまたは国際サイトのどちらを使用しているかによって異なります。次の表に、さまざまなサイトの Cloud Config エンドポイントを示します。
サイト | リージョン | リージョン ID | パブリックエンドポイント | VPC エンドポイント | IPV6 |
中国サイト (aliyun.com) | 中国 (上海) | cn-shanghai | config.cn-shanghai.aliyuncs.com | config-vpc.cn-shanghai.aliyuncs.com | config-dualstack.cn-shanghai.aliyuncs.com |
国際サイト (alibabacloud.com) | シンガポール | ap-southeast-1 | config.ap-southeast-1.aliyuncs.com | config-vpc.ap-southeast-1.aliyuncs.com | サポートされていません |
ユーザー ID
デフォルトでは、Alibaba Cloud アカウントを使用して OpenAPI Explorer にログインすると、その Alibaba Cloud アカウントがオンラインデバッグの実行に使用されます。Alibaba Cloud アカウントは、すべての API 操作に対する権限を持っています。Alibaba Cloud アカウントを使用して API 操作を呼び出すと、セキュリティリスクが発生する可能性があります。RAM ユーザーを使用して API 操作を呼び出したり、日常的な O&M を実行することを強くお勧めします。RAM ユーザーを使用して API 操作を呼び出す前に、ビジネス要件に基づいて必要な権限を RAM ユーザーに付与します。RAM ユーザーは、Cloud Config リソースを管理するための権限を持っている必要があります。詳細については、「RAM を使用してアクセスコントロールを実装する」をご参照ください。
ID | サポート |
はい | |
RAM ユーザー (推奨) | はい |
RAM ロール (推奨) | はい |
参考資料
統合方法
SDK はアプリケーションと簡単に統合でき、最も幅広い操作をカバーしています。SDK を使用して API 操作を呼び出すことをお勧めします。
統合方法の概要
呼び出し方法 | サポート |
Alibaba Cloud SDK (推奨) | はい |
はい | |
いいえ | |
はい |
Alibaba Cloud SDK
Alibaba Cloud は、Java、C#、Go、Python、TypeScript、Node.js、PHP、C++ など、複数のプログラミング言語で SDK を提供しています。アプリケーションに SDK を統合して、API 操作を直接呼び出すことができます。SDK は、データ署名ロジック、タイムアウトメカニズム、リトライメカニズムなど、さまざまな情報をカプセル化します。SDK は、開発を容易にするために、仕様に基づいて構造化されたレスポンスオブジェクトを返します。詳細については、「Alibaba Cloud SDK」をご参照ください。
Alibaba Cloud SDK を使用して、Cloud Config の API 操作を呼び出すことができます。サポートされている言語と依存関係の詳細については、OpenAPI Explorer にアクセスしてください。
Alibaba Cloud CLI
Alibaba Cloud CLI は、Alibaba Cloud API に基づいて開発された汎用コマンドラインツールです。Alibaba Cloud CLI を使用すると、シェルツールを使用して Alibaba Cloud サービスと対話し、Alibaba Cloud サービスを管理できます。Alibaba Cloud CLI の詳細については、「Alibaba Cloud CLI とは」をご参照ください。
Alibaba Cloud CLI を使用して、Cloud Config の API 操作を呼び出すことができます
ROS
ROS は、クラウドコンピューティングリソースの管理を簡素化できる Alibaba Cloud サービスです。Elastic Compute Service (ECS) インスタンスや ApsaraDB RDS インスタンスなどの必要なクラウドコンピューティングリソースと、リソース間の関係を記述するテンプレートを作成できます。ROS は、テンプレートに基づいてすべてのリソースを自動的に作成および構成し、自動化されたデプロイと O&M を実装します。詳細については、「ROS とは」をご参照ください。
ROS を使用して Cloud Config の API 操作を呼び出すことはできません。
カスタムカプセル化 API 呼び出し
ネイティブ HTTP 呼び出しを行うには、カスタムリクエストを作成し、リクエストに署名する必要があります。署名メカニズムの詳細については、「関数別の操作リスト」および「リクエスト構文と署名方式 V3」をご参照ください。
注意事項
Cloud Config の API 操作を呼び出した後にエラーが返された場合は、返されたエラーコードに基づいて、入力パラメーターと値が有効かどうかを確認してください。
OpenAPI 問題診断 ページで、返されたリクエスト ID または SDK エラー情報に基づいてセルフサービス診断を実行することもできます。
FAQ
Cloud Config は、リソースの構成変更を追跡し、構成コンプライアンスを評価できるリソース監査サービスです。Cloud Config は、多数のリソースを評価し、クラウドインフラストラクチャの継続的なコンプライアンスを維持するのに役立ちます。詳細については、「Cloud Config とは」をご参照ください。
Alibaba Cloud は、Java の SDK に加えて、C#、Go、Python、TypeScript、Node.js、PHP、C++ など、複数のプログラミング言語で SDK を提供しています。詳細については、「SDK リファレンス」をご参照ください。