更新一个终端节点。
请求频率:每秒最多调用 10 次。
除了以下参数,您还需要 对请求进行鉴权。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | UpdateResolverEndpoint | 要执行的操作,取值:UpdateResolverEndpoint。 |
Version | String | 是 | 2022-06-01 | API的版本,取值:2022-06-01。 |
EndpointID | Long | 是 | 123 | 终端节点的 ID。您可以从以下 API 的响应中获取: |
Name | String | 否 | endpoint1 | 终端节点的名称。支持 UTF-8 格式。如果您不传入该参数,该参数的值不会变化。 |
EndpointType | String | 否 | IPv4 | 终端节点类型。
|
EndpointTrn | String | 否 | trn:private_zone::21******4::endpoint/ep-1234 | 终端节点的 TRN。格式为 |
IpConfigs | Array of Object | 否 |
| 终端节点的可用区、子网和 IP 配置。 如果您不传入该参数,该参数的值不会变化。 |
本接口无特有的返回参数。更多信息请见返回结构。
POST https://private-zone.volcengineapi.com/?Action=UpdateResolverEndpoint&Version=2022-06-01 { "EndpointID": 238, "Name": "testEndPoint", "IpConfigs": [ { "AzID": "cn-beijing-a", "SubnetID": "subnet-pedexxxxxxx6puq6gc", "IP": "172.16.0.2" } ] }
{ "ResponseMetadata": { "RequestId": "20230614140553EC822FFD341E9C19EF59", "Action": "UpdateResolverEndpoint", "Version": "2022-06-01", "Service": "private_zone", "Region": "cn" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
|---|---|---|
400 | ErrParamInvalid | 参数校验失败 |
400 | ErrEndpointNotReady | 终端节点未就绪 |
400 | EndpointFailed | 终端节点处于异常状态 |
400 | OutboundIpNotEnough | 至少需要两个出站源IP |
400 | OutboundIpExceedsLimit | 最多指定6个出站源IP |
400 | ErrIPDuplicated | 存在重复指定IP |
400 | ErrInvalidOutboundIp | 指定的弹性网卡IP不合法 |
400 | ErrLimitExceeded | 已达到单次可操作数量的上限 |
400 | ErrIpv4Format | IPv4格式错误 |
400 | ErrIPNotInVpc | 指定的IP不属于子网 |
400 | ErrReservedIP | 不可以指定系统保留IP(%s) |
400 | ErrOutboundIpInUse | 指定的出站IP正在使用中 |
500 | ErrInternalServer | 服务内部错误 |