@alicloud/eas20210701 7.5.6 → 7.6.0

package/dist/client.d.ts

@@ -344,6 +344,42 @@ export default class Client extends OpenApi {
      * @returns CreateServiceMirrorResponse
      */
     createServiceMirror(ClusterId: string, ServiceName: string, request: $_model.CreateServiceMirrorRequest): Promise<$_model.CreateServiceMirrorResponse>;
+    /**
+     * 创建服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **策略互斥**：`Partition`（分区发布）和`Batch`（批量发布）两种策略只能选择其中一种，不能同时使用。
+     * - **请求速率限制**：每秒最多100次请求。
+     * - **授权信息**：需要具备`eas:CreateServiceRollout`权限才能调用此接口。
+     * - **资源ARN**：`acs:eas:{#regionId}:{#accountId}:service/{#ServiceName}`。
+     * - **暂停发布**：通过设置`Paused`参数为`true`可以暂停发布流程，之后可通过`UpdateServiceRollout`接口恢复或取消发布。
+     * - **监控与回滚**：在发布过程中建议持续监控服务指标，以便及时发现并处理问题；如需回滚，可以通过调整`Partition`值或删除发布策略来实现。
+     *
+     * @param request - CreateServiceRolloutRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns CreateServiceRolloutResponse
+     */
+    createServiceRolloutWithOptions(ClusterId: string, ServiceName: string, request: $_model.CreateServiceRolloutRequest, headers: {
+        [key: string]: string;
+    }, runtime: $dara.RuntimeOptions): Promise<$_model.CreateServiceRolloutResponse>;
+    /**
+     * 创建服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **策略互斥**：`Partition`（分区发布）和`Batch`（批量发布）两种策略只能选择其中一种，不能同时使用。
+     * - **请求速率限制**：每秒最多100次请求。
+     * - **授权信息**：需要具备`eas:CreateServiceRollout`权限才能调用此接口。
+     * - **资源ARN**：`acs:eas:{#regionId}:{#accountId}:service/{#ServiceName}`。
+     * - **暂停发布**：通过设置`Paused`参数为`true`可以暂停发布流程，之后可通过`UpdateServiceRollout`接口恢复或取消发布。
+     * - **监控与回滚**：在发布过程中建议持续监控服务指标，以便及时发现并处理问题；如需回滚，可以通过调整`Partition`值或删除发布策略来实现。
+     *
+     * @param request - CreateServiceRolloutRequest
+     * @returns CreateServiceRolloutResponse
+     */
+    createServiceRollout(ClusterId: string, ServiceName: string, request: $_model.CreateServiceRolloutRequest): Promise<$_model.CreateServiceRolloutResponse>;
     /**
      * Creates a virtual resource group.
      *
@@ -686,6 +722,44 @@ export default class Client extends OpenApi {
      * @returns DeleteServiceMirrorResponse
      */
     deleteServiceMirror(ClusterId: string, ServiceName: string, request: $_model.DeleteServiceMirrorRequest): Promise<$_model.DeleteServiceMirrorResponse>;
+    /**
+     * 删除服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **不可恢复**：删除操作不可撤销，请谨慎操作。
+     * - **不自动回退**：删除策略不会回退已更新的副本。
+     * - **停止发布**：正在进行的发布会立即停止。
+     * - **状态保留**：已更新的副本保持新版本，未更新的保持旧版本。
+     * - 删除后，后续服务更新将采用默认的滚动更新方式。
+     * - 在删除前，请确认要删除的服务名称和地域，并了解当前发布状态（可以通过调用`DescribeServiceRollout`接口获取）。
+     * - 如果需要回退版本，请在删除策略后通过重新创建策略或直接更新服务镜像来实现。
+     *
+     * @param request - DeleteServiceRolloutRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DeleteServiceRolloutResponse
+     */
+    deleteServiceRolloutWithOptions(ClusterId: string, ServiceName: string, request: $_model.DeleteServiceRolloutRequest, headers: {
+        [key: string]: string;
+    }, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteServiceRolloutResponse>;
+    /**
+     * 删除服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **不可恢复**：删除操作不可撤销，请谨慎操作。
+     * - **不自动回退**：删除策略不会回退已更新的副本。
+     * - **停止发布**：正在进行的发布会立即停止。
+     * - **状态保留**：已更新的副本保持新版本，未更新的保持旧版本。
+     * - 删除后，后续服务更新将采用默认的滚动更新方式。
+     * - 在删除前，请确认要删除的服务名称和地域，并了解当前发布状态（可以通过调用`DescribeServiceRollout`接口获取）。
+     * - 如果需要回退版本，请在删除策略后通过重新创建策略或直接更新服务镜像来实现。
+     *
+     * @param request - DeleteServiceRolloutRequest
+     * @returns DeleteServiceRolloutResponse
+     */
+    deleteServiceRollout(ClusterId: string, ServiceName: string, request: $_model.DeleteServiceRolloutRequest): Promise<$_model.DeleteServiceRolloutResponse>;
     /**
      * Deletes a virtual resource group that contains no resources or instances.
      *
@@ -1043,6 +1117,42 @@ export default class Client extends OpenApi {
      * @returns DescribeServiceMirrorResponse
      */
     describeServiceMirror(ClusterId: string, ServiceName: string, request: $_model.DescribeServiceMirrorRequest): Promise<$_model.DescribeServiceMirrorResponse>;
+    /**
+     * 查看服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - 该接口用于查询特定服务的发布策略（Rollout）配置和当前执行状态。
+     * - 返回的信息包括但不限于发布策略的具体参数、当前发布进度等。
+     * - 请求时需提供`ClusterId`和服务名称`ServiceName`作为路径参数。
+     * - 注意，请求速率限制为每秒最多100次。
+     * - 如果服务不存在或未创建发布策略，调用此接口将返回错误。
+     * - 返回的状态是实时查询的结果，可能会随时间而变化，请根据实际需要调整轮询间隔。
+     *
+     * @param request - DescribeServiceRolloutRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DescribeServiceRolloutResponse
+     */
+    describeServiceRolloutWithOptions(ClusterId: string, ServiceName: string, request: $_model.DescribeServiceRolloutRequest, headers: {
+        [key: string]: string;
+    }, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeServiceRolloutResponse>;
+    /**
+     * 查看服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - 该接口用于查询特定服务的发布策略（Rollout）配置和当前执行状态。
+     * - 返回的信息包括但不限于发布策略的具体参数、当前发布进度等。
+     * - 请求时需提供`ClusterId`和服务名称`ServiceName`作为路径参数。
+     * - 注意，请求速率限制为每秒最多100次。
+     * - 如果服务不存在或未创建发布策略，调用此接口将返回错误。
+     * - 返回的状态是实时查询的结果，可能会随时间而变化，请根据实际需要调整轮询间隔。
+     *
+     * @param request - DescribeServiceRolloutRequest
+     * @returns DescribeServiceRolloutResponse
+     */
+    describeServiceRollout(ClusterId: string, ServiceName: string, request: $_model.DescribeServiceRolloutRequest): Promise<$_model.DescribeServiceRolloutResponse>;
     /**
      * Obtains the logon-free URL of the service.
      *
@@ -1908,6 +2018,40 @@ export default class Client extends OpenApi {
      * @returns UpdateServiceMirrorResponse
      */
     updateServiceMirror(ClusterId: string, ServiceName: string, request: $_model.UpdateServiceMirrorRequest): Promise<$_model.UpdateServiceMirrorResponse>;
+    /**
+     * 更新服务发布计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **至少提供一个参数**：必须在请求中指定`Partition`、`Batch`或`Paused`中的至少一个参数。
+     * - **互斥策略**：不能同时提供`Partition`和`Batch`配置。
+     * - **实时生效**：更新将立即生效，影响正在进行的服务发布过程。
+     * - **回退操作**：通过增加`Partition`值可以实现版本回退，但不会自动触发，需要手动更新服务镜像。
+     * - **暂停不影响参数**：暂停发布不会改变已设置的`Partition`或`Batch`参数，仅暂停执行当前策略。
+     *
+     * @param request - UpdateServiceRolloutRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns UpdateServiceRolloutResponse
+     */
+    updateServiceRolloutWithOptions(ClusterId: string, ServiceName: string, request: $_model.UpdateServiceRolloutRequest, headers: {
+        [key: string]: string;
+    }, runtime: $dara.RuntimeOptions): Promise<$_model.UpdateServiceRolloutResponse>;
+    /**
+     * 更新服务发布计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **至少提供一个参数**：必须在请求中指定`Partition`、`Batch`或`Paused`中的至少一个参数。
+     * - **互斥策略**：不能同时提供`Partition`和`Batch`配置。
+     * - **实时生效**：更新将立即生效，影响正在进行的服务发布过程。
+     * - **回退操作**：通过增加`Partition`值可以实现版本回退，但不会自动触发，需要手动更新服务镜像。
+     * - **暂停不影响参数**：暂停发布不会改变已设置的`Partition`或`Batch`参数，仅暂停执行当前策略。
+     *
+     * @param request - UpdateServiceRolloutRequest
+     * @returns UpdateServiceRolloutResponse
+     */
+    updateServiceRollout(ClusterId: string, ServiceName: string, request: $_model.UpdateServiceRolloutRequest): Promise<$_model.UpdateServiceRolloutResponse>;
     /**
      * Updates the safety lock of a service to minimize misoperations on the service.
      *

package/dist/client.js

@@ -1009,6 +1009,72 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.createServiceMirrorWithOptions(ClusterId, ServiceName, request, headers, runtime);
     }
+    /**
+     * 创建服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **策略互斥**：`Partition`（分区发布）和`Batch`（批量发布）两种策略只能选择其中一种，不能同时使用。
+     * - **请求速率限制**：每秒最多100次请求。
+     * - **授权信息**：需要具备`eas:CreateServiceRollout`权限才能调用此接口。
+     * - **资源ARN**：`acs:eas:{#regionId}:{#accountId}:service/{#ServiceName}`。
+     * - **暂停发布**：通过设置`Paused`参数为`true`可以暂停发布流程，之后可通过`UpdateServiceRollout`接口恢复或取消发布。
+     * - **监控与回滚**：在发布过程中建议持续监控服务指标，以便及时发现并处理问题；如需回滚，可以通过调整`Partition`值或删除发布策略来实现。
+     *
+     * @param request - CreateServiceRolloutRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns CreateServiceRolloutResponse
+     */
+    async createServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime) {
+        request.validate();
+        let body = {};
+        if (!$dara.isNull(request.batch)) {
+            body["Batch"] = request.batch;
+        }
+        if (!$dara.isNull(request.partition)) {
+            body["Partition"] = request.partition;
+        }
+        if (!$dara.isNull(request.paused)) {
+            body["Paused"] = request.paused;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            body: openapi_core_2.OpenApiUtil.parseToMap(body),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "CreateServiceRollout",
+            version: "2021-07-01",
+            protocol: "HTTPS",
+            pathname: `/api/v2/services/${$dara.URL.percentEncode(ClusterId)}/${$dara.URL.percentEncode(ServiceName)}/rollout`,
+            method: "POST",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateServiceRolloutResponse({}));
+    }
+    /**
+     * 创建服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **策略互斥**：`Partition`（分区发布）和`Batch`（批量发布）两种策略只能选择其中一种，不能同时使用。
+     * - **请求速率限制**：每秒最多100次请求。
+     * - **授权信息**：需要具备`eas:CreateServiceRollout`权限才能调用此接口。
+     * - **资源ARN**：`acs:eas:{#regionId}:{#accountId}:service/{#ServiceName}`。
+     * - **暂停发布**：通过设置`Paused`参数为`true`可以暂停发布流程，之后可通过`UpdateServiceRollout`接口恢复或取消发布。
+     * - **监控与回滚**：在发布过程中建议持续监控服务指标，以便及时发现并处理问题；如需回滚，可以通过调整`Partition`值或删除发布策略来实现。
+     *
+     * @param request - CreateServiceRolloutRequest
+     * @returns CreateServiceRolloutResponse
+     */
+    async createServiceRollout(ClusterId, ServiceName, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.createServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime);
+    }
     /**
      * Creates a virtual resource group.
      *
@@ -1830,6 +1896,63 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.deleteServiceMirrorWithOptions(ClusterId, ServiceName, request, headers, runtime);
     }
+    /**
+     * 删除服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **不可恢复**：删除操作不可撤销，请谨慎操作。
+     * - **不自动回退**：删除策略不会回退已更新的副本。
+     * - **停止发布**：正在进行的发布会立即停止。
+     * - **状态保留**：已更新的副本保持新版本，未更新的保持旧版本。
+     * - 删除后，后续服务更新将采用默认的滚动更新方式。
+     * - 在删除前，请确认要删除的服务名称和地域，并了解当前发布状态（可以通过调用`DescribeServiceRollout`接口获取）。
+     * - 如果需要回退版本，请在删除策略后通过重新创建策略或直接更新服务镜像来实现。
+     *
+     * @param request - DeleteServiceRolloutRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DeleteServiceRolloutResponse
+     */
+    async deleteServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime) {
+        request.validate();
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "DeleteServiceRollout",
+            version: "2021-07-01",
+            protocol: "HTTPS",
+            pathname: `/api/v2/services/${$dara.URL.percentEncode(ClusterId)}/${$dara.URL.percentEncode(ServiceName)}/rollout`,
+            method: "DELETE",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteServiceRolloutResponse({}));
+    }
+    /**
+     * 删除服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **不可恢复**：删除操作不可撤销，请谨慎操作。
+     * - **不自动回退**：删除策略不会回退已更新的副本。
+     * - **停止发布**：正在进行的发布会立即停止。
+     * - **状态保留**：已更新的副本保持新版本，未更新的保持旧版本。
+     * - 删除后，后续服务更新将采用默认的滚动更新方式。
+     * - 在删除前，请确认要删除的服务名称和地域，并了解当前发布状态（可以通过调用`DescribeServiceRollout`接口获取）。
+     * - 如果需要回退版本，请在删除策略后通过重新创建策略或直接更新服务镜像来实现。
+     *
+     * @param request - DeleteServiceRolloutRequest
+     * @returns DeleteServiceRolloutResponse
+     */
+    async deleteServiceRollout(ClusterId, ServiceName, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.deleteServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime);
+    }
     /**
      * Deletes a virtual resource group that contains no resources or instances.
      *
@@ -2636,6 +2759,61 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.describeServiceMirrorWithOptions(ClusterId, ServiceName, request, headers, runtime);
     }
+    /**
+     * 查看服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - 该接口用于查询特定服务的发布策略（Rollout）配置和当前执行状态。
+     * - 返回的信息包括但不限于发布策略的具体参数、当前发布进度等。
+     * - 请求时需提供`ClusterId`和服务名称`ServiceName`作为路径参数。
+     * - 注意，请求速率限制为每秒最多100次。
+     * - 如果服务不存在或未创建发布策略，调用此接口将返回错误。
+     * - 返回的状态是实时查询的结果，可能会随时间而变化，请根据实际需要调整轮询间隔。
+     *
+     * @param request - DescribeServiceRolloutRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DescribeServiceRolloutResponse
+     */
+    async describeServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime) {
+        request.validate();
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "DescribeServiceRollout",
+            version: "2021-07-01",
+            protocol: "HTTPS",
+            pathname: `/api/v2/services/${$dara.URL.percentEncode(ClusterId)}/${$dara.URL.percentEncode(ServiceName)}/rollout`,
+            method: "GET",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeServiceRolloutResponse({}));
+    }
+    /**
+     * 查看服务更新计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - 该接口用于查询特定服务的发布策略（Rollout）配置和当前执行状态。
+     * - 返回的信息包括但不限于发布策略的具体参数、当前发布进度等。
+     * - 请求时需提供`ClusterId`和服务名称`ServiceName`作为路径参数。
+     * - 注意，请求速率限制为每秒最多100次。
+     * - 如果服务不存在或未创建发布策略，调用此接口将返回错误。
+     * - 返回的状态是实时查询的结果，可能会随时间而变化，请根据实际需要调整轮询间隔。
+     *
+     * @param request - DescribeServiceRolloutRequest
+     * @returns DescribeServiceRolloutResponse
+     */
+    async describeServiceRollout(ClusterId, ServiceName, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.describeServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime);
+    }
     /**
      * Obtains the logon-free URL of the service.
      *
@@ -5033,6 +5211,70 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.updateServiceMirrorWithOptions(ClusterId, ServiceName, request, headers, runtime);
     }
+    /**
+     * 更新服务发布计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **至少提供一个参数**：必须在请求中指定`Partition`、`Batch`或`Paused`中的至少一个参数。
+     * - **互斥策略**：不能同时提供`Partition`和`Batch`配置。
+     * - **实时生效**：更新将立即生效，影响正在进行的服务发布过程。
+     * - **回退操作**：通过增加`Partition`值可以实现版本回退，但不会自动触发，需要手动更新服务镜像。
+     * - **暂停不影响参数**：暂停发布不会改变已设置的`Partition`或`Batch`参数，仅暂停执行当前策略。
+     *
+     * @param request - UpdateServiceRolloutRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns UpdateServiceRolloutResponse
+     */
+    async updateServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime) {
+        request.validate();
+        let body = {};
+        if (!$dara.isNull(request.batch)) {
+            body["Batch"] = request.batch;
+        }
+        if (!$dara.isNull(request.partition)) {
+            body["Partition"] = request.partition;
+        }
+        if (!$dara.isNull(request.paused)) {
+            body["Paused"] = request.paused;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            body: openapi_core_2.OpenApiUtil.parseToMap(body),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "UpdateServiceRollout",
+            version: "2021-07-01",
+            protocol: "HTTPS",
+            pathname: `/api/v2/services/${$dara.URL.percentEncode(ClusterId)}/${$dara.URL.percentEncode(ServiceName)}/rollout`,
+            method: "PUT",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateServiceRolloutResponse({}));
+    }
+    /**
+     * 更新服务发布计划
+     *
+     * @remarks
+     * ## 请求说明
+     * - **至少提供一个参数**：必须在请求中指定`Partition`、`Batch`或`Paused`中的至少一个参数。
+     * - **互斥策略**：不能同时提供`Partition`和`Batch`配置。
+     * - **实时生效**：更新将立即生效，影响正在进行的服务发布过程。
+     * - **回退操作**：通过增加`Partition`值可以实现版本回退，但不会自动触发，需要手动更新服务镜像。
+     * - **暂停不影响参数**：暂停发布不会改变已设置的`Partition`或`Batch`参数，仅暂停执行当前策略。
+     *
+     * @param request - UpdateServiceRolloutRequest
+     * @returns UpdateServiceRolloutResponse
+     */
+    async updateServiceRollout(ClusterId, ServiceName, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.updateServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime);
+    }
     /**
      * Updates the safety lock of a service to minimize misoperations on the service.
      *