日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

文檔

ModifyInstanceAttribute - 修改一臺實例的部分信息

更新時間:

調用ModifyInstanceAttribute修改一臺ECS實例的部分信息,包括密碼、名稱、描述、主機名、所屬安全組、實例的MTU以及自定義數據等。如果是突發性能實例,還可以切換性能突發模式。

接口說明

查詢 ECS 實例信息時,如果返回數據中包含{"OperationLocks": {"LockReason" : "security"}},則禁止一切操作。

調用該接口完成以下操作時,您需要注意:

  • 修改主機名(HostName):重啟實例后,修改生效,且必須是在 ECS 控制臺重啟(具體操作,請參見重啟實例)或者調用 RebootInstance 重啟,新主機名才能生效。在操作系統內部重啟不保證能生效。

  • 重置密碼(Password):

    • 實例狀態不能為啟動中Starting)。
    • 重啟實例后,重置生效,且必須是在 ECS 控制臺重啟(具體操作,請參見重啟實例)或者調用 RebootInstance 重啟,新密碼才能生效。在操作系統內部重啟不能生效。
  • 修改自定義數據(UserData): 實例必須滿足自定義數據使用限制。更多信息,請參見生成實例自定義數據

    說明 重啟實例后,實例上將展示新的用戶數據,但不會運行用戶數據腳本。
  • 更換實例安全組(SecurityGroupIds.N):

    • 支持切換安全組類型。 當 ECS 實例跨類型切換安全組時,您需要充分了解兩種安全組規則的配置區別,避免影響實例網絡。
    • 不支持經典網絡類型實例。 其他注意事項請參見SecurityGroupIds.N的參數說明。
  • 修改主網卡隊列數(NetworkInterfaceQueueNumber):

    • 實例必須為已停止(Stopped)狀態。
    • 不能超過實例規格允許的單塊網卡最大隊列數。
    • 實例的所有網卡累加隊列數不能超過實例規格允許的隊列數總配額。實例規格的單塊網卡最大隊列數和總配額可以通過 DescribeInstanceTypes 查詢MaximumQueueNumberPerEniTotalEniQueueQuantity字段。
    • 當取值為-1 時,將重置主網卡隊列數為對應實例規格的默認值。實例規格的彈性網卡默認隊列數可以通過 DescribeInstanceTypes 查詢PrimaryEniQueueNumber字段。
  • 實例開啟/關閉 Jumbo frame 特性(EnableJumboFrame)。更多信息,請參見ECS 實例 MTU

    • 實例必須為運行中(Running)或者已停止(Stopped)狀態。
    • 實例必須為虛擬專有網絡(Virtual Private Cloud, VPC)下的 ECS 實例。
    • 開啟 Jumbo Frame 特性后,實例的 MTU 值將變為 8500,關閉后則回退為 1500 。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息,可以在RAM權限策略語句的Action元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:

  • 操作:是指具體的權限點。
  • 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
  • 資源類型:是指操作中支持授權的資源類型。具體說明如下:
    • 對于必選的資源類型,用背景高亮的方式表示。
    • 對于不支持資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指云產品自身定義的條件關鍵字。
  • 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
ecs:ModifyInstanceAttributeupdate
  • Instance
    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}
  • SecurityGroup
    acs:ecs:{#regionId}:{#accountId}:securitygroup/{#SecurityGroupId}
  • ecs:tag

請求參數

名稱類型必填描述示例值
InstanceIdstring

實例 ID。

i-bp67acfmxazb4ph****
Passwordstring

實例的密碼。支持長度為 8~30 個字符,必須同時包含大小寫英文字母、數字和特殊符號中的三類字符。特殊符號可以是:

()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

其中,Windows 實例不能以斜線號(/)為密碼首字符。

說明 如果傳入Password參數,建議您使用 HTTPS 協議發送請求,避免密碼泄露。
Test123456&$
HostNamestring

操作系統的主機名。您需要注意:

  • 修改主機名時,實例不能處于創建中(Pending)或啟動中(Starting)的狀態,否則可能出現主機名以及/etc/hosts配置失效等情況。您可以調用 DescribeInstances 查詢實例當前的狀態信息。

  • 修改主機名后,請調用 RebootInstance 重啟實例,使修改生效。

不同操作系統主機名存在以下限制:

  • Windows Server 系統:長度為 2-15 個字符,允許使用大小寫字母、數字或短劃線(-)。不能以短劃線(-)開頭或結尾,不能連續使用短劃線(-),也不能僅使用數字。

  • 其他類型實例(Linux 等):長度為 2-64 個字符,允許使用半角句號(.)分隔字符成多段,每段允許使用大小寫字母、數字或連字符(-),但不能連續使用半角句號(.)或短劃線(-)。不能以半角句號(.)或短劃線(-)開頭或結尾。

testHostName
InstanceNamestring

實例名稱。長度為 2~128 個英文或中文字符。必須以大小寫字母或中文開頭,不能以http://https://開頭。可以包含數字、半角冒號(:)、下劃線(_)或者短劃線(-)。

testInstanceName
Descriptionstring

實例描述。長度為 2~256 個英文或中文字符,不能以http://https://開頭。

testInstanceDescription
UserDatastring

實例自定義數據,需要以 Base64 編碼。

編碼前,原始數據不能超過 32 KB。建議不要明文傳入敏感信息,例如密碼和私鑰等。如果必須傳入敏感信息,建議您加密后再以 Base64 編碼傳入,在實例內部以同樣的方式解密。

ZWNobyBoZWxsbyBlY3Mh
Recyclableboolean
說明 該參數正在邀測中,暫不開放使用。
true
CreditSpecificationstring

修改突發性能實例的運行模式。取值范圍:

  • Standard:標準模式。
  • Unlimited:無性能約束模式。

關于突發性能實例運行模式的更多信息,請參見什么是突發性能實例

Standard
DeletionProtectionboolean

實例釋放保護屬性。指定是否支持通過控制臺或 API( DeleteInstance )釋放實例。

說明 該屬性僅適用于按量付費實例,且只能限制手動釋放操作,對系統釋放操作不生效。
false
NetworkInterfaceQueueNumberinteger

主網卡隊列數。

8
SecurityGroupIdsarray

實例重新加入的安全組列表。

  • 安全組 ID 不能重復。
  • 實例會離開當前的安全組,如需保留設置,您需要在列表中添加當前的安全組 ID。
  • 支持切換安全組類型,但設置的安全組列表中不能同時包含普通安全組和企業安全組。
  • 安全組必須和實例屬于同一個 VPC。
  • N 的取值范圍與實例能夠加入安全組配額有關。更多信息,請參見使用限制
  • 修改安全組后很快會生效于對應的實例,但可能有較小的延遲。
string

實例重新加入的安全組。

  • 安全組 ID 不能重復。
  • 實例會離開當前的安全組,如需保留設置,您需要在列表中添加當前的安全組 ID。
  • 支持切換安全組類型,但設置的安全組列表中不能同時包含普通安全組和企業安全組。
  • 安全組必須和實例屬于同一個 VPC。
  • N 的取值范圍與實例能夠加入安全組配額有關,更多信息,請參見使用限制
  • 修改安全組后很快會生效于對應的實例,但可能有較小的延遲。
sg-bp15ed6xe1yxeycg7o****
RemoteConnectionOptionsobject
說明 該參數正在邀測中,暫不開放使用。
Passwordstring
說明 該參數正在邀測中,暫不開放使用。
hide
Typestring
說明 該參數正在邀測中,暫不開放使用。
hide
EnableJumboFrameboolean

實例 MTU 是否開啟 Jumbo frame 通信模式,取值范圍:

  • true:開啟。

  • false:不開啟。

目前僅部分規格支持開啟 Jumbo frame。更多信息,請參見ECS 實例 MTU

false
CpuOptions.TopologyTypestring

實例的 Cpu 拓撲類型。取值范圍:

  • ContinuousCoreToHTMapping:當選擇ContinuousCoreToHTMapping時,實例的 Cpu 拓撲中,實例的同一個 Core 的 HT 是連續的。
  • DiscreteCoreToHTMapping:當選擇DiscreteCoreToHTMapping時,實例的同一個 Core 的 HT 是離散的。

默認值:無。

說明
  • 僅部分實例規格族支持使用本參數,具體支持實例規格族請參見查看和修改 CPU 拓撲結構
    • 使用該參數時實例必須為已停止(Stopped)狀態。
    DiscreteCoreToHTMapping
    PrivateDnsNameOptionsobject
    說明 該參數正在邀測中,暫不開放使用。
    EnableInstanceIdDnsARecordboolean
    說明 該參數正在邀測中,暫不開放使用。
    false
    EnableInstanceIdDnsAAAARecordboolean
    說明 該參數正在邀測中,暫不開放使用。
    false
    EnableIpDnsARecordboolean
    說明 該參數正在邀測中,暫不開放使用。
    false
    EnableIpDnsPtrRecordboolean
    說明 該參數正在邀測中,暫不開放使用。
    false
    HostnameTypestring
    說明 該參數正在邀測中,暫不開放使用。
    Custom

    返回參數

    名稱類型描述示例值
    object
    RequestIdstring

    請求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    示例

    正常返回示例

    JSON格式

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

    錯誤碼

    HTTP status code錯誤碼錯誤信息描述
    400InvalidInstanceName.MalformedThe specified parameter "InstanceName" is not valid.InstanceName參數不符合規則。
    400InvalidDescription.MalformedThe specified parameter "Description" is not valid.指定的資源描述格式不合法。長度為2-256個字符,不能以http://和https://開頭。
    400InvalidRemoteConnectionOptions.PasswordThe remote connection password is invalid.-
    400InvalidRemoteConnectionOptions.TypeThe remote connection type is invalid.-
    400InstanceType.ValueNotSupportedThe instance type not supported.-
    400OSType.ValueNotSupportedThe OS type is not supported.-
    400InvalidHostPassword.MalformedThe specified parameter "Password" is not valid.-
    400InvalidHostName.MalformedThe specified parameter "HostName" is not valid.-
    400InvalidPassword.MalformedThe specified parameter "Password" is not valid.-
    400InvalidUserData.SizeExceededThe specified parameter "UserData" exceeds the size.-
    400InvalidUserData.NotSupportedTThe specified parameter "UserData" only support the vpc and IoOptimized Instance.-
    400InvalidUserData.NotSupportedThe specified parameter "UserData" only support the vpc and IoOptimized Instance.-
    400ImageNotSupportCloudInitThe specified image does not support cloud-init.該鏡像不支持CloudInit。
    400ChargeTypeViolationPay-As-You-Go instances do not support this operation.按量付費實例不支持該操作,檢查實例的付費類型是否與該操作沖突。
    400InvalidParameter.RecycleBinYou do not have permission to set recyclable properties.您未被授權執行該操作。
    400InvalidParameter.CreditSpecificationThe specified CreditSpecification is not supported in this region.該地區不支持指定的突發性能實例的運行模式。
    400InvalidInstanceStatus.CreditSpecRestrictedThe current status of the resource does not support this operation.當前資源的狀態不支持此操作。
    400InvalidInstanceStatus.NotRunningThe current status of the resource is invalid, you can only do this operation when instance is running.當前實例的狀態不支持此操作,當實例狀態為 Running 時再進行此操作。
    400InvalidNetworkType.NotSupportedThe classic networkType does not support to modify security group-
    400InvalidOperation.EniCountExceeded=The maximum number of eni in a enterprise security group is exceeded.-
    400JoinedGroupLimitExceed%s指定資源所能加入的安全組數量達到上限。具體信息請參見錯誤信息%s占位符的實際返回結果。
    400InvalidParameterThe specified parameter is not valid.無效的參數,請檢查該參數是否正確。
    400InvalidOperation.InvalidEcsState%s實例當前的狀態不支持此操作。
    400InvalidParam.NotSupportJumboFrameNot support jumbo frame.-
    400InvalidOperation.InstanceStatusNotSupportThe instance status is not support modify mtu config.-
    400InvalidOperation.InstanceStatusUnsupportedThe specified instance status does not support modification of cpu topology type.當前實例狀態不支持修改CPU拓撲類型
    400InvalidParameter.CpuOptionsTopologyTypeThe specified parameter CpuOptions.TopologyType: %s is not valid.當前CPU拓撲類型的枚舉值不合法
    400InvalidInstanceType.NotSupportCpuOptionsTopologyTypeThe specified instance type does not support CpuOptions.TopologyType: %s.當前規格不支持指定的CPU拓撲類型
    400InvalidAdditionalInfoPvdConfig.SizeExceededThe specified parameter AdditionalInfo.PvdConfig exceeds the size.指定的 AdditionalInfo.PvdConfig 超過大小限制。
    400InvalidInstanceType.NotSupportHighDensityModeThe specified instance type does not support the use of the high density mode.當前實例規格不支持使用云盤高密模式
    400InvalidStatus.StoppedRequiredThe current state of the resource does not support this operation, it can only be operated in a stopped state.資源的當前狀態不支持此操作,只有停機狀態才能操作
    403IncorrectInstanceStatusThe current status of the resource does not support this operation.該資源目前的狀態不支持此操作。
    403InstanceLockedForSecurityThe specified operation is denied as your instance is locked for security reasons.實例被安全鎖定。
    403OperationDeniedThe instance amount in the specified SecurityGroup reach its limit.指定安全組的實例數已達最大值。
    403OperationDeniedThe current status of the resource does not support this operation.該資源狀態不支持此類操作。
    403InvalidUserData.ForbiddenUser not authorized to input the parameter "UserData"please apply for permission "UserData"-
    403InvalidUserData.Base64FormatInvalidThe specified UserData is not valid指定的UserData參數編碼出錯
    403InvalidChargeType.ValueNotSupportedDeletion protection is only valid for postPaid instance, not for prePaid or spot instance.刪除保護功能只能使用在按量付費資源上
    403InvalidUser.UnauthorizedThe user is not authorized您當前使用的賬號無權限。
    403EnterpriseGroupLimited.MutliGroupTypeThe specified instance can not join multi SecurityGroup types.指定的實例不能同時加入普通安全組和企業安全組。您可以調用 DescribeSecurityGroups 查詢指定安全組的類型。
    403SecurityGroupInstanceLimitExceed%s該安全組內已有的實例數量已達到最大限制。
    403InstanceNotInSecurityGroupThe instance not in the group.指定的實例不在安全組內。
    403InvalidOperation.InvalidRegion%s指定的參數 RegionId 無效。
    403OperationDeniedThe specified Image is disabled or is deleted.指定的鏡像被禁用或被刪除。
    403InvalidOperation.ResourceManagedByCloudProduct%s云產品托管的安全組不支持修改操作。
    403InvalidParameter.InvalidEniQueueNumber%s彈性網卡隊列數有誤,具體信息請參見錯誤信息%s占位符的實際返回結果。
    403InvalidOperation.MaxEniQueueNumberExceeded%s彈性網卡隊列數超過上限,具體信息請參見錯誤信息%s占位符的實際返回結果。
    403InvalidOperation.ExceedInstanceTypeQueueNumber%s彈性網卡隊列總數超過上限,具體信息請參見錯誤信息%s占位符的實際返回結果。
    403InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode%s-
    403InvalidParameter.InvalidQueuePairNumber%s-
    403InvalidOperation.MaxEniQueuePairNumberExceed%s-
    403InvalidOperation.EniQueuePairNumberOverflow%s-
    403AclLimitExceed%s網卡或實例的安全組規則數量超過限額值。
    404InvalidInstanceId.NotFoundThe specified InstanceId does not exist.指定的實例ID未找到。
    404InvalidSecurityGroupId.NotFoundThe specified SecurityGroupId does not exist.指定的安全組在該用戶賬號下不存在,請您檢查安全組 ID 是否正確。
    404Credit.NotFoundThe specified credit information does not exist.指定的突發性能實例積分信息不存在。
    404InvalidInstanceStatus.NeedRestartThe current status of the resource is invalid, you can only do this operation after instance is restarted.-
    404InvalidParameter.SecurityGroupIdRepeatedThe specified security group ids has repeated.指定的安全組已重復添加。請檢查 SecurityGroupIds 參數值是否正確。
    404InvalidSecurityGroupType.NotSupportClassicThe specified SecurityGroupIds have classic group type.指定的安全組的網絡類型為經典網絡。請檢查 SecurityGroupIds 參數值是否正確。
    404InvalidSecurityGroupVpc.NotBelongToOneVpcThe specified SecurityGroupIds are belong to different vpc.指定的安全組ID屬于不同的VPC。請檢查 SecurityGroupIds 參數值是否正確。您可以調用 DescribeSecurityGroups 查詢指定安全組所屬的VPC。
    500InternalErrorThe request processing has failed due to some unknown error.內部錯誤,請重試。
    500InternalErrorThe request processing has failed due to some unknown error, exception or failure.內部錯誤,請重試。

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

    變更歷史

    變更時間變更內容概要操作
    2024-08-29OpenAPI 錯誤碼發生變更查看變更詳情
    2024-08-08OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更查看變更詳情
    2024-07-03OpenAPI 錯誤碼發生變更查看變更詳情
    2024-05-11OpenAPI 錯誤碼發生變更查看變更詳情
    2023-12-14OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更查看變更詳情
    2023-07-17OpenAPI 錯誤碼發生變更查看變更詳情