nifty-modify-instance-attribute
処理概要
API「ModifyInstanceAttribute」が実行されます。
指定したサーバーの詳細情報を更新します。1回のリクエストで、1つのサーバーの情報を更新できます。
サーバーを指定するためには、サーバー名が必要です。削除済みのサーバーを指定した、管理外のサーバーを指定したなど、無効なサーバーを指定した場合は、エラーが返されます。
サーバータイプの更新について、ホットスケールアップが可能なサーバーであれば、オプション「--reboot false --force」を指定することで、起動中の状態のまま、更新が可能です。ホットスケールアップが可能なサーバーかどうかはAPI「DescribeInstances」のレスポンス値「hotAdd」で確認できます。ただしサーバータイプの値によっては、「hotAdd」が可能となっていても更新できないサーバータイプがあります。
コマンド構文
nifty-modify-instance-attribute サーバー名 [オプション]
オプション
オプション | 短縮 | 説明 | 必須 |
---|---|---|---|
--instance-type TYPE | -t | サーバータイプを更新します。 e-mini | h2-mini | mini | c-small | e-small | h2-small | small | c-small2 | e-small2 | h2-small2 | small2 | c-small4 | e-small4 | h2-small4 | small4 | e-small8 | h2-small8 | small8 | e-small16 | h2-small16 | small16 | c-medium | e-medium | h2-medium | medium | c-medium4 | e-medium4 | h2-medium4 | medium4 | c-medium8 | e-medium8 | h2-medium8 | medium8 | e-medium16 | h2-medium16 | medium16 | e-medium24 | h2-medium24 | medium24 | c-large | e-large | h2-large | large | c-large8 | e-large8 | h2-large8 | large8 | e-large16 | h2-large16 | large16 | e-large24 | h2-large24 | large24 | e-large32 | h2-large32 | large32 | e-extra-large8 | h2-extra-large8 | extra-large8 | e-extra-large16 | h2-extra-large16 | extra-large16 | e-extra-large24 | h2-extra-large24 | extra-large24 | e-extra-large32 | h2-extra-large32 | extra-large32 | e-extra-large48 | h2-extra-large48 | extra-large48 | e-double-large16 | h2-double-large16 | double-large16 | e-double-large24 | h2-double-large24 | double-large24 | e-double-large32 | h2-double-large32 | double-large32 | e-double-large48 | h2-double-large48 | double-large48 | e-double-large64 | h2-double-large64 | double-large64 | e-double-large96 | h2-double-large96 | double-large96 | h2-triple-large32 | triple-large32 | h2-triple-large48 | triple-large48 | h2-triple-large64 | triple-large64 | h2-triple-large96 | triple-large96 | h2-triple-large128 | triple-large128 | h2-quad-large64 | quad-large64 | h2-quad-large96 | quad-large96 | h2-quad-large128 | quad-large128 | h2-quad-large256 | quad-large256 | h2-septa-large128 | septa-large128 | h2-septa-large256 | septa-large256 | h2-octa-large256 | octa-large256 | h2-octa-large384 | octa-large384 | h2-octa-large512 | octa-large512 |
|
--disable-api-termination BOOLEAN | APIからのサーバー削除の可否情報を更新します。 true (削除不可) | false (削除可) |
||
--instance-name INSTANCE | サーバー名を更新します。 | ||
--ip-type IPTYPE | IPアドレスのタイプを更新します。 static(固定化)| none(グローバルIPなし) |
||
--group-id GROUP | -g | ファイアウォールグループを更新します。 | |
--description MEMO | メモ情報を更新します。 | ||
--accounting-type 利用料金タイプ | 利用料金タイプを更新します。 | ||
--reboot REBOOT | 再起動オプション(起動中のサーバータイプ or IPタイプ指定時のオプション)を指定します。 force(強制再起動) | true(通常再起動) | false(再起動しない) Default : true |
||
--force | ホットスケールアップを実行する際、指定します。(※) ※--reboot false指定時のオプション |
||
--tenancy TENANCY | テナント属性を指定します。 default (通常) | dedicated (専有) Default : default |
出力要素
※ニフクラAPIの応答フィールド名を記述します。
- instanceId
- 属性名(指定したパラメーターによって異なります)
- value
実行サンプル
PROMPT>nifty-modify-instance-attribute server01 --instance-type large
server01 instanceType large