ModifyHaVipAttributes--私有网络-火山引擎

文档中心

立即注册

导航

ModifyHaVipAttributes

最近更新时间：2024.08.07 15:47:07首次发布时间：2022.03.01 09:03:59

调用 ModifyHaVipAttributes 接口，修改高可用虚拟IP（HAVIP）的名称、描述。

说明

高可用虚拟IP正在邀测中，暂仅支持完成企业认证的账号申请试用，如需试用，请联系客户经理。

调用说明

以下可选参数如不配置，则保持原有配置。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数名称	类型	是否必选	示例值	描述
Action	String	是	ModifyHaVipAttributes	要执行的操作，取值：ModifyHaVipAttributes。
Version	String	是	2020-04-01	API版本信息，取值为：2020-04-01。
HaVipId	String	是	havip-2zeo05qre24nhrqp****	要修改高可用虚拟IP的ID。您可以调用 DescribeHaVips 接口，查询高可用虚拟IP的ID。
HaVipName	String	否	havip-1	高可用虚拟IP的名称。长度限制为1 ~ 128个字符。需要以字母、中文或数字开头，可包含点号（.）、下划线（_）和短横线（-）。
Description	String	否	This is my HaVip.	高可用虚拟IP的描述。长度限制为0~ 255个字符。需要以字母、中文或数字开头。可包含英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。

返回数据

参数名称	类型	示例值	描述
RequestId	String	F3CD6886-D8D0-4FEE-B93E-1B732396****	请求ID。

请求示例

GET /?Action=ModifyHaVipAttributes&Version=2020-04-01&HaVipId=havip-2zeo05qre24nhrqp****&Description=This is my HaVip.&HaVipName=havip-1 HTTP/1.1
Host: open.volcengineapi.com  
Service: vpc
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B732396****",
        "Action": "ModifyHaVipAttributes",
        "Version": "2020-04-01",
        "Service": "vpc",
        "Region": "cn-beijing"
    },
    "Result": {
        "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B732396****"
    }
}

错误码

此处仅展示当前API的错误码，更多错误码请参见公共错误码。

HttpCode	错误码	错误信息	描述
400	InvalidHaVip.InvalidStatus	The specified HaVip is not in the correct status for the request.	指定的高可用虚拟IP所处状态无法响应该请求。
400	InvalidName.Malformed	The specified name is malformed. Ensure the maximum length of name is 128.	指定的名称格式不合法。名称长度不能超过128个字符。
400	InvalidName.Malformed	The specified name is malformed.	指定的名称格式不合法。请修复名称格式后重试。
400	InvalidDescription.Malformed	The specified description is malformed. Ensure the maximum length of description is 255.	指定的描述格式不合法。描述长度不能超过255个字符。
400	InvalidDescription.Malformed	The specified description is malformed.	指定的描述格式不合法。请修复描述格式后重试。
404	InvalidHaVip.NotFound	The specified HaVip does not exist.	指定的高可用虚拟IP不存在。