ModifyHost_运维安全中心（堡垒机）_API文档-阿里云OpenAPI开发者门户

接口说明

该接口支持修改本地主机、ECS 主机、RDS 专属集群主机的基本信息。

说明如果您修改了 ECS 主机或 RDS 专属集群主机的基本信息，由于堡垒机系统会定期同步 ECS 主机、RDS 专属集群主机的基本信息，修改结果可能会被 ECS 主机或 RDS 专属集群主机所同步的基本信息覆盖。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

yundun-bastionhost:ModifyHost	Update	全部资源 *	无	无

请求参数

字段名称	字段详情
InstanceIdstring	指定要修改的主机所在堡垒机的实例 ID。展开详情示例值:bastionhost-cn-st220aw****参考取值来源: StartInstance DescribeInstances ConfigInstanceWhiteList EnableInstancePublicAccess DisableInstancePublicAccess
RegionIdstring	指定要修改的主机所在堡垒机的区域 ID。展开详情示例值:cn-hangzhou参考取值来源: DescribeRegions
HostIdstring	指定要修改的主机 ID。展开详情示例值:1参考取值来源: ListHosts CreateHost AddHostsToGroup ModifyHostsPort
HostPrivateAddressstring	指定修改后主机的私网地址，可使用域名或 IP 地址。示例值:193.168.XX.XX参考取值来源: ListHostsForUser GetHost
HostPublicAddressstring	指定修改后主机的公网地址，可使用域名或 IP 地址。示例值:200.1.XX.XX参考取值来源: ListHostsForUser GetHost
OSTypestring	指定修改后主机的操作系统类型。取值：展开详情示例值:Linux
HostNamestring	指定修改后主机的名称，最多支持 128 字符。示例值:TestHost参考取值来源: CreateHost GetHost ListHosts
Commentstring	指定修改后主机的备注信息，最多支持 500 字符。示例值:Host for test.
NetworkDomainIdstring	指定修改后主机所属的网络域 ID。展开详情示例值:1参考取值来源: ListNetworkDomains CreateNetworkDomain
PrefKexstring	主机首选密钥交换算法配置。当 OSType 取值为 Linux 时，可以修改本参数。取值：展开详情示例值:default

返回参数

字段名称	字段详情
RequestIdstring	阿里云为该请求生成的唯一标识符。示例值:EC9BF0F4-8983-491A-BC8C-1B4DD94976DE

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidParameter	The argument is invalid.	诊断
400	HostNotFound	The host is not found.	诊断
500	InternalError	An unknown error occurred.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-03-18	新增请求参数PrefKex
	2023-11-27	新增请求参数NetworkDomainId