@alicloud/polardb20170801 8.4.3 → 9.0.1

package/src/models/DescribeKnowledgeBaseAnswerResponseBody.ts

@@ -13,7 +13,7 @@ export class DescribeKnowledgeBaseAnswerResponseBodySourcesImageResources extend
   documentIndex?: number;
   /**
    * @remarks
-   * The unique ID of the image resource.
+   * The unique identifier of the image resource.
    * 
    * @example
    * document-0/pictures/1
@@ -29,7 +29,7 @@ export class DescribeKnowledgeBaseAnswerResponseBodySourcesImageResources extend
   itemRef?: string;
   /**
    * @remarks
-   * The media type of the image resource.
+   * The MIME type of the image resource.
    * 
    * @example
    * image/png
@@ -75,7 +75,7 @@ export class DescribeKnowledgeBaseAnswerResponseBodySourcesImageResources extend
 export class DescribeKnowledgeBaseAnswerResponseBodySources extends $dara.Model {
   /**
    * @remarks
-   * The chunk metadata.
+   * The shard metadata.
    * 
    * @example
    * {}
@@ -94,17 +94,17 @@ export class DescribeKnowledgeBaseAnswerResponseBodySources extends $dara.Model
    * The file name.
    * 
    * @example
-   * FinancialReport.pdf
+   * Financial_Report.pdf
    */
   fileName?: string;
   /**
    * @remarks
-   * The list of image resources associated with the referenced chunk in the Q&A.
+   * The list of image resources associated with the shard referenced in the Q&A.
    */
   imageResources?: DescribeKnowledgeBaseAnswerResponseBodySourcesImageResources[];
   /**
    * @remarks
-   * The unique ID of the knowledge base.
+   * The unique identifier of the knowledge base.
    * 
    * @example
    * pkb-xxxxx
@@ -120,20 +120,20 @@ export class DescribeKnowledgeBaseAnswerResponseBodySources extends $dara.Model
   metadata?: { [key: string]: any };
   /**
    * @remarks
-   * The list of page numbers to which the chunk belongs.
+   * The list of page numbers to which the shard belongs.
    */
   pageNumbers?: number[];
   /**
    * @remarks
-   * The chunk content.
+   * The shard content.
    * 
    * @example
-   * FinancialReport
+   * Financial report
    */
   shardContent?: string;
   /**
    * @remarks
-   * The chunk ID.
+   * The shard ID.
    * 
    * @example
    * 8
@@ -155,6 +155,14 @@ export class DescribeKnowledgeBaseAnswerResponseBodySources extends $dara.Model
    * 1
    */
   sourceId?: number;
+  /**
+   * @remarks
+   * The URI of the original document.
+   * 
+   * @example
+   * https://example.com/source.pdf
+   */
+  sourceUri?: string;
   static names(): { [key: string]: string } {
     return {
       chunkMetadata: 'ChunkMetadata',
@@ -168,6 +176,7 @@ export class DescribeKnowledgeBaseAnswerResponseBodySources extends $dara.Model
       shardIndex: 'ShardIndex',
       similarityScore: 'SimilarityScore',
       sourceId: 'SourceId',
+      sourceUri: 'SourceUri',
     };
   }
 
@@ -184,6 +193,7 @@ export class DescribeKnowledgeBaseAnswerResponseBodySources extends $dara.Model
       shardIndex: 'number',
       similarityScore: 'number',
       sourceId: 'number',
+      sourceUri: 'string',
     };
   }
 
@@ -219,15 +229,15 @@ export class DescribeKnowledgeBaseAnswerResponseBody extends $dara.Model {
   agentId?: string;
   /**
    * @remarks
-   * The answer content.
+   * The content of the answer.
    * 
    * @example
-   * The financial report summary is as follows: ******
+   * The content of the financial report is summarized as follows: ******
    */
   answer?: string;
   /**
    * @remarks
-   * The cumulative number of tokens generated for completion.
+   * The cumulative number of completion tokens generated.
    * 
    * @example
    * 3935
@@ -251,7 +261,7 @@ export class DescribeKnowledgeBaseAnswerResponseBody extends $dara.Model {
   errorType?: string;
   /**
    * @remarks
-   * The large language model ID.
+   * The ID of the large language model.
    * 
    * @example
    * OO1A6p8B******_xPUC
@@ -259,7 +269,7 @@ export class DescribeKnowledgeBaseAnswerResponseBody extends $dara.Model {
   LLMModelId?: string;
   /**
    * @remarks
-   * The cumulative number of tokens consumed by the prompt.
+   * The cumulative number of prompt tokens consumed.
    * 
    * @example
    * 2459
@@ -267,7 +277,7 @@ export class DescribeKnowledgeBaseAnswerResponseBody extends $dara.Model {
   promptTokens?: number;
   /**
    * @remarks
-   * The unique ID of the Q&A task.
+   * The unique identifier of the Q&A task.
    * 
    * @example
    * R3BGbnBqcXN******.2a5a23c9-******-179970533d30
@@ -289,8 +299,8 @@ export class DescribeKnowledgeBaseAnswerResponseBody extends $dara.Model {
   /**
    * @remarks
    * The status of the Q&A task. Valid values:
-   * - RUNNING: In progress.
-   * - COMPLETED: Completed.
+   * - RUNNING: The task is in progress.
+   * - COMPLETED: The task is completed.
    * 
    * @example
    * COMPLETED

package/src/models/DescribeKnowledgeBaseAttributeResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeKnowledgeBaseAttributeResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The number of AI applications bound to the knowledge base.
+   * The number of AI applications associated with the knowledge base.
    * 
    * @example
    * 2
@@ -13,7 +13,9 @@ export class DescribeKnowledgeBaseAttributeResponseBody extends $dara.Model {
   bindingAppCount?: number;
   /**
    * @remarks
-   * The creation time.
+   * The time when the knowledge base was created.
+   * 
+   * The time is in ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
    * 
    * @example
    * 2020-08-14T05:58:42Z

package/src/models/DescribeKnowledgeBaseFileShardsRequest.ts

@@ -15,7 +15,7 @@ export class DescribeKnowledgeBaseFileShardsRequest extends $dara.Model {
   fileId?: string;
   /**
    * @remarks
-   * The unique ID of the knowledge base.
+   * The unique identifier of the knowledge base.
    * 
    * This parameter is required.
    * 
@@ -33,7 +33,7 @@ export class DescribeKnowledgeBaseFileShardsRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of records per page.
+   * The number of entries per page.
    * 
    * @example
    * 30

package/src/models/DescribeKnowledgeBaseFileShardsResponseBody.ts

@@ -13,7 +13,7 @@ export class DescribeKnowledgeBaseFileShardsResponseBodyShardsImageResources ext
   documentIndex?: number;
   /**
    * @remarks
-   * The unique ID of the image resource.
+   * The unique identifier of the image resource.
    * 
    * @example
    * document-0/pictures/1
@@ -29,7 +29,7 @@ export class DescribeKnowledgeBaseFileShardsResponseBodyShardsImageResources ext
   itemRef?: string;
   /**
    * @remarks
-   * The media type of the image resource.
+   * The MIME type of the image resource.
    * 
    * @example
    * image/png
@@ -80,12 +80,12 @@ export class DescribeKnowledgeBaseFileShardsResponseBodyShards extends $dara.Mod
   captions?: string[];
   /**
    * @remarks
-   * The list of Docling source document structured element references associated with the shard. You can use these references to precisely locate original document elements.
+   * The list of structured element references in the Docling source document associated with the shard, which can be used to precisely locate the original elements.
    */
   docItems?: string[];
   /**
    * @remarks
-   * The chain of section headings to which the shard belongs.
+   * The section heading chain to which the shard belongs.
    */
   headings?: string[];
   /**
@@ -114,6 +114,14 @@ export class DescribeKnowledgeBaseFileShardsResponseBodyShards extends $dara.Mod
    * 1
    */
   shardIndex?: number;
+  /**
+   * @remarks
+   * The URI of the source document.
+   * 
+   * @example
+   * https://example.com/source.pdf
+   */
+  sourceUri?: string;
   static names(): { [key: string]: string } {
     return {
       captions: 'Captions',
@@ -123,6 +131,7 @@ export class DescribeKnowledgeBaseFileShardsResponseBodyShards extends $dara.Mod
       pageNumbers: 'PageNumbers',
       shardContent: 'ShardContent',
       shardIndex: 'ShardIndex',
+      sourceUri: 'SourceUri',
     };
   }
 
@@ -135,6 +144,7 @@ export class DescribeKnowledgeBaseFileShardsResponseBodyShards extends $dara.Mod
       pageNumbers: { 'type': 'array', 'itemType': 'string' },
       shardContent: 'string',
       shardIndex: 'number',
+      sourceUri: 'string',
     };
   }
 
@@ -173,7 +183,7 @@ export class DescribeKnowledgeBaseFileShardsResponseBody extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of records on the current page.
+   * The number of entries on the current page.
    * 
    * @example
    * 10
@@ -181,7 +191,7 @@ export class DescribeKnowledgeBaseFileShardsResponseBody extends $dara.Model {
   pageRecordCount?: number;
   /**
    * @remarks
-   * The number of entries per page in a paged query.
+   * The number of entries per page in a paging query.
    * 
    * @example
    * 30
@@ -202,7 +212,7 @@ export class DescribeKnowledgeBaseFileShardsResponseBody extends $dara.Model {
   shards?: DescribeKnowledgeBaseFileShardsResponseBodyShards[];
   /**
    * @remarks
-   * The total number of records.
+   * The total number of entries.
    * 
    * @example
    * 10

package/src/models/DescribeKnowledgeBaseFilesRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeKnowledgeBaseFilesRequest extends $dara.Model {
   /**
    * @remarks
-   * The list of file IDs, separated by commas (,).
+   * The list of file IDs, separated by commas.
    * 
    * @example
    * doc_a,doc_b
@@ -13,15 +13,15 @@ export class DescribeKnowledgeBaseFilesRequest extends $dara.Model {
   fileIds?: string;
   /**
    * @remarks
-   * The keyword used to filter file names.
+   * The keyword for the file name.
    * 
    * @example
-   * Financial report
+   * FinancialReport
    */
   keyword?: string;
   /**
    * @remarks
-   * The unique ID of the knowledge base.
+   * The unique identifier of the knowledge base.
    * 
    * This parameter is required.
    * 
@@ -31,7 +31,7 @@ export class DescribeKnowledgeBaseFilesRequest extends $dara.Model {
   knowledgeBaseId?: string;
   /**
    * @remarks
-   * The unique ID of the synchronization link.
+   * The unique identifier of the synchronization link.
    * 
    * @example
    * pkbl-2ze123456789abc

package/src/models/DescribeKnowledgeBaseFilesResponseBody.ts

@@ -160,7 +160,7 @@ export class DescribeKnowledgeBaseFilesResponseBodyItemsShardingStrategyConfigRu
   parameters?: DescribeKnowledgeBaseFilesResponseBodyItemsShardingStrategyConfigRulesStrategyParameters;
   /**
    * @remarks
-   * The chunking strategy type applied after a rule is matched.
+   * The chunking strategy type after a rule is matched.
    * 
    * @example
    * hierarchical
@@ -294,12 +294,12 @@ export class DescribeKnowledgeBaseFilesResponseBodyItems extends $dara.Model {
    * The file name.
    * 
    * @example
-   * Financial_report.pdf
+   * FinancialReport.pdf
    */
   fileName?: string;
   /**
    * @remarks
-   * The file size, in bytes.
+   * The file size in bytes.
    * 
    * @example
    * 318881
@@ -315,7 +315,7 @@ export class DescribeKnowledgeBaseFilesResponseBodyItems extends $dara.Model {
   fileType?: string;
   /**
    * @remarks
-   * Indicates whether the chunking strategy is inherited from the knowledge space.
+   * Indicates whether the knowledge space chunking strategy is inherited.
    * 
    * @example
    * true
@@ -350,7 +350,7 @@ export class DescribeKnowledgeBaseFilesResponseBodyItems extends $dara.Model {
    * The OSS file path.
    * 
    * @example
-   * oss://test-bucket-example/pks-xxxx/pkb-xxxx/Financial_report.pdf
+   * oss://test-bucket-example/pks-xxxx/pkb-xxxx/FinancialReport.pdf
    */
   OSSPath?: string;
   /**
@@ -363,7 +363,7 @@ export class DescribeKnowledgeBaseFilesResponseBodyItems extends $dara.Model {
   shardCount?: number;
   /**
    * @remarks
-   * The chunking strategy configuration currently in effect for the document. This value may be empty if the complete configuration was not saved for existing objects.
+   * The chunking strategy configuration currently in effect for the document. This value may be empty if the complete configuration was not saved for existing instances.
    */
   shardingStrategyConfig?: DescribeKnowledgeBaseFilesResponseBodyItemsShardingStrategyConfig;
   /**
@@ -386,6 +386,8 @@ export class DescribeKnowledgeBaseFilesResponseBodyItems extends $dara.Model {
    * @remarks
    * The update time.
    * 
+   * The time is in ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
+   * 
    * @example
    * 2026-06-15T22:28:53Z
    */
@@ -394,6 +396,8 @@ export class DescribeKnowledgeBaseFilesResponseBodyItems extends $dara.Model {
    * @remarks
    * The upload time.
    * 
+   * The time is in ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
+   * 
    * @example
    * 2026-06-15T22:28:53Z
    */

package/src/models/DescribeKnowledgeBasesRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeKnowledgeBasesRequest extends $dara.Model {
   /**
    * @remarks
-   * The keyword for searching knowledge bases.
+   * The keyword used to filter knowledge bases.
    * 
    * @example
    * testkb

package/src/models/DescribeKnowledgeBasesResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeKnowledgeBasesResponseBodyItems extends $dara.Model {
   /**
    * @remarks
-   * The number of AI applications bound to the knowledge base.
+   * The number of AI applications that are associated with the knowledge base.
    * 
    * @example
    * 2
@@ -15,6 +15,8 @@ export class DescribeKnowledgeBasesResponseBodyItems extends $dara.Model {
    * @remarks
    * The creation time.
    * 
+   * The time is in ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
+   * 
    * @example
    * 2025-03-25T09:37:10Z
    */

package/src/models/DescribeKnowledgeSpaceAttributeResponseBody.ts

@@ -160,7 +160,7 @@ export class DescribeKnowledgeSpaceAttributeResponseBodyShardingStrategyConfigRu
   parameters?: DescribeKnowledgeSpaceAttributeResponseBodyShardingStrategyConfigRulesStrategyParameters;
   /**
    * @remarks
-   * The chunking strategy type used when a rule is matched.
+   * The chunking strategy type used when the rule is matched.
    * 
    * @example
    * hierarchical
@@ -276,8 +276,8 @@ export class DescribeKnowledgeSpaceAttributeResponseBody extends $dara.Model {
   /**
    * @remarks
    * The access control list (ACL) mode of the knowledge space. Valid values:
-   * - DISABLED
-   * - ENFORCED
+   * - DISABLED: ACL is disabled.
+   * - ENFORCED: ACL is enforced.
    * 
    * @example
    * ENFORCED
@@ -285,7 +285,9 @@ export class DescribeKnowledgeSpaceAttributeResponseBody extends $dara.Model {
   ACLMode?: string;
   /**
    * @remarks
-   * The time when the knowledge space was created.
+   * The creation time.
+   * 
+   * The time is in ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
    * 
    * @example
    * 2026-06-25T09:53:44Z
@@ -309,7 +311,7 @@ export class DescribeKnowledgeSpaceAttributeResponseBody extends $dara.Model {
   DBName?: string;
   /**
    * @remarks
-   * The type of the database engine. Valid values:
+   * The database engine type. Valid values:
    * * MySQL
    * * PostgreSQL
    * 
@@ -407,7 +409,7 @@ export class DescribeKnowledgeSpaceAttributeResponseBody extends $dara.Model {
   shardSize?: number;
   /**
    * @remarks
-   * The default chunking strategy configuration of the knowledge space. This parameter may be empty if existing instances do not have the complete configuration saved.
+   * The default chunking strategy configuration of the knowledge space. This value may be empty if existing instances do not have a complete configuration saved.
    */
   shardingStrategyConfig?: DescribeKnowledgeSpaceAttributeResponseBodyShardingStrategyConfig;
   /**

package/src/models/DescribeLicenseOrdersRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeLicenseOrdersRequest extends $dara.Model {
   /**
    * @remarks
-   * The Alibaba Cloud order ID. This can be a virtual order ID.
+   * The Alibaba Cloud order ID, including virtual order IDs.
    * 
    * @example
    * 239618016570503
@@ -16,16 +16,11 @@ export class DescribeLicenseOrdersRequest extends $dara.Model {
   /**
    * @remarks
    * The package type. Valid values:
-   * 
-   * - single_node_subscribe: single node (subscription)
-   * 
-   * - single_node_long_term: single node (long-term)
-   * 
-   * - primary_backup_subscribe: primary/standby (subscription)
-   * 
-   * - primary_backup_long_term: primary/standby (long-term)
-   * 
-   * - pre_generation_long_term: pre-generated (long-term)
+   * - single_node_subscribe: single node (subscription).
+   * - single_node_long_term: single node (long-term).
+   * - primary_backup_subscribe: primary/secondary (subscription).
+   * - primary_backup_long_term: primary/secondary (long-term).
+   * - pre_generation_long_term: pre-generation (long-term).
    * 
    * @example
    * single_node_subscribe
@@ -33,7 +28,7 @@ export class DescribeLicenseOrdersRequest extends $dara.Model {
   packageType?: string;
   /**
    * @remarks
-   * The page number to query.
+   * The page number of the page to return.
    * 
    * @example
    * 1
@@ -41,7 +36,7 @@ export class DescribeLicenseOrdersRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of records to return on each page.
+   * The number of entries per page.
    * 
    * @example
    * 30
@@ -49,7 +44,9 @@ export class DescribeLicenseOrdersRequest extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The purchase channel. Valid values: \\`aliyun_market\\` (Alibaba Cloud Marketplace) and \\`aliyun_public\\` (standard purchase page).
+   * The purchase channel. Valid values:
+   * - aliyun_market: Alibaba Cloud Marketplace.
+   * - aliyun_public: standard purchase page.
    * 
    * @example
    * aliyun_market

package/src/models/DescribeLicenseOrdersResponseBody.ts

@@ -13,7 +13,7 @@ export class DescribeLicenseOrdersResponseBodyItems extends $dara.Model {
   activatedCodeCount?: number;
   /**
    * @remarks
-   * The quota for requesting activation codes.
+   * The quota of activation codes that can be requested.
    * 
    * @example
    * 10
@@ -29,7 +29,7 @@ export class DescribeLicenseOrdersResponseBodyItems extends $dara.Model {
   aliyunOrderId?: string;
   /**
    * @remarks
-   * Specifies whether the System Identifier can be left empty when an activation code is generated.
+   * Indicates whether the System Identifier field can be left empty when generating an activation code.
    * 
    * @example
    * false
@@ -37,7 +37,7 @@ export class DescribeLicenseOrdersResponseBodyItems extends $dara.Model {
   allowEmptySystemIdentifier?: boolean;
   /**
    * @remarks
-   * The database type, such as PG, Oracle, or MySQL.
+   * The database engine type, such as PG, Oracle, or MySQL.
    * 
    * @example
    * PG
@@ -45,7 +45,7 @@ export class DescribeLicenseOrdersResponseBodyItems extends $dara.Model {
   engine?: string;
   /**
    * @remarks
-   * The creation time.
+   * The time when the order was created.
    * 
    * @example
    * 2022-02-11 03:14:15
@@ -53,7 +53,7 @@ export class DescribeLicenseOrdersResponseBodyItems extends $dara.Model {
   gmtCreated?: string;
   /**
    * @remarks
-   * The update time.
+   * The time when the order was last updated.
    * 
    * @example
    * 2022-02-11 03:14:15
@@ -61,7 +61,7 @@ export class DescribeLicenseOrdersResponseBodyItems extends $dara.Model {
   gmtModified?: string;
   /**
    * @remarks
-   * Indicates whether the order is a virtual order. Virtual orders allow for pre-generating activation codes.
+   * Indicates whether the order is a virtual order. Virtual orders allow pre-generation of activation codes.
    * 
    * @example
    * false
@@ -69,7 +69,7 @@ export class DescribeLicenseOrdersResponseBodyItems extends $dara.Model {
   isVirtualOrder?: boolean;
   /**
    * @remarks
-   * Indicates whether the virtual order is frozen. No more activation codes can be generated from a frozen order.
+   * Indicates whether the virtual order is frozen. A frozen virtual order does not allow further generation of activation codes.
    * 
    * @example
    * false
@@ -79,15 +79,11 @@ export class DescribeLicenseOrdersResponseBodyItems extends $dara.Model {
    * @remarks
    * The package type. Valid values:
    * 
-   * - single_node_subscribe: single node (subscription)
-   * 
-   * - single_node_long_term: single node (long-term)
-   * 
-   * - primary_backup_subscribe: primary/standby (subscription)
-   * 
-   * - primary_backup_long_term: primary/standby (long-term)
-   * 
-   * - pre_generation_long_term: pre-generated (long-term)
+   * - single_node_subscribe: single node (subscription).
+   * - single_node_long_term: single node (long-term).
+   * - primary_backup_subscribe: primary/secondary (subscription).
+   * - primary_backup_long_term: primary/secondary (long-term).
+   * - pre_generation_long_term: pre-generation (long-term).
    * 
    * @example
    * single_node_subscribe
@@ -95,7 +91,7 @@ export class DescribeLicenseOrdersResponseBodyItems extends $dara.Model {
   packageType?: string;
   /**
    * @remarks
-   * The validity period of the package. Common options are one year or long-term (30 years).
+   * The validity period of the package. Typical values are one year or long-term (30 years).
    * 
    * @example
    * 1 year
@@ -103,7 +99,9 @@ export class DescribeLicenseOrdersResponseBodyItems extends $dara.Model {
   packageValidity?: string;
   /**
    * @remarks
-   * The purchase channel. Valid values: \\`aliyun_market\\` (Alibaba Cloud Marketplace) and \\`aliyun_public\\` (standard purchase page).
+   * The purchase channel. Valid values:
+   * - aliyun_market: Alibaba Cloud Marketplace.
+   * - aliyun_public: standard purchase page.
    * 
    * @example
    * aliyun_public

package/src/models/DescribeLocalAvailableRecoveryTimeResponseBody.ts

@@ -13,9 +13,10 @@ export class DescribeLocalAvailableRecoveryTimeResponseBody extends $dara.Model
   DBClusterId?: string;
   /**
    * @remarks
-   * The start of the time range available for recovery.
+   * The start time from which backups can be restored.
+   * > Calculated based on level-1 backups. Level-2 backups are not included.
    * 
-   * > This is calculated based on level-1 backups and does not include level-2 backups.
+   * The time is in the ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
    * 
    * @example
    * 2025-09-10T14:19:48Z
@@ -23,9 +24,11 @@ export class DescribeLocalAvailableRecoveryTimeResponseBody extends $dara.Model
   recoveryBeginTime?: string;
   /**
    * @remarks
-   * The end of the time range available for recovery.
+   * The end time to which backups can be restored.
    * 
-   * > This is calculated based on level-1 backups and does not include level-2 backups.
+   * > Calculated based on level-1 backups. Level-2 backups are not included.
+   * 
+   * The time is in the ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
    * 
    * @example
    * 2025-09-17T08:56:45Z