すべてのプロダクト
Search
ドキュメントセンター

Cloud Control API:Cloud Control API を使用したリソースの管理

最終更新日:Mar 22, 2025

このトピックでは、仮想プライベートクラウド (VPC) のライフサイクル全体にわたるリソースの管理を使用して、OpenAPI Explorer で Cloud Control API を呼び出す方法を示します。

前提条件

[OpenAPI Explorer] にログオンします。次の権限を持つ RAM ユーザー を使用することをお勧めします。

1. Cloud Control API を管理する権限。詳細については、「RAM ユーザーを管理する」をご参照ください。

2. VPC を管理する権限。詳細については、「RAM を使用して VPC 権限を管理する」をご参照ください。

手順

Cloud Control API を呼び出して、VPC の作成、アクセス、更新、リスト、および削除を実行できます。Cloud Control API を統合する必要がある場合は、OpenAPI Explorer のサンプル コードを参照してください。

1. VPC を作成する

  1. RAM ユーザーとして OpenAPI Explorer にログオンします。VPC の [リソース作成] をクリックし、regionId パラメーターと body パラメーターを設定して、[呼び出し開始] をクリックします。右側でサンプル コードの言語を選択できます。システムは参照用にコードを自動的に生成します。

    创建vpc.png

  2. 呼び出し開始後の結果を表示します。

    呼び出しでエラーが報告された場合は、ログ、API ドキュメント、または [診断]一般的なエラー コード を参照して原因を特定します。お問い合わせいただくこともできます。

    呼び出しが成功した場合は、返された結果の resourceId を記録します。状態コード 200 はリソース作成タスクが同期であることを示し、状態コード 202 はタスクが非同期であることを示します。返された taskId を使用してタスクをクエリします。

    説明

    同期操作と非同期操作は、タスク実行の 2 つのモードです。同期操作はタスクの完了後に返されるのに対し、非同期操作はタスクの完了を待たずに返される点が異なります。

    创建vpc返回.png

  3. この例では、返された状態コードは 202 で、非同期操作を示しています。taskId に基づいてタスク ステータスをクエリする必要があります。taskId を記録し、[タスクのクエリ] をクリックして [タスクの取得] ページに移動します。

    点击查询任务.png

  4. taskId を入力し、[呼び出し開始] をクリックします。呼び出し結果を表示します。呼び出しが成功すると、タスク ステータスが [成功] になり、VPC が作成されます。

    任务查询.png

  5. VPCコンソール で、作成された VPC を表示します。

    控制台查看.png

2. VPC リソースへのアクセス

[リソースの取得] ページで、リソース ID を入力し、regionId を選択して、通話を開始する をクリックします。呼び出しは成功し、リソース情報が返されます。

资源查询.png

3. VPC リソースを更新する

[リソースの更新] ページで、リソース ID を入力し、regionId を選択し、更新するパラメーターを入力して、[呼び出しを開始] をクリックします。更新されたリソースは、VPCコンソール で表示するか、CloudMonitor API を呼び出すことで表示できます。

资源更新.png

4. VPC をクエリする

[リソースの取得] ページで、regionId を選択し、通話を開始する をクリックします。呼び出し結果のリソースを表示します。

资源列举.png

5. VPC を削除する

  1. [リソースの削除] ページで、リソース ID を入力し、regionId を選択して、[呼び出し開始] をクリックします。通話を開始する

    资源删除.png

  2. 呼び出しが成功し、状態コード 202 が返された場合は、呼び出しが非同期であることを示します。

    taskId を入力し、[呼び出し開始] をクリックします。タスクステータスが Succeeded の場合は、VPC リソースが削除されたことを示します。通話を開始する

    删除任务查询.png

サンプルコード

サンプルコードリポジトリ: https://github.com/aliyun/cloud-control-api-demo

このリポジトリには、リソースメタデータをクエリし、クラウドリソースを管理するための Cloud Control API のサンプルコードが用意されています。