ModifyDedicatedHostAttribute - 修改Dedicated Host部分資訊 - Elastic Compute Service

調用ModifyDedicatedHostAttribute修改一台Dedicated Host的部分資訊，包括Dedicated Host的名稱、描述和服務不可用屬性等。

介面說明

修改 CPU 超賣比時，Dedicated Host上的 ECS 執行個體必須為已停止（Stopped）狀態。
修改 CPU 超賣比不會影響 DDH 的運行狀態，但需注意 DDH 中已指派的 vCPU 數量不能超過修改後的總 vCPU 數量，否則超出部分的 ECS 執行個體將無法啟動。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:ModifyDedicatedHostAttribute

update

*DedicatedHost

acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

DedicatedHostCluster

acs:ecs:{#regionId}:{#accountId}:ddhcluster/{#ddhclusterId}

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	Dedicated Host所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。	cn-hangzhou
DedicatedHostId	string	是	Dedicated Host ID。	dh-bp165p6xk2tlw61e****
DedicatedHostName	string	否	Dedicated Host名稱。長度為 2~128 個英文或中文字元。必須以大小寫字母或中文開頭，不能以 http://和 https://開頭。可以包含數字、半形冒號（:）、底線（_）或者短劃線（-）。	testDedicatedHostName
Description	string	否	Dedicated Host的描述。長度為 2~256 個英文或中文字元，不能以`http://`或`https://`開頭。	testDescription
ActionOnMaintenance	string	否	當Dedicated Host發生故障或者線上修複時，為其所宿執行個體設定遷移方案。取值範圍： Migrate：遷移執行個體到其他物理機並重新啟動執行個體。 Stop：在當前Dedicated Host上停止執行個體，確認無法修複Dedicated Host後，遷移執行個體到其他物理機並重新啟動執行個體。當Dedicated Host上掛載的是雲端硬碟時，預設值：Migrate。當Dedicated Host上掛載的是本地碟時，預設值：Stop。	Migrate
NetworkAttributes.SlbUdpTimeout	integer	否	負載平衡串連的 UDP 會話逾時時間，單位：秒。取值範圍：15~310。	60
NetworkAttributes.UdpTimeout	integer	否	為Dedicated Host上啟動並執行雲端服務設定使用者訪問的 UDP 會話逾時時間，單位：秒。取值範圍：15~310。	60
AutoPlacement	string	否	設定Dedicated Host是否加入自動部署資源集區。當您在Dedicated Host上建立執行個體，卻不指定 DedicatedHostId 時，阿里雲自動從資源集區中選取Dedicated Host放置執行個體。取值範圍： on：加入自動部署資源集區。 off：不加入自動部署資源集區。自動部署功能詳情，請參見功能特性。	on
DedicatedHostClusterId	string	否	Dedicated Host叢集 ID。	dc-bp165p6xk2tlw61e****
CpuOverCommitRatio	number	否	CPU 超賣比。僅自訂規格 g6s、c6s、r6s 支援設定 CPU 超賣比。取值範圍：1~5。 CPU 超賣比影響 DDH 的可用 vCPU 數，一台 DDH 的可用 vCPU 數=物理 CPU 核心數2CPU 超賣比。例如，g6s 的物理 CPU 核心數為 52，如果設定 CPU 超賣比為 4，則修改完成後 vCPU 總數顯示為 416。針對 CPU 絕對穩定性要求不嚴苛或者 CPU 負載不高的情境，例如開發測試環境，提升超賣比可以提升可用 vCPU 數，用於部署更多同等規格的 ECS 執行個體，降低單位部署成本。	1

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	2A4EA075-CB5B-41B7-B0EB-70D339F6****

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidDedicatedHostName.Malformed	The specified parameter DedicatedHostName is not valid.	指定的參數 DedicatedHostName 無效。
400	InvalidDescription.Malformed	The specified parameter Description is not valid.	指定的資源描述格式不合法。長度為 2-256 個字元，不能以 http:// 和 https:// 開頭。
400	InvalidParameter.SlbUdpTimeout	The specified value is invalid.	指定的參數 SlbUdpTimeout 無效。
400	InvalidParameter.UdpTimeout	The specified value is invalid.	指定的參數 UdpTimeout 無效。
400	InvalidDedicatedHostType.CpuOverCommitRatioNotSupported	%s
400	InvalidCpuOverCommitRatio.ValueNotSupported	%s
403	InvalidUser.Unauthorized	The user is not authorized	您當前使用的帳號無許可權。
404	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.
404	InvalidDedicatedHostClusterId.NotFound	The specified DedicatedHostClusterId does not exist.
404	InvalidDedicatedHostClusterId.ExceedMaxSize	The specified Dedicated Host Cluster exceeded max capacity.
404	InvalidDedicatedHostClusterId.NotMatch	The specified DedicatedHostCluster does not match request.
404	InvalidParameter.ActionOnMaintenance	The specified ActionOnMaintenance does not exist.	指定的遷移方案不存在。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。