すべてのプロダクト
Search

このプロダクト

    Cloud Control API:OpenAPI Explorer での Cloud Control API を使用したクラウドリソースの管理

    ドキュメントセンター

    Cloud Control API:OpenAPI Explorer での Cloud Control API を使用したクラウドリソースの管理

    最終更新日:Feb 28, 2026

    このガイドでは、OpenAPI Explorer を使用して Cloud Control API 経由でクラウドリソースを管理する方法を説明します。Virtual Private Cloud (VPC) を例に、リソースに対する作成、取得、更新、一覧表示、削除といったライフサイクル全体の操作を実行する方法を学びます。

    前提条件

    • RAM ユーザー：セキュリティのため、Alibaba Cloud アカウントの代わりに Resource Access Management (RAM) ユーザーを使用することを推奨します。詳細については、「RAM ユーザーの作成」をご参照ください。

    • 必要な権限：次のポリシーを RAM ユーザーにアタッチします：

    API 操作の概要

    Cloud Control API は、標準化された操作を使用してリソースを管理します。このチュートリアルでは、プロダクトコードが VPC でリソースタイプが VPC である VPC のための、以下のコア操作について説明します：

    • CreateResource：新しいリソースを作成します。

    • GetResource：特定のリソースの詳細を取得します。

    • UpdateResource：既存のリソースを変更します。

    • ListResources：リージョン内の特定のタイプのリソースをすべて一覧表示します。

    • DeleteResource：リソースを削除します。

    同期操作と非同期操作

    Cloud Control API は、2 つの方法で応答できます：

    • 同期 (ステータス 200)：操作は即座に完了し、応答本文に結果が含まれます。

    • 非同期 (ステータス 202)：操作は受け付けられ、バックグラウンドで実行されます。応答は taskId を返します。この taskId を使用して GetTask 操作を呼び出し、タスクの最終的なステータスを確認する必要があります。

    操作手順

    ステップ 1: VPC の作成

    1. RAM ユーザーとして OpenAPI Explorer にログインし、VPC の CreateResource ページに移動します。パラメーターセクションで regionId を指定し、body でリソースのプロパティを定義します。その後、[呼び出し開始] をクリックします。

      创建vpc.png

    2. [応答] タブで応答を確認します。

      呼び出しが失敗した場合は、[診断] をクリックするか、一般的なエラーコード を使用してトラブルシューティングを行います。サポートに お問い合わせ いただくことも可能です。

      呼び出しが成功すると、ステータスコード 200 (同期操作) または 202 (非同期操作) が返されます。応答本文から、次のステップのために taskId と resourceId をコピーします。

      创建vpc返回.png

    3. この例では、状態コードは 202 であり、これは非同期操作であることを示しています。taskId を記録し、[タスクのクエリ] をクリックして、タスククエリページに移動します。

      点击查询任务.png

    ステップ 2: 作成タスクのステータスの確認

    1. GetTask ページに移動します。前のステップで取得した taskId を taskId フィールドに貼り付け、[呼び出し開始] をクリックします。タスクの status が Succeeded であることを確認します。

      任务查询.png

    2. また、VPCコンソール に移動して作成を確認することもできます。

      控制台查看.png

    ステップ 3: VPC 詳細の取得

    GetResource ページに移動します。ステップ 1 でコピーした resourceId と正しい regionId を入力します。[呼び出し開始] をクリックして、新しい VPC の詳細を取得します。

    资源查询.png

    ステップ 4: VPC の更新

    UpdateResource ページに移動します。resourceId と regionId を指定します。body で、変更したいプロパティ (例：Description) を指定します。[呼び出し開始] をクリックし、VPCコンソール で更新を確認します。

    资源更新.png

    ステップ 5: VPC の一覧表示

    GetResources ページに移動します。 regionId を選択し、[呼び出しの開始] をクリックします。 応答には、リソースのリストに作成した VPC が含まれます。

    资源列举.png

    ステップ 6: VPC の削除

    1. リソースをクリーンアップするには、DeleteResource ページに移動します。作成した VPC の resourceId と regionId を入力し、[呼び出し開始] をクリックします。

      资源删除.png

    2. 呼び出しが成功すると、ステータスコード 202 と新しい taskId が返されます。

      再度 GetTask 操作を使用して、この削除タスクのステータスを確認します。ステータスが Succeeded であれば、VPC が削除されたことを確認できます。

      删除任务查询.png

    サンプルコード

    Cloud Control API をプログラムで使用する方法の詳細については、GitHub の公式サンプルコードをご参照ください：Cloud Control API Demo Repository。