You need to enable JavaScript to run this app.
导航
UpdateResolverEndpoint - 更新终端节点
最近更新时间:2025.09.18 11:10:40首次发布时间:2023.06.26 20:59:38
复制全文
我的收藏
有用
有用
无用
无用

更新一个终端节点。

使用说明

请求频率:每秒最多调用 10 次。

请求说明

  • 请求方式:POST
  • 请求地址:https://private-zone.volcengineapi.com/?Action=UpdateResolverEndpoint?Version=2022-06-01

调试

请求参数

除了以下参数,您还需要 对请求进行鉴权

参数
类型
是否必填
示例值
描述
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

终端节点类型。

  • IPv4:IPv4 节点。
  • DualStack:双栈节点。
EndpointTrn
String

trn:private_zone::21******4::endpoint/ep-1234

终端节点的 TRN。格式为 trn:private_zone::accountId::endpoint/ep-endpointId。如果您需要验证子用户是否对终端节点所在的项目有操作权限,您需要传入该参数。

IpConfigs
Array of Object
[
    {
        "AzID": "cn-beijing-a",
        "SubnetID": "subnet-pedexxxxxxx6puq6gc",
        "IP": "172.16.0.2"
    }
]

终端节点的可用区、子网和 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

validation fail: params:[%s] , value:[%v]

参数校验失败

400
ErrEndpointNotReady

endpoint in creating or updating status

终端节点未就绪

400
EndpointFailed

endpoint in error status

终端节点处于异常状态

400
OutboundIpNotEnough

at least 2 outbound IPs required

至少需要两个出站源IP

400
OutboundIpExceedsLimit

at most 6 outbound IPs can be specified

最多指定6个出站源IP

400
ErrIPDuplicated

%s duplicated

存在重复指定IP

400
ErrInvalidOutboundIp

the specified ip %s is malformed

指定的弹性网卡IP不合法

400
ErrLimitExceeded

you've reached the limit on the number of %s that you can operate at one time

已达到单次可操作数量的上限

400
ErrIpv4Format

error format %s

IPv4格式错误

400
ErrIPNotInVpc

%s does not belong to %s

指定的IP不属于子网

400
ErrReservedIP

reserved ip %s is not allowed to use

不可以指定系统保留IP(%s)

400
ErrOutboundIpInUse

specified ip %s of %s is in use

指定的出站IP正在使用中

500
ErrInternalServer

server internal error

服务内部错误