@alicloud/eas20210701 7.5.6 → 7.6.0

package/src/client.ts

@@ -1081,6 +1081,77 @@ export default class Client extends OpenApi {
     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: string, ServiceName: string, request: $_model.CreateServiceRolloutRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.CreateServiceRolloutResponse> {
+    request.validate();
+    let body : {[key: string ]: any} = { };
+    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 $OpenApiUtil.OpenApiRequest({
+      headers: headers,
+      body: OpenApiUtil.parseToMap(body),
+    });
+    let params = new $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<$_model.CreateServiceRolloutResponse>(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: string, ServiceName: string, request: $_model.CreateServiceRolloutRequest): Promise<$_model.CreateServiceRolloutResponse> {
+    let runtime = new $dara.RuntimeOptions({ });
+    let headers : {[key: string ]: string} = { };
+    return await this.createServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime);
+  }
+
   /**
    * Creates a virtual resource group.
    * 
@@ -1970,6 +2041,65 @@ export default class Client extends OpenApi {
     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: string, ServiceName: string, request: $_model.DeleteServiceRolloutRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteServiceRolloutResponse> {
+    request.validate();
+    let req = new $OpenApiUtil.OpenApiRequest({
+      headers: headers,
+    });
+    let params = new $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<$_model.DeleteServiceRolloutResponse>(await this.callApi(params, req, runtime), new $_model.DeleteServiceRolloutResponse({}));
+  }
+
+  /**
+   * 删除服务更新计划
+   * 
+   * @remarks
+   * ## 请求说明
+   * - **不可恢复**：删除操作不可撤销，请谨慎操作。
+   * - **不自动回退**：删除策略不会回退已更新的副本。
+   * - **停止发布**：正在进行的发布会立即停止。
+   * - **状态保留**：已更新的副本保持新版本，未更新的保持旧版本。
+   * - 删除后，后续服务更新将采用默认的滚动更新方式。
+   * - 在删除前，请确认要删除的服务名称和地域，并了解当前发布状态（可以通过调用`DescribeServiceRollout`接口获取）。
+   * - 如果需要回退版本，请在删除策略后通过重新创建策略或直接更新服务镜像来实现。
+   * 
+   * @param request - DeleteServiceRolloutRequest
+   * @returns DeleteServiceRolloutResponse
+   */
+  async deleteServiceRollout(ClusterId: string, ServiceName: string, request: $_model.DeleteServiceRolloutRequest): Promise<$_model.DeleteServiceRolloutResponse> {
+    let runtime = new $dara.RuntimeOptions({ });
+    let headers : {[key: string ]: string} = { };
+    return await this.deleteServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime);
+  }
+
   /**
    * Deletes a virtual resource group that contains no resources or instances.
    * 
@@ -2836,6 +2966,63 @@ export default class Client extends OpenApi {
     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: string, ServiceName: string, request: $_model.DescribeServiceRolloutRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeServiceRolloutResponse> {
+    request.validate();
+    let req = new $OpenApiUtil.OpenApiRequest({
+      headers: headers,
+    });
+    let params = new $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<$_model.DescribeServiceRolloutResponse>(await this.callApi(params, req, runtime), new $_model.DescribeServiceRolloutResponse({}));
+  }
+
+  /**
+   * 查看服务更新计划
+   * 
+   * @remarks
+   * ## 请求说明
+   * - 该接口用于查询特定服务的发布策略（Rollout）配置和当前执行状态。
+   * - 返回的信息包括但不限于发布策略的具体参数、当前发布进度等。
+   * - 请求时需提供`ClusterId`和服务名称`ServiceName`作为路径参数。
+   * - 注意，请求速率限制为每秒最多100次。
+   * - 如果服务不存在或未创建发布策略，调用此接口将返回错误。
+   * - 返回的状态是实时查询的结果，可能会随时间而变化，请根据实际需要调整轮询间隔。
+   * 
+   * @param request - DescribeServiceRolloutRequest
+   * @returns DescribeServiceRolloutResponse
+   */
+  async describeServiceRollout(ClusterId: string, ServiceName: string, request: $_model.DescribeServiceRolloutRequest): Promise<$_model.DescribeServiceRolloutResponse> {
+    let runtime = new $dara.RuntimeOptions({ });
+    let headers : {[key: string ]: string} = { };
+    return await this.describeServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime);
+  }
+
   /**
    * Obtains the logon-free URL of the service.
    * 
@@ -5507,6 +5694,75 @@ export default class Client extends OpenApi {
     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: string, ServiceName: string, request: $_model.UpdateServiceRolloutRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.UpdateServiceRolloutResponse> {
+    request.validate();
+    let body : {[key: string ]: any} = { };
+    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 $OpenApiUtil.OpenApiRequest({
+      headers: headers,
+      body: OpenApiUtil.parseToMap(body),
+    });
+    let params = new $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<$_model.UpdateServiceRolloutResponse>(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: string, ServiceName: string, request: $_model.UpdateServiceRolloutRequest): Promise<$_model.UpdateServiceRolloutResponse> {
+    let runtime = new $dara.RuntimeOptions({ });
+    let headers : {[key: string ]: string} = { };
+    return await this.updateServiceRolloutWithOptions(ClusterId, ServiceName, request, headers, runtime);
+  }
+
   /**
    * Updates the safety lock of a service to minimize misoperations on the service.
    * 

package/src/models/CreateServiceRolloutRequest.ts

@@ -0,0 +1,104 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class CreateServiceRolloutRequestBatch extends $dara.Model {
+  /**
+   * @example
+   * 1
+   */
+  batchSize?: string;
+  /**
+   * @example
+   * 5m
+   */
+  interval?: string;
+  static names(): { [key: string]: string } {
+    return {
+      batchSize: 'BatchSize',
+      interval: 'Interval',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      batchSize: 'string',
+      interval: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class CreateServiceRolloutRequestPartition extends $dara.Model {
+  /**
+   * @example
+   * 1
+   */
+  partition?: string;
+  static names(): { [key: string]: string } {
+    return {
+      partition: 'Partition',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      partition: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class CreateServiceRolloutRequest extends $dara.Model {
+  batch?: CreateServiceRolloutRequestBatch;
+  partition?: CreateServiceRolloutRequestPartition;
+  /**
+   * @example
+   * False
+   */
+  paused?: boolean;
+  static names(): { [key: string]: string } {
+    return {
+      batch: 'Batch',
+      partition: 'Partition',
+      paused: 'Paused',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      batch: CreateServiceRolloutRequestBatch,
+      partition: CreateServiceRolloutRequestPartition,
+      paused: 'boolean',
+    };
+  }
+
+  validate() {
+    if(this.batch && typeof (this.batch as any).validate === 'function') {
+      (this.batch as any).validate();
+    }
+    if(this.partition && typeof (this.partition as any).validate === 'function') {
+      (this.partition as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/CreateServiceRolloutResponse.ts

@@ -0,0 +1,40 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { CreateServiceRolloutResponseBody } from "./CreateServiceRolloutResponseBody";
+
+
+export class CreateServiceRolloutResponse extends $dara.Model {
+  headers?: { [key: string]: string };
+  statusCode?: number;
+  body?: CreateServiceRolloutResponseBody;
+  static names(): { [key: string]: string } {
+    return {
+      headers: 'headers',
+      statusCode: 'statusCode',
+      body: 'body',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
+      statusCode: 'number',
+      body: CreateServiceRolloutResponseBody,
+    };
+  }
+
+  validate() {
+    if(this.headers) {
+      $dara.Model.validateMap(this.headers);
+    }
+    if(this.body && typeof (this.body as any).validate === 'function') {
+      (this.body as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/CreateServiceRolloutResponseBody.ts

@@ -0,0 +1,38 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class CreateServiceRolloutResponseBody extends $dara.Model {
+  /**
+   * @example
+   * Rollout created successfully
+   */
+  message?: string;
+  /**
+   * @example
+   * 40325405-579C-4D82****
+   */
+  requestId?: string;
+  static names(): { [key: string]: string } {
+    return {
+      message: 'Message',
+      requestId: 'RequestId',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      message: 'string',
+      requestId: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/DeleteServiceRolloutRequest.ts

@@ -0,0 +1,24 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class DeleteServiceRolloutRequest extends $dara.Model {
+  static names(): { [key: string]: string } {
+    return {
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/DeleteServiceRolloutResponse.ts

@@ -0,0 +1,40 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { DeleteServiceRolloutResponseBody } from "./DeleteServiceRolloutResponseBody";
+
+
+export class DeleteServiceRolloutResponse extends $dara.Model {
+  headers?: { [key: string]: string };
+  statusCode?: number;
+  body?: DeleteServiceRolloutResponseBody;
+  static names(): { [key: string]: string } {
+    return {
+      headers: 'headers',
+      statusCode: 'statusCode',
+      body: 'body',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
+      statusCode: 'number',
+      body: DeleteServiceRolloutResponseBody,
+    };
+  }
+
+  validate() {
+    if(this.headers) {
+      $dara.Model.validateMap(this.headers);
+    }
+    if(this.body && typeof (this.body as any).validate === 'function') {
+      (this.body as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/DeleteServiceRolloutResponseBody.ts

@@ -0,0 +1,38 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class DeleteServiceRolloutResponseBody extends $dara.Model {
+  /**
+   * @example
+   * Rollout deleted successfully
+   */
+  message?: string;
+  /**
+   * @example
+   * 40325405-579C-4D82****
+   */
+  requestId?: string;
+  static names(): { [key: string]: string } {
+    return {
+      message: 'Message',
+      requestId: 'RequestId',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      message: 'string',
+      requestId: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/DescribeServiceRolloutRequest.ts

@@ -0,0 +1,24 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class DescribeServiceRolloutRequest extends $dara.Model {
+  static names(): { [key: string]: string } {
+    return {
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/DescribeServiceRolloutResponse.ts

@@ -0,0 +1,40 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { DescribeServiceRolloutResponseBody } from "./DescribeServiceRolloutResponseBody";
+
+
+export class DescribeServiceRolloutResponse extends $dara.Model {
+  headers?: { [key: string]: string };
+  statusCode?: number;
+  body?: DescribeServiceRolloutResponseBody;
+  static names(): { [key: string]: string } {
+    return {
+      headers: 'headers',
+      statusCode: 'statusCode',
+      body: 'body',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
+      statusCode: 'number',
+      body: DescribeServiceRolloutResponseBody,
+    };
+  }
+
+  validate() {
+    if(this.headers) {
+      $dara.Model.validateMap(this.headers);
+    }
+    if(this.body && typeof (this.body as any).validate === 'function') {
+      (this.body as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+