@aws-sdk/client-rum 3.378.0 → 3.382.0

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.
@@ -1,4 +1,7 @@
1
1
  import { Endpoint, EndpointParameters as __EndpointParameters, EndpointV2, Provider } from "@smithy/types";
2
+ /**
3
+ * @public
4
+ */
2
5
  export interface ClientInputEndpointParameters {
3
6
  region?: string | Provider<string>;
4
7
  useDualstackEndpoint?: boolean | Provider<boolean>;
@@ -12,6 +12,7 @@
12
12
  */
13
13
  export * from "./RUMClient";
14
14
  export * from "./RUM";
15
+ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
15
16
  export * from "./commands";
16
17
  export * from "./pagination";
17
18
  export * from "./models";
@@ -40,26 +40,31 @@ export type Telemetry = (typeof Telemetry)[keyof typeof Telemetry];
40
40
  */
41
41
  export interface AppMonitorConfiguration {
42
42
  /**
43
+ * @public
43
44
  * <p>The ID of the Amazon Cognito identity pool
44
45
  * that is used to authorize the sending of data to RUM.</p>
45
46
  */
46
47
  IdentityPoolId?: string;
47
48
  /**
49
+ * @public
48
50
  * <p>A list of URLs in your website or application to exclude from RUM data collection.</p>
49
51
  * <p>You can't include both <code>ExcludedPages</code> and <code>IncludedPages</code> in the same operation.</p>
50
52
  */
51
53
  ExcludedPages?: string[];
52
54
  /**
55
+ * @public
53
56
  * <p>If this app monitor is to collect data from only certain pages in your application, this structure lists those pages. </p>
54
57
  * <p>You can't include both <code>ExcludedPages</code> and <code>IncludedPages</code> in the same operation.</p>
55
58
  */
56
59
  IncludedPages?: string[];
57
60
  /**
61
+ * @public
58
62
  * <p>A list of pages in your application that are to be displayed with a "favorite" icon
59
63
  * in the CloudWatch RUM console.</p>
60
64
  */
61
65
  FavoritePages?: string[];
62
66
  /**
67
+ * @public
63
68
  * <p>Specifies the portion of user sessions to use for RUM data collection. Choosing a higher portion gives you
64
69
  * more data but also incurs more costs.</p>
65
70
  * <p>The range for this value is 0 to 1 inclusive. Setting this to 1 means that 100% of user sessions are sampled, and setting
@@ -68,11 +73,13 @@ export interface AppMonitorConfiguration {
68
73
  */
69
74
  SessionSampleRate?: number;
70
75
  /**
76
+ * @public
71
77
  * <p>The ARN of the guest IAM role that is attached to the Amazon Cognito identity pool
72
78
  * that is used to authorize the sending of data to RUM.</p>
73
79
  */
74
80
  GuestRoleArn?: string;
75
81
  /**
82
+ * @public
76
83
  * <p>If you set this to <code>true</code>, the RUM web client sets two cookies, a session
77
84
  * cookie and a user cookie. The cookies allow the RUM web client to collect data relating to
78
85
  * the number of users an application has and the behavior of the application across a
@@ -80,6 +87,7 @@ export interface AppMonitorConfiguration {
80
87
  */
81
88
  AllowCookies?: boolean;
82
89
  /**
90
+ * @public
83
91
  * <p>An array that lists the types of telemetry data that this app monitor is to collect.</p>
84
92
  * <ul>
85
93
  * <li>
@@ -100,6 +108,7 @@ export interface AppMonitorConfiguration {
100
108
  */
101
109
  Telemetries?: (Telemetry | string)[];
102
110
  /**
111
+ * @public
103
112
  * <p>If you set this to <code>true</code>, RUM enables X-Ray tracing for
104
113
  * the user sessions that RUM samples. RUM adds an X-Ray trace header to allowed
105
114
  * HTTP requests. It also records an X-Ray segment for allowed HTTP requests.
@@ -127,6 +136,7 @@ export type CustomEventsStatus = (typeof CustomEventsStatus)[keyof typeof Custom
127
136
  */
128
137
  export interface CustomEvents {
129
138
  /**
139
+ * @public
130
140
  * <p>Specifies whether this app monitor allows the web client to define and send
131
141
  * custom events. The default is for custom events to be <code>DISABLED</code>.</p>
132
142
  */
@@ -139,11 +149,13 @@ export interface CustomEvents {
139
149
  */
140
150
  export interface CwLog {
141
151
  /**
152
+ * @public
142
153
  * <p>Indicated whether the app monitor stores copies of the data
143
154
  * that RUM collects in CloudWatch Logs.</p>
144
155
  */
145
156
  CwLogEnabled?: boolean;
146
157
  /**
158
+ * @public
147
159
  * <p>The name of the log group where the copies are stored.</p>
148
160
  */
149
161
  CwLogGroup?: string;
@@ -155,6 +167,7 @@ export interface CwLog {
155
167
  */
156
168
  export interface DataStorage {
157
169
  /**
170
+ * @public
158
171
  * <p>A structure that contains the information about whether the app monitor stores copies of the data
159
172
  * that RUM collects in CloudWatch Logs. If it does, this structure also contains the name of the log group.</p>
160
173
  */
@@ -181,43 +194,53 @@ export type StateEnum = (typeof StateEnum)[keyof typeof StateEnum];
181
194
  */
182
195
  export interface AppMonitor {
183
196
  /**
197
+ * @public
184
198
  * <p>The name of the app monitor.</p>
185
199
  */
186
200
  Name?: string;
187
201
  /**
202
+ * @public
188
203
  * <p>The top-level internet domain name for which your application has administrative authority.</p>
189
204
  */
190
205
  Domain?: string;
191
206
  /**
207
+ * @public
192
208
  * <p>The unique ID of this app monitor.</p>
193
209
  */
194
210
  Id?: string;
195
211
  /**
212
+ * @public
196
213
  * <p>The date and time that this app monitor was created.</p>
197
214
  */
198
215
  Created?: string;
199
216
  /**
217
+ * @public
200
218
  * <p>The date and time of the most recent changes to this app monitor's configuration.</p>
201
219
  */
202
220
  LastModified?: string;
203
221
  /**
222
+ * @public
204
223
  * <p>The list of tag keys and values associated with this app monitor.</p>
205
224
  */
206
225
  Tags?: Record<string, string>;
207
226
  /**
227
+ * @public
208
228
  * <p>The current state of the app monitor.</p>
209
229
  */
210
230
  State?: StateEnum | string;
211
231
  /**
232
+ * @public
212
233
  * <p>A structure that contains much of the configuration data for the app monitor.</p>
213
234
  */
214
235
  AppMonitorConfiguration?: AppMonitorConfiguration;
215
236
  /**
237
+ * @public
216
238
  * <p>A structure that contains information about whether this app monitor stores a copy of
217
239
  * the telemetry data that RUM collects using CloudWatch Logs.</p>
218
240
  */
219
241
  DataStorage?: DataStorage;
220
242
  /**
243
+ * @public
221
244
  * <p>Specifies whether this app monitor allows the web client to define and send
222
245
  * custom events.</p>
223
246
  * <p>For more information about custom events, see
@@ -231,14 +254,17 @@ export interface AppMonitor {
231
254
  */
232
255
  export interface AppMonitorDetails {
233
256
  /**
257
+ * @public
234
258
  * <p>The name of the app monitor.</p>
235
259
  */
236
260
  name?: string;
237
261
  /**
262
+ * @public
238
263
  * <p>The unique ID of the app monitor.</p>
239
264
  */
240
265
  id?: string;
241
266
  /**
267
+ * @public
242
268
  * <p>The version of the app monitor.</p>
243
269
  */
244
270
  version?: string;
@@ -482,6 +508,7 @@ export type MetricDestination = (typeof MetricDestination)[keyof typeof MetricDe
482
508
  */
483
509
  export interface MetricDefinitionRequest {
484
510
  /**
511
+ * @public
485
512
  * <p>The name for the metric that is defined in this structure. For custom metrics, you can specify
486
513
  * any name that you like. For extended metrics, valid values are the following:</p>
487
514
  * <ul>
@@ -545,6 +572,7 @@ export interface MetricDefinitionRequest {
545
572
  */
546
573
  Name: string | undefined;
547
574
  /**
575
+ * @public
548
576
  * <p>The field within the event object that the metric value is sourced from.</p>
549
577
  * <p>If you omit this field, a hardcoded value of 1 is pushed as the metric value. This is useful if you
550
578
  * just want to count the number of events that the filter catches. </p>
@@ -553,11 +581,13 @@ export interface MetricDefinitionRequest {
553
581
  */
554
582
  ValueKey?: string;
555
583
  /**
584
+ * @public
556
585
  * <p>The CloudWatch metric unit to use for this metric. If you omit this field, the metric
557
586
  * is recorded with no unit.</p>
558
587
  */
559
588
  UnitLabel?: string;
560
589
  /**
590
+ * @public
561
591
  * <p>Use this field only if you are sending the metric to CloudWatch.</p>
562
592
  * <p>This field is a map of field paths to dimension names. It defines the dimensions to associate with this
563
593
  * metric in CloudWatch. For extended metrics, valid values for the entries in this field are the following:</p>
@@ -599,6 +629,7 @@ export interface MetricDefinitionRequest {
599
629
  */
600
630
  DimensionKeys?: Record<string, string>;
601
631
  /**
632
+ * @public
602
633
  * <p>The pattern that defines the metric, specified as a JSON object. RUM checks events that happen in a user's session
603
634
  * against the pattern, and events that match the pattern are sent to the metric destination.</p>
604
635
  * <p>When you define extended metrics, the metric definition is not valid if <code>EventPattern</code>
@@ -651,6 +682,7 @@ export interface MetricDefinitionRequest {
651
682
  */
652
683
  EventPattern?: string;
653
684
  /**
685
+ * @public
654
686
  * <p>If this structure is for a custom metric instead of an extended metrics, use this parameter to define the
655
687
  * metric namespace for that custom metric. Do not specify this parameter if this structure is for an extended metric.</p>
656
688
  * <p>You cannot use any string that starts with <code>AWS/</code> for your namespace.</p>
@@ -662,10 +694,12 @@ export interface MetricDefinitionRequest {
662
694
  */
663
695
  export interface BatchCreateRumMetricDefinitionsRequest {
664
696
  /**
697
+ * @public
665
698
  * <p>The name of the CloudWatch RUM app monitor that is to send the metrics.</p>
666
699
  */
667
700
  AppMonitorName: string | undefined;
668
701
  /**
702
+ * @public
669
703
  * <p>The destination to send the metrics to. Valid values are <code>CloudWatch</code> and <code>Evidently</code>. If
670
704
  * you specify <code>Evidently</code>, you must also specify the ARN of the CloudWatchEvidently experiment
671
705
  * that will receive
@@ -673,6 +707,7 @@ export interface BatchCreateRumMetricDefinitionsRequest {
673
707
  */
674
708
  Destination: MetricDestination | string | undefined;
675
709
  /**
710
+ * @public
676
711
  * <p>This parameter is required if <code>Destination</code> is <code>Evidently</code>. If <code>Destination</code> is
677
712
  * <code>CloudWatch</code>, do not use this parameter.</p>
678
713
  * <p>This parameter specifies the ARN of the Evidently experiment that is to receive the metrics. You must have already defined this
@@ -680,6 +715,7 @@ export interface BatchCreateRumMetricDefinitionsRequest {
680
715
  */
681
716
  DestinationArn?: string;
682
717
  /**
718
+ * @public
683
719
  * <p>An array of structures which define the metrics that you want to send.</p>
684
720
  */
685
721
  MetricDefinitions: MetricDefinitionRequest[] | undefined;
@@ -692,14 +728,17 @@ export interface BatchCreateRumMetricDefinitionsRequest {
692
728
  */
693
729
  export interface BatchCreateRumMetricDefinitionsError {
694
730
  /**
731
+ * @public
695
732
  * <p>The metric definition that caused this error.</p>
696
733
  */
697
734
  MetricDefinition: MetricDefinitionRequest | undefined;
698
735
  /**
736
+ * @public
699
737
  * <p>The error code.</p>
700
738
  */
701
739
  ErrorCode: string | undefined;
702
740
  /**
741
+ * @public
703
742
  * <p>The error message for this metric definition.</p>
704
743
  */
705
744
  ErrorMessage: string | undefined;
@@ -713,29 +752,35 @@ export interface BatchCreateRumMetricDefinitionsError {
713
752
  */
714
753
  export interface MetricDefinition {
715
754
  /**
755
+ * @public
716
756
  * <p>The ID of this metric definition.</p>
717
757
  */
718
758
  MetricDefinitionId: string | undefined;
719
759
  /**
760
+ * @public
720
761
  * <p>The name of the metric that is defined in this structure.</p>
721
762
  */
722
763
  Name: string | undefined;
723
764
  /**
765
+ * @public
724
766
  * <p>The field within the event object that the metric value is sourced from.</p>
725
767
  */
726
768
  ValueKey?: string;
727
769
  /**
770
+ * @public
728
771
  * <p>Use this field only if you are sending this metric to CloudWatch. It defines
729
772
  * the CloudWatch metric unit that this metric is measured in. </p>
730
773
  */
731
774
  UnitLabel?: string;
732
775
  /**
776
+ * @public
733
777
  * <p>This field is a map of field paths to dimension names. It defines the dimensions to associate with this
734
778
  * metric in CloudWatch The value of this field is used only if the metric destination is <code>CloudWatch</code>.
735
779
  * If the metric destination is <code>Evidently</code>, the value of <code>DimensionKeys</code> is ignored.</p>
736
780
  */
737
781
  DimensionKeys?: Record<string, string>;
738
782
  /**
783
+ * @public
739
784
  * <p>The pattern that defines the metric. RUM checks events that happen in a user's session
740
785
  * against the pattern, and events that match the pattern are sent to the metric destination.</p>
741
786
  * <p>If the metrics destination
@@ -744,6 +789,7 @@ export interface MetricDefinition {
744
789
  */
745
790
  EventPattern?: string;
746
791
  /**
792
+ * @public
747
793
  * <p>If this metric definition is for a custom metric instead of an extended metric, this field displays
748
794
  * the metric namespace that the custom metric is published to.</p>
749
795
  */
@@ -754,10 +800,12 @@ export interface MetricDefinition {
754
800
  */
755
801
  export interface BatchCreateRumMetricDefinitionsResponse {
756
802
  /**
803
+ * @public
757
804
  * <p>An array of error objects, if the operation caused any errors.</p>
758
805
  */
759
806
  Errors: BatchCreateRumMetricDefinitionsError[] | undefined;
760
807
  /**
808
+ * @public
761
809
  * <p>An array of structures that define the extended metrics.</p>
762
810
  */
763
811
  MetricDefinitions?: MetricDefinition[];
@@ -770,10 +818,12 @@ export declare class ConflictException extends __BaseException {
770
818
  readonly name: "ConflictException";
771
819
  readonly $fault: "client";
772
820
  /**
821
+ * @public
773
822
  * <p>The name of the resource that is associated with the error.</p>
774
823
  */
775
824
  resourceName: string | undefined;
776
825
  /**
826
+ * @public
777
827
  * <p>The type of the resource that is associated with the error.</p>
778
828
  */
779
829
  resourceType?: string;
@@ -791,6 +841,7 @@ export declare class InternalServerException extends __BaseException {
791
841
  readonly $fault: "server";
792
842
  $retryable: {};
793
843
  /**
844
+ * @public
794
845
  * <p>The value of a parameter in the request caused an error.</p>
795
846
  */
796
847
  retryAfterSeconds?: number;
@@ -807,10 +858,12 @@ export declare class ResourceNotFoundException extends __BaseException {
807
858
  readonly name: "ResourceNotFoundException";
808
859
  readonly $fault: "client";
809
860
  /**
861
+ * @public
810
862
  * <p>The name of the resource that is associated with the error.</p>
811
863
  */
812
864
  resourceName: string | undefined;
813
865
  /**
866
+ * @public
814
867
  * <p>The type of the resource that is associated with the error.</p>
815
868
  */
816
869
  resourceType?: string;
@@ -842,14 +895,17 @@ export declare class ThrottlingException extends __BaseException {
842
895
  throttling: boolean;
843
896
  };
844
897
  /**
898
+ * @public
845
899
  * <p>The ID of the service that is associated with the error.</p>
846
900
  */
847
901
  serviceCode?: string;
848
902
  /**
903
+ * @public
849
904
  * <p>The ID of the service quota that was exceeded.</p>
850
905
  */
851
906
  quotaCode?: string;
852
907
  /**
908
+ * @public
853
909
  * <p>The value of a parameter in the request caused an error.</p>
854
910
  */
855
911
  retryAfterSeconds?: number;
@@ -875,10 +931,12 @@ export declare class ValidationException extends __BaseException {
875
931
  */
876
932
  export interface BatchDeleteRumMetricDefinitionsRequest {
877
933
  /**
934
+ * @public
878
935
  * <p>The name of the CloudWatch RUM app monitor that is sending these metrics.</p>
879
936
  */
880
937
  AppMonitorName: string | undefined;
881
938
  /**
939
+ * @public
882
940
  * <p>Defines the destination where you want to stop sending the specified metrics. Valid values are <code>CloudWatch</code> and
883
941
  * <code>Evidently</code>. If
884
942
  * you specify <code>Evidently</code>, you must also specify the ARN of the CloudWatchEvidently experiment that is to
@@ -886,6 +944,7 @@ export interface BatchDeleteRumMetricDefinitionsRequest {
886
944
  */
887
945
  Destination: MetricDestination | string | undefined;
888
946
  /**
947
+ * @public
889
948
  * <p>This parameter is required if <code>Destination</code> is <code>Evidently</code>. If <code>Destination</code> is
890
949
  * <code>CloudWatch</code>, do not use this parameter. </p>
891
950
  * <p>This parameter specifies
@@ -893,6 +952,7 @@ export interface BatchDeleteRumMetricDefinitionsRequest {
893
952
  */
894
953
  DestinationArn?: string;
895
954
  /**
955
+ * @public
896
956
  * <p>An array of structures which define the metrics that you want to stop sending.</p>
897
957
  */
898
958
  MetricDefinitionIds: string[] | undefined;
@@ -905,14 +965,17 @@ export interface BatchDeleteRumMetricDefinitionsRequest {
905
965
  */
906
966
  export interface BatchDeleteRumMetricDefinitionsError {
907
967
  /**
968
+ * @public
908
969
  * <p>The ID of the metric definition that caused this error.</p>
909
970
  */
910
971
  MetricDefinitionId: string | undefined;
911
972
  /**
973
+ * @public
912
974
  * <p>The error code.</p>
913
975
  */
914
976
  ErrorCode: string | undefined;
915
977
  /**
978
+ * @public
916
979
  * <p>The error message for this metric definition.</p>
917
980
  */
918
981
  ErrorMessage: string | undefined;
@@ -922,10 +985,12 @@ export interface BatchDeleteRumMetricDefinitionsError {
922
985
  */
923
986
  export interface BatchDeleteRumMetricDefinitionsResponse {
924
987
  /**
988
+ * @public
925
989
  * <p>An array of error objects, if the operation caused any errors.</p>
926
990
  */
927
991
  Errors: BatchDeleteRumMetricDefinitionsError[] | undefined;
928
992
  /**
993
+ * @public
929
994
  * <p>The IDs of the metric definitions that were deleted.</p>
930
995
  */
931
996
  MetricDefinitionIds?: string[];
@@ -935,15 +1000,18 @@ export interface BatchDeleteRumMetricDefinitionsResponse {
935
1000
  */
936
1001
  export interface BatchGetRumMetricDefinitionsRequest {
937
1002
  /**
1003
+ * @public
938
1004
  * <p>The name of the CloudWatch RUM app monitor that is sending the metrics.</p>
939
1005
  */
940
1006
  AppMonitorName: string | undefined;
941
1007
  /**
1008
+ * @public
942
1009
  * <p>The type of destination that you want to view metrics for. Valid values are <code>CloudWatch</code>
943
1010
  * and <code>Evidently</code>.</p>
944
1011
  */
945
1012
  Destination: MetricDestination | string | undefined;
946
1013
  /**
1014
+ * @public
947
1015
  * <p>This parameter is required if <code>Destination</code> is <code>Evidently</code>. If <code>Destination</code> is
948
1016
  * <code>CloudWatch</code>, do not use this parameter.</p>
949
1017
  * <p>This parameter
@@ -951,6 +1019,7 @@ export interface BatchGetRumMetricDefinitionsRequest {
951
1019
  */
952
1020
  DestinationArn?: string;
953
1021
  /**
1022
+ * @public
954
1023
  * <p>The maximum number of results to return in one operation. The default is 50. The maximum that you can
955
1024
  * specify is 100.</p>
956
1025
  * <p>To retrieve the remaining results, make another call with the returned
@@ -958,6 +1027,7 @@ export interface BatchGetRumMetricDefinitionsRequest {
958
1027
  */
959
1028
  MaxResults?: number;
960
1029
  /**
1030
+ * @public
961
1031
  * <p>Use the token returned by the previous operation to request the next page of results.</p>
962
1032
  */
963
1033
  NextToken?: string;
@@ -967,11 +1037,13 @@ export interface BatchGetRumMetricDefinitionsRequest {
967
1037
  */
968
1038
  export interface BatchGetRumMetricDefinitionsResponse {
969
1039
  /**
1040
+ * @public
970
1041
  * <p>An array of structures that display information about the metrics that are sent by the specified
971
1042
  * app monitor to the specified destination.</p>
972
1043
  */
973
1044
  MetricDefinitions?: MetricDefinition[];
974
1045
  /**
1046
+ * @public
975
1047
  * <p>A token that you can use in a subsequent operation to
976
1048
  * retrieve the next set of results.</p>
977
1049
  */
@@ -982,14 +1054,17 @@ export interface BatchGetRumMetricDefinitionsResponse {
982
1054
  */
983
1055
  export interface CreateAppMonitorRequest {
984
1056
  /**
1057
+ * @public
985
1058
  * <p>A name for the app monitor.</p>
986
1059
  */
987
1060
  Name: string | undefined;
988
1061
  /**
1062
+ * @public
989
1063
  * <p>The top-level internet domain name for which your application has administrative authority.</p>
990
1064
  */
991
1065
  Domain: string | undefined;
992
1066
  /**
1067
+ * @public
993
1068
  * <p>Assigns one or more tags (key-value pairs) to the app monitor.</p>
994
1069
  * <p>Tags can help you organize and categorize your resources. You can also use them to scope user
995
1070
  * permissions by granting a user
@@ -1000,6 +1075,7 @@ export interface CreateAppMonitorRequest {
1000
1075
  */
1001
1076
  Tags?: Record<string, string>;
1002
1077
  /**
1078
+ * @public
1003
1079
  * <p>A structure that contains much of the configuration data for the app monitor. If you are using
1004
1080
  * Amazon Cognito for authorization, you must include this structure in your request, and it must include the ID of the
1005
1081
  * Amazon Cognito identity pool to use for authorization. If you don't include <code>AppMonitorConfiguration</code>, you must set up your own
@@ -1010,6 +1086,7 @@ export interface CreateAppMonitorRequest {
1010
1086
  */
1011
1087
  AppMonitorConfiguration?: AppMonitorConfiguration;
1012
1088
  /**
1089
+ * @public
1013
1090
  * <p>Data collected by RUM is kept by RUM for 30 days and then deleted. This parameter specifies whether RUM
1014
1091
  * sends a copy of this telemetry data to Amazon CloudWatch Logs
1015
1092
  * in your account. This enables you to keep the telemetry data for more than 30 days, but it does incur
@@ -1018,6 +1095,7 @@ export interface CreateAppMonitorRequest {
1018
1095
  */
1019
1096
  CwLogEnabled?: boolean;
1020
1097
  /**
1098
+ * @public
1021
1099
  * <p>Specifies whether this app monitor allows the web client to define and send
1022
1100
  * custom events. If you omit this parameter, custom events are <code>DISABLED</code>.</p>
1023
1101
  * <p>For more information about custom events, see
@@ -1030,6 +1108,7 @@ export interface CreateAppMonitorRequest {
1030
1108
  */
1031
1109
  export interface CreateAppMonitorResponse {
1032
1110
  /**
1111
+ * @public
1033
1112
  * <p>The unique ID of the new app monitor.</p>
1034
1113
  */
1035
1114
  Id?: string;
@@ -1039,6 +1118,7 @@ export interface CreateAppMonitorResponse {
1039
1118
  */
1040
1119
  export interface DeleteAppMonitorRequest {
1041
1120
  /**
1121
+ * @public
1042
1122
  * <p>The name of the app monitor to delete.</p>
1043
1123
  */
1044
1124
  Name: string | undefined;
@@ -1053,14 +1133,17 @@ export interface DeleteAppMonitorResponse {
1053
1133
  */
1054
1134
  export interface DeleteRumMetricsDestinationRequest {
1055
1135
  /**
1136
+ * @public
1056
1137
  * <p>The name of the app monitor that is sending metrics to the destination that you want to delete.</p>
1057
1138
  */
1058
1139
  AppMonitorName: string | undefined;
1059
1140
  /**
1141
+ * @public
1060
1142
  * <p>The type of destination to delete. Valid values are <code>CloudWatch</code> and <code>Evidently</code>.</p>
1061
1143
  */
1062
1144
  Destination: MetricDestination | string | undefined;
1063
1145
  /**
1146
+ * @public
1064
1147
  * <p>This parameter is required if <code>Destination</code> is <code>Evidently</code>. If <code>Destination</code> is
1065
1148
  * <code>CloudWatch</code>, do not use this parameter. This parameter
1066
1149
  * specifies the ARN of the Evidently experiment that corresponds to the destination to delete.</p>
@@ -1077,6 +1160,7 @@ export interface DeleteRumMetricsDestinationResponse {
1077
1160
  */
1078
1161
  export interface GetAppMonitorRequest {
1079
1162
  /**
1163
+ * @public
1080
1164
  * <p>The app monitor to retrieve information for.</p>
1081
1165
  */
1082
1166
  Name: string | undefined;
@@ -1086,6 +1170,7 @@ export interface GetAppMonitorRequest {
1086
1170
  */
1087
1171
  export interface GetAppMonitorResponse {
1088
1172
  /**
1173
+ * @public
1089
1174
  * <p>A structure containing all the configuration information for the app monitor.</p>
1090
1175
  */
1091
1176
  AppMonitor?: AppMonitor;
@@ -1105,6 +1190,7 @@ export interface GetAppMonitorResponse {
1105
1190
  */
1106
1191
  export interface QueryFilter {
1107
1192
  /**
1193
+ * @public
1108
1194
  * <p>The name of a key to search for.
1109
1195
  * The filter returns only the events that match the <code>Name</code>
1110
1196
  * and <code>Values</code> that you specify.
@@ -1115,6 +1201,7 @@ export interface QueryFilter {
1115
1201
  */
1116
1202
  Name?: string;
1117
1203
  /**
1204
+ * @public
1118
1205
  * <p>The values of the <code>Name</code> that are to be be included in the returned results.</p>
1119
1206
  */
1120
1207
  Values?: string[];
@@ -1125,10 +1212,12 @@ export interface QueryFilter {
1125
1212
  */
1126
1213
  export interface TimeRange {
1127
1214
  /**
1215
+ * @public
1128
1216
  * <p>The beginning of the time range to retrieve performance events from.</p>
1129
1217
  */
1130
1218
  After: number | undefined;
1131
1219
  /**
1220
+ * @public
1132
1221
  * <p>The end of the time range to retrieve performance events from. If you omit this, the time
1133
1222
  * range extends to the time that this operation is performed.</p>
1134
1223
  */
@@ -1139,23 +1228,28 @@ export interface TimeRange {
1139
1228
  */
1140
1229
  export interface GetAppMonitorDataRequest {
1141
1230
  /**
1231
+ * @public
1142
1232
  * <p>The name of the app monitor that collected the data that you want to retrieve.</p>
1143
1233
  */
1144
1234
  Name: string | undefined;
1145
1235
  /**
1236
+ * @public
1146
1237
  * <p>A structure that defines the time range that you want to retrieve results from.</p>
1147
1238
  */
1148
1239
  TimeRange: TimeRange | undefined;
1149
1240
  /**
1241
+ * @public
1150
1242
  * <p>An array of structures that you can use to filter the results to those that match one or
1151
1243
  * more sets of key-value pairs that you specify.</p>
1152
1244
  */
1153
1245
  Filters?: QueryFilter[];
1154
1246
  /**
1247
+ * @public
1155
1248
  * <p>The maximum number of results to return in one operation. </p>
1156
1249
  */
1157
1250
  MaxResults?: number;
1158
1251
  /**
1252
+ * @public
1159
1253
  * <p>Use the token returned by the previous operation to request the next page of results.</p>
1160
1254
  */
1161
1255
  NextToken?: string;
@@ -1165,10 +1259,12 @@ export interface GetAppMonitorDataRequest {
1165
1259
  */
1166
1260
  export interface GetAppMonitorDataResponse {
1167
1261
  /**
1262
+ * @public
1168
1263
  * <p>The events that RUM collected that match your request.</p>
1169
1264
  */
1170
1265
  Events?: string[];
1171
1266
  /**
1267
+ * @public
1172
1268
  * <p>A token that you can use in a subsequent operation to retrieve the next set of
1173
1269
  * results.</p>
1174
1270
  */
@@ -1179,11 +1275,13 @@ export interface GetAppMonitorDataResponse {
1179
1275
  */
1180
1276
  export interface ListAppMonitorsRequest {
1181
1277
  /**
1278
+ * @public
1182
1279
  * <p>The maximum number of results to return in one operation. The default is 50. The maximum that you can
1183
1280
  * specify is 100.</p>
1184
1281
  */
1185
1282
  MaxResults?: number;
1186
1283
  /**
1284
+ * @public
1187
1285
  * <p>Use the token returned by the previous operation to request the next page of results.</p>
1188
1286
  */
1189
1287
  NextToken?: string;
@@ -1194,22 +1292,27 @@ export interface ListAppMonitorsRequest {
1194
1292
  */
1195
1293
  export interface AppMonitorSummary {
1196
1294
  /**
1295
+ * @public
1197
1296
  * <p>The name of this app monitor.</p>
1198
1297
  */
1199
1298
  Name?: string;
1200
1299
  /**
1300
+ * @public
1201
1301
  * <p>The unique ID of this app monitor.</p>
1202
1302
  */
1203
1303
  Id?: string;
1204
1304
  /**
1305
+ * @public
1205
1306
  * <p>The date and time that the app monitor was created.</p>
1206
1307
  */
1207
1308
  Created?: string;
1208
1309
  /**
1310
+ * @public
1209
1311
  * <p>The date and time of the most recent changes to this app monitor's configuration.</p>
1210
1312
  */
1211
1313
  LastModified?: string;
1212
1314
  /**
1315
+ * @public
1213
1316
  * <p>The current state of this app monitor.</p>
1214
1317
  */
1215
1318
  State?: StateEnum | string;
@@ -1219,11 +1322,13 @@ export interface AppMonitorSummary {
1219
1322
  */
1220
1323
  export interface ListAppMonitorsResponse {
1221
1324
  /**
1325
+ * @public
1222
1326
  * <p>A token that you can use in a subsequent operation to retrieve the next set of
1223
1327
  * results.</p>
1224
1328
  */
1225
1329
  NextToken?: string;
1226
1330
  /**
1331
+ * @public
1227
1332
  * <p>An array of structures that contain information about the returned app monitors.</p>
1228
1333
  */
1229
1334
  AppMonitorSummaries?: AppMonitorSummary[];
@@ -1233,10 +1338,12 @@ export interface ListAppMonitorsResponse {
1233
1338
  */
1234
1339
  export interface ListRumMetricsDestinationsRequest {
1235
1340
  /**
1341
+ * @public
1236
1342
  * <p>The name of the app monitor associated with the destinations that you want to retrieve.</p>
1237
1343
  */
1238
1344
  AppMonitorName: string | undefined;
1239
1345
  /**
1346
+ * @public
1240
1347
  * <p>The maximum number of results to return in one operation. The default is 50. The maximum that you can
1241
1348
  * specify is 100.</p>
1242
1349
  * <p>To retrieve the remaining results, make another call with the returned
@@ -1244,6 +1351,7 @@ export interface ListRumMetricsDestinationsRequest {
1244
1351
  */
1245
1352
  MaxResults?: number;
1246
1353
  /**
1354
+ * @public
1247
1355
  * <p>Use the token returned by the previous operation to request the next page of results.</p>
1248
1356
  */
1249
1357
  NextToken?: string;
@@ -1255,15 +1363,18 @@ export interface ListRumMetricsDestinationsRequest {
1255
1363
  */
1256
1364
  export interface MetricDestinationSummary {
1257
1365
  /**
1366
+ * @public
1258
1367
  * <p>Specifies whether the destination is <code>CloudWatch</code> or <code>Evidently</code>.</p>
1259
1368
  */
1260
1369
  Destination?: MetricDestination | string;
1261
1370
  /**
1371
+ * @public
1262
1372
  * <p>If the destination is <code>Evidently</code>, this specifies the ARN of the Evidently experiment that receives
1263
1373
  * the metrics.</p>
1264
1374
  */
1265
1375
  DestinationArn?: string;
1266
1376
  /**
1377
+ * @public
1267
1378
  * <p>This field appears only when the destination is <code>Evidently</code>. It specifies
1268
1379
  * the ARN of the IAM role that is used to write to the Evidently experiment that receives the metrics.</p>
1269
1380
  */
@@ -1274,11 +1385,13 @@ export interface MetricDestinationSummary {
1274
1385
  */
1275
1386
  export interface ListRumMetricsDestinationsResponse {
1276
1387
  /**
1388
+ * @public
1277
1389
  * <p>The list of CloudWatch RUM extended metrics destinations associated with the app monitor that
1278
1390
  * you specified.</p>
1279
1391
  */
1280
1392
  Destinations?: MetricDestinationSummary[];
1281
1393
  /**
1394
+ * @public
1282
1395
  * <p>A token that you can use in a subsequent operation to
1283
1396
  * retrieve the next set of results.</p>
1284
1397
  */
@@ -1289,10 +1402,12 @@ export interface ListRumMetricsDestinationsResponse {
1289
1402
  */
1290
1403
  export interface PutRumMetricsDestinationRequest {
1291
1404
  /**
1405
+ * @public
1292
1406
  * <p>The name of the CloudWatch RUM app monitor that will send the metrics.</p>
1293
1407
  */
1294
1408
  AppMonitorName: string | undefined;
1295
1409
  /**
1410
+ * @public
1296
1411
  * <p>Defines the destination to send the metrics to. Valid values are <code>CloudWatch</code> and
1297
1412
  * <code>Evidently</code>. If
1298
1413
  * you specify <code>Evidently</code>, you must also specify the ARN of the CloudWatchEvidently experiment that is to
@@ -1300,11 +1415,13 @@ export interface PutRumMetricsDestinationRequest {
1300
1415
  */
1301
1416
  Destination: MetricDestination | string | undefined;
1302
1417
  /**
1418
+ * @public
1303
1419
  * <p>Use this parameter only if <code>Destination</code> is <code>Evidently</code>. This parameter specifies
1304
1420
  * the ARN of the Evidently experiment that will receive the extended metrics.</p>
1305
1421
  */
1306
1422
  DestinationArn?: string;
1307
1423
  /**
1424
+ * @public
1308
1425
  * <p>This parameter is required if <code>Destination</code> is <code>Evidently</code>. If <code>Destination</code> is
1309
1426
  * <code>CloudWatch</code>, do not use this parameter.</p>
1310
1427
  * <p>This parameter specifies
@@ -1323,14 +1440,17 @@ export interface PutRumMetricsDestinationResponse {
1323
1440
  */
1324
1441
  export interface UpdateAppMonitorRequest {
1325
1442
  /**
1443
+ * @public
1326
1444
  * <p>The name of the app monitor to update.</p>
1327
1445
  */
1328
1446
  Name: string | undefined;
1329
1447
  /**
1448
+ * @public
1330
1449
  * <p>The top-level internet domain name for which your application has administrative authority.</p>
1331
1450
  */
1332
1451
  Domain?: string;
1333
1452
  /**
1453
+ * @public
1334
1454
  * <p>A structure that contains much of the configuration data for the app monitor. If you are using
1335
1455
  * Amazon Cognito for authorization, you must include this structure in your request, and it must include the ID of the
1336
1456
  * Amazon Cognito identity pool to use for authorization. If you don't include <code>AppMonitorConfiguration</code>, you must set up your own
@@ -1340,6 +1460,7 @@ export interface UpdateAppMonitorRequest {
1340
1460
  */
1341
1461
  AppMonitorConfiguration?: AppMonitorConfiguration;
1342
1462
  /**
1463
+ * @public
1343
1464
  * <p>Data collected by RUM is kept by RUM for 30 days and then deleted. This parameter specifies whether RUM
1344
1465
  * sends a copy of this telemetry data to Amazon CloudWatch Logs
1345
1466
  * in your account. This enables you to keep the telemetry data for more than 30 days, but it does incur
@@ -1347,6 +1468,7 @@ export interface UpdateAppMonitorRequest {
1347
1468
  */
1348
1469
  CwLogEnabled?: boolean;
1349
1470
  /**
1471
+ * @public
1350
1472
  * <p>Specifies whether this app monitor allows the web client to define and send
1351
1473
  * custom events. The default is for custom events to be <code>DISABLED</code>.</p>
1352
1474
  * <p>For more information about custom events, see
@@ -1364,10 +1486,12 @@ export interface UpdateAppMonitorResponse {
1364
1486
  */
1365
1487
  export interface UpdateRumMetricDefinitionRequest {
1366
1488
  /**
1489
+ * @public
1367
1490
  * <p>The name of the CloudWatch RUM app monitor that sends these metrics.</p>
1368
1491
  */
1369
1492
  AppMonitorName: string | undefined;
1370
1493
  /**
1494
+ * @public
1371
1495
  * <p>The destination to send the metrics to. Valid values are <code>CloudWatch</code> and <code>Evidently</code>. If
1372
1496
  * you specify <code>Evidently</code>, you must also specify the ARN of the CloudWatchEvidently experiment
1373
1497
  * that will receive
@@ -1375,6 +1499,7 @@ export interface UpdateRumMetricDefinitionRequest {
1375
1499
  */
1376
1500
  Destination: MetricDestination | string | undefined;
1377
1501
  /**
1502
+ * @public
1378
1503
  * <p>This parameter is required if <code>Destination</code> is <code>Evidently</code>. If <code>Destination</code> is
1379
1504
  * <code>CloudWatch</code>, do not use this parameter.</p>
1380
1505
  * <p>This parameter specifies the ARN of the Evidently experiment that is to receive the metrics. You must have already defined this
@@ -1382,10 +1507,12 @@ export interface UpdateRumMetricDefinitionRequest {
1382
1507
  */
1383
1508
  DestinationArn?: string;
1384
1509
  /**
1510
+ * @public
1385
1511
  * <p>A structure that contains the new definition that you want to use for this metric.</p>
1386
1512
  */
1387
1513
  MetricDefinition: MetricDefinitionRequest | undefined;
1388
1514
  /**
1515
+ * @public
1389
1516
  * <p>The ID of the metric definition to update.</p>
1390
1517
  */
1391
1518
  MetricDefinitionId: string | undefined;
@@ -1400,6 +1527,7 @@ export interface UpdateRumMetricDefinitionResponse {
1400
1527
  */
1401
1528
  export interface ListTagsForResourceRequest {
1402
1529
  /**
1530
+ * @public
1403
1531
  * <p>The ARN of the resource that you want to see the tags of.</p>
1404
1532
  */
1405
1533
  ResourceArn: string | undefined;
@@ -1409,10 +1537,12 @@ export interface ListTagsForResourceRequest {
1409
1537
  */
1410
1538
  export interface ListTagsForResourceResponse {
1411
1539
  /**
1540
+ * @public
1412
1541
  * <p>The ARN of the resource that you are viewing.</p>
1413
1542
  */
1414
1543
  ResourceArn: string | undefined;
1415
1544
  /**
1545
+ * @public
1416
1546
  * <p>The list of tag keys and values associated with the resource you specified.</p>
1417
1547
  */
1418
1548
  Tags: Record<string, string> | undefined;
@@ -1424,24 +1554,29 @@ export interface ListTagsForResourceResponse {
1424
1554
  */
1425
1555
  export interface RumEvent {
1426
1556
  /**
1557
+ * @public
1427
1558
  * <p>A unique ID for this event.</p>
1428
1559
  */
1429
1560
  id: string | undefined;
1430
1561
  /**
1562
+ * @public
1431
1563
  * <p>The exact time that this event occurred.</p>
1432
1564
  */
1433
1565
  timestamp: Date | undefined;
1434
1566
  /**
1567
+ * @public
1435
1568
  * <p>The JSON schema that denotes the type of event this is, such as a page load or a new session.</p>
1436
1569
  */
1437
1570
  type: string | undefined;
1438
1571
  /**
1572
+ * @public
1439
1573
  * <p>Metadata about this event, which contains a JSON serialization of the identity of the user for
1440
1574
  * this session. The user information comes from information such as the HTTP user-agent request header
1441
1575
  * and document interface.</p>
1442
1576
  */
1443
1577
  metadata?: __LazyJsonString | string;
1444
1578
  /**
1579
+ * @public
1445
1580
  * <p>A string containing details about the event.</p>
1446
1581
  */
1447
1582
  details: __LazyJsonString | string | undefined;
@@ -1452,11 +1587,13 @@ export interface RumEvent {
1452
1587
  */
1453
1588
  export interface UserDetails {
1454
1589
  /**
1590
+ * @public
1455
1591
  * <p>The ID of the user for this user session. This ID is generated by RUM and does not include any
1456
1592
  * personally identifiable information about the user.</p>
1457
1593
  */
1458
1594
  userId?: string;
1459
1595
  /**
1596
+ * @public
1460
1597
  * <p>The session ID that the performance events are from.</p>
1461
1598
  */
1462
1599
  sessionId?: string;
@@ -1466,22 +1603,27 @@ export interface UserDetails {
1466
1603
  */
1467
1604
  export interface PutRumEventsRequest {
1468
1605
  /**
1606
+ * @public
1469
1607
  * <p>The ID of the app monitor that is sending this data.</p>
1470
1608
  */
1471
1609
  Id: string | undefined;
1472
1610
  /**
1611
+ * @public
1473
1612
  * <p>A unique identifier for this batch of RUM event data.</p>
1474
1613
  */
1475
1614
  BatchId: string | undefined;
1476
1615
  /**
1616
+ * @public
1477
1617
  * <p>A structure that contains information about the app monitor that collected this telemetry information.</p>
1478
1618
  */
1479
1619
  AppMonitorDetails: AppMonitorDetails | undefined;
1480
1620
  /**
1621
+ * @public
1481
1622
  * <p>A structure that contains information about the user session that this batch of events was collected from.</p>
1482
1623
  */
1483
1624
  UserDetails: UserDetails | undefined;
1484
1625
  /**
1626
+ * @public
1485
1627
  * <p>An array of structures that contain the telemetry event data.</p>
1486
1628
  */
1487
1629
  RumEvents: RumEvent[] | undefined;
@@ -1496,10 +1638,12 @@ export interface PutRumEventsResponse {
1496
1638
  */
1497
1639
  export interface TagResourceRequest {
1498
1640
  /**
1641
+ * @public
1499
1642
  * <p>The ARN of the CloudWatch RUM resource that you're adding tags to.</p>
1500
1643
  */
1501
1644
  ResourceArn: string | undefined;
1502
1645
  /**
1646
+ * @public
1503
1647
  * <p>The list of key-value pairs to associate with the resource.</p>
1504
1648
  */
1505
1649
  Tags: Record<string, string> | undefined;
@@ -1514,10 +1658,12 @@ export interface TagResourceResponse {
1514
1658
  */
1515
1659
  export interface UntagResourceRequest {
1516
1660
  /**
1661
+ * @public
1517
1662
  * <p>The ARN of the CloudWatch RUM resource that you're removing tags from.</p>
1518
1663
  */
1519
1664
  ResourceArn: string | undefined;
1520
1665
  /**
1666
+ * @public
1521
1667
  * <p>The list of tag keys to remove from the resource.</p>
1522
1668
  */
1523
1669
  TagKeys: string[] | undefined;
@@ -1,5 +1,6 @@
1
1
  export * from "./RUMClient";
2
2
  export * from "./RUM";
3
+ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
3
4
  export * from "./commands";
4
5
  export * from "./pagination";
5
6
  export * from "./models";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-rum",
3
3
  "description": "AWS SDK for JavaScript Rum Client for Node.js, Browser and React Native",
4
- "version": "3.378.0",
4
+ "version": "3.382.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,15 +21,15 @@
21
21
  "dependencies": {
22
22
  "@aws-crypto/sha256-browser": "3.0.0",
23
23
  "@aws-crypto/sha256-js": "3.0.0",
24
- "@aws-sdk/client-sts": "3.378.0",
25
- "@aws-sdk/credential-provider-node": "3.378.0",
26
- "@aws-sdk/middleware-host-header": "3.378.0",
24
+ "@aws-sdk/client-sts": "3.382.0",
25
+ "@aws-sdk/credential-provider-node": "3.382.0",
26
+ "@aws-sdk/middleware-host-header": "3.379.1",
27
27
  "@aws-sdk/middleware-logger": "3.378.0",
28
28
  "@aws-sdk/middleware-recursion-detection": "3.378.0",
29
- "@aws-sdk/middleware-signing": "3.378.0",
30
- "@aws-sdk/middleware-user-agent": "3.378.0",
29
+ "@aws-sdk/middleware-signing": "3.379.1",
30
+ "@aws-sdk/middleware-user-agent": "3.382.0",
31
31
  "@aws-sdk/types": "3.378.0",
32
- "@aws-sdk/util-endpoints": "3.378.0",
32
+ "@aws-sdk/util-endpoints": "3.382.0",
33
33
  "@aws-sdk/util-user-agent-browser": "3.378.0",
34
34
  "@aws-sdk/util-user-agent-node": "3.378.0",
35
35
  "@smithy/config-resolver": "^2.0.1",