ModifyNodePoolAttribute - App Streaming - Alibaba Cloud ドキュメントセンター

配信グループの弾性モードを変更します。固定数量（弾力的スケーリングなし）、スケジュールされたスケーリング、自動スケーリングが含まれます。

操作説明

設定項目で WUYING Cloud Application リソースの弾性パターンを設定できます。

固定数量：弾力的スケーリングは使用されません。
自動スケーリング：接続された会話の数および会話未接続の持続時間に基づいてリソースを自動的にスケーリングします。
スケジュールされたスケーリング：指定された日時の指定された期間にリソースのスケーリングを実行します。

このメソッドを使用する前に、WUYING Cloud Application の課金方法と料金を十分にご確認ください。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

appstreaming:ModifyNodePoolAttribute

update

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ProductType	string	任意	プロダクトタイプ。列挙値: CloudApp : WUYING Cloud Application。	CloudApp。
PoolId	string	任意	リソースグループの ID。	rg-ew7va2g1wl3vm****
NodeCapacity	integer	任意	同時接続可能な会話数、つまり単一リソースに同時に接続できる会話の数です。同時に接続される会話が多すぎると、アプリケーションのエクスペリエンスが低下する可能性があります。有効値はリソース仕様によって異なります。各リソース仕様の有効値は以下のとおりです。 appstreaming.general.4c8g: 1～2。 appstreaming.general.8c16g: 1～4。 appstreaming.vgpu.8c16g.4g: 1～4。 appstreaming.vgpu.8c31g.16g: 1～4。 appstreaming.vgpu.14c93g.12g: 1～6。	2
NodePoolStrategy	object	任意	配信グループの自動スケーリング戦略。
StrategyType	string	任意	弾性モード。説明 `NODE_FIXED`（固定数量）：サブスクリプションおよび従量課金リソースに適用されます。 `NODE_SCALING_BY_USAGE`（自動スケーリング）：サブスクリプションおよび従量課金リソースに適用されます。 `NODE_SCALING_BY_SCHEDULE`（スケジュールされたスケーリング）：従量課金リソースにのみ適用されます。列挙値: NODE_FIXED : 固定数量（弾力的スケーリングなし） NODE_SCALING_BY_SCHEDULE : スケジュールされたスケーリング。 NODE_SCALING_BY_USAGE : 自動スケーリング。	NODE_FIXED。
NodeAmount	integer	任意	購入したリソースの数。有効な値: 1～100。説明リソースがサブスクリプションリソースの場合、このパラメーターは変更済みにはできません。リソースが従量課金リソースの場合、弾性モード（`StrategyType`）が固定数量（`NODE_FIXED`）または自動スケーリング（`NODE_SCALING_BY_USAGE`）にセットされているときに、このパラメーターを変更できます。	1
MaxScalingAmount	integer	任意	スケールアウト時に作成できるリソースの最大値。`StrategyType` が `NODE_SCALING_BY_USAGE` にセットされている場合、このパラメーターは必須です。	10
MaxIdleAppInstanceAmount	integer	任意	アイドル状態の会話の上限。この値を指定すると、会話の使用量が `ScalingUsageThreshold` を超え、かつ現在の配信グループ内のアイドル状態の会話数が `MaxIdleAppInstanceAmount` 未満の場合にのみ、自動スケールアウトがトリガーされます。それ以外の場合は、配信グループ内のアイドル状態の会話が十分であるとみなされ、自動スケールアウトはトリガーされません。このパラメーターを使用することで、弾力的なスケールアウト動作を柔軟にコントロールし、コストを削減できます。	3
ScalingStep	integer	任意	各スケールアウト操作で作成されるリソースの数。有効な値: 1～10。`StrategyType` が `NODE_SCALING_BY_USAGE` に設定されている場合、このパラメーターは必須です。	2
ScalingUsageThreshold	string	任意	会話使用量の上限しきい値（%）。会話の使用量がこのしきい値を超えると、自動スケールアウトがトリガーされます。会話使用量の数式は「会話使用量 = 現在の会話数 ÷ (総リソース数 × リソースあたりの同時会話数) × 100%」です。`StrategyType` が `NODE_SCALING_BY_USAGE` に設定されている場合、このパラメーターは必須です。有効な値: 0～100。デフォルト値: 85。	85
ScalingDownAfterIdleMinutes	integer	任意	会話未接続のリソースが保持される最大値（分単位）。リソースに会話が接続されていない場合、ここで指定された持続時間に基づいてカウントダウンが開始されます。カウントダウンが終了すると、スケールインが完了します。有効な値: 5～120。デフォルト値: 5。以下の例外が適用されます。スケールインによって再度自動スケールアウトがトリガーされる場合、繰り返しのスケールインおよびスケールアウト操作を避けるため、スケールインは実行されません。この期間中に会話の増加により自動スケールアウトがトリガーされた場合、リソースは当初の計画どおりにはスケールインされず、カウントダウンが再開されます。	5
StrategyEnableDate	string	任意	戦略が効果を持つ日付。フォーマット: yyyy-MM-dd。この日付は現在の日付以降である必要があります。`StrategyType`（弾性モード）が `NODE_SCALING_BY_SCHEDULE`（スケジュールされたスケーリング）にセットされている場合、このパラメーターは必須です。	2023-01-05
StrategyDisableDate	string	任意	戦略の効果が切れる日付。フォーマット: yyyy-MM-dd。有効期限と発効日の間隔は 7 日から 1 年の間（両端を含む）である必要があります。`StrategyType`（弾性モード）が `NODE_SCALING_BY_SCHEDULE`（スケジュールされたスケーリング）にセットされている場合、このパラメーターは必須です。	2023-01-19
WarmUp	boolean	任意	リソースプリフェッチポリシーを有効にするかどうかを指定します。`StrategyType`（弾性モード）が `NODE_SCALING_BY_SCHEDULE`（スケジュールされたスケーリング）に設定されている場合、このパラメーターは必須です。	false。
RecurrenceSchedules	array<object>	任意	戦略実行サイクルのリスト。`StrategyType`（弾性モード）が `NODE_SCALING_BY_SCHEDULE`（スケジュールされたスケーリング）に設定されている場合、このパラメーターは必須です。
	array<object>	任意	戦略実行サイクル。
RecurrenceType	string	任意	戦略実行サイクルのタイプ。`RecurrenceType` と `RecurrenceValues` の両方を指定する必要があります。列挙値: weekly : weekly（スケジュールされたタスクは毎週指定された曜日に実行されます）	weekly。
RecurrenceValues	array	任意	戦略実行サイクルの値のリスト。
	integer	任意	戦略実行サイクルの値。列挙値: 1 : 月曜日。 2 : 火曜日。 3 : 水曜日。 4 : 木曜日。 5 : 金曜日。 6 : 土曜日。 7 : 日曜日。	1
TimerPeriods	array<object>	任意	戦略実行サイクルの時間のセットのリスト。時間のセット設定の要件：最大 3 つの時間のセットを追加できます。時間のセットを重複させることはできません。時間のセットの間隔は 5 分以上である必要があります。単一の時間のセットの持続時間は 15 分以上である必要があります。すべての時間のセットを合わせても日をまたぐスパンにすることはできません。
	object	任意	戦略実行サイクルの時間のセット。
StartTime	string	任意	開始時刻。フォーマット: HH:mm。	12:00
EndTime	string	任意	終了時刻。フォーマット: HH:mm。	15:00
Amount	integer	任意	リソース数。	2
BizRegionId	string	任意	配信グループのリージョン ID。サポートされているリージョンの詳細については、「使用制限」をご参照ください。列挙値: cn-shanghai : 中国（上海） cn-hangzhou : 中国（杭州）	cn-hangzhou。

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
RequestId	string	リクエスト ID。	1CBAFFAB-B697-4049-A9B1-67E1FC5F****
Code	string	リクエストが失敗した場合に返されるエラーコード。	InvalidParameter.PoolId
Message	string	リクエストが失敗した場合に返されるエラーメッセージ。	パラメーター PoolId が有効ではありません。

例

成功レスポンス

JSONJSON

{
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "Code": "InvalidParameter.PoolId",
  "Message": "The parameter PoolId is invalid."
}

エラーコード

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

変更履歴

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