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

Auto Scaling:ApplyScalingGroup

最終更新日:Sep 17, 2026

設定ファイルを使用して、Elastic Container Instance (ECI) ベースのスケーリンググループを作成および管理します。ApplyScalingGroup 操作の呼び出しにより、この機能を実装します。

操作説明

操作の説明

ApplyScalingGroup は、Kubernetes Deployment リソース定義フォーマットでの ECI ベースのスケーリンググループの迅速な作成をサポートします。ECI インスタンスは、Kubernetes YAML 拡張アノテーションもサポートしています。詳細については、本トピックの「サポートされているアノテーション」セクションを参照してください。

YAML 設定とスケーリンググループのマッピング: スケーリンググループ名は、YAML 設定で定義された namespacekindname の 3 つの組によってマッピングされます。同一リージョン内では、同じ YAML 設定は 1 つのスケーリンググループにのみマッピングできます。例: デフォルト名前空間で namenginx に設定された Deployment YAML 設定を使用する場合、同じリージョン内の k8s_default_Deployment_nginx という名前のスケーリンググループにマッピングされます。

YAML 設定に基づくスケーリンググループの管理ロジック:

  • YAML 設定によってマッピングされたスケーリンググループが存在する場合、スケーリンググループは YAML 設定に基づいて更新されます。

  • YAML 設定によってマッピングされたスケーリンググループが存在しない場合、YAML 設定に基づいてスケーリンググループが作成されます。

注意事項

  • YAML 設定で VPC、vSwitch、またはセキュリティグループのアノテーションが指定されていない場合、システムはデフォルト VPC、VPC 内のデフォルト vSwitch、およびデフォルト Auto Scaling セキュリティグループ (ess-default-sg) を自動作成します。セキュリティグループポリシーは、デフォルトで TCP ポート 22 および 3389 と ICMP (IPv4) プロトコルを開放します。他のポートプロトコルが必要な場合は、それに応じてセキュリティグループポリシーを調整してください。

  • パブリックイメージを使用する場合、パブリックネットワークアクセスを有効にする必要があります。k8s.aliyun.com/eci-with-eip pod annotation を設定して、EIP 機能を有効にします。

  • ApplyScalingGroup が YAML 設定を適用した後、スケーリンググループとスケーリング設定はすぐに有効になります。replicas が 0 より大きい値に設定されている場合、リソースの自動作成がトリガーされます。

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

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

パラメーター説明
k8s.aliyun.com/ess-scaling-group-min-size1スケーリンググループ内のインスタンスの最小値。デフォルト値: 0。
k8s.aliyun.com/ess-scaling-group-max-size20スケーリンググループ内のインスタンスの最大値。デフォルト値: max(replicas, 30)。
k8s.aliyun.com/eci-ntp-server100.100..NTP サーバー。
k8s.aliyun.com/eci-use-specs2-4Gi2 vCPU および 4 GiB メモリのスペック。詳細については、複数のスペックを持つ Pod の作成 を参照してください。
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 に設定します。SLS CRD を使用してログを収集する場合、特定の Pod でログ収集が不要な場合は、このアノテーションを設定してログ収集機能を無効にし、Logtail の自動作成によるリソースの無駄を回避します。
k8s.aliyun.com/eci-spot-strategySpotAsPriceGoスポットインスタンスの入札ポリシー。必要に応じて設定します。SpotWithPriceLimit: スポットインスタンスのカスタム値幅制限を設定します。k8s.aliyun.com/eci-spot-price-limit も設定する必要があります。SpotAsPriceGo: システムは現在のマーケットプレイス価格に基づいて自動的に入札します。
k8s.aliyun.com/eci-spot-price-limit"0.5"スポットインスタンスの 1 時間あたりの最大価格。値は 10 進数 3 桁まで正確に指定できます。このパラメーターは、k8s.aliyun.com/eci-spot-strategySpotWithPriceLimit に設定されている場合にのみ有効です。
k8s.aliyun.com/eci-with-eip"true"EIP を自動作成してアタッチするには、このパラメーターを true に設定します。
k8s.aliyun.com/eci-data-cache-bucketdefaultデータキャッシュバケット。データキャッシュを使用して Pod を作成する場合、このパラメーターは必須です。
k8s.aliyun.com/eci-data-cache-plPL1データキャッシュに基づいて作成されたクラウドディスクのパフォーマンスレベル (PL)。デフォルトでは ESSD が使用され、デフォルトの PL は PL1 です。
k8s.aliyun.com/eci-data-cache-provisionedIops"40000"ESSD AutoPL クラウドディスクのプロビジョニングされた読み取り/書き込み IOPS。有効な値: 0 ~ min{50000, 1000 × capacity - ベースラインパフォーマンス}。ここで、ベースラインパフォーマンス = min{1800 + 50 × capacity, 50000} です。詳細については、ESSD AutoPL クラウドディスク を参照してください。このアノテーションが追加されると、データキャッシュに基づいて作成されたクラウドディスクは ESSD AutoPL クラウドディスクになります。
k8s.aliyun.com/eci-data-cache-burstingEnabled"true"ESSD AutoPL クラウドディスクのバースト (バースト機能) を有効にするかどうかを指定します。詳細については、ESSD AutoPL クラウドディスク を参照してください。このアノテーションが追加されると、データキャッシュに基づいて作成されたクラウドディスクは ESSD AutoPL クラウドディスクになります。
k8s.aliyun.com/eci-custom-tags"env:test,name:alice"アタッチするタグ文字列。最大 3 つのタグをアタッチできます。タグキーとタグ値はコロン (:) で区切り、複数のタグはカンマ (,) で区切ります。

今すぐお試しください

この 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

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ClientToken

string

任意

リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを使用でき、長さは 64 文字を超えることはできません。詳細については、How to ensure idempotence を参照してください。

123e4567-e89b-12d3-a456-42665544****

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 アノテーション: k8s.aliyun.com/eip-bandwidth: 10 k8s.aliyun.com/eci-with-eip: true spec: コンテナ: - name: nginx イメージ: nginx:1.14.2 ポート: - コンテナポート: 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****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 IdempotentParameterMismatch The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

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

変更履歴

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