このトピックでは、Cloud Control API で使用される基本的な用語について説明します。
リソースメタデータ
リソースメタデータには、リソースの属性、タイプ、関係、および動作が含まれます。すべてのリソース管理は、リソースメタデータに基づいて実装されます。GetResourceType は、指定されたリソースのメタデータを取得し、レスポンスパラメータのメタデータを解釈するのに役立ちます。
リソースメタデータの情報は、基本情報、属性、および指定されたリソースの拡張情報の 3 つの部分に分けることができます。
基本情報には、リソースの名前、関連付けられているサービス、説明、デプロイメントレベル、および課金方法が含まれます。
属性には、特定のリソース属性の説明、非公開操作パラメータのコレクション、および機密属性のコレクションが含まれます。
拡張情報には、権限付与ポリシー、スロットリングポリシー、クォータなど、権限付与とリソース容量の情報が含まれます。
親リソースと子リソース
親リソースと子リソースは、同じプロダクトが所有するリソース間の依存関係を記述するために使用される論理的な概念です。親リソースには子リソースが含まれ、子リソースは親リソースに属します。リソースの異なる階層間の論理的な関係は、子リソースでリソース管理を実装するのに役立ちます。
リソースが親リソースに属しているかどうかを判断する方法
リソースメタデータの resourceType が ****/**** 形式の場合、リソースは親リソースに属します。たとえば、ApsaraDB for Redis には、DBInstance という名前の ApsaraDB for Redis インスタンスと、DBInstance/Account という名前のデータベースアカウントが含まれています。データベースアカウントの resourceType が DBInstance/Account の場合、データベースアカウントは親リソースに属します。親リソースの resourceType は DBInstance で、これは ApsaraDB for Redis インスタンスです。
親リソースに属するリソースでリソース管理を実行する方法
API 操作を呼び出して、親リソースに属するリソースでリソース管理を実行する場合、リクエストパスに親リソースの情報を追加する必要があります。詳細については、「API ディレクトリ」のリクエストパラメータの requestPath をご参照ください。
同期操作と非同期操作
同期操作と非同期操作は、タスク実行の 2 つのモードです。違いは、同期操作はタスクが完了した後に返されるのに対し、非同期操作はタスクが完了するのを待たずに返されることです。
ほとんどの場合、リソースのクエリ、リストまたは更新、メタデータのクエリなどの Cloud Control API 操作は同期的に処理されます。リソースの作成や削除などの時間のかかるタスクは、サービスの安定性を向上させるために非同期的に処理されます。
非同期タスクを作成するために Cloud Control API 操作を呼び出したときに状態コード「202」が返された場合は、GetTask 操作を呼び出して、非同期タスクのステータスをクエリできます。