<fix>[sdk]: ZSTAC-85916 host interface IPv6

[ZStack-Robot]

ZSTAC-85916: add SDK parameter prefixLength for SetIpOnHostNetworkInterfaceAction.\n\nValidation:\n- git diff --check\n- mvn -pl sdk -DskipTests compile

sync from gitlab !10164

[coderabbitai]

Warning

Review limit reached

@MatheMatrix, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 10 minutes and 45 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 6f741afc-3b54-4f60-adf9-14d32f55d675

📥 Commits

Reviewing files that changed from the base of the PR and between 39840be and 5329923.

📒 Files selected for processing (80)

• compute/src/main/java/org/zstack/compute/allocator/HostAllocatorManagerImpl.java
• compute/src/main/java/org/zstack/compute/allocator/TagAllocatorFlow.java
• compute/src/main/java/org/zstack/compute/host/HostApiInterceptor.java
• compute/src/main/java/org/zstack/compute/vm/VmCreateOnHypervisorFlow.java
• compute/src/main/java/org/zstack/compute/vm/VmInstantiateResourceForChangeImageFlow.java
• compute/src/main/java/org/zstack/compute/vm/VmInstantiateResourcePostFlow.java
• compute/src/main/java/org/zstack/compute/vm/VmInstantiateResourcePreFlow.java
• compute/src/main/java/org/zstack/compute/vm/VmReleaseResourceFlow.java
• compute/src/main/java/org/zstack/compute/vm/VmStartOnHypervisorFlow.java
• conf/deploydb.sh
• conf/deployuidb.sh
• console/src/main/java/org/zstack/console/ConsoleManagerImpl.java
• console/src/main/java/org/zstack/console/ConsoleProxyBase.java
• core/src/main/java/org/zstack/core/Platform.java
• core/src/main/java/org/zstack/core/agent/AgentManagerImpl.java
• core/src/main/java/org/zstack/core/ansible/AnsibleRunner.java
• core/src/main/java/org/zstack/core/ansible/CallBackNetworkChecker.java
• core/src/main/java/org/zstack/core/cloudbus/CloudBusImpl3.java
• core/src/main/java/org/zstack/core/config/GlobalConfig.java
• core/src/main/java/org/zstack/core/config/GlobalConfigConstant.java
• core/src/main/java/org/zstack/core/config/GlobalConfigFacadeImpl.java
• core/src/main/java/org/zstack/core/db/DatabaseFacadeImpl.java
• core/src/main/java/org/zstack/core/db/GLock.java
• core/src/main/java/org/zstack/core/db/Q.java
• core/src/main/java/org/zstack/core/db/SimpleQueryImpl.java
• core/src/main/java/org/zstack/core/rest/RESTFacadeImpl.java
• core/src/main/java/org/zstack/core/timeout/ApiTimeoutManagerImpl.java
• header/src/main/java/org/zstack/header/rest/RESTFacade.java
• network/src/main/java/org/zstack/network/l3/L3NetworkApiInterceptor.java
• plugin/applianceVm/src/main/java/org/zstack/appliancevm/ApplianceVmConstant.java
• plugin/applianceVm/src/main/java/org/zstack/appliancevm/ApplianceVmFacadeImpl.java
• plugin/ceph/src/main/java/org/zstack/storage/ceph/MonUri.java
• plugin/ceph/src/main/java/org/zstack/storage/ceph/backup/CephBackupStorageMetaDataMaker.java
• plugin/ceph/src/main/java/org/zstack/storage/ceph/backup/CephBackupStorageMonBase.java
• plugin/ceph/src/main/java/org/zstack/storage/ceph/primary/CephPrimaryStorageBase.java
• plugin/ceph/src/main/java/org/zstack/storage/ceph/primary/CephPrimaryStorageMonBase.java
• plugin/kvm/src/main/java/org/zstack/kvm/KVMConsoleHypervisorBackend.java
• plugin/kvm/src/main/java/org/zstack/kvm/KVMHost.java
• plugin/kvm/src/main/java/org/zstack/kvm/KVMHostFactory.java
• plugin/kvm/src/main/java/org/zstack/kvm/KVMHostUtils.java
• plugin/kvm/src/main/java/org/zstack/kvm/KvmHostIpmiPowerExecutor.java
• plugin/nfsPrimaryStorage/src/main/java/org/zstack/storage/primary/nfs/NfsApiParamChecker.java
• plugin/virtualRouterProvider/src/main/java/org/zstack/network/service/virtualrouter/VirtualRouter.java
• plugin/virtualRouterProvider/src/main/java/org/zstack/network/service/virtualrouter/VirtualRouterApiInterceptor.java
• plugin/virtualRouterProvider/src/main/java/org/zstack/network/service/virtualrouter/VirtualRouterManager.java
• plugin/virtualRouterProvider/src/main/java/org/zstack/network/service/virtualrouter/VirtualRouterManagerImpl.java
• plugin/virtualRouterProvider/src/main/java/org/zstack/network/service/virtualrouter/lifecycle/VirtualRouterDeployAgentFlow.java
• plugin/virtualRouterProvider/src/main/java/org/zstack/network/service/virtualrouter/vyos/VyosConnectFlow.java
• plugin/vxlan/src/main/java/org/zstack/network/l2/vxlan/vxlanNetworkPool/APICreateVxlanPoolRemoteVtepMsg.java
• plugin/vxlan/src/main/java/org/zstack/network/l2/vxlan/vxlanNetworkPool/APIDeleteVxlanPoolRemoteVtepMsg.java
• plugin/vxlan/src/main/java/org/zstack/network/l2/vxlan/vxlanNetworkPool/VxlanNetworkPoolConstant.java
• plugin/vxlan/src/main/java/org/zstack/network/l2/vxlan/vxlanNetworkPool/VxlanPoolApiInterceptor.java
• plugin/zbs/src/main/java/org/zstack/storage/zbs/MdsUri.java
• plugin/zbs/src/main/java/org/zstack/storage/zbs/ZbsAgentUrl.java
• resourceconfig/src/main/java/org/zstack/resourceconfig/ResourceConfig.java
• resourceconfig/src/main/java/org/zstack/resourceconfig/ResourceConfigFacadeImpl.java
• sdk/src/main/java/org/zstack/sdk/CreateVxlanPoolRemoteVtepAction.java
• sdk/src/main/java/org/zstack/sdk/DeleteVxlanPoolRemoteVtepAction.java
• sdk/src/main/java/org/zstack/sdk/SetIpOnHostNetworkInterfaceAction.java
• storage/src/main/java/org/zstack/storage/primary/PrimaryStorageFeatureAllocatorFlow.java
• storage/src/main/java/org/zstack/storage/primary/PrimaryStorageTagAllocatorFlow.java
• test/src/test/groovy/org/zstack/compute/host/HostApiInterceptorIpv6Case.groovy
• test/src/test/groovy/org/zstack/kvm/KVMHostFactoryIpv6Case.groovy
• test/src/test/groovy/org/zstack/test/integration/appliancevm/ApplianceVmIpv6Case.groovy
• test/src/test/groovy/org/zstack/test/integration/console/ConsoleProxyCase.groovy
• test/src/test/groovy/org/zstack/test/integration/core/ManagementNetworkIpv6Case.groovy
• test/src/test/groovy/org/zstack/test/integration/core/MustFailCase.groovy
• test/src/test/groovy/org/zstack/test/integration/kvm/host/KvmHostIpv6Case.groovy
• test/src/test/groovy/org/zstack/test/integration/network/l3network/ipv6/Ipv6RangeCase.groovy
• test/src/test/groovy/org/zstack/test/integration/network/vxlanNetwork/AddRemoteVxlanVtepIpCase.groovy
• test/src/test/groovy/org/zstack/test/integration/storage/primary/addon/zbs/ZbsPrimaryStorageCase.groovy
• test/src/test/java/org/zstack/test/kvm/KVMHostUtilsTest.java
• utils/src/main/java/org/zstack/utils/TagUtils.java
• utils/src/main/java/org/zstack/utils/URLBuilder.java
• utils/src/main/java/org/zstack/utils/clouderrorcode/CloudOperationsErrorCode.java
• utils/src/main/java/org/zstack/utils/network/IPv6NetworkUtils.java
• utils/src/main/java/org/zstack/utils/network/NetworkUtils.java
• utils/src/main/java/org/zstack/utils/ssh/Ssh.java
• utils/src/main/java/org/zstack/utils/ssh/SshShell.java
• utils/src/main/java/org/zstack/utils/zsha2/ZSha2Helper.java

Warning

.coderabbit.yaml has a parsing error

The CodeRabbit configuration file in this repository has a parsing error and default settings were used instead. Please fix the error(s) in the configuration file. You can initialize chat with CodeRabbit to get help with the configuration file.

💥 Parsing errors (1)

Could not fetch remote config from http://open.zstack.ai:20001/code-reviews/zstack-cloud.yaml: TimeoutError: The operation was aborted due to timeout

⚙️ Configuration instructions

• Please see the configuration documentation for more information.
• You can also validate your configuration using the online YAML validator.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

功能总结

在 SetIpOnHostNetworkInterfaceAction 操作类中新增可选参数 prefixLength，用于设置主机网络接口时传递 IP 前缀长度，该参数使用 @Param 注解并约束取值范围为 0 到 128。

变更详情

IP 配置参数扩展

层级 / 文件	说明
前缀长度参数声明 sdk/src/main/java/org/zstack/sdk/SetIpOnHostNetworkInterfaceAction.java	新增 prefixLength 字段作为可选参数，使用 @Param 注解添加数值范围约束（0L 至 128L），用于在设置主机网络接口 IP 时指定前缀长度。

代码审查工作量估计

🎯 1 (微不足道) | ⏱️ ~3 分钟

诗句

一个参数悄然而至，
前缀长度有了约束，
从零到一百二十八，
网络接口更加智慧。🐰✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	标题清晰明确地说明了主要变更内容，即为 SDK 添加 IPv6 支持的相关修复。
Description check	✅ Passed	描述与变更集相关，解释了为 SetIpOnHostNetworkInterfaceAction 添加 prefixLength 参数以支持 IPv6 配置。
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch sync/shixin.ruan/shixin-ZSTAC-85916@@3

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}