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

Container Service for Kubernetes:既存の ECS インスタンスの追加

最終更新日:Feb 28, 2026

既存の Elastic Compute Service (ECS) インスタンスを、Container Service for Kubernetes (ACK) クラスターのワーカーノードとして追加します。

リクエスト構文

POST /clusters/<cluster_id>/attach

<cluster_id> は、対象の ACK クラスターの ID に置き換えます。

CLI の使用例

aliyun cs POST /clusters/<cluster_id>/attach \
  --header "Content-Type=application/json" \
  --body "$(cat attach.json)"

ヘッダー

ヘッダー必須
Content-Typeはいapplication/json

リクエストボディ

リクエストボディを JSON ファイル(例: attach.json)で定義します。

パラメーター

パラメーター必須説明
instances文字列の配列はいクラスターに追加する ECS インスタンス ID。
password文字列いいえECS インスタンスのパスワード。長さは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。バックスラッシュ (\) およびダブルクォーテーション (") を含めることはできません。このパラメーターまたは key_pair のいずれかを指定する必要があります。
key_pair文字列いいえログイン用のキーペア名。このパラメーターまたは password のいずれかを指定する必要があります。
format_diskブール値いいえコンテナーのデータおよびイメージをデータディスク上に保存するかどうかを指定します。デフォルト値は false です。このパラメーターを true に設定し、インスタンスにデータディスクがアタッチされている場合、ディスク上の既存のデータはすべてクリアされます。
tags配列いいえノードに適用するタグ。
ECS インスタンスの認証には、password または key_pair のいずれかを指定してください。

{
    "password": "ECSpassword1234",
    "instances": ["i-2zee3oiwcyoz7kwd****", "i-2ze0lgm3y6iylcbt****"],
    "format_disk": false,
    "key_pair": "",
    "tags": []
}

レスポンス

正常なリクエストでは、各インスタンスの結果を含む list 配列と、操作の進捗をトラックするための task_id を含む JSON オブジェクトが返されます。

レスポンスパラメーター

パラメーター説明
list配列各 ECS インスタンスの処理結果。
list[].code文字列ステータスコード。"200" の場合、成功を示します。
list[].instanceId文字列ECS インスタンス ID。
list[].message文字列処理結果の説明。
task_id文字列非同期タスクの ID。この ID を使用してタスクの進捗をトラックできます。

{
    "list": [
        {
            "code": "200",
            "instanceId": "i-2zee3oiwcyoz7kwd****",
            "message": "successful"
        },
        {
            "code": "200",
            "instanceId": "i-2ze0lgm3y6iylcbt****",
            "message": "successful"
        }
    ],
    "task_id": "T-5a544aff80282e39ea000039"
}