このトピックでは、SDK を使用して OpenAPI 操作を呼び出し、ACK マネージドクラスターを作成する方法について説明します。ACK マネージドクラスター。
手順1:API ドキュメントの確認
API を呼び出す前に、「OpenAPI を使用した ACK マネージドクラスターの作成」を参照し、必要なパラメーターと権限を確認します。パラメーターの詳細については、「API の概要」をご参照ください。
手順2:RAM ユーザーの作成と権限の付与
このオペレーションは、Alibaba Cloud アカウント、RAM ユーザー、または RAM ロールで呼び出すことができます。違いについては、「アイデンティティ」をご参照ください。
Alibaba Cloud アカウントはすべての API にアクセスできます。セキュリティのため、API の呼び出しや日常のオペレーションには RAM ユーザーを作成して使用することを推奨します。
-
RAM ユーザーを作成します。
-
Alibaba Cloud アカウントで RAM コンソールにログインします。
-
左側のナビゲーションペインで、 を選択します。
-
User ページで、ユーザーの作成 をクリックします。
-
ユーザーの作成 ページで、ログイン名 と 表示名 を設定し、アクセス方法 で パスワードによるコンソールログイン を選択します。
-
OK をクリックします。
作成後、OpenAPI Developer Portal へのログインに使用するログイン名とパスワードを控えておきます。
-
-
RAM ユーザーに AliyunCSFullAccess 権限を付与します。詳細については、「RAM ユーザーの権限管理」をご参照ください。
説明AliyunCSFullAccess:Container Service for Kubernetes へのフルアクセス権限。
AliyunCSReadOnlyAccess:Container Service for Kubernetes への読み取り専用アクセス権限。
カスタムポリシーを作成するには、「権限付与に関する情報」をご参照ください。
-
RAM ユーザーの詳細ページで、認証 タブに移動し、AccessKey の作成 をクリックします。詳細については、「AccessKey の作成」をご参照ください。
手順3:API の呼び出し
この例では、Java SDK を使用して RAM ユーザーとして CreateCluster を呼び出し、ACK Pro クラスターを作成します。他の言語については、「Container Service for Kubernetes (ACK) SDK」をご参照ください。他の呼び出し方法については、「オペレーションの呼び出し方法」をご参照ください。
環境変数の設定
API を呼び出す前に、認証情報用の環境変数を設定します。詳細については、「Linux、macOS、および Windows での環境変数の設定」をご参照ください。
SDK サンプルコードのダウンロード
-
CreateCluster に移動します。
-
パラメーター セクションで、必要なパラメーターを指定し、[呼び出し開始] をクリックします。
-
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****
-
-
[SDK サンプル] タブで、SDK バージョン 2.0 と言語を選択し、[プロジェクトのダウンロード] をクリックします。ダウンロードしたパッケージを解凍します。
説明SDK V2.0 を使用してください。バージョンの比較については、「SDK V1.0 と SDK V2.0 の違い」をご参照ください。
[パラメーター] タブで
name、region_id、cluster_type、cluster_spec、cluster_versionなどのパラメーターを指定すると、コードペインで選択した言語のサンプルコードが自動的に生成されます。
SDK サンプルコードの実行
-
IntelliJ IDEA を開きます。[File] > [Open] に移動し、プロジェクトフォルダーを選択して、Maven が依存関係をインストールするのを待ちます。
-
サンプルコードを実行します。
Sample ファイルをダブルクリックし、エラーが表示されないことを確認して実行します。
-
結果の確認
下部のコンソールで
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..." } }