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

Container Service for Kubernetes:Java SDK 呼び出し例

最終更新日:Mar 26, 2026

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

前提条件

開始する前に、以下を確認してください。

  • Alibaba Cloud アカウントまたは RAM ユーザー — 呼び出し元の ID には API アクセスが必要です。Alibaba Cloud アカウント (root ユーザー) はすべての API オペレーションへの完全なアクセス権を持ちます。日常の運用保守 (O&M) には RAM ユーザーを使用してください。詳細については、「ID」をご参照ください。

  • 「AliyunCSFullAccess 権限」— このポリシーを、API を呼び出す RAM ユーザーに付与します。読み取り専用アクセスの場合は、代わりに AliyunCSReadOnlyAccess を付与します。

  • AccessKey ペア — RAM ユーザーの詳細ページの [認証] タブで作成します。手順については、「AccessKey ペアの作成」をご参照ください。

  • Java と IntelliJ IDEA — OpenAPI Explorer からダウンロードした SDK デモプロジェクトを実行するために必要です。

  • Maven — デモプロジェクトは Maven を使用して依存関係を管理します。

ステップ 1: API リファレンスの確認

API を呼び出す前に、ACK マネージドクラスターの作成をお読みいただき、必須パラメーターとオプションパラメーターについてご理解ください。ACK API オペレーションの完全なリストについては、関数別のオペレーションリストをご参照ください。

ステップ 2: RAM ユーザーの設定

すでに [AliyunCSFullAccess] 権限を持つ RAM ユーザーと AccessKey ペアがある場合は、このステップをスキップしてください。

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

  2. 左側のナビゲーションウィンドウで、[Identities] > [Users] を選択します。

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

  4. [ユーザーの作成] ページで、[ログオン名] および [表示名] を設定し、[アクセスモード] を [コンソールアクセス] に設定します。

  5. [OK] をクリックします。ユーザー名とパスワードを記録してください — これらは、後で OpenAPI Explorer コンソールにログインする際に使用します。

  6. RAM ユーザーに [AliyunCSFullAccess] 権限を付与します。手順については、「RAM ユーザーに権限を付与する」をご参照ください。

    説明

    [AliyunCSFullAccess] は Container Service for Kubernetes (ACK) の完全な権限を提供します。[AliyunCSReadOnlyAccess] は読み取り専用のアクセス権を提供します。カスタム権限ポリシーについては、「RAM 認可」をご参照ください。

  7. ユーザー詳細ページで、[認証] タブをクリックし、次に [AccessKey の作成] をクリックして AccessKey ペアを生成します。

ステップ 3: API の呼び出し

この例では、ACK SDK for Java を使用して、CreateCluster API オペレーションを呼び出して ACK Pro マネージドクラスターを作成します。他の言語向け SDK も同様に機能します。サポートされている SDK の完全な一覧については、「Container Service for Kubernetes SDK」をご参照ください。代替の呼び出し方法については、「呼び出し方法」をご参照ください。

環境変数の設定

AccessKey 認証情報は、ソースコードにハードコーディングするのではなく、環境変数として保存してください。設定手順については、「Linux、macOS、および Windows での環境変数の設定」をご参照ください。

SDK デモのダウンロード

  1. CreateCluster API Explorer にアクセスします。CreateCluster

  2. [パラメーター] タブで、以下のサンプル値を入力し、[呼び出しを開始] をクリックします:

    パラメーターサンプル値
    nametest
    region_idcn-beijing
    cluster_typeManagedKubernetes
    cluster_specack.pro.small
    cluster_version1.30.1-aliyun.1
    vpcidvpc-2zedl8cyb7tnkaux1****
    container_cidr10.0.0.0/8
    service_cidr172.21.0.0/20
    vswitch_idsvsw-2ze7hfp0ah8rk1nz9****
  3. SDK サンプルコード」タブで、「バージョン 2.0」を選択し、「Java」を言語として選択して、「プロジェクトのダウンロード」をクリックします。ダウンロードしたパッケージをローカルマシンに展開します。

    説明

    SDK version 2.0 を使用してください。version 1.0 と 2.0 の比較については、「Alibaba Cloud SDK V1.0 と V2.0」をご参照ください。

    image

SDK デモの実行

  1. IntelliJ IDEA を開き、[ファイル] > [開く] の順に選択して、展開したプロジェクトフォルダを選択します。 Maven が依存関係のインストールを完了するまで待ちます。

  2. [Sample] をダブルクリックしてエントリクラスを開きます。エラーが表示されないことを確認し、サンプルコードを実行します。

  3. IDE の下部にあるコンソール出力で、statusCode を検索します。"statusCode":202 を含む応答は、API 呼び出しに成功し、ACK がクラスターを作成していることを意味します。

    image

  4. クラスターが作成されていることを確認するには、ACK コンソール にログインし、[クラスター] ページに移動して、新しく作成されたクラスターを表示します。