Container Service SDK の使用 - Container Service for Kubernetes - Alibaba Cloud ドキュメントセンター

ステップ 1：API ドキュメントの確認

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

ステップ 2：RAM ユーザーの作成と権限の付与

この操作を呼び出すには、Alibaba Cloud アカウント、RAM ユーザー、または RAM ロールを使用できます。これらのアイデンティティの違いの詳細については、「アイデンティティ」をご参照ください。

重要

セキュリティのため、API 呼び出しと日常業務には RAM ユーザーを作成して使用することを推奨します。

RAM ユーザーを作成します。
1. Alibaba Cloud アカウントで RAM コンソールにログインします。
2. 左側のナビゲーションペインで、認証情報管理 > User を選択します。
3. User ページで、ユーザーの作成 をクリックします。
4. ユーザーの作成 ページで、ログイン名 と 表示名 を設定し、アクセス方法 に パスワードによるコンソールログイン を選択します。
5. OK をクリックします。
  
  RAM ユーザーが作成されたら、ログイン名とパスワードを記録してください。Alibaba Cloud OpenAPI Developer Portal にログインして OpenAPI を呼び出す際に必要になります。
RAM ユーザーに AliyunCSFullAccess 権限を付与します。詳細については、「RAM ユーザーの権限管理」をご参照ください。

説明
AliyunCSFullAccess：Container Service for Kubernetes を管理する権限。

AliyunCSReadOnlyAccess：Container Service for Kubernetes の読み取り専用権限。

カスタムポリシーを作成する必要がある場合は、「認可情報」をご参照ください。
RAM ユーザーの詳細ページで、認証タブに移動し、AccessKey の作成 をクリックします。詳細については、「AccessKey を作成する」をご参照ください。

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

この例では、RAM ユーザーを使用して CreateCluster API を呼び出して、Java SDK でACK Pro クラスターを作成します。他の言語の SDK も同様の方法で使用できます。詳細については、「Container Service for Kubernetes (ACK) SDK」をご参照ください。他の呼び出し方法も使用できます。詳細については、「操作の呼び出し方法」をご参照ください。

環境変数の設定

操作を呼び出す前に、認証情報を取得するために環境変数を設定する必要があります。詳細については、「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 の例：10.0.0.0/8
- service_cidr の例：172.21.0.0/20
- vswitch_ids の例：vsw-2ze7hfp0ah8rk1nz9****
[SDKサンプル] タブで、SDK バージョン 2.0 と希望するプログラミング言語を選択し、[プロジェクトをダウンロード] をクリックします。ダウンロードが完了したら、ローカルマシンでパッケージを解凍します。

説明
SDK V2.0 の使用を推奨します。V1.0 と V2.0 の違いの詳細については、「SDK V1.0 と SDK V2.0 の違い」をご参照ください。

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

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..."
  }
}
```