@alicloud/polardb20170801 8.4.2 → 9.0.0

package/src/models/DescribeHalogsResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeHALogsResponseBodyHaLogItems extends $dara.Model {
   /**
    * @remarks
-   * The cause code of the switchover.
+   * The switchover cause code.
    * 
    * @example
    * Platform.Ha.AuroraService.ManualOperations
@@ -13,7 +13,7 @@ export class DescribeHALogsResponseBodyHaLogItems extends $dara.Model {
   switchCauseCode?: string;
   /**
    * @remarks
-   * The cause of the switchover.
+   * The switchover cause.
    * 
    * @example
    * Platform.Ha.ManuallyTriggered
@@ -23,6 +23,8 @@ export class DescribeHALogsResponseBodyHaLogItems extends $dara.Model {
    * @remarks
    * The end time of the switchover.
    * 
+   * The time is in ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
+   * 
    * @example
    * 2025-05-20T03:09:56Z
    */
@@ -39,6 +41,8 @@ export class DescribeHALogsResponseBodyHaLogItems extends $dara.Model {
    * @remarks
    * The start time of the switchover.
    * 
+   * The time is in ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
+   * 
    * @example
    * 2025-05-20T03:09:45Z
    */
@@ -83,9 +87,8 @@ export class DescribeHALogsResponseBody extends $dara.Model {
   DBInstanceName?: string;
   /**
    * @remarks
-   * The instance type. Valid values:
-   * 
-   * - **polardb_mysql_rw**: read-write instance.
+   * The instance type. Valid values: 
+   * - **polardb_mysql_rw**: read/write instance.
    * - **polardb_mysql_ro**: read-only instance.
    * - **polardb_mysql_standby**: standby instance.
    * 
@@ -95,15 +98,14 @@ export class DescribeHALogsResponseBody extends $dara.Model {
   DBInstanceType?: string;
   /**
    * @remarks
-   * The list of primary/secondary 这里 AI 机翻使用了 failover，但代码里用了 switch，建议保持一致，都改为 swichover logs.
+   * The list of primary/secondary switchover logs.
    */
   haLogItems?: DescribeHALogsResponseBodyHaLogItems[];
   /**
    * @remarks
    * Indicates whether primary/secondary switchover records exist. Valid values:
-   * 
-   * - **1**: No
-   * - **0**: Yes
+   * - **1**: No records exist.
+   * - **0**: Records exist.
    * 
    * @example
    * 1
@@ -119,7 +121,7 @@ export class DescribeHALogsResponseBody extends $dara.Model {
   itemsNumbers?: number;
   /**
    * @remarks
-   * The page number. The value is greater than 0 and does not exceed the maximum value of the Integer data type. Default value: 1.
+   * The page number. The value is a positive integer that does not exceed the maximum value of the Integer data type. Default value: 1.
    * 
    * @example
    * 1
@@ -127,7 +129,7 @@ export class DescribeHALogsResponseBody extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of entries returned per page. Valid values: 30 to 100. Default value: 30.
+   * The number of entries per page. Valid values: 30 to 100. Default value: 30.
    * 
    * @example
    * 30

package/src/models/DescribeHistoryTasksRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeHistoryTasksRequest extends $dara.Model {
   /**
    * @remarks
-   * The minimum task execution time in seconds. Filters for tasks that took longer than this value. Default value: 0.
+   * The minimum execution duration. Filters tasks whose execution duration is greater than this value. Unit: seconds. Default value: 0, which indicates no restriction.
    * 
    * @example
    * 0
@@ -13,9 +13,7 @@ export class DescribeHistoryTasksRequest extends $dara.Model {
   fromExecTime?: number;
   /**
    * @remarks
-   * The start of the time range to query, based on task start time. The time follows the ISO8601 standard and must be in `UTC+0` time. Format: `yyyy-MM-ddTHH:mm:ssZ`.
-   * 
-   * The earliest supported time is 30 days ago. If the specified time is more than 30 days ago, it will be automatically converted to 30 days ago.
+   * The beginning of the time range for the task start time. Tasks whose start time is later than this time are queried. Specify the time in the ISO 8601 standard in the `yyyy-MM-ddTHH:mm:ssZ` format. The time must be in `UTC+0`. The earliest supported time is 30 days before the current time. A value earlier than 30 days is automatically converted to 30 days before the current time.
    * 
    * This parameter is required.
    * 
@@ -25,9 +23,9 @@ export class DescribeHistoryTasksRequest extends $dara.Model {
   fromStartTime?: string;
   /**
    * @remarks
-   * The resource ID to filter by. You can provide a comma-separated list of up to 30 IDs. Default value: empty, indicating no restriction.
+   * The resource ID. Specify this parameter to query tasks for the corresponding resource. Separate multiple IDs with commas (,). A maximum of 30 IDs are supported. Default value: empty, which indicates no restriction.
    * 
-   * > Currently, only PolarDB cluster IDs are supported.
+   * > Currently, only cluster IDs are supported.
    * 
    * @example
    * pc-2zed3m89cw***
@@ -44,7 +42,7 @@ export class DescribeHistoryTasksRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The page number. Valid values: positive integers. Default value: 1.
+   * The page number of the query results. Valid values: positive integers. Default value: 1.
    * 
    * @example
    * 1
@@ -52,7 +50,7 @@ export class DescribeHistoryTasksRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of records per page. Valid values: 10 to 100. Default value: 10.
+   * The number of entries per page. Valid values: 10 to 100. Default value: 10.
    * 
    * @example
    * 10
@@ -61,8 +59,7 @@ export class DescribeHistoryTasksRequest extends $dara.Model {
   /**
    * @remarks
    * The region ID.
-   * 
-   * > For more information, see [DescribeRegions](https://help.aliyun.com/document_detail/98041.html).
+   * > You can call the [DescribeRegions](https://help.aliyun.com/document_detail/98041.html) operation to query region information.
    * 
    * @example
    * cn-beijing
@@ -82,20 +79,14 @@ export class DescribeHistoryTasksRequest extends $dara.Model {
   /**
    * @remarks
    * The task status. Valid values:
+   * * **Scheduled**: Waiting for execution.
+   * * **Running**: Running.
+   * * **Succeed**: Succeeded.
+   * * **Cancelling**: Being canceled.
+   * * **Canceled**: Canceled.
+   * * **Waiting**: Waiting for the scheduled time.
    * 
-   * - **Scheduled**: waiting for execution
-   * 
-   * - **Running**: executing
-   * 
-   * - **Succeed**: executed successfully
-   * 
-   * - **Cancelling**: stopping
-   * 
-   * - **Canceled**: stopped
-   * 
-   * - **Waiting**: waiting for preset time
-   * 
-   * You can provide a comma-separated list. Default value: empty, which indicates all statuses.
+   * Separate multiple statuses with commas (,). Default value: empty, which indicates all statuses.
    * 
    * @example
    * Running
@@ -103,7 +94,7 @@ export class DescribeHistoryTasksRequest extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The task ID. You can provide a comma-separated list of up to 30 IDs. Default value: empty, indicating no restriction.
+   * The task ID. Separate multiple task IDs with commas (,). A maximum of 30 IDs are supported. Default value: empty, which indicates no restriction.
    * 
    * @example
    * t-0mqi38ho0cgjv***
@@ -111,7 +102,7 @@ export class DescribeHistoryTasksRequest extends $dara.Model {
   taskId?: string;
   /**
    * @remarks
-   * The task type. You can provide a comma-separated list of up to 30 task types. Default value: empty, indicating no restriction.
+   * The task type. Specify this parameter to query tasks of a specific type. Separate multiple types with commas (,). A maximum of 30 types are supported. Default value: empty, which indicates no restriction.
    * 
    * @example
    * ChangeVariable
@@ -119,7 +110,7 @@ export class DescribeHistoryTasksRequest extends $dara.Model {
   taskType?: string;
   /**
    * @remarks
-   * The maximum task execution time in seconds. Filters for tasks that took less than this value. Default value: 0.
+   * The maximum execution duration. Filters tasks whose execution duration is not less than this value. Unit: seconds. Default value: 0, which indicates no restriction.
    * 
    * @example
    * 0
@@ -127,7 +118,7 @@ export class DescribeHistoryTasksRequest extends $dara.Model {
   toExecTime?: number;
   /**
    * @remarks
-   * The end of the time range to query, based on task start time. The time follows the ISO8601 standard and must be in `UTC+0` time. Format: `yyyy-MM-ddTHH:mm:ssZ`.
+   * The end of the time range for the task start time. Tasks whose start time is earlier than this time are queried. Specify the time in the ISO 8601 standard in the `yyyy-MM-ddTHH:mm:ssZ` format. The time must be in `UTC+0`.
    * 
    * This parameter is required.
    * 

package/src/models/DescribeHistoryTasksResponseBody.ts

@@ -7,7 +7,7 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
    * @remarks
    * The allowed operation information.
    * 
-   * > This feature is not supported yet.
+   * > This feature is not supported.
    * 
    * @example
    * {}
@@ -16,10 +16,8 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
   /**
    * @remarks
    * The request source. Valid values:
-   * 
-   * - **System**: system
-   * 
-   * - **User**: user
+   * * **System**: system.
+   * * **User**: user.
    * 
    * @example
    * User
@@ -27,7 +25,7 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
   callerSource?: string;
   /**
    * @remarks
-   * The ID of the requesting user. If `CallerSource` is `User`, this is the user\\"s UID.
+   * The ID of the requesting user. When CallerSource is set to User, this value represents the user UID.
    * 
    * @example
    * 1816563541899***
@@ -35,7 +33,7 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
   callerUid?: string;
   /**
    * @remarks
-   * The name of the current step being executed. If this parameter is empty, the task has not started.
+   * The name of the current step being executed. An empty value indicates that the task has not started.
    * 
    * @example
    * finish_task
@@ -51,7 +49,9 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
   dbType?: string;
   /**
    * @remarks
-   * The end time of the task.
+   * The task end time.
+   * 
+   * The time is in the ISO 8601 standard in the YYYY-MM-DDTHH:mm:ssZ format. The time is displayed in UTC.
    * 
    * @example
    * 2025-03-03T07:30:57Z
@@ -91,7 +91,7 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
   product?: string;
   /**
    * @remarks
-   * The completion progress of the task, from 0.0 to 100.0.
+   * The current progress.
    * 
    * @example
    * 100.0
@@ -99,7 +99,7 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
   progress?: number;
   /**
    * @remarks
-   * The reason for initiating the current task.
+   * The reason why the current task was initiated.
    * 
    * @example
    * ""
@@ -115,9 +115,9 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The estimated remaining execution time, in seconds (s).
+   * The estimated remaining execution duration. Unit: seconds.
    * 
-   * > This value is for reference only. The actual execution time prevails.
+   * > This value is for reference only. The actual execution duration may vary.
    * 
    * @example
    * 0
@@ -125,7 +125,9 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
   remainTime?: number;
   /**
    * @remarks
-   * The start time of the task.
+   * The task start time.
+   * 
+   * The time is in the ISO 8601 standard in the YYYY-MM-DDTHH:mm:ssZ format. The time is displayed in UTC.
    * 
    * @example
    * 2025-03-03T07:25:16Z
@@ -133,21 +135,15 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
   startTime?: string;
   /**
    * @remarks
-   * The final status of the task.
-   * 
-   * - Scheduled: waiting for execution
-   * 
-   * - Running: executing
-   * 
-   * - Succeed: executed successfully
-   * 
-   * - Failed: execution failed
-   * 
-   * - Cancelling: stopping
-   * 
-   * - Canceled: stopped
+   * The task status.
    * 
-   * - Waiting: waiting for preset time
+   * * Scheduled: Waiting for execution.
+   * * Running: Running.
+   * * Succeed: Succeeded.
+   * * Failed: Failed.
+   * * Cancelling: Being canceled.
+   * * Canceled: Canceled.
+   * * Waiting: Waiting for the scheduled time.
    * 
    * @example
    * Succeed
@@ -179,7 +175,7 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
   taskType?: string;
   /**
    * @remarks
-   * The UID of the account that owns the resource.
+   * The ID of the user to whom the resource belongs.
    * 
    * @example
    * 1816563541899***
@@ -247,12 +243,12 @@ export class DescribeHistoryTasksResponseBodyItems extends $dara.Model {
 export class DescribeHistoryTasksResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The list of tasks.
+   * The task list.
    */
   items?: DescribeHistoryTasksResponseBodyItems[];
   /**
    * @remarks
-   * The page number of the query result.
+   * The page number of the query results.
    * 
    * @example
    * 1
@@ -260,7 +256,7 @@ export class DescribeHistoryTasksResponseBody extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of records per page.
+   * The number of entries per page.
    * 
    * @example
    * 10
@@ -268,7 +264,7 @@ export class DescribeHistoryTasksResponseBody extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The unique ID of the request.
+   * The request ID.
    * 
    * @example
    * F90D7C14-2D1C-5B88-9CD1-23AB2CF89***
@@ -276,7 +272,7 @@ export class DescribeHistoryTasksResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The total number of tasks that meet the conditions, regardless of paging factors.
+   * The total number of tasks that meet the filter conditions, regardless of pagination.
    * 
    * @example
    * 2

package/src/models/DescribeKbsyncLinkAttributeRequest.ts

@@ -0,0 +1,60 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class DescribeKBSyncLinkAttributeRequest extends $dara.Model {
+  /**
+   * @remarks
+   * The unique identifier of the knowledge base.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * kb-123456
+   */
+  knowledgeBaseId?: string;
+  /**
+   * @remarks
+   * The unique identifier of the synchronization link.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * pkbl-123456
+   */
+  linkId?: string;
+  /**
+   * @remarks
+   * The region ID.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * cn-hangzhou
+   */
+  regionId?: string;
+  static names(): { [key: string]: string } {
+    return {
+      knowledgeBaseId: 'KnowledgeBaseId',
+      linkId: 'LinkId',
+      regionId: 'RegionId',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      knowledgeBaseId: 'string',
+      linkId: 'string',
+      regionId: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/DescribeKbsyncLinkAttributeResponse.ts

@@ -0,0 +1,40 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { DescribeKBSyncLinkAttributeResponseBody } from "./DescribeKbsyncLinkAttributeResponseBody";
+
+
+export class DescribeKBSyncLinkAttributeResponse extends $dara.Model {
+  headers?: { [key: string]: string };
+  statusCode?: number;
+  body?: DescribeKBSyncLinkAttributeResponseBody;
+  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: DescribeKBSyncLinkAttributeResponseBody,
+    };
+  }
+
+  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/DescribeKbsyncLinkAttributeResponseBody.ts

@@ -0,0 +1,174 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class DescribeKBSyncLinkAttributeResponseBodyConfig extends $dara.Model {
+  /**
+   * @remarks
+   * The validity period of the successful snapshot of Lark group members for fallback reuse, in seconds. This parameter is returned only for FEISHU synchronization links. A value of -1 indicates that the snapshot never expires. A value of 0 indicates that snapshot fallback reuse is disabled. A positive integer indicates the maximum age of the snapshot allowed for reuse. The valid value configured for the link is returned. If no value is configured, the default value -1 is returned.
+   * 
+   * @example
+   * -1
+   */
+  feishuChatMemberStaleTtlSeconds?: number;
+  /**
+   * @remarks
+   * The ID of the DingTalk user who performs the operation. This parameter is returned only for DINGTALK synchronization links.
+   * 
+   * @example
+   * manager123
+   */
+  userId?: string;
+  static names(): { [key: string]: string } {
+    return {
+      feishuChatMemberStaleTtlSeconds: 'FeishuChatMemberStaleTtlSeconds',
+      userId: 'UserId',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      feishuChatMemberStaleTtlSeconds: 'number',
+      userId: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class DescribeKBSyncLinkAttributeResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * The client ID of the source application.
+   * 
+   * @example
+   * cli_a123456
+   */
+  clientId?: string;
+  /**
+   * @remarks
+   * The synchronization configuration whitelist returned based on the source type. For DINGTALK, UserId can be returned. For FEISHU, FeishuChatMemberStaleTtlSeconds can be returned.
+   */
+  config?: DescribeKBSyncLinkAttributeResponseBodyConfig;
+  /**
+   * @remarks
+   * The creation time of the synchronization link.
+   * 
+   * @example
+   * 2026-09-22T12:00:00Z
+   */
+  creationTime?: string;
+  /**
+   * @remarks
+   * The description of the synchronization link.
+   * 
+   * @example
+   * Synchronize Lark knowledge base documents
+   */
+  description?: string;
+  /**
+   * @remarks
+   * The source channel of the synchronization link. Valid values: OSS, DINGTALK, FEISHU, and SHAREPOINT.
+   * 
+   * @example
+   * FEISHU
+   */
+  imPlatform?: string;
+  /**
+   * @remarks
+   * The unique identifier of the synchronization link.
+   * 
+   * @example
+   * pkbl-123456
+   */
+  linkId?: string;
+  /**
+   * @remarks
+   * The name of the synchronization link.
+   * 
+   * @example
+   * feishu-doc-sync
+   */
+  linkName?: string;
+  /**
+   * @remarks
+   * The request ID.
+   * 
+   * @example
+   * 12345678-1234-1234-1234-1234567890ab
+   */
+  requestId?: string;
+  /**
+   * @remarks
+   * The source directory.
+   * 
+   * @example
+   * /documents
+   */
+  sourceDir?: string;
+  /**
+   * @remarks
+   * The automatic synchronization interval, in minutes.
+   * 
+   * @example
+   * 60
+   */
+  syncIntervalMinutes?: number;
+  /**
+   * @remarks
+   * The status of the synchronization link.
+   * 
+   * @example
+   * RUNNING
+   */
+  syncStatus?: string;
+  static names(): { [key: string]: string } {
+    return {
+      clientId: 'ClientId',
+      config: 'Config',
+      creationTime: 'CreationTime',
+      description: 'Description',
+      imPlatform: 'ImPlatform',
+      linkId: 'LinkId',
+      linkName: 'LinkName',
+      requestId: 'RequestId',
+      sourceDir: 'SourceDir',
+      syncIntervalMinutes: 'SyncIntervalMinutes',
+      syncStatus: 'SyncStatus',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      clientId: 'string',
+      config: DescribeKBSyncLinkAttributeResponseBodyConfig,
+      creationTime: 'string',
+      description: 'string',
+      imPlatform: 'string',
+      linkId: 'string',
+      linkName: 'string',
+      requestId: 'string',
+      sourceDir: 'string',
+      syncIntervalMinutes: 'number',
+      syncStatus: 'string',
+    };
+  }
+
+  validate() {
+    if(this.config && typeof (this.config as any).validate === 'function') {
+      (this.config as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/DescribeKbsyncLinksResponseBody.ts

@@ -15,6 +15,8 @@ export class DescribeKBSyncLinksResponseBodyItems extends $dara.Model {
    * @remarks
    * The creation time.
    * 
+   * The time is in the ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
+   * 
    * @example
    * 2026-08-11T09:55:19Z
    */

package/src/models/DescribeKnowledgeBaseAnswerRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeKnowledgeBaseAnswerRequest extends $dara.Model {
   /**
    * @remarks
-   * The unique ID of the knowledge base.
+   * The unique identifier of the knowledge base.
    * 
    * This parameter is required.
    * 
@@ -15,7 +15,7 @@ export class DescribeKnowledgeBaseAnswerRequest extends $dara.Model {
   knowledgeBaseId?: string;
   /**
    * @remarks
-   * The unique ID of the Q&A task.
+   * The unique identifier of the Q&A task.
    * 
    * This parameter is required.
    *