すべてのプロダクト
Search

このプロダクト

    Auto Scaling:ApplyScalingGroup

    ドキュメントセンター

    Auto Scaling:ApplyScalingGroup

    最終更新日:May 22, 2026

    設定ファイルを使用してスケーリンググループを作成および管理します。ApplyScalingGroup 操作を呼び出すことで、設定ファイルを用いて効率的にスケーリンググループの作成および管理が可能です。

    操作説明

    ApplyScalingGroup 操作を呼び出すことで、Elastic Container Instance (ECI) タイプのスケーリンググループを簡単に作成できます。スケーリンググループのリソースは Kubernetes Deployment YAML ファイルで定義されます。また、この操作を呼び出して Kubernetes Deployment YAML ファイル内の ECI 用アノテーションを拡張することも可能です。詳細については、本トピックの「サポートされるアノテーション」をご参照ください。

    YAML ファイルとスケーリンググループのマッピング：YAML ファイル内の名前空間、kind、name の 3 要素（トリプレット）をスケーリンググループ名にマッピングできます。YAML ファイルとスケーリンググループは、同一リージョン内で一対一のマッピング関係を持ちます。たとえば、default 名前空間内の NGINX という名前の Kubernetes Deployment YAML ファイルを使用してリージョン内にスケーリンググループを作成した場合、マッピングされたスケーリンググループの一意の名前は k8s_default_Deployment_nginx となります。

    Kubernetes Deployment YAML ファイルを使用してスケーリンググループを管理する際は、以下のロジックに従います。

    • 既存のスケーリンググループがご利用の Kubernetes Deployment YAML ファイルとマッピング関係を持つ場合、その YAML ファイルを使用してスケーリンググループを更新できます。

    • ご利用の Kubernetes Deployment YAML ファイルとマッピング関係を持つスケーリンググループが存在しない場合、その YAML ファイルを使用して簡単にスケーリンググループを作成できます。

    1. Kubernetes Deployment YAML ファイル内に VPC、vSwitch、セキュリティグループ、またはアノテーションを指定しない場合、システムはデフォルト vSwitch を持つデフォルト VPC を作成し、Auto Scaling のデフォルトセキュリティグループ ess-default-sg を使用します。デフォルトでは、セキュリティグループルールにより、伝送制御プロトコル (TCP) ベースのポート 22 およびポート 3389 のトラフィックが許可され、IPv4 アドレスに対してインターネット制御通知プロトコル (ICMP) が有効になります。他のポートやプロトコルを有効にする場合は、カスタムセキュリティグループルールを作成してください。

    2. パブリックイメージを使用する場合は、インターネットアクセス機能を有効化し、k8s.aliyun.com/eci-with-eip Pod アノテーションを設定してエラスティック IP アドレス (EIP) 機能を有効にしてください。

    3. ApplyScalingGroup 操作を呼び出して Kubernetes Deployment YAML ファイルを適用すると、スケーリンググループは直ちに「有効」状態になり、スケーリング設定は直ちに「アクティブ」状態になります。YAML ファイル内で指定したレプリカ数が 0 より大きい場合、Elastic Container Instance が自動的に作成されます。

    サポートされるアノテーション

    アノテーションの詳細については、「ECI Pod Annotation」をご参照ください。

    アノテーション例説明
    k8s.aliyun.com/ess-scaling-group-min-size1作成するスケーリンググループの最小サイズです。デフォルト値：0。
    k8s.aliyun.com/ess-scaling-group-max-size20作成するスケーリンググループの最大サイズです。デフォルト値：レプリカ数の最大値または 30 のうち、大きい方。
    k8s.aliyun.com/eci-ntp-server100.100..ネットワーク時刻プロトコル (NTP) サーバーの IP アドレスです。
    k8s.aliyun.com/eci-use-specs2-4Gi2 vCPU および 4 GiB メモリの仕様です。詳細については、「複数の仕様を指定してポッドを作成する」をご参照ください。
    k8s.aliyun.com/eci-vswitchvsw-bp1xpiowfm5vo8o3c****vSwitch の ID です。複数の vSwitch を指定することで、複数のゾーンを指定できます。
    k8s.aliyun.com/eci-security-groupsg-bp1dktddjsg5nktv****セキュリティグループの ID です。このアノテーションを設定する前に、以下の要件にご注意ください。

    • 1 つ以上のセキュリティグループを指定できます。各スケーリンググループに対して最大 5 つのセキュリティグループを指定可能です。

    • 複数のセキュリティグループを指定する場合、それらは同一の VPC に属している必要があります。

    • 複数のセキュリティグループを指定する場合、それらは同一のタイプである必要があります。

    k8s.aliyun.com/eci-sls-enable"false"値を false に設定すると、ログ収集機能が無効になります。

    k8s.aliyun.com/eci-spot-strategy｜SpotAsPriceGo｜プリエンプティブルインスタンスの入札ポリシーです。有効値：

    • SpotWithPriceLimit：インスタンスは、最大時間単価が設定されたプリエンプティブルインスタンスとして作成されます。SpotWithPriceLimit を設定する場合は、k8s.aliyun.com/eci-spot-price-limit アノテーションを設定する必要があります。

    • SpotAsPriceGo: インスタンスはプリエンプティブルインスタンスとして作成され、購入時の市場価格が自動的に入札価格として使用されます。

    k8s.aliyun.com/eci-spot-price-limit｜"0.5"｜プリエンプティブルインスタンスの最大時間単価です。この値は小数点以下 3 桁まで指定可能です。 このアノテーションは、k8s.aliyun.com/eci-spot-strategy アノテーションを SpotWithPriceLimit に設定した場合にのみ有効になります。 k8s.aliyun.com/eci-with-eip｜"true"｜値を true に設定すると、各 Elastic Container Instance に対して自動的にエラスティック IP アドレス (EIP) が作成され、バインドされます。

    k8s.aliyun.com/eci-data-cache-bucket｜default｜データキャッシュのバケットです。データキャッシュに基づいてポッドを作成する場合は、このアノテーションを設定する必要があります。

    デフォルトでは ESSD (エンタープライズ SSD) が作成されます。デフォルト値：PL1。

    k8s.aliyun.com/eci-data-cache-provisionedIops｜"40000"｜ESSD AutoPL のプロビジョニング済み読み取り/書き込み IOPS です。有効値：0 ～ min{50000, 1000 × 容量 - ベースライン IOPS}。ベースライン IOPS = min{1800 + 50 × 容量, 50000}。詳細については、「ESSD AutoPL」をご参照ください。

    k8s.aliyun.com/eci-data-cache-burstingEnabled｜"true"｜ESSD AutoPL ディスクに対してバースト機能を有効化するかどうかを指定します。詳細については、「ESSD AutoPL」をご参照ください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ess:ApplyScalingGroup

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Content

    string

    必須

    設定ファイルの内容です。

    apiVersion: apps/v1 kind: Deployment metadata: name: nginx-deployment labels: app: nginx spec: replicas: 3 selector: matchLabels: app: nginx template: metadata: labels: app: nginx annotations: k8s.aliyun.com/eip-bandwidth: 10 k8s.aliyun.com/eci-with-eip: true spec: containers: - name: nginx image: nginx:1.14.2 ports: - containerPort: 80
    RegionId

    string

    任意

    リージョン ID です。

    cn-hangzhou

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答スキーマ

    RequestId

    string

    リクエスト ID です。

    CC107349-57B7-4405-B1BF-9BF5AF7F****
    ScalingGroupId

    string

    有効化されたスケーリンググループの ID です。

    asg-bp1igpak5ft1flyp****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "CC107349-57B7-4405-B1BF-9BF5AF7F****",
  "ScalingGroupId": "asg-bp1igpak5ft1flyp****"
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。