このトピックでは、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 ペアがある場合は、このステップをスキップしてください。
RAM ユーザーを作成します。Alibaba Cloud アカウントで RAM コンソールにログインします。
左側のナビゲーションウィンドウで、[Identities] > [Users] を選択します。
[ユーザー] ページで、[ユーザーの作成] をクリックします。
[ユーザーの作成] ページで、[ログオン名] および [表示名] を設定し、[アクセスモード] を [コンソールアクセス] に設定します。
[OK] をクリックします。ユーザー名とパスワードを記録してください — これらは、後で OpenAPI Explorer コンソールにログインする際に使用します。
RAM ユーザーに [AliyunCSFullAccess] 権限を付与します。手順については、「RAM ユーザーに権限を付与する」をご参照ください。
説明[AliyunCSFullAccess] は Container Service for Kubernetes (ACK) の完全な権限を提供します。[AliyunCSReadOnlyAccess] は読み取り専用のアクセス権を提供します。カスタム権限ポリシーについては、「RAM 認可」をご参照ください。
ユーザー詳細ページで、[認証] タブをクリックし、次に [AccessKey の作成] をクリックして AccessKey ペアを生成します。
ステップ 3: API の呼び出し
この例では、ACK SDK for Java を使用して、CreateCluster API オペレーションを呼び出して ACK Pro マネージドクラスターを作成します。他の言語向け SDK も同様に機能します。サポートされている SDK の完全な一覧については、「Container Service for Kubernetes SDK」をご参照ください。代替の呼び出し方法については、「呼び出し方法」をご参照ください。
環境変数の設定
AccessKey 認証情報は、ソースコードにハードコーディングするのではなく、環境変数として保存してください。設定手順については、「Linux、macOS、および Windows での環境変数の設定」をご参照ください。
SDK デモのダウンロード
CreateCluster API Explorer にアクセスします。CreateCluster
[パラメーター] タブで、以下のサンプル値を入力し、[呼び出しを開始] をクリックします:
パラメーター サンプル値 nametestregion_idcn-beijingcluster_typeManagedKubernetescluster_specack.pro.smallcluster_version1.30.1-aliyun.1vpcidvpc-2zedl8cyb7tnkaux1****container_cidr10.0.0.0/8service_cidr172.21.0.0/20vswitch_idsvsw-2ze7hfp0ah8rk1nz9****「SDK サンプルコード」タブで、「バージョン 2.0」を選択し、「Java」を言語として選択して、「プロジェクトのダウンロード」をクリックします。ダウンロードしたパッケージをローカルマシンに展開します。
説明SDK version 2.0 を使用してください。version 1.0 と 2.0 の比較については、「Alibaba Cloud SDK V1.0 と V2.0」をご参照ください。

SDK デモの実行
IntelliJ IDEA を開き、[ファイル] > [開く] の順に選択して、展開したプロジェクトフォルダを選択します。 Maven が依存関係のインストールを完了するまで待ちます。
[Sample] をダブルクリックしてエントリクラスを開きます。エラーが表示されないことを確認し、サンプルコードを実行します。
IDE の下部にあるコンソール出力で、
statusCodeを検索します。"statusCode":202を含む応答は、API 呼び出しに成功し、ACK がクラスターを作成していることを意味します。
クラスターが作成されていることを確認するには、ACK コンソール にログインし、[クラスター] ページに移動して、新しく作成されたクラスターを表示します。