インスタンスのパスワードや名前など、インスタンスの属性を変更します。
操作説明
-
インスタンスステータスが Starting の場合、インスタンスのパスワードをリセットできません。
-
インスタンスステータスが Running の場合、インスタンスのパスワードを変更できません。
-
パスワードをリセットした後、変更の効果を適用するには、コンソールでインスタンスを再起動するか、RebootInstance 操作の呼び出しを行う必要があります。オペレーティングシステム内からインスタンスを再起動しても効果はありません。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ens:ModifyInstanceAttribute |
update |
*Instance
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| InstanceId |
string |
必須 |
変更するインスタンスの ID。単一のインスタンス ID のみ指定できます。 |
i-instanc**** |
| Password |
string |
任意 |
インスタンスのパスワード。 |
yourPassword |
| InstanceName |
string |
任意 |
インスタンスの名前。 名前は 2~128 文字である必要があります。先頭は英字または漢字にする必要があり、http:// または https:// で始めることはできません。数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。 |
i-instanceidname |
| HostName |
string |
任意 |
ECS インスタンスのホスト名。ホスト名は 2~64 文字である必要があります。期間 (.) を使用してホスト名を複数のセグメント数に分割できます。各セグメントには、英字、数字、ハイフン (-) を含めることができます。連続した期間 (.) またはハイフン (-) は使用できません。ホスト名の先頭または末尾を期間 (.) またはハイフン (-) にすることはできません。 |
testHostName |
| UserData |
string |
任意 |
インスタンスのユーザーデータ。ユーザーデータは Base64 でエンコードされている必要があります。 エンコーディング前の生データは、サイズが 16 KB を超えることはできません。パスワードや非公開鍵などの機密情報をプレーンテキストで渡さないでください。機密情報を渡す必要がある場合は、Base64 でエンコードする前に情報を暗号化する必要があり、インスタンス内で同じ方法で情報を復号します。 |
/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgK**** |
| DeletionProtection |
boolean |
任意 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| Code |
integer |
ビジネスリターンコード。値が 0 の場合は成功を示します。 |
200 |
| RequestId |
string |
リクエスト ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
例
成功レスポンス
JSONJSON
{
"Code": 200,
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | MissingParameter | The input parameter that is mandatory for processing this request is not supplied. | |
| 400 | InstanceIdNotFound | The input parameter InstanceId that is not found. | |
| 400 | InvalidParameter.%s | The specified field %s invalid. Please check it again. | |
| 400 | NoPermission | Permission denied. | |
| 400 | InvalidDeletionAppointmentNotSupported | The scheduled release time of the current instance is set to prohibit this operation. | 現在のインスタンスにリリース予定時間が設定されているため、この操作は実行できません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。