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

Container Service for Kubernetes:Java SDK を使用した ACK API の呼び出し

最終更新日:Sep 01, 2026

このトピックでは、SDK を使用して OpenAPI 操作を呼び出し、ACK マネージドクラスターを作成する方法について説明します。ACK マネージドクラスター。

手順1:API ドキュメントの確認

API を呼び出す前に、「OpenAPI を使用した ACK マネージドクラスターの作成」を参照し、必要なパラメーターと権限を確認します。パラメーターの詳細については、「API の概要」をご参照ください。

手順2:RAM ユーザーの作成と権限の付与

このオペレーションは、Alibaba Cloud アカウント、RAM ユーザー、または RAM ロールで呼び出すことができます。違いについては、「アイデンティティ」をご参照ください。

重要

Alibaba Cloud アカウントはすべての API にアクセスできます。セキュリティのため、API の呼び出しや日常のオペレーションには RAM ユーザーを作成して使用することを推奨します。

  1. RAM ユーザーを作成します。

    1. Alibaba Cloud アカウントで RAM コンソールにログインします。

    2. 左側のナビゲーションペインで、認証情報管理 > User を選択します。

    3. User ページで、ユーザーの作成 をクリックします。

    4. ユーザーの作成 ページで、ログイン名 と 表示名 を設定し、アクセス方法 で パスワードによるコンソールログイン を選択します。

    5. OK をクリックします。

      作成後、OpenAPI Developer Portal へのログインに使用するログイン名とパスワードを控えておきます。

  2. RAM ユーザーに AliyunCSFullAccess 権限を付与します。詳細については、「RAM ユーザーの権限管理」をご参照ください。

    説明

    AliyunCSFullAccess:Container Service for Kubernetes へのフルアクセス権限。

    AliyunCSReadOnlyAccess:Container Service for Kubernetes への読み取り専用アクセス権限。

    カスタムポリシーを作成するには、「権限付与に関する情報」をご参照ください。

  3. RAM ユーザーの詳細ページで、認証 タブに移動し、AccessKey の作成 をクリックします。詳細については、「AccessKey の作成」をご参照ください。

手順3:API の呼び出し

この例では、Java SDK を使用して RAM ユーザーとして CreateCluster を呼び出し、ACK Pro クラスターを作成します。他の言語については、「Container Service for Kubernetes (ACK) SDK」をご参照ください。他の呼び出し方法については、「オペレーションの呼び出し方法」をご参照ください。

環境変数の設定

API を呼び出す前に、認証情報用の環境変数を設定します。詳細については、「Linux、macOS、および Windows での環境変数の設定」をご参照ください。

SDK サンプルコードのダウンロード

  1. CreateCluster に移動します。

  2. パラメーター セクションで、必要なパラメーターを指定し、[呼び出し開始] をクリックします。

    • name のパラメーター値の例:test

    • region_id のパラメーター値の例:cn-beijing

    • cluster_type のパラメーター値の例:ManagedKubernetes

    • cluster_spec のパラメーター値の例:ack.pro.small

    • cluster_version のパラメーター値の例:1.30.1-aliyun.1

    • vpcid のパラメーター値の例:vpc-2zedl8cyb7tnkaux1****

    • container_cidr のパラメーター値の例:172.16.0.0/12

    • service_cidr のパラメーター値の例:172.21.0.0/20

    • vswitch_ids のパラメーター値の例:vsw-2ze7hfp0ah8rk1nz9****

  3. [SDK サンプル] タブで、SDK バージョン 2.0 と言語を選択し、[プロジェクトのダウンロード] をクリックします。ダウンロードしたパッケージを解凍します。

    説明

    SDK V2.0 を使用してください。バージョンの比較については、「SDK V1.0 と SDK V2.0 の違い」をご参照ください。

    [パラメーター] タブで name、region_id、cluster_type、cluster_spec、cluster_version などのパラメーターを指定すると、コードペインで選択した言語のサンプルコードが自動的に生成されます。

SDK サンプルコードの実行

  1. IntelliJ IDEA を開きます。[File] > [Open] に移動し、プロジェクトフォルダーを選択して、Maven が依存関係をインストールするのを待ちます。

  2. サンプルコードを実行します。

    Sample ファイルをダブルクリックし、エラーが表示されないことを確認して実行します。

  3. 結果の確認

    下部のコンソールで statusCode を探します。"statusCode": 202 は、呼び出しが成功し、クラスターの作成が開始されたことを示します。新しいクラスターは、ACK コンソール の クラスターリスト ページで表示できます。

    {
      "headers": {
        "content-type": "application/json;charset=utf-8",
        "access-control-expose-headers": "*",
        "x-acs-trace-id": "30c74bc83a7fae0a081e5f5846be703e"
      },
      "statusCode": 202,
      "body": {
        "clusterId": "c6104ee21d6304ef8..."
      }
    }