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

Elastic Compute Service:ModifyInstanceAttribute

最終更新日:Jun 29, 2026

パスワード、インスタンス名、ホスト名、セキュリティグループメンバーシップ、MTU、インスタンスユーザーデータなど、ECS インスタンスの一部のプロパティを変更します。

操作説明

セキュリティ上の理由でロック済みのインスタンスはこの操作をサポートしていません。詳細については、「リソースセキュリティロックが API 呼び出しに与える影響」をご参照ください。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:ModifyInstanceAttribute

update

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#SecurityGroupId}

  • ecs:tag
  • ecs:PasswordCustomized
なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

InstanceId

string

必須

インスタンス ID

i-bp67acfmxazb4ph****

Password

string

任意

インスタンスのパスワード。パスワードは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。次の特殊文字がサポートされています: ()`~!@#$%^&*-_+=|{}[]:;'<>,.?/ 。Windows インスタンスの場合、パスワードは転送スラッシュ (/) で始めることはできません。次の点にご注意ください:

  • インスタンスは Starting 状態であってはなりません。

  • 新しいパスワードはインスタンスを再起動した後に有効になります。ECS コンソールでインスタンスを再起動するか (詳細については「インスタンスの再起動」をご参照ください)、 RebootInstance を呼び出して再起動できます。オペレーティングシステム内からの再起動では有効になりません。

説明

Password パラメーターを指定する場合は、パスワードの漏洩を防ぐために HTTPS を使用してリクエストを送信してください。

Test123456&$

HostName

string

任意

オペレーティングシステムのホスト名。次の点にご注意ください:

  • インスタンスは Pending または Starting 状態であってはなりません。そうでない場合、ホスト名と /etc/hosts の設定が有効にならない可能性があります。 DescribeInstances を呼び出してインスタンスの現在のステータスをクエリできます。

  • 新しいホスト名はインスタンスを再起動した後に有効になります。ECS コンソールでインスタンスを再起動するか (詳細については「インスタンスの再起動」をご参照ください)、 RebootInstance を呼び出して再起動できます。オペレーティングシステム内からの再起動では有効になりません。

ホスト名にはオペレーティングシステムごとに次の制限があります:

  • Windows Server: ホスト名は 2~15 文字で、大文字、小文字、数字、ハイフン (-) を含めることができます。ハイフン (-) で開始または終了することはできず、連続するハイフン (-) を含めることはできず、数字のみで構成することはできません。

  • その他のインスタンス (Linux など): ホスト名は 2~64 文字です。ピリオド (.) を使用してホスト名を複数のセグメントに区切ることができます。各セグメントには大文字、小文字、数字、ハイフン (-) を含めることができますが、連続するピリオド (.) やハイフン (-) を含めることはできません。ホスト名はピリオド (.) やハイフン (-) で開始または終了することはできません。

testHostName

InstanceName

string

任意

インスタンスの名前。名前は 2~128 文字で、大文字、小文字、または中国語の文字で始まる必要があり、http:// または https:// で始めることはできません。名前には数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

testInstanceName

Description

string

任意

インスタンスの説明。説明は 2~256 文字で、http:// または https:// で始めることはできません。

testInstanceDescription

UserData

string

任意

インスタンスユーザーデータ。データを渡す前に Base64 エンコーディングすることをお勧めします。次の点にご注意ください:

  • インスタンスはインスタンスユーザーデータの使用制限を満たす必要があります。詳細については、「インスタンスユーザーデータの作成」をご参照ください。

  • インスタンスを再起動すると、新しいユーザーデータはインスタンスに表示されますが、実行はされません。

説明

Base64 エンコーディング前の生データは 32 KB を超えることはできません。パスワードや非公開キーなどの機密情報をプレーンテキストで渡さないでください。機密情報を渡す必要がある場合は、情報を暗号化し、Base64 エンコーディングしてから、インスタンス内で同じ方法で復号してください。

ZWNobyBoZWxsbyBlY3Mh

Recyclable

boolean

任意

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

true

CreditSpecification

string

任意

バーストパフォーマンスインスタンスの実行中モード。有効な値:

  • Standard: 標準モード。

  • Unlimited: 無制限版モード。

バーストパフォーマンスインスタンスの実行中モードの詳細については、「バーストパフォーマンスインスタンスとは」をご参照ください。

Standard

DeletionProtection

boolean

任意

インスタンスのリリース保護属性。コンソールから、または DeleteInstance を呼び出してインスタンスをリリースできるかどうかを指定します。

説明

この属性は従量課金インスタンスにのみ適用され、手動解放操作のみを防止します。システムによるリリース操作には適用されません。

false

NetworkInterfaceQueueNumber

integer

任意

プライマリネットワークインターフェースコントローラー (NIC) のキュー数。次の点にご注意ください:

  • インスタンスは Stopped 状態である必要があります。

  • 値はインスタンスタイプで許可される NIC あたりの最大キュー数を超えることはできません。インスタンス上のすべての NIC の合計キュー数は、インスタンスタイプで許可される合計キュークォータを超えることはできません。 DescribeInstanceTypes を呼び出して、NIC あたりの最大キュー数とインスタンスタイプの合計キュークォータをクエリできます。

  • このパラメーターを -1 に設定すると、プライマリ NIC のキュー数はインスタンスタイプのデフォルト値にリセットされます。 DescribeInstanceTypes を呼び出して、インスタンスタイプのデフォルトの Elastic Network Interface (ENI) キュー数をクエリできます。

8

SecurityGroupIds

array

任意

インスタンスが再割り当てされるセキュリティグループの ID。次の点にご注意ください:

  • 配列内のセキュリティグループ ID は重複できません。配列の最大長は、インスタンスが所属できるセキュリティグループの最大数に依存します。詳細については、「使用制限」をご参照ください。

  • インスタンスは現在のセキュリティグループから離脱します。現在のセキュリティグループを保持するには、それらの ID を配列に追加してください。

  • セキュリティグループタイプ間の切り替えは可能ですが、リストに基本セキュリティグループと高度なセキュリティグループの両方を同時に含めることはできません。

  • セキュリティグループはインスタンスと同じ VPC に属している必要があります。

説明

セキュリティグループの変更は変更後まもなくインスタンスに反映されますが、わずかな遅延が発生する場合があります。

sg-bp15ed6xe1yxeycg7o****

string

任意

セキュリティグループの ID。

sg-bp15ed6xe1yxeycg7o****

RemoteConnectionOptions

object

任意

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

Password

string

任意

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

hide

Type

string

任意

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

hide

EnableJumboFrame

boolean

任意

インスタンス MTU のジャンボフレーム機能を有効にするかどうかを指定します。有効な値:

  • true: 機能を有効にします。

  • false: 機能を有効にしません。

次の点にご注意ください:

  • インスタンスは Running または Stopped 状態である必要があります。

  • インスタンスは VPC 接続インスタンスである必要があります。

  • ジャンボフレーム機能を有効にすると、インスタンスの MTU 値は 8500 に変更されます。機能を無効にすると、MTU 値は 1500 に戻ります。 一部のインスタンスタイプのみがジャンボフレーム機能をサポートしています。詳細については、「ECS インスタンス MTU」をご参照ください。

false

CpuOptions.Core

integer

任意

CPU コア数。このパラメーターはカスタム値をサポートしておらず、デフォルト値のみを使用できます。

2

CpuOptions.ThreadsPerCore

integer

任意

CPU コアあたりのスレッド数。ECS インスタンスの vCPU 数 = CpuOptions.Core 値 × CpuOptions.ThreadsPerCore 値。

  • CpuOptions.ThreadsPerCore=1 はハイパースレッディングが無効であることを示します。

  • 一部のインスタンスタイプのみがカスタムスレッド数をサポートしています。

2

CpuOptions.TopologyType

string

任意

インスタンスの CPU トポロジータイプ。有効な値:

  • ContinuousCoreToHTMapping: CPU トポロジーにおいて同一コアのハイパースレッドが連続しています。

  • DiscreteCoreToHTMapping: 同一コアのハイパースレッドが離散しています。

デフォルト値: なし。

次の点にご注意ください:

  • インスタンスは Stopped 状態である必要があります。

説明

一部のインスタンスファミリーのみがこのパラメーターをサポートしています。サポートされているインスタンスファミリーの情報については、「CPU トポロジー構造の表示と変更」をご参照ください。

DiscreteCoreToHTMapping

PrivateDnsNameOptions

object

任意

インスタンスの非公開ドメイン名構成。

非公開ドメイン名解決の詳細については、「ECS 非公開ドメイン名解決」をご参照ください。

EnableInstanceIdDnsARecord

boolean

任意

インスタンス ID ベースのドメイン名から IPv4 アドレスへの DNS 解決を有効にするかどうかを指定します。有効な値:

  • true: 解決を有効にします。

  • false: 解決を無効にします。

デフォルト値: false。

false

EnableInstanceIdDnsAAAARecord

boolean

任意

インスタンス ID ベースのドメイン名から IPv6 アドレスへの DNS 解決を有効にするかどうかを指定します。有効な値:

  • true: 解決を有効にします。

  • false: 解決を無効にします。

デフォルト値: false。

false

EnableIpDnsARecord

boolean

任意

IP ベースのドメイン名から IPv4 アドレスへの DNS 解決を有効にするかどうかを指定します。有効な値:

  • true: 解決を有効にします。

  • false: 解決を無効にします。

デフォルト値: false。

false

EnableIpDnsPtrRecord

boolean

任意

IPv4 アドレスから IP ベースのドメイン名への逆引き DNS 解決を有効にするかどうかを指定します。有効な値:

  • true: 解決を有効にします。

  • false: 解決を無効にします。

デフォルト値: false。

false

HostnameType

string

任意

ホスト名タイプ。有効な値:

  • Custom: カスタム。

  • IpBased: IP ベースのホスト名。

  • InstanceIdBased: インスタンス ID ベースのホスト名。

デフォルト値: Custom。

Custom

CpuOptions

object

任意

NestedVirtualization

string

任意

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

enabled

EnableNetworkEncryption

boolean

任意

VPC ネットワークトラフィックを暗号化するかどうかを指定します。有効な値:

  • true: 暗号化を有効にします。

  • false: 暗号化を無効にします。

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

true

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidInstanceName.Malformed The specified parameter "InstanceName" is not valid.
400 InvalidDescription.Malformed The specified parameter "Description" is not valid.
400 InvalidRemoteConnectionOptions.Password The remote connection password is invalid.
400 InvalidRemoteConnectionOptions.Type The remote connection type is invalid.
400 InstanceType.ValueNotSupported The instance type not supported.
400 OSType.ValueNotSupported The OS type is not supported.
400 InvalidHostPassword.Malformed The specified parameter "Password" is not valid.
400 InvalidHostName.Malformed The specified parameter "HostName" is not valid.
400 InvalidPassword.Malformed The specified parameter "Password" is not valid.
400 InvalidUserData.SizeExceeded The specified parameter "UserData" exceeds the size.
400 InvalidUserData.NotSupported TThe specified parameter "UserData" only support the vpc and IoOptimized Instance.
400 ImageNotSupportCloudInit The specified image does not support cloud-init.
400 ChargeTypeViolation Pay-As-You-Go instances do not support this operation.
400 InvalidParameter.RecycleBin You do not have permission to set recyclable properties.
400 InvalidParameter.CreditSpecification The specified CreditSpecification is not supported in this region.
400 InvalidInstanceStatus.CreditSpecRestricted The current status of the resource does not support this operation.
400 InvalidInstanceStatus.NotRunning The current status of the resource is invalid, you can only do this operation when instance is running.
400 InvalidNetworkType.NotSupported The classic networkType does not support to modify security group
400 InvalidOperation.EniCountExceeded =The maximum number of eni in a enterprise security group is exceeded.
400 JoinedGroupLimitExceed %s
400 InvalidParameter The specified parameter is not valid.
400 InvalidOperation.InvalidEcsState %s
400 InvalidParam.NotSupportJumboFrame Not support jumbo frame.
400 InvalidOperation.InstanceStatusNotSupport The instance status is not support modify mtu config.
400 InvalidOperation.InstanceStatusUnsupported The specified instance status does not support modification of cpu topology type.
400 InvalidParameter.CpuOptionsTopologyType The specified parameter CpuOptions.TopologyType: %s is not valid.
400 InvalidInstanceType.NotSupportCpuOptionsTopologyType The specified instance type does not support CpuOptions.TopologyType: %s.
400 InvalidAdditionalInfoPvdConfig.SizeExceeded The specified parameter AdditionalInfo.PvdConfig exceeds the size.
400 InvalidInstanceType.NotSupportHighDensityMode The specified instance type does not support the use of the high density mode.
400 InvalidStatus.StoppedRequired The current state of the resource does not support this operation, it can only be operated in a stopped state.
400 InvalidParameter.CpuOptionsTurboMode The specified parameter TurboMode is not valid.
400 InvalidInstanceType.EnableNVSUnsupported The specified instance type does not support EnableNVS.
400 InvalidInstanceType.EnableVISSTUnsupported The specified instance type does not support EnableVISST.
400 InvalidInstanceType.EnableVRDTUnsupported The specified instance type does not support EnableVRDT.
400 InvalidInstanceType.SingleCoreMaxModeUnsupported The specified instance type does not support TurboMode: "SINGLE CORE MAX".
400 InvalidInstanceType.GpuOptionsConfidentialComputingUnsupported The specified instance type does not support the confidential computing mode.
400 InvalidParameter.GpuOptionsConfidentialComputing The specified parameter confidential computing mode is not valid.
400 InvalidParameterAuthorized.GpuOptionsConfidentialComputing The specified parameter confidential computing mode is unauthorized.
400 InvalidParameter.CpuOptionsNestedVirtualization The specified parameter CpuOptions.NestedVirtualization: %s is not valid.
400 InvalidInstanceType.NotSupportCpuOptionsNestedVirtualization The specified instance type does not support CpuOptions.NestedVirtualization: %s.
500 InternalError The request processing has failed due to some unknown error.
403 IncorrectInstanceStatus The current status of the resource does not support this operation.
403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons.
403 OperationDenied The instance amount in the specified SecurityGroup reach its limit.
403 InvalidUserData.Forbidden User not authorized to input the parameter "UserData"please apply for permission "UserData"
403 InvalidUserData.Base64FormatInvalid The specified UserData is not valid
403 InvalidChargeType.ValueNotSupported Deletion protection is only valid for postPaid instance, not for prePaid or spot instance.
403 InvalidUser.Unauthorized The user is not authorized
403 EnterpriseGroupLimited.MutliGroupType The specified instance can not join multi SecurityGroup types.
403 SecurityGroupInstanceLimitExceed %s
403 InstanceNotInSecurityGroup The instance not in the group.
403 InvalidOperation.InvalidRegion %s
403 InvalidOperation.ResourceManagedByCloudProduct %s
403 InvalidParameter.InvalidEniQueueNumber %s
403 InvalidOperation.MaxEniQueueNumberExceeded %s
403 InvalidOperation.ExceedInstanceTypeQueueNumber %s
403 InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode %s
403 InvalidParameter.InvalidQueuePairNumber %s
403 InvalidOperation.MaxEniQueuePairNumberExceed %s
403 InvalidOperation.EniQueuePairNumberOverflow %s
403 AclLimitExceed %s
403 InvalidInstanceType.CpuOptionsThreadsPerCoreUnsupported The current instance type does not support setting or modifying the CpuOptions.ThreadsPerCore parameter.
403 InvalidParameter.CpuOptionsCore The specified parameter CpuOptions.Core is not valid.
403 InvalidParameter.CpuOptionsThreadsPerCore The specified parameter CpuOptions.ThreadsPerCore is not valid.
403 InvalidOperation.UserNotSupportNetworkEncryption User not support network encryption.
403 InvalidOperation.InstanceTypeNotSupportNetworkEncryption The specified instance type does not support network encryption.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist.
404 InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist.
404 Credit.NotFound The specified credit information does not exist.
404 InvalidInstanceStatus.NeedRestart The current status of the resource is invalid, you can only do this operation after instance is restarted.
404 InvalidParameter.SecurityGroupIdRepeated The specified security group ids has repeated.
404 InvalidSecurityGroupType.NotSupportClassic The specified SecurityGroupIds have classic group type.
404 InvalidSecurityGroupVpc.NotBelongToOneVpc The specified SecurityGroupIds are belong to different vpc.

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

変更履歴

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