Docs
api
UHost(UHost)
ModifyUHostIP

Change the internal IP address of the cloud host - ModifyUHostIP

Overview

Change the internal IP address of the cloud host

💡 The modified IP address must be in the same VPC and subnet as the original IP address.

ℹ️ Before performing this operation, please modify the configuration file inside the host and shut down your host.

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is ModifyUHostIP.Yes
PublicKeystringThe user's public key can be obtained from Console (opens in a new tab)Yes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
RegionstringRegion. See List of Regions and Availability ZonesYes
ZonestringAvailability Zone. See Availability Zone ListYes
ProjectIdstringProject ID. When not filled in, it defaults to the default project. Please refer to the GetProjectList interface.No
PresentIpAddressstringThe IP address that needs to be changed. The new IP address and the old IP address must belong to the same subnet, and be consistent with the configuration file inside the host.Yes
UHostIdstringSpecify the cloud host ID.Yes
PreviousIpAddressstringThe original IP address that needs to be modified. This parameter is not required when the cloud host only has one IP address.No

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
UHostIdstringTarget UHost IDNo

Example

Request Example

https://api.ucloud-global.com/?Action=ModifyUHostIP
&Region=cn-bj2
&Zone=cn-bj2-04
&PresentIpAddress=192.168.0.77
&UHostId=uhost-xxxxx

Response Example

{
  "Action": "ModifyUHostIPResponse",
  "RetCode": 0,
  "UHostId": "uhost-xxxxx"
}