すべてのプロダクト
Search

このプロダクト

    :ACK SDK for Javaの使用方法の例

    ドキュメントセンター

    :ACK SDK for Javaの使用方法の例

    最終更新日:Nov 14, 2024

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

    ステップ1: APIリファレンスを読む

    APIを呼び出す前に、「Create an ACK managed cluster」を読んで、APIパラメーターと必須パラメーターについて確認することを推奨します。 APIパラメーターの詳細については、「関数別の操作のリスト」をご参照ください。

    手順2: RAMユーザーを作成し、RAMユーザーに権限を付与する

    Alibaba Cloudアカウント、RAMユーザー、またはRAMロールを使用してAPIを呼び出すことができます。 これらのID間の違いの詳細については、「ID」をご参照ください。

    重要

    Alibaba Cloudアカウントには、すべてのAPI操作に対するアクセス権限があります。 RAMユーザーを使用してAPI操作を呼び出したり、ルーチンのO&Mを実行することを推奨します。

    1. RAMユーザーの作成

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

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

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

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

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

        RAMユーザーが作成されたら、RAMユーザーのユーザー名とパスワードを記録します。 APIを呼び出すときは、RAMユーザーを使用してOpenAPI Explorerコンソールにログインする必要があります。

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

      説明

      AliyunCSFullAccess: Container Service for Kubernetesに対する完全な権限を提供します。

      AliyunCSReadOnlyAccess: Container Service for Kubernetesに対する読み取り権限を付与します。

      カスタムポリシーの作成方法の詳細については、「RAM権限付与」をご参照ください。

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

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

    この例では、RAMユーザーを使用してCreateCluster APIを呼び出し、ACK Proクラスターを作成する方法を示します。 この例ではACK SDK for Javaを使用しています。 他のプログラミング言語にも同様の方法でSDKを使用できます。 詳細については、次をご参照ください： Container Service for Kubernetes ACK SDKに加えて、他のメソッドを使用してAPI操作を呼び出すことができます。 詳細については、「コールメソッド」をご参照ください。

    環境変数の設定

    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のサンプル値: 10.0.0.0/8

      • service_cidrのサンプル値: 172.21.0.0/20

      • vswitch_idsのサンプル値: vsw-2ze7hfp0ah8rk1nz9 ****

    3. 右側の [SDKサンプルコード] タブで、バージョン2.0を選択して言語を指定し、[プロジェクトのダウンロード] をクリックしてオンプレミスマシンにパッケージを解凍します。

      説明

      2.0バージョンの使用を推奨します。 バージョン1.0と2.0の違いについては、「Alibaba Cloud SDK V1.0およびV2.0」をご参照ください。

      image

    SDKデモの実行

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

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

      [サンプル] をダブルクリックします。 エラーがスローされないことを確認し、サンプルコードを実行します。

    3. 結果を表示します。

      コンソールの下部でstatusCodeを検索します。 "statusCode":202が表示された場合、API操作が呼び出され、ACKがクラスターを作成します。 ACKコンソールにログインし、[クラスター] ページに移動して、新しく作成されたクラスターを表示することもできます。 image