Cloud Governance Center は、視覚化された管理コンソールを提供し、OpenAPI Explorer または SDK を使用して API 操作を呼び出すことができます。Cloud Governance Center を使用した開発効率を向上させるには、ビジネス要件に基づいて適切な操作と統合方法を選択することをお勧めします。
API の概要
Alibaba Cloud は、開発者がさまざまな Alibaba Cloud サービスの API 操作を迅速かつ効率的に理解して使用できるように、OpenAPI Explorer を提供しています。OpenAPI Explorer は、インテリジェント検索、ドキュメント、オンラインデバッグ、SDK ダウンロード、サンプルコード、エラー診断、呼び出し統計など、API 操作に関連する複数の機能を提供します。OpenAPI Explorer では、Alibaba Cloud サービスの API 操作を呼び出し、API リクエストとレスポンスを表示できます。さらに、OpenAPI Explorer は、Alibaba Cloud サービスの使用を容易にするために、対応する SDK サンプルコードを自動的に生成します。詳細については、「API とは」をご参照ください。
API バージョン
Alibaba Cloud OpenAPI Explorer は、バージョン番号を使用してクラウドサービス API のバージョンを管理します。たとえば、Cloud Governance Center は現在、バージョン 2021-01-20 の API 操作をサポートしています。2021-01-20 は日付ではなく API のバージョン番号です。ユーザーには、API に関する最新のパブリック情報が表示されます。2021-01-20 は API の最終更新日ではありません。
API バージョン | 説明 |
推奨 |
オンラインデバッグ
OpenAPI Explorer は、Cloud Governance Center API のオンラインデバッグなどの複数の機能を提供します。リクエストを開始する前に、Cloud Governance Center API でサポートされている API バージョン、エンドポイント、統合方法などの関連情報を確認する必要があります。
デバッグページ
エンドポイント
リソースが存在するリージョンに基づいてエンドポイントを選択して、レイテンシを削減できます。たとえば、中国 (杭州) リージョンにおけるバージョン 2021-01-20 の Cloud Governance Center API のパブリックエンドポイントは governance.cn-hangzhou.aliyuncs.com で、Virtual Private Cloud (VPC) エンドポイントは governance-vpc.cn-hangzhou.aliyuncs.com です。
パブリックエンドポイントはグローバルにアクセスできます。
VPC エンドポイントは、特定の Alibaba Cloud リージョンの VPC 内からのみアクセスできます。VPC エンドポイントには次の利点があります。
セキュリティの向上: VPC エンドポイントは VPC 内からのみアクセスできます。これにより、セキュリティとプライバシーが向上します。
高速なレスポンス: VPC エンドポイントは内部ネットワーク環境を使用するため、パブリックエンドポイントよりも高速なレスポンスを提供します。さらに、VPC エンドポイントを使用することで、ネットワークレイテンシや帯域幅制限などの問題から解放されます。
低コスト: VPC エンドポイントは内部ネットワーク経由でアクセスされます。
詳細については、「エンドポイント」をご参照ください。
ユーザー ID
Alibaba Cloud アカウントを使用して OpenAPI Explorer にログインすると、OpenAPI Explorer はデフォルトで Alibaba Cloud アカウントを使用してオンラインデバッグを実行します。Alibaba Cloud アカウントには、すべての API 操作に対する権限があります。Alibaba Cloud アカウントを使用して API 操作をオンラインでデバッグすると、セキュリティリスクが発生する可能性があります。API 操作の呼び出しまたはルーチンの O&M は、Resource Access Management (RAM) ユーザーとして実行することをお勧めします。RAM ユーザーとして API 操作を呼び出す前に、ビジネス要件に基づいて必要な権限を RAM ユーザーに付与します。RAM ユーザーとして Cloud Governance Center の API 操作を呼び出すには、RAM ユーザーに Cloud Governance Center リソースを管理する権限が付与されている必要があります。詳細については、「RAM を使用したアクセスコントロール」をご参照ください。
ID | サポート |
はい | |
RAM ユーザー (推奨) | はい |
RAM ロール (推奨) | はい |
参照
統合方法
SDK はアプリケーションに簡単に統合でき、幅広い操作に対応しています。 API 操作を呼び出すには、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 Governance Center API を呼び出すことができます。サポートされている言語と依存関係のインストール方法の詳細については、OpenAPI Explorer の Cloud Governance Center のページをご覧ください。
Alibaba Cloud CLI
Alibaba Cloud CLI を使用すると、
aliyunコマンドを実行して、Alibaba Cloud サービスとやり取りし、クラウド サービス リソースを管理できます。詳細については、「Alibaba Cloud CLI とは」をご参照ください。Alibaba Cloud CLI を使用して Cloud Governance Center API を呼び出すことはできません。
ROS
ROS は、クラウドコンピューティングリソースを簡素化された方法で管理できる Alibaba Cloud サービスです。Elastic Compute Service (ECS) や ApsaraDB RDS インスタンスなどの必要な Alibaba Cloud リソースと、リソース間の依存関係を定義するテンプレートを作成できます。ROS エンジンは、テンプレートに基づいてスタック内のすべてのリソースを自動的に作成および構成し、自動化されたデプロイメントと O&M を実装します。詳細については、「ROS とは」をご参照ください。
ROS を使用して Cloud Governance Center API を呼び出すことはできません。
カスタムカプセル化
ネイティブ HTTP 呼び出しを行うには、カスタムリクエストを作成し、リクエストに署名する必要があります。署名メソッドの詳細については、「関数別の操作リスト」および「リクエスト構文と署名メソッド V3」をご参照ください。
使用方法
Cloud Governance Center の API 操作を呼び出した後にエラーが返された場合は、エラーコードに基づいて、関連するリクエストパラメータと値が有効かどうかを確認する必要があります。
また、返されたリクエスト ID または SDK エラー情報に基づいて、OpenAPI 問題診断 ページでセルフサービス診断を実行することもできます。
参考資料
Cloud Governance Center は、クラウドテクノロジーを使用してサービスを構築している、または構築したことのある企業向けに、リソース構造の計画と構築、ID および権限管理、コンプライアンス監査構成など、複数の機能を提供します。これにより、企業は安全で効率的、かつ管理しやすいクラウド環境を構築できます。詳細については、「Cloud Governance Center とは」をご参照ください。
Cloud Governance Center SDK でサポートされている言語の詳細については、「SDK の概要」をご参照ください。