この操作では、専用ホストに障害が発生したときに適用される名前、説明、インスタンス移行ポリシーなど、専用ホストの一部のプロパティを変更できます。

説明

  • 専用ホストでホストされているすべてのECSインスタンスは、専用ホストのCPUオーバーコミット率を変更する前に、停止済み (停止済み) 状態である必要があります。
  • 専用ホストのCPUオーバーコミット率を変更しても、専用ホストの実行状態には影響しません。 CPUオーバーコミット率が変更された後、専用ホストに割り当てられたvCPUの数は、新しいvCPUの合計数を超えることはできません。 それ以外の場合、過剰なvCPUを使用するECSインスタンスは起動できません。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 ModifyDedicatedHostAttribute

実行する操作です。 値をModifyDedicatedHostAttributeに設定します。
DedicatedHostId String 必須 dh-bp165p6xk2tlw61e ****

専用ホストの ID。
RegionId String 必須 cn-hangzhou

専用ホストのリージョンID。 DescribeRegions を呼び出すと、最新のリージョンリストを照会できます。

DedicatedHostName String 任意 testDedicatedHostName

専用ホストの名前。 名前は2〜128文字である必要があり、http:// またはhttpsで始めることはできません。 英数字、コロン (:) 、アンダースコア (_) 、ハイフン (-) を使用できます。

説明 String 任意 testDescription

専用ホストの説明。 説明は、長さが 2 文字から 256 文字とする必要があります。文頭に http:// または https:// を含めることはできません。
ActionOnMaintenance String 任意 移行

専用ホストにデプロイされたインスタンスを移行するために使用されるポリシー。 設定可能な値は以下のとおりです。

  • Migrate: インスタンスは別の物理サーバーに移行され、再起動されます。
  • 停止: 専用ホストのインスタンスが停止しています。 専用ホストを修復できない場合、インスタンスは別の物理サーバーに移行され、再起動されます。

専用ホストにクラウドディスクがアタッチされている場合、デフォルト値はMigrateです。

専用ホストにローカルディスクが接続されている場合、デフォルト値は [停止] です。
NetworkAttributes.SlbUdpTimeout Integer 任意 60

Server Load Balancer (SLB) と専用ホスト間のUDPセッションのタイムアウト期間。 (単位：秒) 有効な値: 15 ~ 310
NetworkAttributes.UdpTimeout Integer 任意 60

ユーザーと専用ホスト上のAlibaba Cloudサービス間のUDPセッションのタイムアウト期間。 (単位：秒) Valid values: 15 to 310.
自動配置 String 任意 on

自動デプロイのために専用ホストをリソースプールに追加するかどうかを指定します。 専用ホスト上にインスタンスを作成するときにDedicatedHostIdパラメーターを指定しない場合、Alibaba Cloudはリソースプールからインスタンスをホストする専用ホストを自動的に選択します。 有効値：

  • on: 自動デプロイのために専用ホストをリソースプールに追加します。
  • off: 自動デプロイのために専用ホストをリソースプールに追加しません。

自動デプロイの詳細については、「機能」をご参照ください。

DedicatedHostClusterId String 任意 dc-bp165p6xk2tlw61e ****

専用ホストが属する専用ホストクラスタのID。
CpuOverCommitRatio Float 任意 1

CPUオーバーコミット率。 CPU オーバーコミット率は、g6s、c6s、r6s の専用ホストタイプに対してのみ設定できます。 有効な値: 1 ~ 5。

CPU オーバーコミット率は、専用ホストで使用可能な vCPU の数に影響します。 専用ホストで使用可能な vCPU の数は、使用可能な vCPU の数 = 物理 CPU コアの数 × 2 × CPU オーバーコミット率で計算できます。 たとえば、g6s 専用ホストの物理 CPU コア数は 52 です。 g6s専用ホストのCPUオーバーコミット率を4に変更すると、専用ホストで使用可能なvCPUの数は416になります。 開発環境やテスト環境など、CPUの安定性に対する要件が最小限であるシナリオや、CPU負荷が重くないシナリオでは、CPUオーバーコミット率を上げることで、専用ホストで使用可能なvCPUの数を増やすことができます。 これにより、同じ仕様のより多くのECSインスタンスを専用ホストにデプロイし、ユニットデプロイコストを削減できます。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 2A4EA075-CB5B-41B7-B0EB-70D339F64DE7

リクエストの ID です。

例

リクエストの例

http(s):// ecs.aliyuncs.com/? アクション=ModifyDedicatedHostAttribute
&DedicatedHostId=dh-bp165p6xk2tlw61e ****
&RegionId=cn-hangzhou
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<ModifyDedicatedHostAttributeResponse>
    <RequestId>2A4EA075-CB5B-41B7-B0EB-70D339F64DE7</RequestId>
</ModifyDedicatedHostAttributeResponse>

JSON 形式 

{
    "RequestId":"2A4EA075-CB5B-41B7-B0EB-70D339F64DE7"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist. 指定された DedicatedHostId が存在しない場合に返されるエラーメッセージ。
400 InvalidDedicatedHostName.Malformed 指定されたパラメーターDedicatedHostNameは無効です。 指定されたDedicatedHostNameパラメーターが無効な場合に返されるエラーメッセージ。
400 InvalidDescription.Malformed 指定されたパラメータの説明が無効です。 指定された Description パラメーターが無効な場合に返されるエラーメッセージ。 説明は、長さが 2 文字から 256 文字とする必要があります。文頭に http:// または https:// を含めることはできません。
403 InvalidUser.Unauthorized ユーザーは承認されていません 該当の操作を実行する権限がない場合に返されるエラーメッセージです。
400 InvalidParameter.SlbUdpTimeout 指定された値は無効です。 指定されたNetworkAttributes.SlbUdpTimeoutパラメーターが無効な場合に返されるエラーメッセージ。
400 InvalidParameter.UdpTimeout 指定された値は無効です。 指定されたNetworkAttributes.UdpTimeoutパラメーターが無効な場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。