@dynatrace-sdk/client-query 1.11.1 → 1.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,24 @@
2
2
 
3
3
  @dynatrace-sdk/client-query
4
4
 
5
+ ## 1.12.1
6
+
7
+ ### Patch Changes
8
+
9
+ - Updated boolean serialization handling. APPDEV-9047
10
+
11
+ ## 1.12.0
12
+
13
+ ### Minor Changes
14
+
15
+ - Client updated to support latest API changes. NOISSUE
16
+ - Updated dependencies
17
+ - @dynatrace-sdk/http-client@1.3.0
18
+
19
+ ### Patch Changes
20
+
21
+ - Documentation removed from the package. APPDEV-8356
22
+
5
23
  ## 1.11.1
6
24
 
7
25
  ### Patch Changes
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @dynatrace-sdk/client-query
2
2
 
3
- [![npm](https://img.shields.io/badge/npm-v1.11.1-blue)](https://www.npmjs.com/package/@dynatrace-sdk/client-query/v/1.11.1)
3
+ [![npm](https://img.shields.io/badge/npm-v1.12.1-blue)](https://www.npmjs.com/package/@dynatrace-sdk/client-query/v/1.12.1)
4
4
  [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
5
5
 
6
6
  Exposes an API to fetch records stored in Grail
@@ -826,7 +826,7 @@ The response for error state
826
826
  | Name | Type | Description |
827
827
  | --- | --- | --- |
828
828
  |code<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Error code, which normally matches the HTTP error code. |
829
- |details<sup>*required</sup>|<a href="#errorresponsedetails" target="_blank" rel="noopener noreferrer">ErrorResponseDetails</a>| |
829
+ |details|<a href="#errorresponsedetails" target="_blank" rel="noopener noreferrer">ErrorResponseDetails</a>| |
830
830
  |message<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|A short, clear error message without details |
831
831
 
832
832
  ### ErrorResponseDetails
@@ -838,15 +838,31 @@ Detailed information about the error.
838
838
 
839
839
  | Name | Type | Description |
840
840
  | --- | --- | --- |
841
- |arguments<sup>*required</sup>|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The arguments for the message format. |
842
- |errorMessage<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Complete error message. |
843
- |errorMessageFormat<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The message format of the error message, string.format based. |
844
- |errorMessageFormatSpecifierTypes<sup>*required</sup>|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The corresponding DQL format specifier types for each format specifier used in the error message format. |
845
- |errorType<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The error type, e.g. COMMAND_NAME_MISSING |
846
- |exceptionType<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The exception type. |
841
+ |arguments|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The arguments for the message format. |
842
+ |constraintViolations|Array&lt;<a href="#errorresponsedetailsconstraintviolationsitem">ErrorResponseDetailsConstraintViolationsItem</a>&gt;|Information about an input parameter that violated some validation rule of the service API. |
843
+ |errorMessage|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Complete error message. |
844
+ |errorMessageFormat|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The message format of the error message, string.format based. |
845
+ |errorMessageFormatSpecifierTypes|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The corresponding DQL format specifier types for each format specifier used in the error message format. |
846
+ |errorType|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The error type, e.g. COMMAND_NAME_MISSING |
847
+ |exceptionType|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The exception type. |
848
+ |missingPermissions|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|List of missing IAM permissions necessary to successfully execute the request. |
849
+ |missingScopes|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|List of missing IAM scopes necessary to successfully execute the request. |
847
850
  |queryId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |
848
- |queryString<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Submitted query string. |
849
- |syntaxErrorPosition|<a href="#tokenposition">TokenPosition</a>| |
851
+ |queryString|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Submitted query string. |
852
+ |syntaxErrorPosition|<a href="#tokenposition" target="_blank" rel="noopener noreferrer">TokenPosition</a>| |
853
+
854
+ ### ErrorResponseDetailsConstraintViolationsItem
855
+
856
+
857
+
858
+
859
+
860
+
861
+ | Name | Type | Description |
862
+ | --- | --- | --- |
863
+ |message<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Message describing the error. |
864
+ |parameterDescriptor|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Describes the violating parameter. |
865
+ |parameterLocation|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Describes the general location of the violating parameter. |
850
866
 
851
867
  ### ExecuteRequest
852
868
 
@@ -867,7 +883,7 @@ Detailed information about the error.
867
883
  |maxResultBytes|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The maximum number of result bytes that this query will return. |
868
884
  |maxResultRecords|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The maximum number of result records that this query will return. |
869
885
  |query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
870
- |queryOptions|<a href="#queryoptions" target="_blank" rel="noopener noreferrer">QueryOptions</a>| |
886
+ |queryOptions|<a href="#queryoptions">QueryOptions</a>| |
871
887
  |requestTimeoutMilliseconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The time a client is willing to wait for the query result. In case the query finishes within the specified timeout, the query result is returned. Otherwise, the requestToken is returned, allowing polling for the result. |
872
888
  |timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
873
889
 
@@ -881,7 +897,7 @@ The possible type of a field in DQL.
881
897
  | Name | Type |
882
898
  | --- | --- |
883
899
  |type<sup>*required</sup>|FieldTypeType|
884
- |types|Array&lt;<a href="#rangedfieldtypes">RangedFieldTypes</a>&gt;|
900
+ |types|Array&lt;<a href="#rangedfieldtypes" target="_blank" rel="noopener noreferrer">RangedFieldTypes</a>&gt;|
885
901
 
886
902
  ### GeoPoint
887
903
 
@@ -904,12 +920,12 @@ Collects various bits of metadata information.
904
920
 
905
921
  | Name | Type | Description |
906
922
  | --- | --- | --- |
907
- |analysisTimeframe|<a href="#timeframe" target="_blank" rel="noopener noreferrer">Timeframe</a>| |
923
+ |analysisTimeframe|<a href="#timeframe">Timeframe</a>| |
908
924
  |canonicalQuery|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The canonical form of the query. It has normalized spaces and canonical constructs. |
909
925
  |dqlVersion|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The version of DQL that was used to process the query request. |
910
926
  |executionTimeMilliseconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The time it took to execute the query. |
911
927
  |locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Effective locale for the query. |
912
- |notifications|Array&lt;<a href="#metadatanotification">MetadataNotification</a>&gt;|Collected messages during the execution of the query. |
928
+ |notifications|Array&lt;<a href="#metadatanotification" target="_blank" rel="noopener noreferrer">MetadataNotification</a>&gt;|Collected messages during the execution of the query. |
913
929
  |query|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The submitted query. |
914
930
  |queryId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The id of the query |
915
931
  |sampled|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if sampling was used for at least one segment. |
@@ -927,8 +943,8 @@ Collects various bits of metadata information.
927
943
 
928
944
  | Name | Type |
929
945
  | --- | --- |
930
- |grail|<a href="#grailmetadata" target="_blank" rel="noopener noreferrer">GrailMetadata</a>|
931
- |metrics|Array&lt;<a href="#metricmetadata">MetricMetadata</a>&gt;|
946
+ |grail|<a href="#grailmetadata">GrailMetadata</a>|
947
+ |metrics|Array&lt;<a href="#metricmetadata" target="_blank" rel="noopener noreferrer">MetricMetadata</a>&gt;|
932
948
 
933
949
  ### MetadataNotification
934
950
 
@@ -945,7 +961,7 @@ The message that provides additional information about the execution of the quer
945
961
  |messageFormatSpecifierTypes|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The corresponding DQL format specifier types for each format specifier used in the error message format. |
946
962
  |notificationType|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The notification type, e.g. LIMIT_ADDED. |
947
963
  |severity|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The severity of the notification, currently: INFO, WARN, ERROR. |
948
- |syntaxPosition|<a href="#tokenposition" target="_blank" rel="noopener noreferrer">TokenPosition</a>| |
964
+ |syntaxPosition|<a href="#tokenposition">TokenPosition</a>| |
949
965
 
950
966
  ### MetricMetadata
951
967
 
@@ -976,7 +992,7 @@ An object that defines additional metric metadata.
976
992
  | --- | --- | --- |
977
993
  |locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query locale. If none specified, then a language/country neutral locale is chosen. The input values take the ISO-639 Language code with an optional ISO-3166 country code appended to it with an underscore. For instance, both values are valid 'en' or 'en_US'. |
978
994
  |query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
979
- |queryOptions|<a href="#queryoptions">QueryOptions</a>| |
995
+ |queryOptions|<a href="#queryoptions" target="_blank" rel="noopener noreferrer">QueryOptions</a>| |
980
996
  |timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
981
997
 
982
998
  ### PositionInfo
@@ -1009,7 +1025,7 @@ The response of GET query:execute call.
1009
1025
  | Name | Type | Description |
1010
1026
  | --- | --- | --- |
1011
1027
  |progress|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The progress of the query from 0 to 100. |
1012
- |result|<a href="#queryresult" target="_blank" rel="noopener noreferrer">QueryResult</a>| |
1028
+ |result|<a href="#queryresult">QueryResult</a>| |
1013
1029
  |state<sup>*required</sup>|QueryState| |
1014
1030
  |ttlSeconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Time to live in seconds. |
1015
1031
 
@@ -1022,9 +1038,9 @@ The result of the DQL query.
1022
1038
 
1023
1039
  | Name | Type | Description |
1024
1040
  | --- | --- | --- |
1025
- |metadata<sup>*required</sup>|<a href="#metadata">Metadata</a>| |
1026
- |records<sup>*required</sup>|Array&lt;null &#124; <a href="#resultrecord" target="_blank" rel="noopener noreferrer">ResultRecord</a>&gt;|List of records containing the result fields data. |
1027
- |types<sup>*required</sup>|Array&lt;<a href="#rangedfieldtypes">RangedFieldTypes</a>&gt;|The data types for the result records. |
1041
+ |metadata<sup>*required</sup>|<a href="#metadata" target="_blank" rel="noopener noreferrer">Metadata</a>| |
1042
+ |records<sup>*required</sup>|Array&lt;null &#124; <a href="#resultrecord">ResultRecord</a>&gt;|List of records containing the result fields data. |
1043
+ |types<sup>*required</sup>|Array&lt;<a href="#rangedfieldtypes" target="_blank" rel="noopener noreferrer">RangedFieldTypes</a>&gt;|The data types for the result records. |
1028
1044
 
1029
1045
  ### QueryStartResponse
1030
1046
 
@@ -1037,7 +1053,7 @@ The response when starting a query.
1037
1053
  | --- | --- | --- |
1038
1054
  |progress|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The progress of the query from 0 to 100. |
1039
1055
  |requestToken|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The token returned by the POST query:execute call. |
1040
- |result|<a href="#queryresult" target="_blank" rel="noopener noreferrer">QueryResult</a>| |
1056
+ |result|<a href="#queryresult">QueryResult</a>| |
1041
1057
  |state<sup>*required</sup>|QueryState| |
1042
1058
  |ttlSeconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Time to live in seconds. |
1043
1059
 
@@ -1051,7 +1067,7 @@ The field type in range.
1051
1067
  | Name | Type | Description |
1052
1068
  | --- | --- | --- |
1053
1069
  |indexRange|Array&lt;[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)&gt;|The range of elements at use this type in arrays (null for records). |
1054
- |mappings<sup>*required</sup>|<a href="#rangedfieldtypesmappings">RangedFieldTypesMappings</a>| |
1070
+ |mappings<sup>*required</sup>|<a href="#rangedfieldtypesmappings" target="_blank" rel="noopener noreferrer">RangedFieldTypesMappings</a>| |
1055
1071
 
1056
1072
  ### RangedFieldTypesMappings
1057
1073
  **type**: Record&lt;string, FieldType | undefined&gt;
@@ -1088,8 +1104,8 @@ The position of a token in a query string used for errors and notification to ma
1088
1104
 
1089
1105
  | Name | Type |
1090
1106
  | --- | --- |
1091
- |end<sup>*required</sup>|<a href="#positioninfo" target="_blank" rel="noopener noreferrer">PositionInfo</a>|
1092
- |start<sup>*required</sup>|<a href="#positioninfo">PositionInfo</a>|
1107
+ |end<sup>*required</sup>|<a href="#positioninfo">PositionInfo</a>|
1108
+ |start<sup>*required</sup>|<a href="#positioninfo" target="_blank" rel="noopener noreferrer">PositionInfo</a>|
1093
1109
 
1094
1110
  ### VerifyRequest
1095
1111
 
@@ -1103,7 +1119,7 @@ The position of a token in a query string used for errors and notification to ma
1103
1119
  |generateCanonicalQuery|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)| <i>default:</i> <code>false</code>|
1104
1120
  |locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query locale. If none specified, then a language/country neutral locale is chosen. The input values take the ISO-639 Language code with an optional ISO-3166 country code appended to it with an underscore. For instance, both values are valid 'en' or 'en_US'. |
1105
1121
  |query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
1106
- |queryOptions|<a href="#queryoptions" target="_blank" rel="noopener noreferrer">QueryOptions</a>| |
1122
+ |queryOptions|<a href="#queryoptions">QueryOptions</a>| |
1107
1123
  |timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
1108
1124
 
1109
1125
  ### VerifyResponse
@@ -1116,7 +1132,7 @@ Verify response.
1116
1132
  | Name | Type | Description |
1117
1133
  | --- | --- | --- |
1118
1134
  |canonicalQuery|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |
1119
- |notifications|Array&lt;<a href="#metadatanotification">MetadataNotification</a>&gt;|The notifications related to the supplied DQL query string. |
1135
+ |notifications|Array&lt;<a href="#metadatanotification" target="_blank" rel="noopener noreferrer">MetadataNotification</a>&gt;|The notifications related to the supplied DQL query string. |
1120
1136
  |valid<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the supplied DQL query string is valid. |
1121
1137
 
1122
1138
  ## Enums