@alicloud/polardb20170801 7.4.0 → 7.6.0

package/src/client.ts

@@ -2070,7 +2070,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates a model operator instance.
+   * Creates a model creation operator instance.
    * 
    * @param request - CreateAIDBClusterTaskRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2143,6 +2143,10 @@ export default class Client extends OpenApi {
       query["TaskName"] = request.taskName;
     }
 
+    if (!$dara.isNull(request.tuneArch)) {
+      query["TuneArch"] = request.tuneArch;
+    }
+
     if (!$dara.isNull(request.VPCId)) {
       query["VPCId"] = request.VPCId;
     }
@@ -2173,7 +2177,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates a model operator instance.
+   * Creates a model creation operator instance.
    * 
    * @param request - CreateAIDBClusterTaskRequest
    * @returns CreateAIDBClusterTaskResponse
@@ -3001,11 +3005,9 @@ export default class Client extends OpenApi {
    * Creates a full snapshot backup for a PolarDB cluster.
    * 
    * @remarks
-   * > - Each cluster can have up to three manually created backups at a time.
-   * >
-   * > - If you receive the error message `Exceeding the daily backup times of this DB cluster`, this indicates that three manual backups already exist for your cluster. [Delete a backup](https://help.aliyun.com/document_detail/98101.html) before you call this operation again.
-   * >
-   * > - After you call this operation, a backup job is created in the background. The job may take a long time to complete if the data volume is large.
+   * > * Each cluster can have up to three manually created backups at the same time.
+   * > * If the error message `Exceeding the daily backup times of this DB cluster` is returned, three manually created backups already exist in your cluster. [Delete backups](https://help.aliyun.com/document_detail/98101.html) before you call this operation.
+   * > * After you call this operation, a backup task is created in the background. If the data volume is large, the backup may take a long time. Wait until the backup is complete.
    * 
    * @param request - CreateBackupRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -3018,6 +3020,10 @@ export default class Client extends OpenApi {
       query["ClientToken"] = request.clientToken;
     }
 
+    if (!$dara.isNull(request.comment)) {
+      query["Comment"] = request.comment;
+    }
+
     if (!$dara.isNull(request.DBClusterId)) {
       query["DBClusterId"] = request.DBClusterId;
     }
@@ -3059,11 +3065,9 @@ export default class Client extends OpenApi {
    * Creates a full snapshot backup for a PolarDB cluster.
    * 
    * @remarks
-   * > - Each cluster can have up to three manually created backups at a time.
-   * >
-   * > - If you receive the error message `Exceeding the daily backup times of this DB cluster`, this indicates that three manual backups already exist for your cluster. [Delete a backup](https://help.aliyun.com/document_detail/98101.html) before you call this operation again.
-   * >
-   * > - After you call this operation, a backup job is created in the background. The job may take a long time to complete if the data volume is large.
+   * > * Each cluster can have up to three manually created backups at the same time.
+   * > * If the error message `Exceeding the daily backup times of this DB cluster` is returned, three manually created backups already exist in your cluster. [Delete backups](https://help.aliyun.com/document_detail/98101.html) before you call this operation.
+   * > * After you call this operation, a backup task is created in the background. If the data volume is large, the backup may take a long time. Wait until the backup is complete.
    * 
    * @param request - CreateBackupRequest
    * @returns CreateBackupResponse
@@ -8954,7 +8958,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Get task instance details
+   * Retrieves the details of a task instance.
    * 
    * @param request - DescribeAIDBClusterTaskAttributeRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -9009,7 +9013,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Get task instance details
+   * Retrieves the details of a task instance.
    * 
    * @param request - DescribeAIDBClusterTaskAttributeRequest
    * @returns DescribeAIDBClusterTaskAttributeResponse
@@ -9166,12 +9170,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Retrieves a list of model operators for a specified PolarDB instance.
+   * Retrieves the list of model operators for a specified PolarDB database instance.
    * 
    * @remarks
-   * ## Request
-   * - This API returns a list of model operators filtered by the `RelativeDBClusterId` and `KubeType` parameters.
-   * - Note: Ensure the provided `RelativeDBClusterId` matches the ID of an existing PolarDB database instance. Otherwise, no data will be returned.
+   * ## Description
+   * - This operation supports filtering and returning the list of model operators based on the `RelativeDBClusterId` and `KubeType` parameters.
+   * - Note: Ensure that the `RelativeDBClusterId` provided in the request matches an existing PolarDB database instance ID. Otherwise, data cannot be retrieved correctly.
    * 
    * @param request - DescribeAIDBClusterTasksRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -9226,12 +9230,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Retrieves a list of model operators for a specified PolarDB instance.
+   * Retrieves the list of model operators for a specified PolarDB database instance.
    * 
    * @remarks
-   * ## Request
-   * - This API returns a list of model operators filtered by the `RelativeDBClusterId` and `KubeType` parameters.
-   * - Note: Ensure the provided `RelativeDBClusterId` matches the ID of an existing PolarDB database instance. Otherwise, no data will be returned.
+   * ## Description
+   * - This operation supports filtering and returning the list of model operators based on the `RelativeDBClusterId` and `KubeType` parameters.
+   * - Note: Ensure that the `RelativeDBClusterId` provided in the request matches an existing PolarDB database instance ID. Otherwise, data cannot be retrieved correctly.
    * 
    * @param request - DescribeAIDBClusterTasksRequest
    * @returns DescribeAIDBClusterTasksResponse
@@ -10512,7 +10516,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * AI Application Log Details
+   * Queries the log details of an AI application.
    * 
    * @param request - DescribeApplicationLogsRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -10595,7 +10599,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * AI Application Log Details
+   * Queries the log details of an AI application.
    * 
    * @param request - DescribeApplicationLogsRequest
    * @returns DescribeApplicationLogsResponse
@@ -10679,6 +10683,14 @@ export default class Client extends OpenApi {
       query["ConsumerGroup"] = request.consumerGroup;
     }
 
+    if (!$dara.isNull(request.downsample)) {
+      query["Downsample"] = request.downsample;
+    }
+
+    if (!$dara.isNull(request.endStep)) {
+      query["EndStep"] = request.endStep;
+    }
+
     if (!$dara.isNull(request.endTime)) {
       query["EndTime"] = request.endTime;
     }
@@ -10691,10 +10703,18 @@ export default class Client extends OpenApi {
       query["Key"] = request.key;
     }
 
+    if (!$dara.isNull(request.maxPoints)) {
+      query["MaxPoints"] = request.maxPoints;
+    }
+
     if (!$dara.isNull(request.modelService)) {
       query["ModelService"] = request.modelService;
     }
 
+    if (!$dara.isNull(request.startStep)) {
+      query["StartStep"] = request.startStep;
+    }
+
     if (!$dara.isNull(request.startTime)) {
       query["StartTime"] = request.startTime;
     }
@@ -10819,6 +10839,80 @@ export default class Client extends OpenApi {
     return await this.describeApplicationServerlessConfWithOptions(request, runtime);
   }
 
+  /**
+   * Queries AI application sessions.
+   * 
+   * @param request - DescribeApplicationSessionIdsRequest
+   * @param runtime - runtime options for this request RuntimeOptions
+   * @returns DescribeApplicationSessionIdsResponse
+   */
+  async describeApplicationSessionIdsWithOptions(request: $_model.DescribeApplicationSessionIdsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeApplicationSessionIdsResponse> {
+    request.validate();
+    let query = { };
+    if (!$dara.isNull(request.applicationId)) {
+      query["ApplicationId"] = request.applicationId;
+    }
+
+    if (!$dara.isNull(request.endTime)) {
+      query["EndTime"] = request.endTime;
+    }
+
+    if (!$dara.isNull(request.ownerAccount)) {
+      query["OwnerAccount"] = request.ownerAccount;
+    }
+
+    if (!$dara.isNull(request.ownerId)) {
+      query["OwnerId"] = request.ownerId;
+    }
+
+    if (!$dara.isNull(request.pageNumber)) {
+      query["PageNumber"] = request.pageNumber;
+    }
+
+    if (!$dara.isNull(request.pageSize)) {
+      query["PageSize"] = request.pageSize;
+    }
+
+    if (!$dara.isNull(request.regionId)) {
+      query["RegionId"] = request.regionId;
+    }
+
+    if (!$dara.isNull(request.resourceOwnerAccount)) {
+      query["ResourceOwnerAccount"] = request.resourceOwnerAccount;
+    }
+
+    if (!$dara.isNull(request.startTime)) {
+      query["StartTime"] = request.startTime;
+    }
+
+    let req = new $OpenApiUtil.OpenApiRequest({
+      query: OpenApiUtil.query(query),
+    });
+    let params = new $OpenApiUtil.Params({
+      action: "DescribeApplicationSessionIds",
+      version: "2017-08-01",
+      protocol: "HTTPS",
+      pathname: "/",
+      method: "POST",
+      authType: "AK",
+      style: "RPC",
+      reqBodyType: "formData",
+      bodyType: "json",
+    });
+    return $dara.cast<$_model.DescribeApplicationSessionIdsResponse>(await this.callApi(params, req, runtime), new $_model.DescribeApplicationSessionIdsResponse({}));
+  }
+
+  /**
+   * Queries AI application sessions.
+   * 
+   * @param request - DescribeApplicationSessionIdsRequest
+   * @returns DescribeApplicationSessionIdsResponse
+   */
+  async describeApplicationSessionIds(request: $_model.DescribeApplicationSessionIdsRequest): Promise<$_model.DescribeApplicationSessionIdsResponse> {
+    let runtime = new $dara.RuntimeOptions({ });
+    return await this.describeApplicationSessionIdsWithOptions(request, runtime);
+  }
+
   /**
    * Gets the list of applications for all PolarDB instances in a specified region.
    * 
@@ -11022,7 +11116,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Lists the available models in an AI cluster.
+   * Retrieves the list of AI cluster models.
    * 
    * @param request - DescribeAvailableModelsRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -11057,7 +11151,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Lists the available models in an AI cluster.
+   * Retrieves the list of AI cluster models.
    * 
    * @param request - DescribeAvailableModelsRequest
    * @returns DescribeAvailableModelsResponse
@@ -11328,7 +11422,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries backup information for a PolarDB cluster.
+   * Queries the backup information of a PolarDB cluster.
    * 
    * @param request - DescribeBackupsRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -11407,7 +11501,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries backup information for a PolarDB cluster.
+   * Queries the backup information of a PolarDB cluster.
    * 
    * @param request - DescribeBackupsRequest
    * @returns DescribeBackupsResponse
@@ -11528,7 +11622,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Querying budget policies
+   * Queries cost budget policies.
    * 
    * @param request - DescribeBudgetPoliciesRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -11565,6 +11659,10 @@ export default class Client extends OpenApi {
       query["RegionId"] = request.regionId;
     }
 
+    if (!$dara.isNull(request.scopeRefName)) {
+      query["ScopeRefName"] = request.scopeRefName;
+    }
+
     if (!$dara.isNull(request.status)) {
       query["Status"] = request.status;
     }
@@ -11587,7 +11685,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Querying budget policies
+   * Queries cost budget policies.
    * 
    * @param request - DescribeBudgetPoliciesRequest
    * @returns DescribeBudgetPoliciesResponse
@@ -11890,7 +11988,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Returns a list of consumers.
+   * Queries the list of consumers.
    * 
    * @param request - DescribeConsumersRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -11907,6 +12005,14 @@ export default class Client extends OpenApi {
       query["ConsumerId"] = request.consumerId;
     }
 
+    if (!$dara.isNull(request.consumerName)) {
+      query["ConsumerName"] = request.consumerName;
+    }
+
+    if (!$dara.isNull(request.consumerNameList)) {
+      query["ConsumerNameList"] = request.consumerNameList;
+    }
+
     if (!$dara.isNull(request.gwClusterId)) {
       query["GwClusterId"] = request.gwClusterId;
     }
@@ -11941,7 +12047,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Returns a list of consumers.
+   * Queries the list of consumers.
    * 
    * @param request - DescribeConsumersRequest
    * @returns DescribeConsumersResponse
@@ -12242,7 +12348,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the IP whitelists and security groups that are allowed to access a database cluster.
+   * Queries the IP whitelist and security groups that are allowed to access a database cluster.
    * 
    * @param request - DescribeDBClusterAccessWhitelistRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -12263,6 +12369,10 @@ export default class Client extends OpenApi {
       query["OwnerId"] = request.ownerId;
     }
 
+    if (!$dara.isNull(request.pfsInstanceId)) {
+      query["PfsInstanceId"] = request.pfsInstanceId;
+    }
+
     if (!$dara.isNull(request.resourceOwnerAccount)) {
       query["ResourceOwnerAccount"] = request.resourceOwnerAccount;
     }
@@ -12289,7 +12399,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the IP whitelists and security groups that are allowed to access a database cluster.
+   * Queries the IP whitelist and security groups that are allowed to access a database cluster.
    * 
    * @param request - DescribeDBClusterAccessWhitelistRequest
    * @returns DescribeDBClusterAccessWhitelistResponse
@@ -13103,6 +13213,134 @@ export default class Client extends OpenApi {
     return await this.describeDBClusterPerformanceWithOptions(request, runtime);
   }
 
+  /**
+   * Queries the price of a cluster.
+   * 
+   * @param tmpReq - DescribeDBClusterPriceRequest
+   * @param runtime - runtime options for this request RuntimeOptions
+   * @returns DescribeDBClusterPriceResponse
+   */
+  async describeDBClusterPriceWithOptions(tmpReq: $_model.DescribeDBClusterPriceRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeDBClusterPriceResponse> {
+    tmpReq.validate();
+    let request = new $_model.DescribeDBClusterPriceShrinkRequest({ });
+    OpenApiUtil.convert(tmpReq, request);
+    if (!$dara.isNull(tmpReq.DBNodes)) {
+      request.DBNodesShrink = OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.DBNodes, "DBNodes", "json");
+    }
+
+    let query = { };
+    if (!$dara.isNull(request.creationCategory)) {
+      query["CreationCategory"] = request.creationCategory;
+    }
+
+    if (!$dara.isNull(request.DBClusterId)) {
+      query["DBClusterId"] = request.DBClusterId;
+    }
+
+    if (!$dara.isNull(request.DBNodeClass)) {
+      query["DBNodeClass"] = request.DBNodeClass;
+    }
+
+    if (!$dara.isNull(request.DBNodeIds)) {
+      query["DBNodeIds"] = request.DBNodeIds;
+    }
+
+    if (!$dara.isNull(request.DBNodeNum)) {
+      query["DBNodeNum"] = request.DBNodeNum;
+    }
+
+    if (!$dara.isNull(request.DBNodesShrink)) {
+      query["DBNodes"] = request.DBNodesShrink;
+    }
+
+    if (!$dara.isNull(request.DBType)) {
+      query["DBType"] = request.DBType;
+    }
+
+    if (!$dara.isNull(request.DBVersion)) {
+      query["DBVersion"] = request.DBVersion;
+    }
+
+    if (!$dara.isNull(request.hotStandbyCluster)) {
+      query["HotStandbyCluster"] = request.hotStandbyCluster;
+    }
+
+    if (!$dara.isNull(request.modifyType)) {
+      query["ModifyType"] = request.modifyType;
+    }
+
+    if (!$dara.isNull(request.orderType)) {
+      query["OrderType"] = request.orderType;
+    }
+
+    if (!$dara.isNull(request.payType)) {
+      query["PayType"] = request.payType;
+    }
+
+    if (!$dara.isNull(request.period)) {
+      query["Period"] = request.period;
+    }
+
+    if (!$dara.isNull(request.provisionedIops)) {
+      query["ProvisionedIops"] = request.provisionedIops;
+    }
+
+    if (!$dara.isNull(request.regionId)) {
+      query["RegionId"] = request.regionId;
+    }
+
+    if (!$dara.isNull(request.serverlessType)) {
+      query["ServerlessType"] = request.serverlessType;
+    }
+
+    if (!$dara.isNull(request.storageChargeType)) {
+      query["StorageChargeType"] = request.storageChargeType;
+    }
+
+    if (!$dara.isNull(request.storageSpace)) {
+      query["StorageSpace"] = request.storageSpace;
+    }
+
+    if (!$dara.isNull(request.storageType)) {
+      query["StorageType"] = request.storageType;
+    }
+
+    if (!$dara.isNull(request.usedTime)) {
+      query["UsedTime"] = request.usedTime;
+    }
+
+    if (!$dara.isNull(request.zoneId)) {
+      query["ZoneId"] = request.zoneId;
+    }
+
+    let req = new $OpenApiUtil.OpenApiRequest({
+      query: OpenApiUtil.query(query),
+    });
+    let params = new $OpenApiUtil.Params({
+      action: "DescribeDBClusterPrice",
+      version: "2017-08-01",
+      protocol: "HTTPS",
+      pathname: "/",
+      method: "POST",
+      authType: "AK",
+      style: "RPC",
+      reqBodyType: "formData",
+      bodyType: "json",
+    });
+    return $dara.cast<$_model.DescribeDBClusterPriceResponse>(await this.callApi(params, req, runtime), new $_model.DescribeDBClusterPriceResponse({}));
+  }
+
+  /**
+   * Queries the price of a cluster.
+   * 
+   * @param request - DescribeDBClusterPriceRequest
+   * @returns DescribeDBClusterPriceResponse
+   */
+  async describeDBClusterPrice(request: $_model.DescribeDBClusterPriceRequest): Promise<$_model.DescribeDBClusterPriceResponse> {
+    let runtime = new $dara.RuntimeOptions({ });
+    return await this.describeDBClusterPriceWithOptions(request, runtime);
+  }
+
   /**
    * Queries a database cluster proxy.
    * 
@@ -13191,6 +13429,10 @@ export default class Client extends OpenApi {
       query["OwnerId"] = request.ownerId;
     }
 
+    if (!$dara.isNull(request.pfsInstanceId)) {
+      query["PfsInstanceId"] = request.pfsInstanceId;
+    }
+
     if (!$dara.isNull(request.resourceOwnerAccount)) {
       query["ResourceOwnerAccount"] = request.resourceOwnerAccount;
     }
@@ -17544,7 +17786,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查看polarfs信息
+   * Queries PolarFS information.
    * 
    * @param request - DescribePolarFsRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -17607,7 +17849,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查看polarfs信息
+   * Queries PolarFS information.
    * 
    * @param request - DescribePolarFsRequest
    * @returns DescribePolarFsResponse
@@ -22790,7 +23032,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates or modifies the access whitelist for a cluster. The whitelist can be an IP address whitelist or a security group.
+   * Creates or modifies the whitelist of a cluster, including the IP whitelist and security groups.
    * 
    * @param request - ModifyDBClusterAccessWhitelistRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -22823,6 +23065,10 @@ export default class Client extends OpenApi {
       query["OwnerId"] = request.ownerId;
     }
 
+    if (!$dara.isNull(request.pfsInstanceId)) {
+      query["PfsInstanceId"] = request.pfsInstanceId;
+    }
+
     if (!$dara.isNull(request.resourceOwnerAccount)) {
       query["ResourceOwnerAccount"] = request.resourceOwnerAccount;
     }
@@ -22861,7 +23107,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates or modifies the access whitelist for a cluster. The whitelist can be an IP address whitelist or a security group.
+   * Creates or modifies the whitelist of a cluster, including the IP whitelist and security groups.
    * 
    * @param request - ModifyDBClusterAccessWhitelistRequest
    * @returns ModifyDBClusterAccessWhitelistResponse
@@ -24028,7 +24274,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Enables or disables SSL encryption for a PolarDB cluster, or updates its CA certificate.
+   * Enables or shuts down the Secure Sockets Layer (SSL) encryption feature for a PolarDB cluster, or updates the CA certificate of a PolarDB cluster.
    * 
    * @param request - ModifyDBClusterSSLRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -24037,6 +24283,10 @@ export default class Client extends OpenApi {
   async modifyDBClusterSSLWithOptions(request: $_model.ModifyDBClusterSSLRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ModifyDBClusterSSLResponse> {
     request.validate();
     let query = { };
+    if (!$dara.isNull(request.connectionString)) {
+      query["ConnectionString"] = request.connectionString;
+    }
+
     if (!$dara.isNull(request.DBClusterId)) {
       query["DBClusterId"] = request.DBClusterId;
     }
@@ -24057,6 +24307,10 @@ export default class Client extends OpenApi {
       query["OwnerId"] = request.ownerId;
     }
 
+    if (!$dara.isNull(request.pfsInstanceId)) {
+      query["PfsInstanceId"] = request.pfsInstanceId;
+    }
+
     if (!$dara.isNull(request.resourceOwnerAccount)) {
       query["ResourceOwnerAccount"] = request.resourceOwnerAccount;
     }
@@ -24091,7 +24345,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Enables or disables SSL encryption for a PolarDB cluster, or updates its CA certificate.
+   * Enables or shuts down the Secure Sockets Layer (SSL) encryption feature for a PolarDB cluster, or updates the CA certificate of a PolarDB cluster.
    * 
    * @param request - ModifyDBClusterSSLRequest
    * @returns ModifyDBClusterSSLResponse