apolloconfig · hezhangjian · Oct 21, 2025 · Oct 21, 2025
diff --git a/apollo-openapi.yaml b/apollo-openapi.yaml
@@ -2395,6 +2395,7 @@ paths:
   /openapi/v1/envs/{env}/releases/{releaseId}/instances:
     get:
       summary: 根据发布版本查询实例（支持分页） (new added)
+      operationId: getByRelease
       deprecated: false
       description: GET /openapi/v1/envs/{env}/releases/{releaseId}/instances
       tags:
@@ -2461,9 +2462,10 @@ paths:
                         dataChangeLastModifiedTime: ''
                     dataChangeCreatedTime: ''
           headers: {}
-  /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances_not_int: # avoidng confliction with other server endpoint
+  /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances_not_in: # avoidng confliction with other server endpoint
     get:
       summary: 查询不在指定发布版本中的实例 (new added)
+      operationId: getByReleasesNotIn
       deprecated: false
       description: >-
         GET

diff --git a/java-client/README.md b/java-client/README.md
@@ -149,9 +149,9 @@ Class | Method | HTTP request | Description
 *ClusterManagementApi* | [**createCluster**](docs/ClusterManagementApi.md#createCluster) | **POST** /openapi/v1/envs/{env}/apps/{appId}/clusters | 创建集群 (original openapi)
 *ClusterManagementApi* | [**deleteCluster**](docs/ClusterManagementApi.md#deleteCluster) | **DELETE** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName} | 删除集群 (new added)
 *ClusterManagementApi* | [**getCluster**](docs/ClusterManagementApi.md#getCluster) | **GET** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName} | 获取指定集群信息 (original openapi)
+*InstanceManagementApi* | [**getByRelease**](docs/InstanceManagementApi.md#getByRelease) | **GET** /openapi/v1/envs/{env}/releases/{releaseId}/instances | 根据发布版本查询实例（支持分页） (new added)
+*InstanceManagementApi* | [**getByReleasesNotIn**](docs/InstanceManagementApi.md#getByReleasesNotIn) | **GET** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances_not_in | 查询不在指定发布版本中的实例 (new added)
 *InstanceManagementApi* | [**getInstanceCountByNamespace**](docs/InstanceManagementApi.md#getInstanceCountByNamespace) | **GET** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances | 获取命名空间下的实例数量 (original openapi)
-*InstanceManagementApi* | [**openapiV1EnvsEnvAppsAppIdClustersClusterNameNamespacesNamespaceNameInstancesNotIntGet**](docs/InstanceManagementApi.md#openapiV1EnvsEnvAppsAppIdClustersClusterNameNamespacesNamespaceNameInstancesNotIntGet) | **GET** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances_not_int | 查询不在指定发布版本中的实例 (new added)
-*InstanceManagementApi* | [**openapiV1EnvsEnvReleasesReleaseIdInstancesGet**](docs/InstanceManagementApi.md#openapiV1EnvsEnvReleasesReleaseIdInstancesGet) | **GET** /openapi/v1/envs/{env}/releases/{releaseId}/instances | 根据发布版本查询实例（支持分页） (new added)
 *ItemManagementApi* | [**batchUpdateItemsByText**](docs/ItemManagementApi.md#batchUpdateItemsByText) | **PUT** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/items/batchUpdate | 通过文本批量修改配置项 (new added)
 *ItemManagementApi* | [**compareItems**](docs/ItemManagementApi.md#compareItems) | **POST** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/items/compare | 对比命名空间配置差异 (new added)
 *ItemManagementApi* | [**createItem**](docs/ItemManagementApi.md#createItem) | **POST** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/items | 创建新的配置项 (original openapi)

diff --git a/java-client/api/openapi.yaml b/java-client/api/openapi.yaml
@@ -2680,6 +2680,7 @@ paths:
     get:
       deprecated: false
       description: "GET /openapi/v1/envs/{env}/releases/{releaseId}/instances"
+      operationId: getByRelease
       parameters:
       - description: ""
         explode: false
@@ -2754,10 +2755,11 @@ paths:
       tags:
       - Instance Management
       x-accepts: application/json
-  /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances_not_int:
+  /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances_not_in:
     get:
       deprecated: false
       description: "GET /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances?excludeReleases=1,2,3"
+      operationId: getByReleasesNotIn
       parameters:
       - description: 环境标识
         explode: false

diff --git a/java-client/docs/InstanceManagementApi.md b/java-client/docs/InstanceManagementApi.md
@@ -4,18 +4,18 @@ All URIs are relative to *http://localhost*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
+| [**getByRelease**](InstanceManagementApi.md#getByRelease) | **GET** /openapi/v1/envs/{env}/releases/{releaseId}/instances | 根据发布版本查询实例（支持分页） (new added) |
+| [**getByReleasesNotIn**](InstanceManagementApi.md#getByReleasesNotIn) | **GET** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances_not_in | 查询不在指定发布版本中的实例 (new added) |
 | [**getInstanceCountByNamespace**](InstanceManagementApi.md#getInstanceCountByNamespace) | **GET** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances | 获取命名空间下的实例数量 (original openapi) |
-| [**openapiV1EnvsEnvAppsAppIdClustersClusterNameNamespacesNamespaceNameInstancesNotIntGet**](InstanceManagementApi.md#openapiV1EnvsEnvAppsAppIdClustersClusterNameNamespacesNamespaceNameInstancesNotIntGet) | **GET** /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances_not_int | 查询不在指定发布版本中的实例 (new added) |
-| [**openapiV1EnvsEnvReleasesReleaseIdInstancesGet**](InstanceManagementApi.md#openapiV1EnvsEnvReleasesReleaseIdInstancesGet) | **GET** /openapi/v1/envs/{env}/releases/{releaseId}/instances | 根据发布版本查询实例（支持分页） (new added) |
 
 
-<a id="getInstanceCountByNamespace"></a>
-# **getInstanceCountByNamespace**
-> Integer getInstanceCountByNamespace(env, appId, clusterName, namespaceName)
+<a id="getByRelease"></a>
+# **getByRelease**
+> OpenPageDTOOpenInstanceDTO getByRelease(env, releaseId, page, size)
 
-获取命名空间下的实例数量 (original openapi)
+根据发布版本查询实例（支持分页） (new added)
 
-GET /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances
+GET /openapi/v1/envs/{env}/releases/{releaseId}/instances
 
 ### Example
 ```java
@@ -40,14 +40,14 @@ public class Example {
 
     InstanceManagementApi apiInstance = new InstanceManagementApi(defaultClient);
     String env = "env_example"; // String |
-    String appId = "appId_example"; // String | 应用ID
-    String clusterName = "clusterName_example"; // String | 集群名称
-    String namespaceName = "namespaceName_example"; // String | 命名空间名称
+    Integer releaseId = 56; // Integer |
+    Integer page = 0; // Integer |
+    Integer size = 20; // Integer |
     try {
-      Integer result = apiInstance.getInstanceCountByNamespace(env, appId, clusterName, namespaceName);
+      OpenPageDTOOpenInstanceDTO result = apiInstance.getByRelease(env, releaseId, page, size);
       System.out.println(result);
     } catch (ApiException e) {
-      System.err.println("Exception when calling InstanceManagementApi#getInstanceCountByNamespace");
+      System.err.println("Exception when calling InstanceManagementApi#getByRelease");
       System.err.println("Status code: " + e.getCode());
       System.err.println("Reason: " + e.getResponseBody());
       System.err.println("Response headers: " + e.getResponseHeaders());
@@ -62,13 +62,13 @@ public class Example {
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **env** | **String**|  | |
-| **appId** | **String**| 应用ID | |
-| **clusterName** | **String**| 集群名称 | |
-| **namespaceName** | **String**| 命名空间名称 | |
+| **releaseId** | **Integer**|  | |
+| **page** | **Integer**|  | |
+| **size** | **Integer**|  | |
 
 ### Return type
 
-**Integer**
+[**OpenPageDTOOpenInstanceDTO**](OpenPageDTOOpenInstanceDTO.md)
 
 ### Authorization
 
@@ -82,11 +82,11 @@ public class Example {
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | 成功返回实例数量 |  -  |
+| **200** |  |  -  |
 
-<a id="openapiV1EnvsEnvAppsAppIdClustersClusterNameNamespacesNamespaceNameInstancesNotIntGet"></a>
-# **openapiV1EnvsEnvAppsAppIdClustersClusterNameNamespacesNamespaceNameInstancesNotIntGet**
-> List&lt;OpenInstanceDTO&gt; openapiV1EnvsEnvAppsAppIdClustersClusterNameNamespacesNamespaceNameInstancesNotIntGet(env, appId, clusterName, namespaceName, excludeReleases)
+<a id="getByReleasesNotIn"></a>
+# **getByReleasesNotIn**
+> List&lt;OpenInstanceDTO&gt; getByReleasesNotIn(env, appId, clusterName, namespaceName, excludeReleases)
 
 查询不在指定发布版本中的实例 (new added)
 
@@ -120,10 +120,10 @@ public class Example {
     String namespaceName = "namespaceName_example"; // String | 命名空间名称
     String excludeReleases = "excludeReleases_example"; // String | 排除的发布ID列表，用逗号分隔
     try {
-      List<OpenInstanceDTO> result = apiInstance.openapiV1EnvsEnvAppsAppIdClustersClusterNameNamespacesNamespaceNameInstancesNotIntGet(env, appId, clusterName, namespaceName, excludeReleases);
+      List<OpenInstanceDTO> result = apiInstance.getByReleasesNotIn(env, appId, clusterName, namespaceName, excludeReleases);
       System.out.println(result);
     } catch (ApiException e) {
-      System.err.println("Exception when calling InstanceManagementApi#openapiV1EnvsEnvAppsAppIdClustersClusterNameNamespacesNamespaceNameInstancesNotIntGet");
+      System.err.println("Exception when calling InstanceManagementApi#getByReleasesNotIn");
       System.err.println("Status code: " + e.getCode());
       System.err.println("Reason: " + e.getResponseBody());
       System.err.println("Response headers: " + e.getResponseHeaders());
@@ -161,13 +161,13 @@ public class Example {
 |-------------|-------------|------------------|
 | **200** |  |  -  |
 
-<a id="openapiV1EnvsEnvReleasesReleaseIdInstancesGet"></a>
-# **openapiV1EnvsEnvReleasesReleaseIdInstancesGet**
-> OpenPageDTOOpenInstanceDTO openapiV1EnvsEnvReleasesReleaseIdInstancesGet(env, releaseId, page, size)
+<a id="getInstanceCountByNamespace"></a>
+# **getInstanceCountByNamespace**
+> Integer getInstanceCountByNamespace(env, appId, clusterName, namespaceName)
 
-根据发布版本查询实例（支持分页） (new added)
+获取命名空间下的实例数量 (original openapi)
 
-GET /openapi/v1/envs/{env}/releases/{releaseId}/instances
+GET /openapi/v1/envs/{env}/apps/{appId}/clusters/{clusterName}/namespaces/{namespaceName}/instances
 
 ### Example
 ```java
@@ -192,14 +192,14 @@ public class Example {
 
     InstanceManagementApi apiInstance = new InstanceManagementApi(defaultClient);
     String env = "env_example"; // String |
-    Integer releaseId = 56; // Integer |
-    Integer page = 0; // Integer |
-    Integer size = 20; // Integer |
+    String appId = "appId_example"; // String | 应用ID
+    String clusterName = "clusterName_example"; // String | 集群名称
+    String namespaceName = "namespaceName_example"; // String | 命名空间名称
     try {
-      OpenPageDTOOpenInstanceDTO result = apiInstance.openapiV1EnvsEnvReleasesReleaseIdInstancesGet(env, releaseId, page, size);
+      Integer result = apiInstance.getInstanceCountByNamespace(env, appId, clusterName, namespaceName);
       System.out.println(result);
     } catch (ApiException e) {
-      System.err.println("Exception when calling InstanceManagementApi#openapiV1EnvsEnvReleasesReleaseIdInstancesGet");
+      System.err.println("Exception when calling InstanceManagementApi#getInstanceCountByNamespace");
       System.err.println("Status code: " + e.getCode());
       System.err.println("Reason: " + e.getResponseBody());
       System.err.println("Response headers: " + e.getResponseHeaders());
@@ -214,13 +214,13 @@ public class Example {
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **env** | **String**|  | |
-| **releaseId** | **Integer**|  | |
-| **page** | **Integer**|  | |
-| **size** | **Integer**|  | |
+| **appId** | **String**| 应用ID | |
+| **clusterName** | **String**| 集群名称 | |
+| **namespaceName** | **String**| 命名空间名称 | |
 
 ### Return type
 
-[**OpenPageDTOOpenInstanceDTO**](OpenPageDTOOpenInstanceDTO.md)
+**Integer**
 
 ### Authorization
 
@@ -234,4 +234,4 @@ public class Example {
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** |  |  -  |
+| **200** | 成功返回实例数量 |  -  |