@alicloud/alidns20150109 4.4.0 → 4.5.0

package/src/models/DescribeInterAuthStatisticsSummaryRequest.ts

@@ -4,68 +4,138 @@ import * as $dara from '@darabonba/typescript';
 
 export class DescribeInterAuthStatisticsSummaryRequest extends $dara.Model {
   /**
+   * @remarks
+   * The sort direction. Valid values:
+   * 
+   * - DESC (default): descending order
+   * 
+   * - ASC: ascending order.
+   * 
    * @example
    * DESC
    */
   direction?: string;
   /**
+   * @remarks
+   * The domain name.
+   * 
    * @example
    * example.com
    */
   domainName?: string;
   /**
+   * @remarks
+   * The end time of the query. The value is a UNIX timestamp in milliseconds.
+   * >Warning: If the query time range is large and the domain name has an excessive volume of resolution logs, the query may time out or return inaccurate results..
+   * 
    * @example
    * 1741526400000
    */
   endTimestamp?: number;
   /**
+   * @remarks
+   * Used for the report of subdomain names with sudden increases or decreases in request volume.
+   * 
    * @example
    * up
    * down
    */
   growType?: string;
   /**
+   * @remarks
+   * The sort parameter. Valid values:
+   * - createDate: sorts by creation time (default if left empty)
+   * - expireDate: sorts by expiration time.
+   * 
    * @example
    * default
    */
   orderBy?: string;
   /**
+   * @remarks
+   * The page number. The value starts from 1. Default value: 1.
+   * 
    * @example
    * 1
    */
   pageNumber?: number;
   /**
+   * @remarks
+   * The number of entries per page in a paged query. Maximum value: 100. Default value: 20.
+   * 
    * @example
    * 1
    */
   pageSize?: number;
   /**
+   * @remarks
+   * The sampling period. Valid values:
+   * 
+   * - DAY: day
+   * 
+   * - WEEK: week
+   * 
+   * - MONTH: month.
+   * 
    * @example
-   * 300
+   * DAY
    */
   period?: string;
   /**
+   * @remarks
+   * The DNS response code.
+   * 
    * @example
    * 0
    */
   rcode?: string;
   /**
+   * @remarks
+   * The region of the resolution cluster.
+   * 
    * @example
    * ap-southeast-3
    */
   serverRegion?: string;
   /**
+   * @remarks
+   * The route type. Valid values: cloud: cloud route. local: on-premises route.
+   * 
    * @example
    * File
    */
   sourceType?: string;
   /**
+   * @remarks
+   * The start time of the query. The value is a UNIX timestamp in milliseconds.
+   * 
    * @example
    * 1516779348000
    */
   startTimestamp?: number;
+  /**
+   * @remarks
+   * The type of statistical metric.
+   * 
+   * @example
+   * QTYPE_RATIO
+   * 枚举值：
+   * QTYPE_RATIO：DNS请求记录类型占比
+   * RCODE_DOMAIN：否定应答域名TOP排行
+   * RCODE_SOURCE_IP：某否定应答域名的请求源地址TOP排行
+   * REQUEST_ZONE：域名请求量排行（zone级别）
+   * REQUEST_DOMAIN：子域名请求量排行（domain name级别）
+   * SOURCE_REGION：请求来源地域分布
+   * SOURCE_ISP：请求来源运营商（ISP）分布
+   * SOURCE_IP：请求源IP详情（含地域、运营商、占比）
+   * LINE_HIT：解析线路命中详情
+   * LINE_RATIO：解析线路流量占比
+   */
   statisticalType?: string;
   /**
+   * @remarks
+   * The zone name.
+   * 
    * @example
    * example.com
    */

package/src/models/DescribeInterAuthStatisticsSummaryResponseBody.ts

@@ -4,71 +4,117 @@ import * as $dara from '@darabonba/typescript';
 
 export class DescribeInterAuthStatisticsSummaryResponseBodyPageData extends $dara.Model {
   /**
+   * @remarks
+   * The start time of the current period (the 0th second of the minute).
+   * 
    * @example
    * 1776754800000
    */
   aggrTimestamp?: number;
   /**
+   * @remarks
+   * The number of requests.
+   * 
    * @example
    * 20
    */
   count?: number;
   /**
+   * @remarks
+   * The domain name. Queries the transfer records of the specified domain name.
+   * 
    * @example
    * nervermsf.com
    */
   domainName?: string;
   /**
+   * @remarks
+   * The fluctuation rate.
+   * 
    * @example
    * 19
    */
   fluctuationValue?: number;
   /**
+   * @remarks
+   * The resolution line.
+   * 
    * @example
    * default
    */
   line?: string;
   /**
+   * @remarks
+   * The value of the previous period.
+   * 
    * @example
    * 2227
    */
   previousCount?: number;
   /**
+   * @remarks
+   * The protocol type of the DNS resolution query request. Valid values:
+   * 
+   * - UDP
+   * 
+   * - TCP.
+   * 
    * @example
    * TCP%DF\\"
    */
   protocol?: string;
   /**
+   * @remarks
+   * The request record type.
+   * 
    * @example
    * A
    */
   qtype?: string;
   /**
+   * @remarks
+   * The success rate or proportion.
+   * 
    * @example
    * 20
    */
   ratio?: number;
   /**
+   * @remarks
+   * The DNS response code.
+   * 
    * @example
    * 0
    */
   rcode?: string;
   /**
+   * @remarks
+   * The source IP address.
+   * 
    * @example
    * 112.16.17.203
    */
   sourceIp?: string;
   /**
+   * @remarks
+   * The ISP of the request source.
+   * 
    * @example
    * telecom
    */
   sourceIsp?: string;
   /**
+   * @remarks
+   * The source region for copying the image. If not specified, a random region is selected.
+   * 
    * @example
    * cn-shenzhen
    */
   sourceRegion?: string;
   /**
+   * @remarks
+   * The zone name.
+   * 
    * @example
    * longzi.xyz
    */
@@ -122,12 +168,22 @@ export class DescribeInterAuthStatisticsSummaryResponseBodyPageData extends $dar
 
 export class DescribeInterAuthStatisticsSummaryResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The current page number.
+   * 
    * @example
    * 1
    */
   curPage?: number;
+  /**
+   * @remarks
+   * The paginated data.
+   */
   pageData?: DescribeInterAuthStatisticsSummaryResponseBodyPageData[];
   /**
+   * @remarks
+   * The number of entries per page in a paged query. Maximum value: 100. Default value: 20.
+   * 
    * @example
    * 5
    */
@@ -141,11 +197,17 @@ export class DescribeInterAuthStatisticsSummaryResponseBody extends $dara.Model
    */
   requestId?: string;
   /**
+   * @remarks
+   * The total number of pages.
+   * 
    * @example
    * 5
    */
   totalPage?: number;
   /**
+   * @remarks
+   * The total number of entries.
+   * 
    * @example
    * 48
    */

package/src/models/DescribeInterAuthStatisticsZoneOverviewRequest.ts

@@ -4,16 +4,25 @@ import * as $dara from '@darabonba/typescript';
 
 export class DescribeInterAuthStatisticsZoneOverviewRequest extends $dara.Model {
   /**
+   * @remarks
+   * The statistical period. Valid values: DAY, WEEK, and MONTH.
+   * 
    * @example
    * DAY、WEEK、MONTH
    */
   overviewPeriod?: string;
   /**
+   * @remarks
+   * The region.
+   * 
    * @example
    * DescribeInterAuthStatisticsZoneOverview
    */
   serverRegion?: string;
   /**
+   * @remarks
+   * The name of the zone.
+   * 
    * @example
    * cheng.suow.cc
    */

package/src/models/DescribeInterAuthStatisticsZoneOverviewResponseBody.ts

@@ -4,16 +4,25 @@ import * as $dara from '@darabonba/typescript';
 
 export class DescribeInterAuthStatisticsZoneOverviewResponseBodyData extends $dara.Model {
   /**
+   * @remarks
+   * The number of domain names with refused responses.
+   * 
    * @example
    * 6
    */
   refusedDomainCount?: number;
   /**
+   * @remarks
+   * The number of domain names with a sudden drop in QPS.
+   * 
    * @example
    * 66
    */
   suddenDropDomainCount?: number;
   /**
+   * @remarks
+   * The number of domain names with a sudden increase in QPS.
+   * 
    * @example
    * 56
    */
@@ -44,10 +53,14 @@ export class DescribeInterAuthStatisticsZoneOverviewResponseBodyData extends $da
 }
 
 export class DescribeInterAuthStatisticsZoneOverviewResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * The overview data for the zone.
+   */
   data?: DescribeInterAuthStatisticsZoneOverviewResponseBodyData;
   /**
    * @remarks
-   * Id of the request
+   * The request ID.
    * 
    * @example
    * 536E9CAD-DB30-4647-AC87-AA5CC38C5382

package/src/models/DescribeInternetDnsLogsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeInternetDnsLogsRequest extends $dara.Model {
   /**
    * @remarks
-   * The account ID displayed on the Recursive Resolution (Public DNS) page after you activate Alibaba Cloud Public DNS.
+   * The ID of the Public DNS configuration.
    * 
    * @example
    * 51**4
@@ -16,24 +16,27 @@ export class DescribeInternetDnsLogsRequest extends $dara.Model {
    * The domain name.
    * 
    * @example
-   * example.com
+   * www.example.com
    */
   domainName?: string;
   /**
    * @remarks
-   * The end time of the query (timestamp, unit: milliseconds). >Warning: If the query time span is too large and the amount of resolution logs for the queried domain is excessive, it may lead to a query timeout or inaccurate query results.
+   * The end of the time range to query. This is a UNIX timestamp in milliseconds.
+   * >Warning: If you specify a wide time range, many logs may be returned. This can cause a query timeout or inaccurate results.
    * 
    * @example
-   * 1709196299999
+   * 1741526400000
    */
   endTimestamp?: number;
   /**
    * @remarks
-   * Return value language, options: 
-   * - zh: Chinese 
+   * The language of the response. Valid values:
+   * 
+   * - zh: Chinese
+   * 
    * - en: English
    * 
-   * Default: en
+   * Default value: en.
    * 
    * @example
    * en
@@ -41,9 +44,11 @@ export class DescribeInternetDnsLogsRequest extends $dara.Model {
   lang?: string;
   /**
    * @remarks
-   * Module type 
-   * - AUTHORITY (default): Public Authoritative DNS 
-   * - RECURSION: Public Recursive DNS
+   * The module type.
+   * 
+   * - AUTHORITY (default): public authoritative DNS
+   * 
+   * - RECURSION: public recursive DNS
    * 
    * @example
    * AUTHORITY
@@ -51,7 +56,7 @@ export class DescribeInternetDnsLogsRequest extends $dara.Model {
   module?: string;
   /**
    * @remarks
-   * Page number, default value is 1.
+   * The page number. Default value: 1.
    * 
    * @example
    * 1
@@ -59,7 +64,7 @@ export class DescribeInternetDnsLogsRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * Page size for query.
+   * The number of entries to return on each page.
    * 
    * @example
    * 10
@@ -68,13 +73,19 @@ export class DescribeInternetDnsLogsRequest extends $dara.Model {
   preciseSort?: boolean;
   /**
    * @remarks
-   * Query parameters 
-   * - sourceIp: Source IP address 
-   * - queryNameFuzzy: Domain name (fuzzy value) 
-   * - queryType: Record type 
-   * - value: Resolution result 
-   * - status: Status 
-   * - serverIp: Resolution server IP
+   * The query parameters.
+   * 
+   * - sourceIp: the source IP address
+   * 
+   * - queryNameFuzzy: the domain name (fuzzy match)
+   * 
+   * - queryType: the record type
+   * 
+   * - value: the resolution result
+   * 
+   * - status: the status
+   * 
+   * - serverIp: the IP address of the resolution server
    * 
    * @example
    * {"sourceIp":"59.82.XX.XX","queryType":"A"}
@@ -83,10 +94,10 @@ export class DescribeInternetDnsLogsRequest extends $dara.Model {
   recursionProtocolType?: string;
   /**
    * @remarks
-   * The start time of the query (timestamp, unit: milliseconds).
+   * The start of the time range to query. This is a UNIX timestamp in milliseconds.
    * 
    * @example
-   * 1709192640000
+   * 1738848000000
    */
   startTimestamp?: number;
   static names(): { [key: string]: string } {

package/src/models/DescribeInternetDnsLogsResponseBody.ts

@@ -125,7 +125,7 @@ export class DescribeInternetDnsLogsResponseBodyLogs extends $dara.Model {
 export class DescribeInternetDnsLogsResponseBody extends $dara.Model {
   /**
    * @remarks
-   * Indicates whether the log query is precise.
+   * Indicates whether the DNS resolution log query is precise.
    * 
    * @example
    * true
@@ -133,7 +133,7 @@ export class DescribeInternetDnsLogsResponseBody extends $dara.Model {
   complete?: boolean;
   /**
    * @remarks
-   * Current page number.
+   * The current page number.
    * 
    * @example
    * 1
@@ -142,7 +142,7 @@ export class DescribeInternetDnsLogsResponseBody extends $dara.Model {
   logs?: DescribeInternetDnsLogsResponseBodyLogs;
   /**
    * @remarks
-   * Page size for query.
+   * The number of entries returned per page.
    * 
    * @example
    * 10
@@ -150,7 +150,7 @@ export class DescribeInternetDnsLogsResponseBody extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * Unique request identifier.
+   * The unique ID of the request.
    * 
    * @example
    * 536E9CAD-DB30-4647-AC87-AA5CC38C5382
@@ -158,7 +158,7 @@ export class DescribeInternetDnsLogsResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * Total number of pages.
+   * The total number of pages.
    * 
    * @example
    * 5
@@ -166,7 +166,7 @@ export class DescribeInternetDnsLogsResponseBody extends $dara.Model {
   totalPage?: number;
   /**
    * @remarks
-   * Total quantity.
+   * The total number of entries.
    * 
    * @example
    * 48

package/src/models/DescribePdnsRequestStatisticRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribePdnsRequestStatisticRequest extends $dara.Model {
   /**
    * @remarks
-   * The primary domain name whose statistics you want to query.
+   * The primary domain name for which you want to query statistics.
    * 
    * @example
    * example.com
@@ -13,20 +13,21 @@ export class DescribePdnsRequestStatisticRequest extends $dara.Model {
   domainName?: string;
   /**
    * @remarks
-   * The end of the time range to query. Specify the time in the **YYYY-MM-DD** format.
+   * The end date of the query in the **YYYY-MM-DD** format.
    * 
-   * The default value is the day when you query the data.
+   * The default value is the current day.
    * 
    * @example
-   * 2024-7-1 00:00:00
+   * 2024-07-01
    */
   endDate?: string;
   /**
    * @remarks
-   * The language of the content within the request and response. Default value: **zh**. Valid values:
+   * The language of the request and response. The default value is **zh**. Valid values:
    * 
-   * *   **zh**: Chinese
-   * *   **en**: English
+   * - **zh**: Chinese
+   * 
+   * - **en**: English
    * 
    * @example
    * zh
@@ -34,17 +35,17 @@ export class DescribePdnsRequestStatisticRequest extends $dara.Model {
   lang?: string;
   /**
    * @remarks
-   * The beginning of the time range to query. Specify the time in the **YYYY-MM-DD** format.
+   * The start date of the query in the **YYYY-MM-DD** format.
    * 
-   * You can query only records of the last 90 days.
+   * You can query data from the last 90 days.
    * 
    * @example
-   * 2024-06-14 00:00:00
+   * 2024-06-14
    */
   startDate?: string;
   /**
    * @remarks
-   * The subdomain name whose statistics you want to query.
+   * The subdomain for which you want to query statistics.
    * 
    * @example
    * www.example.com
@@ -52,11 +53,13 @@ export class DescribePdnsRequestStatisticRequest extends $dara.Model {
   subDomain?: string;
   /**
    * @remarks
-   * The type of the request statistics that you want to query. Valid values:
+   * The dimension for statistics. Valid values:
+   * 
+   * - **ACCOUNT**: queries statistics by account.
+   * 
+   * - **DOMAIN**: queries statistics by domain name. The DomainName parameter is required.
    * 
-   * *   **ACCOUNT**: queries the request statistics by account.
-   * *   **DOMAIN**: queries the request statistics by domain name.
-   * *   **SUB_DOMAIN**: queries the request statistics by subdomain name.
+   * - **SUB_DOMAIN**: queries statistics by subdomain. The DomainName and SubDomain parameters are required.
    * 
    * @example
    * ACCOUNT

package/src/models/DescribePdnsRequestStatisticResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribePdnsRequestStatisticResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The total number of DoH requests, including HTTP and HTTPS requests.
+   * The total number of DNS-over-HTTPS (DoH) requests. This value includes both HTTP and HTTPS requests.
    * 
    * @example
    * 0
@@ -21,7 +21,7 @@ export class DescribePdnsRequestStatisticResponseBodyData extends $dara.Model {
   httpCount?: number;
   /**
    * @remarks
-   * The number of HTTPS requests. On the Traffic Analysis tab of the Public DNS console, the value of this parameter includes the number of DNS over HTTPs (DoH) requests. Therefore, the number of DoH requests is not separately displayed in the console.
+   * The number of HTTPS requests. On the Traffic Analysis tab of the Public DNS console, this parameter includes the number of DNS-over-HTTPS (DoH) requests. Therefore, DoH requests are not displayed separately in the console.
    * 
    * @example
    * 0
@@ -37,7 +37,7 @@ export class DescribePdnsRequestStatisticResponseBodyData extends $dara.Model {
   ipCount?: number;
   /**
    * @remarks
-   * The statistical timestamp. This value is a UNIX timestamp representing the number of milliseconds that have elapsed since January 1, 1970, 00:00:00 UTC.
+   * The timestamp of the statistics. Unit: milliseconds.
    * 
    * @example
    * 1706716800000
@@ -61,7 +61,7 @@ export class DescribePdnsRequestStatisticResponseBodyData extends $dara.Model {
   udpTotalCount?: number;
   /**
    * @remarks
-   * The number of IPv4-based requests.
+   * The number of IPv4 requests.
    * 
    * @example
    * 0
@@ -69,7 +69,7 @@ export class DescribePdnsRequestStatisticResponseBodyData extends $dara.Model {
   v4Count?: number;
   /**
    * @remarks
-   * The number of IPv4-based HTTP requests.
+   * The number of IPv4 HTTP requests.
    * 
    * @example
    * 0
@@ -77,7 +77,7 @@ export class DescribePdnsRequestStatisticResponseBodyData extends $dara.Model {
   v4HttpCount?: number;
   /**
    * @remarks
-   * The number of IPv4-based HTTPS requests.
+   * The number of IPv4 HTTPS requests.
    * 
    * @example
    * 0
@@ -85,7 +85,7 @@ export class DescribePdnsRequestStatisticResponseBodyData extends $dara.Model {
   v4HttpsCount?: number;
   /**
    * @remarks
-   * The number of IPv6-based requests.
+   * The number of IPv6 requests.
    * 
    * @example
    * 0
@@ -93,7 +93,7 @@ export class DescribePdnsRequestStatisticResponseBodyData extends $dara.Model {
   v6Count?: number;
   /**
    * @remarks
-   * The number of IPv6-based HTTP requests.
+   * The number of IPv6 HTTP requests.
    * 
    * @example
    * 0
@@ -101,7 +101,7 @@ export class DescribePdnsRequestStatisticResponseBodyData extends $dara.Model {
   v6HttpCount?: number;
   /**
    * @remarks
-   * The number of IPv6-based HTTPS requests.
+   * The number of IPv6 HTTPS requests.
    * 
    * @example
    * 0
@@ -155,12 +155,12 @@ export class DescribePdnsRequestStatisticResponseBodyData extends $dara.Model {
 export class DescribePdnsRequestStatisticResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The statistics on the DNS requests.
+   * A list of request statistics.
    */
   data?: DescribePdnsRequestStatisticResponseBodyData[];
   /**
    * @remarks
-   * The request ID.
+   * The unique request ID.
    * 
    * @example
    * 536E9CAD-DB30-4647-AC87-AA5CC38C5382