You need to enable JavaScript to run this app.
文档中心
私网连接

私网连接

复制全文
下载 pdf
终端节点连接
ModifyVpcEndpointZoneConnectionResourceAttributes - 修改终端节点连接的服务资源
复制全文
下载 pdf
ModifyVpcEndpointZoneConnectionResourceAttributes - 修改终端节点连接的服务资源
调用ModifyVpcEndpointZoneConnectionResourceAttributes接口,为终端节点连接更换服务资源。​
说明​
私网连接支持更换服务资源的功能正在邀测中,如需使用,请联系客户经理。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Action String 必选 示例值:ModifyVpcEndpointZoneConnectionResourceAttributes​
要执行的操作,取值:ModifyVpcEndpointZoneConnectionResourceAttributes。​
​
Version String 必选 示例值:2020-04-01​
API的版本信息,当前版本为 2020-04-01。​
​
EndpointId String 必选 示例值:ep-273yuq6q7bgn47fap8squ****​
终端节点的ID。​
您可以调用DescribeVpcEndpoints接口,获取终端节点的ID。​
​
ServiceId String 必选 示例值:epsvc-2fe630gurkl37k5gfuy33****​
终端节点服务的ID。​
您可以调用DescribeVpcEndpointServices接口,获取终端节点服务的ID。​
​
ResourceReplaceMode String 必选 示例值:grace​
更换服务资源的模式。​
  • grace:平滑更换。当前终端节点网卡与旧的服务资源连接保持不变,终端节点新建一张网卡,通过该网卡与新的服务资源建立连接。新增流量默认发往新连接,待旧连接无流量后,您需要调用DisableVpcEndpointConnection接口,手动断开旧连接。​
说明​
平滑切换是通过终端节点新增一张网卡建立连接的方式,请充分评估业务影响后,谨慎操作。​
  • force:立即更换。终端节点网卡立即与原有服务资源断开连接,并与新的服务资源建立连接。​
​
ZoneId String 必选 示例值:cn-guangzhou-a​
更换后的服务资源所属的可用区ID。​
​
ResourceId String 必选 示例值:clb-y1u2q56redg5tgfadfsur****​
更换后的服务资源ID。​
​
​
​
返回参数​
RequestId String 示例值:0ED8D006-F706-4D23-88ED-E11ED28D****​
请求ID。​
​
​
​
请求示例​
​
GET /?Action=ModifyVpcEndpointZoneConnectionResourceAttributes&Version=2020-04-01&EndpointId=ep-273yuq6q7bgn47fap8squ****&ServiceId=epsvc-2fe630gurkl37k5gfuy33****&ResourceReplaceMode=grace&ZoneId=cn-guangzhou-a&ResourceId=clb-y1u2q56redg5tgfadfsur**** HTTP/1.1​
Host: privatelink.cn-guangzhou.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-guangzhou/privatelink/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****",​
"Action": "ModifyVpcEndpointZoneConnectionResourceAttributes",​
"Version": "2020-04-01",​
"Service": "privatelink",​
"Region": "cn-guangzhou"​
},​
"Result": {​
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****"​
}​
}​
​
错误码​
此处仅展示当前API的错误码,更多错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
InsufficientIpInSubnet​
The specified subnet does not contain enough free private IP addresses to fulfill your request.​
指定子网下可用IP不足。​
400​
InvalidEndpoint.InvalidStatus​
The specified endpoint is not in the correct status for the request.​
指定的终端节点所处的状态无法响应该请求。​
400​
InvalidEndpoint.ServiceMisMatch​
The specified endpoint and service don't match.​
指定的终端节点和终端节点服务不匹配。​
400​
InvalidEndpointService.InvalidLock​
The operation is refused by the endpoint service.​
终端节点服务无法支持该操作。​
400​
InvalidEndpointZone.InvalidStatus​
The specified EndpointZone is not in the correct status for the request.​
指定的终端节点可用区所处的状态无法响应该请求。​
400​
InvalidEndpointZoneIPVersion.AddressMismatch​
The specified EndpointZone AddressIPVersion and address are not matched.​
指定的终端节点可用区地址与终端节点IP地址类型不匹配。​
400​
InvalidFusionClusterEndpoint.ResourceNotMatch​
The endpoint zone of the fusion cluster is not allowed to replace the load balancer of non-fusion cluster.​
指定的负载均衡实例是非融合集群实例,不支持被替换到融合集群的终端节点可用区。​
400​
InvalidReplaceResource.TypeInconsistent​
The types of specified resource and the replaced resource are inconsistent.​
指定的服务资源与被替换的服务资源类型不一致。​
400​
InvalidReplaceResource.ZoneMismatch​
The available zones of specified resource and the replaced resource are not matched.​
指定的服务资源与被替换的服务资源的可用区不匹配。​
400​
InvalidResource.Conflict​
The specified resource is duplicated.​
指定的资源重复。​
400​
InvalidResourceReplaceMode.Malformed​
The specified ResourceReplaceMode is malformed.​
指定的服务资源切换模式不合法。​
400​
InvalidResourceType.Malformed​
The specified ResourceType is malformed.​
指定的 ResourceType 参数格式不合法。​
400​
InvalidServiceResourceType.Malformed​
The specified ServiceResourceType is malformed.​
指定的 ServiceResourceType 参数格式不合法。​
400​
InvalidServiceType.Malformed​
The specified ServiceType is malformed.​
指定的 ServiceType 参数格式不合法。​
400​
InvalidSubnet.VpcMisMatch​
The specified subnet and vpc don't match.​
指定的私有网络和子网不匹配。​
400​
InvalidSubnet.ZoneMisMatch​
The specified subnet and available zone don't match.​
指定的可用区和子网不匹配。​
400​
UnsupportedOperation.AccountArrears​
The request on the specified instance is denied due to the account in arrears status.​
因账户处于欠费状态,对于该实例的操作请求被拒绝。​
400​
UnsupportedOperation.ReplaceResourceConflict​
The specified endpoint connection has not completed the service resource replacement. Please disconnect the service resource first.​
指定的终端节点连接尚未完成服务资源更换,请先断开服务资源。​
403​
Forbidden​
You are not authorized to perform operations on the specified service.​
无权限对指定服务进行操作。​
404​
InvalidEndpoint.NotFound​
The specified endpoint does not exist.​
指定的终端节点不存在。​
404​
InvalidEndpointService.NotFound​
The specified EndpointService does not exist.​
指定的终端节点服务不存在。​
404​
InvalidEndpointZone.NotFound​
The specified zone does not exist.​
指定的可用区不存在。​
404​
InvalidServiceResource.NotFound​
The specified ServiceResource does not exist.​
指定的服务资源不存在。​
404​
InvalidSubnet.NotFound​
The specified subnet does not exist.​
指定的子网不存在。​
500​
NetworkInterfaceCreateFailed​
The network interface create failed.​
可用区下的网卡创建失败。​
​
​
最近更新时间:2026.01.05 11:33:45
这个页面对您有帮助吗?
有用
有用
无用
无用