@alicloud/esa20240910 3.4.0 → 3.5.0

package/src/models/ListCertificatesResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListCertificatesResponseBodyResultDCV extends $dara.Model {
   /**
    * @remarks
-   * The ID of the DCV record.
+   * DCV ID。
    * 
    * @example
    * bababf7cdd1546a2ad04c0def1f4****
@@ -13,7 +13,7 @@ export class ListCertificatesResponseBodyResultDCV extends $dara.Model {
   id?: string;
   /**
    * @remarks
-   * The DCV key. For the `DNS` method, this is the name of the TXT record. For the `HTTP` method, this is the URL.
+   * The DCV name. For the DNS type, this is the TXT record name. For the HTTP type, this is the URL.
    * 
    * @example
    * http://www.example.com/.well-known/acme-challenge/pH20CqwS5L3ZnvkhI436DCzadKFuG7QcUcvB_4KsAow
@@ -29,7 +29,7 @@ export class ListCertificatesResponseBodyResultDCV extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The DCV method. Valid values: `DNS` and `HTTP`.
+   * The DCV type. Valid values: DNS and HTTP.
    * 
    * @example
    * HTTP
@@ -37,7 +37,7 @@ export class ListCertificatesResponseBodyResultDCV extends $dara.Model {
   type?: string;
   /**
    * @remarks
-   * The DCV value.
+   * The DCV content.
    * 
    * @example
    * pH20CqwS5L3ZnvkhI436DCzadKFuG7QcUcvB_4KsAow.KfzYo4LH3EgOt7a73G-RqZkbR0eYtLfEUmtmqGmr4FQ
@@ -75,7 +75,7 @@ export class ListCertificatesResponseBodyResultDCV extends $dara.Model {
 export class ListCertificatesResponseBodyResult extends $dara.Model {
   /**
    * @remarks
-   * The error code returned when a certificate application fails.
+   * The error code for the certificate application.
    * 
    * @example
    * 2
@@ -83,7 +83,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   applyCode?: number;
   /**
    * @remarks
-   * The error message returned when a certificate application fails.
+   * The error message for the certificate application.
    * 
    * @example
    * canceled
@@ -91,7 +91,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   applyMessage?: string;
   /**
    * @remarks
-   * The ID of the cloud certificate.
+   * The cloud certificate ID.
    * 
    * @example
    * 30000569
@@ -107,7 +107,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   commonName?: string;
   /**
    * @remarks
-   * The time when the certificate was created.
+   * The creation time. Format: YYYY-MM-DD HH:MM:SS, in UTC/GMT time zone.
    * 
    * @example
    * 2022-06-24 07:48:51
@@ -115,7 +115,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   createTime?: string;
   /**
    * @remarks
-   * The domain control validation (DCV) information.
+   * The Domain Control Validation (DCV) information.
    */
   DCV?: ListCertificatesResponseBodyResultDCV[];
   /**
@@ -128,7 +128,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   fingerprintSha256?: string;
   /**
    * @remarks
-   * The ID of the certificate.
+   * The certificate ID.
    * 
    * @example
    * baba39055622c008b90285a8838e****
@@ -136,7 +136,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   id?: string;
   /**
    * @remarks
-   * The issuer of the certificate.
+   * The certificate issuer.
    * 
    * @example
    * GlobalSign nv-sa
@@ -152,7 +152,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   issuerCN?: string;
   /**
    * @remarks
-   * The ID of the keyless server. This parameter is valid only when `Type` is set to `keyless`.
+   * The Keyless server ID. This parameter is valid only when Type is set to keyless.
    * 
    * @example
    * baba39055622c008b90285a8838e****
@@ -160,7 +160,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   keyServerId?: string;
   /**
    * @remarks
-   * The name of the certificate.
+   * The certificate name.
    * 
    * @example
    * yourCertName
@@ -168,7 +168,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The time when the certificate expires.
+   * The end time of the certificate validity period. Format: YYYY-MM-DD HH:MM:SS, in UTC/GMT time zone.
    * 
    * @example
    * 2024-03-31 02:08:00
@@ -176,7 +176,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   notAfter?: string;
   /**
    * @remarks
-   * The time when the certificate becomes valid.
+   * The start time of the certificate validity period. Format: YYYY-MM-DD HH:MM:SS, in UTC/GMT time zone.
    * 
    * @example
    * 2023-03-31 02:08:00
@@ -192,7 +192,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   pubAlg?: string;
   /**
    * @remarks
-   * The region.
+   * The region information.
    * 
    * @example
    * cn-hangzhou
@@ -200,7 +200,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   region?: string;
   /**
    * @remarks
-   * The subject alternative name (SAN) of the certificate.
+   * The Subject Alternative Name (SAN) of the certificate.
    * 
    * @example
    * www.example.com,*.example.com
@@ -208,7 +208,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   SAN?: string;
   /**
    * @remarks
-   * The serial number of the certificate.
+   * The certificate serial number.
    * 
    * @example
    * babab022c5e9b27bf9c64d7f4b16****
@@ -224,21 +224,14 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   sigAlg?: string;
   /**
    * @remarks
-   * The status of the certificate. Valid values:
-   * 
-   * - `OK`: The certificate is valid.
-   * 
-   * - `Expired`: The certificate has expired.
-   * 
-   * - `Expiring`: The certificate is due to expire within 30 days.
-   * 
-   * - `Issued`: The free certificate has been issued.
-   * 
-   * - `Applying`: The free certificate application is in progress.
-   * 
-   * - `ApplyFailed`: The free certificate application has failed.
-   * 
-   * - `Canceled`: The free certificate application has been canceled.
+   * The certificate status. Valid values:
+   * - OK: Normal.
+   * - Expired: The certificate has expired.
+   * - Expiring: The certificate is about to expire (within 30 days).
+   * - Issued: Free certificate - issued.
+   * - Applying: Free certificate - applying.
+   * - ApplyFailed: Free certificate - application failed.
+   * - Canceled: Free certificate - canceled.
    * 
    * @example
    * OK
@@ -246,15 +239,11 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The type of the certificate. Valid values:
-   * 
-   * - `cas`: An Alibaba Cloud certificate.
-   * 
-   * - `upload`: A user-uploaded certificate.
-   * 
-   * - `free`: A free certificate.
-   * 
-   * - `keyless`: A keyless certificate.
+   * The certificate type. Valid values:
+   * - cas: SSL Certificates Service certificate.
+   * - upload: Custom uploaded certificate.
+   * - free: Free certificate.
+   * - keyless: Keyless certificate.
    * 
    * @example
    * free
@@ -262,7 +251,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
   type?: string;
   /**
    * @remarks
-   * The time when the certificate was last updated.
+   * The update time. Format: YYYY-MM-DD HH:MM:SS, in UTC/GMT time zone.
    * 
    * @example
    * 2023-04-20 06:18:42
@@ -337,7 +326,7 @@ export class ListCertificatesResponseBodyResult extends $dara.Model {
 export class ListCertificatesResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The page number.
+   * The page number of the data to return.
    * 
    * @example
    * 1
@@ -345,7 +334,7 @@ export class ListCertificatesResponseBody extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of entries to return on each page.
+   * The number of records per page.
    * 
    * @example
    * 20
@@ -361,12 +350,12 @@ export class ListCertificatesResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * A list of certificate details.
+   * The result array.
    */
   result?: ListCertificatesResponseBodyResult[];
   /**
    * @remarks
-   * The ID of the site.
+   * The site ID.
    * 
    * @example
    * 1234567890123
@@ -374,7 +363,7 @@ export class ListCertificatesResponseBody extends $dara.Model {
   siteId?: number;
   /**
    * @remarks
-   * The name of the site.
+   * The site name.
    * 
    * @example
    * example.com
@@ -382,7 +371,7 @@ export class ListCertificatesResponseBody extends $dara.Model {
   siteName?: string;
   /**
    * @remarks
-   * The total number of entries.
+   * The total number of records.
    * 
    * @example
    * 10

package/src/models/ListClientCaCertificatesRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListClientCaCertificatesRequest extends $dara.Model {
   /**
    * @remarks
-   * The page number. Valid values: 1 to 500.
+   * The page number to return. Valid values: 1 to 500.
    * 
    * @example
    * 1
@@ -13,7 +13,7 @@ export class ListClientCaCertificatesRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of entries to return per page. Valid values: 1 to 100. The default value is 20.
+   * The number of entries per page. Default value: 20. Maximum value: 100. Valid values: 1 to 100.
    * 
    * @example
    * 20
@@ -21,7 +21,7 @@ export class ListClientCaCertificatesRequest extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The site ID. Call the [ListSites](~~ListSites~~) operation to obtain this ID.
+   * The site ID. You can call the [ListSites](~~ListSites~~) operation to obtain the site ID.
    * 
    * This parameter is required.
    * 

package/src/models/ListClientCaCertificatesResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   /**
    * @remarks
-   * The common name.
+   * The common name of the certificate.
    * 
    * @example
    * www.example.com
@@ -13,7 +13,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   commonName?: string;
   /**
    * @remarks
-   * The time when the certificate was added.
+   * The creation time. The time is in the YYYY-MM-DD HH:MM:SS format in the UTC/GMT time zone.
    * 
    * @example
    * 2024-06-24 07:48:51
@@ -21,7 +21,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   createTime?: string;
   /**
    * @remarks
-   * The SHA-256 fingerprint.
+   * The SHA-256 fingerprint of the certificate.
    * 
    * @example
    * 1dc5fc9af4eead2570c70d94b416130baeb6d4429b51fd3557379588456a****
@@ -37,7 +37,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   id?: string;
   /**
    * @remarks
-   * The issuer of the certificate.
+   * The authority that issued the certificate.
    * 
    * @example
    * GlobalSign nv-sa
@@ -53,7 +53,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The date and time when the certificate expires.
+   * The end time of the certificate validity period. The time is in the YYYY-MM-DD HH:MM:SS format in the UTC/GMT time zone.
    * 
    * @example
    * 2024-03-31 02:08:00
@@ -61,7 +61,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   notAfter?: string;
   /**
    * @remarks
-   * The date and time when the certificate becomes valid.
+   * The start time of the certificate validity period. The time is in the YYYY-MM-DD HH:MM:SS format in the UTC/GMT time zone.
    * 
    * @example
    * 2023-03-31 02:08:00
@@ -69,7 +69,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   notBefore?: string;
   /**
    * @remarks
-   * The algorithm of the certificate\\"s public key.
+   * The public key algorithm of the certificate.
    * 
    * @example
    * RSA
@@ -77,7 +77,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   pubkeyAlgorithm?: string;
   /**
    * @remarks
-   * The subject alternative names (SANs) of the certificate.
+   * The Subject Alternative Name (SAN) of the certificate.
    * 
    * @example
    * www.example.com,*.example.com
@@ -85,7 +85,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   SAN?: string;
   /**
    * @remarks
-   * The unique serial number assigned by the issuer.
+   * The certificate sequence number.
    * 
    * @example
    * babab022c5e9b27bf9c64d7f4b16****
@@ -93,7 +93,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   serialNumber?: string;
   /**
    * @remarks
-   * The algorithm used to sign the certificate.
+   * The signature algorithm of the certificate.
    * 
    * @example
    * SHA256-RSA
@@ -117,7 +117,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
   type?: string;
   /**
    * @remarks
-   * The time when the certificate was last updated.
+   * The update time. The time is in the YYYY-MM-DD HH:MM:SS format in the UTC/GMT time zone.
    * 
    * @example
    * 2024-07-20 06:18:42
@@ -175,7 +175,7 @@ export class ListClientCaCertificatesResponseBodyResult extends $dara.Model {
 export class ListClientCaCertificatesResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The page number.
+   * The page number of the returned data.
    * 
    * @example
    * 1
@@ -199,7 +199,7 @@ export class ListClientCaCertificatesResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * A list of client CA certificates.
+   * The list of client CA certificates.
    */
   result?: ListClientCaCertificatesResponseBodyResult[];
   /**

package/src/models/ListClientCertificatesResponseBody.ts

@@ -21,7 +21,7 @@ export class ListClientCertificatesResponseBodyResult extends $dara.Model {
   commonName?: string;
   /**
    * @remarks
-   * The creation time of the certificate.
+   * The creation time. Format: YYYY-MM-DD HH:MM:SS, in the UTC/GMT time zone.
    * 
    * @example
    * 2024-06-24 07:48:51
@@ -30,6 +30,9 @@ export class ListClientCertificatesResponseBodyResult extends $dara.Model {
   /**
    * @remarks
    * The SHA-256 fingerprint of the certificate.
+   * 
+   * @example
+   * 1dc5fc9af4eead2570c70d94b416130baeb6d4429b51fd3557379588456a****
    */
   fingerprintSha256?: string;
   /**
@@ -42,7 +45,7 @@ export class ListClientCertificatesResponseBodyResult extends $dara.Model {
   id?: string;
   /**
    * @remarks
-   * The certificate issuer.
+   * The authority that issued the certificate.
    * 
    * @example
    * GlobalSign nv-sa
@@ -58,7 +61,7 @@ export class ListClientCertificatesResponseBodyResult extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The time when the certificate expires.
+   * The end time of the certificate validity period. Format: YYYY-MM-DD HH:MM:SS, in the UTC/GMT time zone.
    * 
    * @example
    * 2024-03-31 02:08:00
@@ -66,7 +69,7 @@ export class ListClientCertificatesResponseBodyResult extends $dara.Model {
   notAfter?: string;
   /**
    * @remarks
-   * The time when the certificate becomes valid.
+   * The start time of the certificate validity period. Format: YYYY-MM-DD HH:MM:SS, in the UTC/GMT time zone.
    * 
    * @example
    * 2023-03-31 02:08:00
@@ -82,7 +85,7 @@ export class ListClientCertificatesResponseBodyResult extends $dara.Model {
   pubkeyAlgorithm?: string;
   /**
    * @remarks
-   * The subject alternative name (SAN) of the certificate.
+   * The Subject Alternative Name (SAN) of the certificate.
    * 
    * @example
    * www.example.com,*.example.com
@@ -90,7 +93,10 @@ export class ListClientCertificatesResponseBodyResult extends $dara.Model {
   SAN?: string;
   /**
    * @remarks
-   * The serial number of the certificate.
+   * The certificate serial number.
+   * 
+   * @example
+   * babaded901474b9693acf530e0fb1d**
    */
   serialNumber?: string;
   /**
@@ -119,7 +125,7 @@ export class ListClientCertificatesResponseBodyResult extends $dara.Model {
   type?: string;
   /**
    * @remarks
-   * The last update time of the certificate.
+   * The update time. Format: YYYY-MM-DD HH:MM:SS, in the UTC/GMT time zone.
    * 
    * @example
    * 2024-07-20 06:18:42
@@ -179,7 +185,7 @@ export class ListClientCertificatesResponseBodyResult extends $dara.Model {
 export class ListClientCertificatesResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The page number of the returned entries.
+   * The page number of the returned data.
    * 
    * @example
    * 1

package/src/models/ListKeylessServersRequest.ts

@@ -13,7 +13,7 @@ export class ListKeylessServersRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of entries per page.
+   * The number of records per page.
    * 
    * @example
    * 20
@@ -21,7 +21,7 @@ export class ListKeylessServersRequest extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The site ID. You can obtain this ID by calling the [ListSites](https://help.aliyun.com/document_detail/2850189.html) operation.
+   * The site ID. You can call the [ListSites](https://help.aliyun.com/document_detail/2850189.html) operation to obtain the site ID.
    * 
    * This parameter is required.
    * 

package/src/models/ListKeylessServersResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListKeylessServersResponseBodyResult extends $dara.Model {
   /**
    * @remarks
-   * The CA certificate used to verify the server certificate of the keyless server. This parameter applies only when `Verify` is set to `true`.
+   * The CA certificate used to verify the Keyless server certificate. This parameter takes effect only when Verify is set to true.
    * 
    * @example
    * -----BEGIN CERTIFICATE-----****
@@ -13,7 +13,7 @@ export class ListKeylessServersResponseBodyResult extends $dara.Model {
   caCertificate?: string;
   /**
    * @remarks
-   * The client certificate. This parameter must be provided with `ClientPrivateKey`.
+   * The client certificate. This parameter must be used together with the client private key.
    * 
    * @example
    * -----BEGIN CERTIFICATE-----****
@@ -21,7 +21,7 @@ export class ListKeylessServersResponseBodyResult extends $dara.Model {
   clientCertificate?: string;
   /**
    * @remarks
-   * The client private key. This parameter must be provided with `ClientCertificate`.
+   * The client private key. This parameter must be used together with the client certificate.
    * 
    * @example
    * -----BEGIN RSA PRIVATE KEY-----****
@@ -29,15 +29,15 @@ export class ListKeylessServersResponseBodyResult extends $dara.Model {
   clientPrivateKey?: string;
   /**
    * @remarks
-   * The creation time.
+   * The creation time. The time follows the format YYYY-MM-DDTHH:MM:SS+08:00 in the UTC/GMT time zone.
    * 
    * @example
-   * 2024-06-24 07:48:51
+   * 2025-07-18T20:33:31+08:00
    */
   createTime?: string;
   /**
    * @remarks
-   * The keyless server host name.
+   * The Keyless server hostname.
    * 
    * @example
    * example.com
@@ -45,7 +45,7 @@ export class ListKeylessServersResponseBodyResult extends $dara.Model {
   host?: string;
   /**
    * @remarks
-   * The keyless server ID.
+   * Keyless server ID。
    * 
    * @example
    * babab9db65ee5efcca9f3d41d4b5****
@@ -53,7 +53,7 @@ export class ListKeylessServersResponseBodyResult extends $dara.Model {
   id?: string;
   /**
    * @remarks
-   * The keyless server name.
+   * The Keyless server name.
    * 
    * @example
    * example
@@ -61,7 +61,7 @@ export class ListKeylessServersResponseBodyResult extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The keyless server port. Valid values: 1 to 65535.
+   * The Keyless server port. Valid values: 1 to 65535.
    * 
    * @example
    * 443
@@ -69,15 +69,15 @@ export class ListKeylessServersResponseBodyResult extends $dara.Model {
   port?: number;
   /**
    * @remarks
-   * The update time.
+   * The update time. The time follows the format YYYY-MM-DDTHH:MM:SS+08:00 in the UTC/GMT time zone.
    * 
    * @example
-   * 2024-07-20 06:18:42
+   * 2025-07-18T20:33:31+08:00
    */
   updateTime?: string;
   /**
    * @remarks
-   * Specifies whether to verify the server certificate of the keyless server. Defaults to false.
+   * Indicates whether to verify the Keyless server certificate. Default value: false.
    * 
    * @example
    * true
@@ -149,7 +149,7 @@ export class ListKeylessServersResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * A list of keyless server configurations.
+   * The result array.
    */
   result?: ListKeylessServersResponseBodyResult[];
   /**
@@ -170,7 +170,7 @@ export class ListKeylessServersResponseBody extends $dara.Model {
   siteName?: string;
   /**
    * @remarks
-   * The total count.
+   * The total number of records.
    * 
    * @example
    * 90