@dynatrace-sdk/client-classic-environment-v2 0.6.7 → 0.6.11

package/types/packages/client/classic-environment-v2/src/lib/apis/extensions-2-0-api.d.ts

@@ -1,6 +1,7 @@
 import { AbortSignal, HttpClient } from '@dynatrace-sdk/http-client';
 import { ErrorEnvelope } from '../models/error-envelope';
 import { Extension } from '../models/extension';
+import { ExtensionAssetsDto } from '../models/extension-assets-dto';
 import { ExtensionEnvironmentConfigurationVersion } from '../models/extension-environment-configuration-version';
 import { ExtensionEventsList } from '../models/extension-events-list';
 import { ExtensionList } from '../models/extension-list';
@@ -17,7 +18,6 @@ import { MonitoringConfigurationUpdateDto } from '../models/monitoring-configura
 import { SchemaDefinitionRestDto } from '../models/schema-definition-rest-dto';
 import { SchemaFiles } from '../models/schema-files';
 import { SchemasList } from '../models/schemas-list';
-import { UploadExtensionBody } from '../models/upload-extension-body';
 /**
  * Manage Extensions 2.0 life cycle
  */
@@ -32,7 +32,7 @@ export declare class Extensions_2_0Client {
     /**
      * Gets the active environment configuration version of the specified extension 2.0
      *
-     * **Required scope:** environment-api:extensions:read
+     * **Required scope:** environment-api:extensions:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     getActiveEnvironmentConfiguration(config: {
@@ -42,7 +42,7 @@ export declare class Extensions_2_0Client {
     /**
      * Updates the active environment configuration version of the extension 2.0
      *
-     * **Required scope:** environment-api:extensions:write
+     * **Required scope:** environment-api:extensions:write<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success. Environment configuration updated.
      */
     updateExtensionEnvironmentConfiguration(config: {
@@ -53,7 +53,7 @@ export declare class Extensions_2_0Client {
     /**
      * Activates the environment configuration from the specified version of the extension 2.0
      *
-     * **Required scope:** environment-api:extensions:write
+     * **Required scope:** environment-api:extensions:write<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success. Environment configuration created.
      */
     activateExtensionEnvironmentConfiguration(config: {
@@ -64,7 +64,7 @@ export declare class Extensions_2_0Client {
     /**
      * Deactivates the environment configuration of the specified extension 2.0
      *
-     * **Required scope:** environment-api:extensions:write
+     * **Required scope:** environment-api:extensions:write<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success. Environment configuration deactivated.
      */
     deleteEnvironmentConfiguration(config: {
@@ -74,7 +74,7 @@ export declare class Extensions_2_0Client {
     /**
      * Lists all the monitoring configurations of the specified extension 2.0
      *
-     * **Required scope:** environment-api:extension-configurations:read
+     * **Required scope:** environment-api:extension-configurations:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     extensionMonitoringConfigurations(config: {
@@ -100,7 +100,7 @@ export declare class Extensions_2_0Client {
     /**
      * Creates new monitoring configuration for the specified extension 2.0
      *
-     * **Required scope:** environment-api:extension-configurations:write
+     * **Required scope:** environment-api:extension-configurations:write<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success | Multi-Status, if not all requests resulted in the same status
      */
     createMonitoringConfiguration(config: {
@@ -116,7 +116,7 @@ export declare class Extensions_2_0Client {
     /**
      * Gets the configuration schema of the specified version of the extension 2.0
      *
-     * **Required scope:** environment-api:extension-configurations:read
+     * **Required scope:** environment-api:extension-configurations:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     extensionConfigurationSchema(config: {
@@ -127,7 +127,7 @@ export declare class Extensions_2_0Client {
     /**
      * Gets details of the specified version of the extension 2.0
      *
-     * **Required scope:** environment-api:extensions:read
+     * **Required scope:** environment-api:extensions:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     extensionDetails(config: {
@@ -139,7 +139,7 @@ export declare class Extensions_2_0Client {
     /**
      * Deletes the specified version of the extension 2.0
      *
-     * **Required scope:** environment-api:extensions:write
+     * **Required scope:** environment-api:extensions:write<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success. The extension 2.0 version has been deleted.
      */
     removeExtension(config: {
@@ -147,10 +147,20 @@ export declare class Extensions_2_0Client {
         /** The version of the requested extension 2.0 */ extensionVersion: string;
         abortSignal?: AbortSignal;
     }): Promise<Extension>;
+    /**
+     * Gets the information about assets in an active extension 2.0
+     *
+     * **Required scope:** environment-api:extensions:read<br/>**Required permission:** environment:roles:manage-settings
+     * @returns Success
+     */
+    getEnvironmentConfigurationAssetsInfo(config: {
+        /** The name of the requested extension 2.0. */ extensionName: string;
+        abortSignal?: AbortSignal;
+    }): Promise<ExtensionAssetsDto>;
     /**
      * List of the latest extension environment configuration events
      *
-     * **Required scope:** environment-api:extensions:read
+     * **Required scope:** environment-api:extensions:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns List of the latest extension environment configuration events
      */
     getEnvironmentConfigurationEvents(config: {
@@ -198,7 +208,7 @@ export declare class Extensions_2_0Client {
     /**
      * Gets the list of the events linked to specific monitoring configuration
      *
-     * **Required scope:** environment-api:extension-configurations:read
+     * **Required scope:** environment-api:extension-configurations:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     getExtensionMonitoringConfigurationEvents(config: {
@@ -262,7 +272,7 @@ export declare class Extensions_2_0Client {
     /**
      * Gets the most recent status of the execution of given monitoring configuration
      *
-     * **Required scope:** environment-api:extension-configurations:read
+     * **Required scope:** environment-api:extension-configurations:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     getExtensionMonitoringConfigurationStatus(config: {
@@ -273,7 +283,7 @@ export declare class Extensions_2_0Client {
     /**
      * Gets the extension 2.0 schema file in the specified version
      *
-     * **Required scope:** environment-api:extensions:read
+     * **Required scope:** environment-api:extensions:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     getSchemaFile(config: {
@@ -284,7 +294,7 @@ export declare class Extensions_2_0Client {
     /**
      * Lists all versions of the extension 2.0
      *
-     * **Required scope:** environment-api:extensions:read
+     * **Required scope:** environment-api:extensions:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     listExtensionVersions(config: {
@@ -308,7 +318,7 @@ export declare class Extensions_2_0Client {
     /**
      * Lists all the extensions 2.0 available in your environment
      *
-     * **Required scope:** environment-api:extensions:read
+     * **Required scope:** environment-api:extensions:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     listExtensions(config: {
@@ -332,18 +342,19 @@ export declare class Extensions_2_0Client {
     /**
      * Uploads or verifies a new extension 2.0
      *
-     * **Required scope:** environment-api:extensions:write
+     * **Required scope:** environment-api:extensions:write<br/>**Required permission:** environment:roles:manage-settings
      * @returns The extension is valid | Success. The extension 2.0 has been uploaded.
      */
     uploadExtension(config: {
-        body: UploadExtensionBody;
+        body: Blob;
+        type: 'application/octet-stream' | 'multipart/form-data';
         /** Only run validation but do not persist the extension even if validation was successful. */ validateOnly?: boolean;
         abortSignal?: AbortSignal;
     }): Promise<ExtensionUploadResponseDto>;
     /**
      * Lists all the files available for the specified extension 2.0 schema version
      *
-     * **Required scope:** environment-api:extensions:read
+     * **Required scope:** environment-api:extensions:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     listSchemaFiles(config: {
@@ -354,14 +365,14 @@ export declare class Extensions_2_0Client {
     /**
      * Lists all the extension 2.0 schemas versions available in your environment
      *
-     * **Required scope:** environment-api:extensions:read
+     * **Required scope:** environment-api:extensions:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     listSchemas(abortSignal?: AbortSignal): Promise<SchemasList>;
     /**
      * Gets the details of the specified monitoring configuration
      *
-     * **Required scope:** environment-api:extension-configurations:read
+     * **Required scope:** environment-api:extension-configurations:read<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     monitoringConfigurationDetails(config: {
@@ -372,7 +383,7 @@ export declare class Extensions_2_0Client {
     /**
      * Updates the specified monitoring configuration
      *
-     * **Required scope:** environment-api:extension-configurations:write
+     * **Required scope:** environment-api:extension-configurations:write<br/>**Required permission:** environment:roles:manage-settings
      * @returns Success
      */
     updateMonitoringConfiguration(config: {
@@ -384,7 +395,7 @@ export declare class Extensions_2_0Client {
     /**
      * Deletes the specified monitoring configuration
      *
-     * **Required scope:** environment-api:extension-configurations:write
+     * **Required scope:** environment-api:extension-configurations:write<br/>**Required permission:** environment:roles:manage-settings
      */
     removeMonitoringConfiguration(config: {
         /** The name of the requested extension 2.0. */ extensionName: string;

package/types/packages/client/classic-environment-v2/src/lib/apis/hub-items-api.d.ts

@@ -0,0 +1,162 @@
+import { AbortSignal, HttpClient } from '@dynatrace-sdk/http-client';
+import { CategoryList } from '../models/category-list';
+import { ExtensionReleaseNotes } from '../models/extension-release-notes';
+import { ItemDetails } from '../models/item-details';
+import { ItemList } from '../models/item-list';
+import { ListItemsQueryItemType } from '../models/list-items-query-item-type';
+import { RegisteredExtensionResultDto } from '../models/registered-extension-result-dto';
+import { UploadMetadataForExtensionBody } from '../models/upload-metadata-for-extension-body';
+/**
+ * Install, update and manage metadata of Hub items
+ */
+export declare class HubItemsClient {
+    private httpClient;
+    /**
+     * @param {HttpClient} httpClientImplementation - You can provide custom http client as a parameter to constructor of a HubItemsClient. Custom http client should implement {HttpClient} interface.
+     * @example
+     * const queryClientNodeJs = new QueryClient(yourCustomImplementation);
+     */
+    constructor(httpClientImplementation: HttpClient);
+    /**
+     * Retrieves the image associated with the given url.
+     * Can only obtain images used in hub items.
+     *
+     * **Required scope:** environment-api:hub:read<br/>**Required permission:** environment:roles:viewer
+     */
+    getImage(config: {
+        encodedUrl: string;
+        abortSignal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Lists all the available category groupings of items
+     *
+     * **Required scope:** environment-api:hub:read<br/>**Required permission:** environment:roles:viewer
+     * @returns OK
+     */
+    listCategories(abortSignal?: AbortSignal): Promise<CategoryList>;
+    /**
+     * Registers the given extension version in the environment (using the recommended version if no other release is registered)
+     *
+     * **Required scope:** environment-api:hub:write<br/>**Required permission:** environment:roles:manage-settings
+     * @returns OK
+     */
+    addToEnvironment(config: {
+        /** Fully qualified name of the extension */ extensionName: string;
+        /** Version of the extension. Fallback to the evaluated recommended version when the version is not provided */ extensionVersion?: string;
+        abortSignal?: AbortSignal;
+    }): Promise<RegisteredExtensionResultDto>;
+    /**
+     * The details of the given extension
+     *
+     * **Required scope:** environment-api:hub:read<br/>**Required permission:** environment:roles:viewer
+     * @returns OK
+     */
+    getExtensionDetails(config: {
+        /** Fully qualified name of the extension */ extensionName: string;
+        abortSignal?: AbortSignal;
+    }): Promise<ItemDetails>;
+    /**
+     * Updates the given extension to the latest compatible published version
+     *
+     * **Required scope:** environment-api:hub:write<br/>**Required permission:** environment:roles:manage-settings
+     * @returns OK
+     */
+    update(config: {
+        /** Fully qualified name of the extension */ extensionName: string;
+        /** Version of the extension. Fallback to the evaluated recommended version when the version is not provided */ extensionVersion?: string;
+        abortSignal?: AbortSignal;
+    }): Promise<RegisteredExtensionResultDto>;
+    /**
+     * Sets or updates the release notes of the specified extension release
+     *
+     * **Required scope:** environment-api:hub:write<br/>**Required permission:** environment:roles:manage-settings
+     */
+    updateReleaseNotes(config: {
+        body: ExtensionReleaseNotes;
+        /** Fully qualified name of the extension */ extensionName: string;
+        /** Version of the extension release */ version: string;
+        abortSignal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Create/Replace metadata for an extension that does not have Dynatrace distributed metadata.
+     *
+     * **Required scope:** environment-api:hub:write<br/>**Required permission:** environment:roles:manage-settings
+     */
+    uploadMetadataForExtension(config: {
+        body: UploadMetadataForExtensionBody;
+        /** Fully qualified name of the extension */ extensionName: string;
+        abortSignal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Artifact of the given version of an item
+     *
+     * **Required scope:** environment-api:hub:read<br/>**Required permission:** environment:roles:viewer
+     * @returns Ok - download file
+     */
+    getArtifact(config: {
+        /** Fully qualified name of the extension1/plugin */ extension1Fqn: string;
+        /** Version of the release of the extension1/plugin */ version: string;
+        abortSignal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * The details of the given extension version 1
+     *
+     * **Required scope:** environment-api:hub:read<br/>**Required permission:** environment:roles:viewer
+     * @returns OK
+     */
+    getDetails(config: {
+        /** Fully qualified name of the extension1/plugin */ extension1Fqn: string;
+        abortSignal?: AbortSignal;
+    }): Promise<ItemDetails>;
+    /**
+     * The details of the given technology
+     *
+     * **Required scope:** environment-api:hub:read<br/>**Required permission:** environment:roles:viewer
+     * @returns OK
+     */
+    getTechnologyDetails(config: {
+        /** Slug of the technology to be fetched */ slug: string;
+        abortSignal?: AbortSignal;
+    }): Promise<ItemDetails>;
+    /**
+     * Lists all the available items in your environment
+     *
+     * **Required scope:** environment-api:hub:read<br/>**Required permission:** environment:roles:viewer
+     * @returns OK
+     */
+    listItems(config: {
+        /**
+         * The cursor for the next page of results. You can find it in the **nextPageKey** field of the previous response.
+         *
+         * The first page is always returned if you don't specify the **nextPageKey** query parameter.
+         *
+         * When the **nextPageKey** is set to obtain subsequent pages, you must omit all other query parameters.
+         */ nextPageKey?: string;
+        /**
+         * The amount of hub items in a single response payload.
+         *
+         * The maximal allowed page size is 100.
+         *
+         * If not set, 20 is used.
+         */ pageSize?: number;
+        /** If provided, will filter out results based on the given item type. */ itemType?: ListItemsQueryItemType;
+        /**
+         * Filter the results for items matching the query string within id, name, author, description or any tag.
+         * - Case insensitive
+         * - Spaces in the query string will lead to an intersection of the results of each term
+         */ query?: string;
+        /**
+         * If provided, will restrict the result to Extensions 2.0 that have the respective installed state.
+         * - Only applies if itemType filter is not set or EXTENSION2
+         */ installed?: boolean;
+        /**
+         * If provided, will filter items that belong to the given category.
+         * - This overrides the itemType or installed filters
+         * - For a list of category ids refer to /categories
+         * - Will return the items in the order of the category
+         */ categoryId?: string;
+        /** If provided, will skip the desired number of results, allowing for pagination in combination with page size */ offset?: string;
+        abortSignal?: AbortSignal;
+    }): Promise<ItemList>;
+}
+export declare const hubItemsClient: HubItemsClient;

package/types/packages/client/classic-environment-v2/src/lib/apis/index.d.ts

@@ -9,11 +9,13 @@ export * from './credential-vault-api';
 export * from './davis-security-advisor-api';
 export * from './events-api';
 export * from './extensions-2-0-api';
+export * from './hub-items-api';
 export * from './logs-api';
 export * from './metrics-api';
 export * from './metrics-units-api';
 export * from './monitored-entities-api';
 export * from './monitored-entities-custom-tags-api';
+export * from './monitored-entities-monitoring-state-api';
 export * from './network-zones-api';
 export * from './problems-api';
 export * from './releases-api';

package/types/packages/client/classic-environment-v2/src/lib/apis/logs-api.d.ts

@@ -19,23 +19,23 @@ export declare class LogsClient {
     /**
      * Pushes log records to Dynatrace | maturity=EARLY_ADOPTER
      *
-     * **Required scope:** storage:logs:write<br/><br/>Ingested logs are stored in the indexed log storage.
+     * **Required scope:** storage:logs:write<br/>**Required permission:** storage:logs:write<br/><br/>Ingested logs are stored in the indexed log storage.
      *
      * This endpoint requires an ActiveGate with the **Log Analytics Collector** module enabled.
      *
      * The maximum payload size of a single request is **5 MB**. Requests with a greater payload are rejected, and the API returns a 413 response code.
      *
-     * If the ingested payload is a JSON array, the maximum array size is **5000**. Requests with a greater payload are rejected, and the API returns a 413 response code.
+     * If the ingested payload is a JSON array, the maximum array size is **50000**. Requests with a greater payload are rejected, and the API returns a 413 response code.
      *
      * <br />**Log events per minute (SaaS)**:
      *
-     * Trial tenants: 10k, paid one: 100k per minute by default.
+     * Grail tenants: no limit, other tenants: 1M per minute by default.
      *
      * If your log data stream within your cluster exceeds the limit, all log events above the limit are ignored.
      *
      * <br />**Log events per minute (Managed)**:
      *
-     * 10k/minute per cluster by default.
+     * 1k/minute per cluster by default.
      *
      * If your log data stream within your cluster exceeds the limit, all log events above the limit are ignored.
      *
@@ -54,7 +54,7 @@ export declare class LogsClient {
      * **High-cardinality attributes:**
      *
      * Unique log data attributes (high-cardinality attributes) such as `span_id` and `trace_id` generate unnecessarily excessive facet lists that may impact log viewer performance. Because of this, they aren't listed in log viewer facets. You can still use them in a log viewer advanced search query.
-     * @returns Only a part of input events were ingested due to event size limits or JSON parsing issues.
+     * @returns Only a part of input events were ingested due to event invalidity. For details, check the response body.
      */
     storeLog(config: ({
         body: LogMessageJson;
@@ -68,7 +68,7 @@ export declare class LogsClient {
     /**
      * Exports log records | maturity=EARLY_ADOPTER
      *
-     * **Required scope:** environment-api<br/><br/>Returns the first *X* records (specified in the **pageSize** query parameter).
+     * **Required scope:** environment-api<br/>**Required permission:** environment:roles:logviewer<br/><br/>Returns the first *X* records (specified in the **pageSize** query parameter).
      *
      *  Unlike the **search** API, this API does not split the result into slices and has no limit for the total number of records. Log records are sorted by the criteria specified in the **sort** query parameter.
      *
@@ -139,7 +139,7 @@ export declare class LogsClient {
     /**
      * Gets aggregated log records | maturity=EARLY_ADOPTER
      *
-     * **Required scope:** storage:logs:read<br/><br/>Returns the aggregated number of occurrences of log values divided into time slots.
+     * **Required scope:** storage:logs:read<br/>**Required permission:** environment:roles:logviewer<br/><br/>Returns the aggregated number of occurrences of log values divided into time slots.
      *
      * It is possible that the timeframe covered by results exceeds the specified timeframe. In that case the request returns fewer time slots than specified in the **timeBuckets** query parameter.
      * @returns Success
@@ -216,7 +216,7 @@ export declare class LogsClient {
     /**
      * Reads log records | maturity=EARLY_ADOPTER
      *
-     * **Required scope:** storage:logs:read<br/><br/>Returns the first *X* records (specified in the **limit** query parameter). Log records are sorted by the criteria specified in the **sort** query parameter.
+     * **Required scope:** storage:logs:read<br/>**Required permission:** environment:roles:logviewer<br/><br/>Returns the first *X* records (specified in the **limit** query parameter). Log records are sorted by the criteria specified in the **sort** query parameter.
      *
      * If the query is too large to be processed in a single request, it is divided into slices. In that case the first response contains the **nextSliceKey** cursor for the second slice. Use it in the **nextSliceKey** query parameter to obtain the second slice, which contains **nextSliceKey** cursor for the third slice, and so on.
      *

package/types/packages/client/classic-environment-v2/src/lib/apis/metrics-api.d.ts

@@ -17,7 +17,7 @@ export declare class MetricsClient {
     /**
      * Gets the descriptor of the specified metric
      *
-     * **Required scope:** environment-api:metrics:read
+     * **Required scope:** environment-api:metrics:read<br/>**Required permission:** environment:roles:viewer
      * @returns Success
      */
     metric(config: {
@@ -32,7 +32,7 @@ export declare class MetricsClient {
     /**
      * Deletes the specified metric
      *
-     * **Required scope:** environment-api:metrics:write<br/><br/>Deletion cannot be undone! You can't delete a metric if it has data points ingested within the last two hours.
+     * **Required scope:** environment-api:metrics:write<br/>**Required permission:** environment:roles:manage-settings<br/><br/>Deletion cannot be undone! You can't delete a metric if it has data points ingested within the last two hours.
      */
     delete(config: {
         /** The key of the required metric. */ metricKey: string;
@@ -41,7 +41,7 @@ export declare class MetricsClient {
     /**
      * Lists all available metrics
      *
-     * **Required scope:** environment-api:metrics:read<br/><br/>You can narrow down the output by selecting metrics in the **metricSelector** field.
+     * **Required scope:** environment-api:metrics:read<br/>**Required permission:** environment:roles:viewer<br/><br/>You can narrow down the output by selecting metrics in the **metricSelector** field.
      *
      * You can additionally limit the output by using pagination:
      *
@@ -152,8 +152,9 @@ export declare class MetricsClient {
          * * `unit("unit-1","unit-2")`
          * * `tags("tag-1","tag-2")`
          * * `dimensionKey("dimkey-1","dimkey-2")`. The filtering applies only to dimensions that were written within the last 14 days.
+         * * `custom("true")`. "true" to include only user-defined metrics metrics (without namespace or with `ext:`, `calc:`, `func:`, `appmon:`), "false" to filter them out.
          *
-         * To set several criteria, separate them with a comma (`,`). For example, `tags("feature","cloud"),unit("Percent"),dimensionKey("location")`. Only results matching **all** criteria are included in response.
+         * To set several criteria, separate them with a comma (`,`). For example, `tags("feature","cloud"),unit("Percent"),dimensionKey("location"),custom("true")`. Only results matching **all** criteria are included in response.
          *
          * For example, to list metrics that have the tags **feature** AND **cloud** with a unit of **Percent** OR **MegaByte** AND a dimension with a dimension key **location**, use this **metadataSelector**: `tags("feature"),unit("Percent","MegaByte"),tags("cloud"),dimensionKey("location")`.
          */ metadataSelector?: string;
@@ -163,7 +164,7 @@ export declare class MetricsClient {
     /**
      * Gets data points of the specified metrics
      *
-     * **Required scope:** environment-api:metrics:read<br/><br/>The following limits apply:
+     * **Required scope:** environment-api:metrics:read<br/>**Required permission:** environment:roles:viewer<br/><br/>The following limits apply:
      * * The amount of aggregated data points in the response is limited to 1,000
      * * The amount of series in the response is limited to 1,000
      *    * The amount of data points per series is limited to 10,080 (minutes of one week)
@@ -259,16 +260,16 @@ export declare class MetricsClient {
          * * Entity type: `type("TYPE")`
          * * Dynatrace entity ID: `entityId("id")`. You can specify several IDs, separated by a comma (`entityId("id-1","id-2")`). All requested entities must be of the same type.
          *
-         * You can add one or several of the following criteria. Values are case-sensitive and the `EQUALS` operator is used unless otherwise specified.
+         * You can add one or more of the following criteria. Values are case-sensitive and the `EQUALS` operator is used unless otherwise specified.
          *
-         * * Tag: `tag("value")`. Tags in `[context]key:value`, `key:value`, and `value` formats are detected and parsed automatically. Any colons (`:`) that are part of the key or value must be escaped with a backslash(`\`), otherwise, it will be interpreted as the separator between the key and the value. All tag values are case-sensitive.
+         * * Tag: `tag("value")`. Tags in `[context]key:value`, `key:value`, and `value` formats are detected and parsed automatically. Any colons (`:`) that are part of the key or value must be escaped with a backslash(`\`). Otherwise, it will be interpreted as the separator between the key and the value. All tag values are case-sensitive.
          * * Management zone ID: `mzId(123)`
          * * Management zone name: `mzName("value")`
          * * Entity name:
          * 	* `entityName.equals`: performs a non-casesensitive `EQUALS` query.
          * 	* `entityName.startsWith`: changes the operator to `BEGINS WITH`.
          * 	* `entityName.in`: enables you to provide multiple values. The `EQUALS` operator applies.
-         * 	* `caseSensitive(entityName.equals("value"))`: takes any entity name criterion as an arguments and makes the value case-sensitive.
+         * 	* `caseSensitive(entityName.equals("value"))`: takes any entity name criterion as an argument and makes the value case-sensitive.
          * * Health state (HEALTHY,UNHEALTHY): `healthState("HEALTHY")`
          * * First seen timestamp: `firstSeenTms.<operator>(now-3h)`. Use any timestamp format from the **from** /**to** parameters.
          * 	The following operators are available:
@@ -277,14 +278,14 @@ export declare class MetricsClient {
          * 	* `gte`: later than or at the specified time
          * 	* `gt`: later than the specified time
          * * Entity attribute: `<attribute>("value1","value2")` and `<attribute>.exists()`. To fetch the list of available attributes, execute the [GET entity type](https://dt-url.net/2ka3ivt) request and check the **properties** field of the response.
-         * * Relationships: `fromRelationships.<relationshipName>()` and `toRelationships.<relationshipName>()`. The criterion takes an entity selector as an attribute. To fetch the list of available relationships, execute the [GET entity type](https://dt-url.net/2ka3ivt) request and check the **fromRelationships** and **toRelationships** fields.
+         * * Relationships: `fromRelationships.<relationshipName>()` and `toRelationships.<relationshipName>()`. This criterion takes an entity selector as an attribute. To fetch the list of available relationships, execute the [GET entity type](https://dt-url.net/2ka3ivt) request and check the **fromRelationships** and **toRelationships** fields.
          * * Negation: `not(<criterion>)`. Inverts any criterion except for **type**.
          *
          * For more information, see [Entity selector](https://dt-url.net/apientityselector) in Dynatrace Documentation.
          *
-         * To set several criteria, separate them with a comma (`,`). For example, `type("HOST"),healthState("HEALTHY")`. Only results matching **all** criteria are included in response.
+         * To set several criteria, separate them with a comma (`,`). For example, `type("HOST"),healthState("HEALTHY")`. Only results matching **all** criteria are included in the response.
          *
-         * Supported string length is 2,000 characters.
+         * The maximum string length is 2,000 characters.
          *
          * Use the [`GET /metrics/{metricId}`](https://dt-url.net/6z23ifk) call to fetch the list of possible entity types for your metric.
          *
@@ -305,7 +306,7 @@ export declare class MetricsClient {
     /**
      * Pushes metric data points to Dynatrace
      *
-     * **Required scope:** storage:metrics:write
+     * **Required scope:** storage:metrics:write<br/>**Required permission:** storage:metrics:write
      * @returns The provided metric data points are accepted and will be processed in the background.
      */
     ingest(config: {

package/types/packages/client/classic-environment-v2/src/lib/apis/metrics-units-api.d.ts

@@ -16,7 +16,7 @@ export declare class MetricsUnitsClient {
     /**
      * Converts a value from a source unit into a target unit
      *
-     * **Required scope:** environment-api:metrics:read<br/><br/>If no target unit is set, the request finds an appropriate target unit automatically, taking into account the preferred number format (if specified).
+     * **Required scope:** environment-api:metrics:read<br/>**Required permission:** environment:roles:viewer<br/><br/>If no target unit is set, the request finds an appropriate target unit automatically, taking into account the preferred number format (if specified).
      * @returns Success
      */
     convert(config: {
@@ -40,7 +40,7 @@ export declare class MetricsUnitsClient {
     /**
      * Gets the properties of the specified unit
      *
-     * **Required scope:** environment-api:metrics:read
+     * **Required scope:** environment-api:metrics:read<br/>**Required permission:** environment:roles:viewer
      * @returns Success
      */
     unit(config: {
@@ -50,7 +50,7 @@ export declare class MetricsUnitsClient {
     /**
      * Lists all available units
      *
-     * **Required scope:** environment-api:metrics:read<br/><br/>You can narrow down the output by providing filter criteria in the **unitSelector** field.
+     * **Required scope:** environment-api:metrics:read<br/>**Required permission:** environment:roles:viewer<br/><br/>You can narrow down the output by providing filter criteria in the **unitSelector** field.
      * @returns Success
      */
     allUnits(config: {