最近更新时间:2024.04.11 14:29:32
首次发布时间:2022.03.01 09:03:59
调用 CreateHaVip 接口,创建一个高可用虚拟IP(HAVIP)。
说明
高可用虚拟IP功能正在邀测中,如需试用,请联系客户经理。
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateHaVip | 要执行的操作,取值:CreateHaVip。 |
Version | String | 是 | 2020-04-01 | API版本信息,取值为:2020-04-01。 |
SubnetId | String | 是 | subnet-bp1s5fn4gn2tws03**** | 高可用虚拟IP所属子网的ID,该子网将为高可用虚拟IP提供IP地址。 |
IpAddress | String | 否 | 192.XX.XX.10 | 高可用虚拟IP的IP地址。
|
HaVipName | String | 否 | havip-1 | 高可用虚拟IP的名称。
|
Description | String | 否 | This is my HaVip. | 高可用虚拟IP的描述信息。
|
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 客户端Token,用于保证请求幂等性。
|
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
HaVipId | String | havip-2zeo05qre24nhrqpy**** | 新创建高可用虚拟IP的ID。 |
IpAddress | String | 192.XX.XX.10 | 新创建高可用虚拟IP的IP地址。 |
RequestId | String | C44F62BE-9CE7-4277-B117-69243F39**** | 请求ID。 |
GET /?Action=CreateHaVip&Version=2020-04-01&SubnetId=subnet-ina9r9xnfpc08gbs****&IpAddress=192.XX.XX.10&HaVipName=havip-1 HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing
{ "ResponseMetadata": { "RequestId": "202201271634510102251100110614****", "Action": "CreateHaVip", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result": { "RequestId": "202201271634510102251100110614****", "HaVipId": "havip-12awu7gcpmdxc17q7y23q****", "IpAddress": "192.XX.XX.10" } }
此处仅展示当前API的错误码,更多错误码请参见公共错误码。
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | IdempotentParameterMismatch | Arguments on this idempotent request are inconsistent with arguments used in previous request(s). | 此幂等请求的参数与前一个请求中使用的参数不一致。 |
400 | InsufficientIpInSubnet | The specified subnet does not contain enough free private IP addresses to fulfill your request. | 指定子网下可用IP不足。 |
400 | InvalidDescription.Malformed | The specified description is malformed. | 指定的描述格式不合法。请修复描述格式后重试。 |
400 | InvalidDescription.Malformed | The specified description is malformed. Ensure the maximum length of description is 255. | 指定的描述格式不合法。描述长度不能超过255个字符。 |
400 | InvalidIpAddress.Malformed | The specified IP address is malformed. Ensure that the IP address of the HaVip is in the range of the CIDR block of the subnet. | 指定高可用虚拟IP的IP地址不合法。请确保高可用虚拟IP的IP地址必须从属于所在子网的网段。 |
400 | InvalidName.Malformed | The specified name is malformed. | 指定的名称格式不合法。请修复名称格式后重试。 |
400 | InvalidName.Malformed | The specified name is malformed. Ensure the maximum length of name is 128. | 指定的名称格式不合法。名称长度不能超过128个字符。 |
400 | InvalidParameter.ClientTokenMalformed | The specified parameter ClientToken is malformed. | 指定的参数ClientToken格式不合法,长度不能超过64个ASCII字符。 |
400 | InvalidPrivateIp.Malformed | The specified private ip is malformed. | 指定的私网IP不合法。 |
400 | QuotaExceeded.HaVip | HaVip number exceeded quota. | 当前账户在一个地域下已达到可创建高可用虚拟IP的数量上限。 |
400 | QuotaExceeded.HaVip | HaVip number of VPC exceeded quota. | 当前私有网络已达到可创建高可用虚拟IP的数量上限。 |
403 | Forbidden | You are not authorized to create HaVip. | 您无权限创建高可用虚拟IP。 |
404 | InvalidSubnet.NotFound | The specified subnet does not exist. | 指定的子网不存在。 |
409 | InvalidIpAddress.InUse | The specified IP address is in use. | 指定的IP地址已被占用。 |
412 | IdempotentProcessing | The request uses the same client token as a previous one that is still in process. | 幂等请求处理中。 |