@aws-sdk/client-datazone 3.848.0 → 3.855.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.
@@ -74,7 +74,7 @@ declare const SearchCommand_base: {
74
74
  * order: "ASCENDING" || "DESCENDING",
75
75
  * },
76
76
  * additionalAttributes: [ // SearchOutputAdditionalAttributes
77
- * "FORMS" || "TIME_SERIES_DATA_POINT_FORMS",
77
+ * "FORMS" || "TIME_SERIES_DATA_POINT_FORMS" || "TEXT_MATCH_RATIONALE",
78
78
  * ],
79
79
  * };
80
80
  * const command = new SearchCommand(input);
@@ -93,6 +93,24 @@ declare const SearchCommand_base: {
93
93
  * // createdBy: "STRING_VALUE",
94
94
  * // updatedAt: new Date("TIMESTAMP"),
95
95
  * // updatedBy: "STRING_VALUE",
96
+ * // additionalAttributes: { // GlossaryItemAdditionalAttributes
97
+ * // matchRationale: [ // MatchRationale
98
+ * // { // MatchRationaleItem Union: only one key present
99
+ * // textMatches: [ // TextMatches
100
+ * // { // TextMatchItem
101
+ * // attribute: "STRING_VALUE",
102
+ * // text: "STRING_VALUE",
103
+ * // matchOffsets: [ // MatchOffsets
104
+ * // { // MatchOffset
105
+ * // startOffset: Number("int"),
106
+ * // endOffset: Number("int"),
107
+ * // },
108
+ * // ],
109
+ * // },
110
+ * // ],
111
+ * // },
112
+ * // ],
113
+ * // },
96
114
  * // },
97
115
  * // glossaryTermItem: { // GlossaryTermItem
98
116
  * // domainId: "STRING_VALUE", // required
@@ -114,6 +132,24 @@ declare const SearchCommand_base: {
114
132
  * // createdBy: "STRING_VALUE",
115
133
  * // updatedAt: new Date("TIMESTAMP"),
116
134
  * // updatedBy: "STRING_VALUE",
135
+ * // additionalAttributes: { // GlossaryTermItemAdditionalAttributes
136
+ * // matchRationale: [
137
+ * // {// Union: only one key present
138
+ * // textMatches: [
139
+ * // {
140
+ * // attribute: "STRING_VALUE",
141
+ * // text: "STRING_VALUE",
142
+ * // matchOffsets: [
143
+ * // {
144
+ * // startOffset: Number("int"),
145
+ * // endOffset: Number("int"),
146
+ * // },
147
+ * // ],
148
+ * // },
149
+ * // ],
150
+ * // },
151
+ * // ],
152
+ * // },
117
153
  * // },
118
154
  * // assetItem: { // AssetItem
119
155
  * // domainId: "STRING_VALUE", // required
@@ -158,6 +194,22 @@ declare const SearchCommand_base: {
158
194
  * // id: "STRING_VALUE",
159
195
  * // },
160
196
  * // ],
197
+ * // matchRationale: [
198
+ * // {// Union: only one key present
199
+ * // textMatches: [
200
+ * // {
201
+ * // attribute: "STRING_VALUE",
202
+ * // text: "STRING_VALUE",
203
+ * // matchOffsets: [
204
+ * // {
205
+ * // startOffset: Number("int"),
206
+ * // endOffset: Number("int"),
207
+ * // },
208
+ * // ],
209
+ * // },
210
+ * // ],
211
+ * // },
212
+ * // ],
161
213
  * // },
162
214
  * // },
163
215
  * // dataProductItem: { // DataProductResultItem
@@ -173,6 +225,24 @@ declare const SearchCommand_base: {
173
225
  * // createdBy: "STRING_VALUE",
174
226
  * // firstRevisionCreatedAt: new Date("TIMESTAMP"),
175
227
  * // firstRevisionCreatedBy: "STRING_VALUE",
228
+ * // additionalAttributes: { // DataProductItemAdditionalAttributes
229
+ * // matchRationale: [
230
+ * // {// Union: only one key present
231
+ * // textMatches: [
232
+ * // {
233
+ * // attribute: "STRING_VALUE",
234
+ * // text: "STRING_VALUE",
235
+ * // matchOffsets: [
236
+ * // {
237
+ * // startOffset: Number("int"),
238
+ * // endOffset: Number("int"),
239
+ * // },
240
+ * // ],
241
+ * // },
242
+ * // ],
243
+ * // },
244
+ * // ],
245
+ * // },
176
246
  * // },
177
247
  * // },
178
248
  * // ],
@@ -67,12 +67,18 @@ declare const SearchListingsCommand_base: {
67
67
  * "<FilterClause>",
68
68
  * ],
69
69
  * },
70
+ * aggregations: [ // AggregationList
71
+ * { // AggregationListItem
72
+ * attribute: "STRING_VALUE", // required
73
+ * displayValue: "STRING_VALUE",
74
+ * },
75
+ * ],
70
76
  * sort: { // SearchSort
71
77
  * attribute: "STRING_VALUE", // required
72
78
  * order: "ASCENDING" || "DESCENDING",
73
79
  * },
74
80
  * additionalAttributes: [ // SearchOutputAdditionalAttributes
75
- * "FORMS" || "TIME_SERIES_DATA_POINT_FORMS",
81
+ * "FORMS" || "TIME_SERIES_DATA_POINT_FORMS" || "TEXT_MATCH_RATIONALE",
76
82
  * ],
77
83
  * };
78
84
  * const command = new SearchListingsCommand(input);
@@ -100,6 +106,22 @@ declare const SearchListingsCommand_base: {
100
106
  * // owningProjectId: "STRING_VALUE",
101
107
  * // additionalAttributes: { // AssetListingItemAdditionalAttributes
102
108
  * // forms: "STRING_VALUE",
109
+ * // matchRationale: [ // MatchRationale
110
+ * // { // MatchRationaleItem Union: only one key present
111
+ * // textMatches: [ // TextMatches
112
+ * // { // TextMatchItem
113
+ * // attribute: "STRING_VALUE",
114
+ * // text: "STRING_VALUE",
115
+ * // matchOffsets: [ // MatchOffsets
116
+ * // { // MatchOffset
117
+ * // startOffset: Number("int"),
118
+ * // endOffset: Number("int"),
119
+ * // },
120
+ * // ],
121
+ * // },
122
+ * // ],
123
+ * // },
124
+ * // ],
103
125
  * // latestTimeSeriesDataPointForms: [ // TimeSeriesDataPointSummaryFormOutputList
104
126
  * // { // TimeSeriesDataPointSummaryFormOutput
105
127
  * // formName: "STRING_VALUE", // required
@@ -131,6 +153,22 @@ declare const SearchListingsCommand_base: {
131
153
  * // owningProjectId: "STRING_VALUE",
132
154
  * // additionalAttributes: { // DataProductListingItemAdditionalAttributes
133
155
  * // forms: "STRING_VALUE",
156
+ * // matchRationale: [
157
+ * // {// Union: only one key present
158
+ * // textMatches: [
159
+ * // {
160
+ * // attribute: "STRING_VALUE",
161
+ * // text: "STRING_VALUE",
162
+ * // matchOffsets: [
163
+ * // {
164
+ * // startOffset: Number("int"),
165
+ * // endOffset: Number("int"),
166
+ * // },
167
+ * // ],
168
+ * // },
169
+ * // ],
170
+ * // },
171
+ * // ],
134
172
  * // },
135
173
  * // items: [ // ListingSummaryItems
136
174
  * // { // ListingSummaryItem
@@ -149,6 +187,19 @@ declare const SearchListingsCommand_base: {
149
187
  * // ],
150
188
  * // nextToken: "STRING_VALUE",
151
189
  * // totalMatchCount: Number("int"),
190
+ * // aggregates: [ // AggregationOutputList
191
+ * // { // AggregationOutput
192
+ * // attribute: "STRING_VALUE",
193
+ * // displayValue: "STRING_VALUE",
194
+ * // items: [ // AggregationOutputItems
195
+ * // { // AggregationOutputItem
196
+ * // value: "STRING_VALUE",
197
+ * // count: Number("int"),
198
+ * // displayValue: "STRING_VALUE",
199
+ * // },
200
+ * // ],
201
+ * // },
202
+ * // ],
152
203
  * // };
153
204
  *
154
205
  * ```
@@ -1650,6 +1650,67 @@ export interface AddPolicyGrantInput {
1650
1650
  */
1651
1651
  export interface AddPolicyGrantOutput {
1652
1652
  }
1653
+ /**
1654
+ * <p>An aggregation list item.</p>
1655
+ * @public
1656
+ */
1657
+ export interface AggregationListItem {
1658
+ /**
1659
+ * <p>An attribute on which to compute aggregations.</p>
1660
+ * @public
1661
+ */
1662
+ attribute: string | undefined;
1663
+ /**
1664
+ * <p>The display value of the aggregation list item. Supported values include
1665
+ * <code>value</code> and <code>glossaryTerm.name</code>.</p>
1666
+ * @public
1667
+ */
1668
+ displayValue?: string | undefined;
1669
+ }
1670
+ /**
1671
+ * <p>An aggregation output item.</p>
1672
+ * @public
1673
+ */
1674
+ export interface AggregationOutputItem {
1675
+ /**
1676
+ * <p>The attribute value of the aggregation output item.</p>
1677
+ * @public
1678
+ */
1679
+ value?: string | undefined;
1680
+ /**
1681
+ * <p>The count of the aggregation output item.</p>
1682
+ * @public
1683
+ */
1684
+ count?: number | undefined;
1685
+ /**
1686
+ * <p>The display value of the aggregation. If the attribute being aggregated corresponds to
1687
+ * the id of a public resource, the service automatically resolves the id to the provided
1688
+ * display value.</p>
1689
+ * @public
1690
+ */
1691
+ displayValue?: string | undefined;
1692
+ }
1693
+ /**
1694
+ * <p>The aggregation for an attribute.</p>
1695
+ * @public
1696
+ */
1697
+ export interface AggregationOutput {
1698
+ /**
1699
+ * <p>The attribute for this aggregation.</p>
1700
+ * @public
1701
+ */
1702
+ attribute?: string | undefined;
1703
+ /**
1704
+ * <p>The display value of the aggregation output item.</p>
1705
+ * @public
1706
+ */
1707
+ displayValue?: string | undefined;
1708
+ /**
1709
+ * <p>A list of aggregation output items.</p>
1710
+ * @public
1711
+ */
1712
+ items?: AggregationOutputItem[] | undefined;
1713
+ }
1653
1714
  /**
1654
1715
  * @public
1655
1716
  * @enum
@@ -1743,6 +1804,8 @@ export interface CreateAssetInput {
1743
1804
  domainIdentifier: string | undefined;
1744
1805
  /**
1745
1806
  * <p>The external identifier of the asset.</p>
1807
+ * <p>If the value for the <code>externalIdentifier</code> parameter is specified, it must be
1808
+ * a unique value.</p>
1746
1809
  * @public
1747
1810
  */
1748
1811
  externalIdentifier?: string | undefined;
@@ -2111,6 +2174,9 @@ export interface GetAssetInput {
2111
2174
  domainIdentifier: string | undefined;
2112
2175
  /**
2113
2176
  * <p>The ID of the Amazon DataZone asset.</p>
2177
+ * <p>This parameter supports either the value of <code>assetId</code> or <code>externalIdentifier</code>
2178
+ * as input. If you are passing the value of <code>externalIdentifier</code>, you must prefix this
2179
+ * value with <code>externalIdentifer%2F</code>.</p>
2114
2180
  * @public
2115
2181
  */
2116
2182
  identifier: string | undefined;
@@ -2748,6 +2814,73 @@ export interface AssetFilterSummary {
2748
2814
  */
2749
2815
  errorMessage?: string | undefined;
2750
2816
  }
2817
+ /**
2818
+ * <p>The offset of a matched term.</p>
2819
+ * @public
2820
+ */
2821
+ export interface MatchOffset {
2822
+ /**
2823
+ * <p>The 0-indexed number indicating the start position (inclusive) of a matched term.</p>
2824
+ * @public
2825
+ */
2826
+ startOffset?: number | undefined;
2827
+ /**
2828
+ * <p>The 0-indexed number indicating the end position (exclusive) of a matched term.</p>
2829
+ * @public
2830
+ */
2831
+ endOffset?: number | undefined;
2832
+ }
2833
+ /**
2834
+ * <p>A structure indicating matched terms for an attribute.</p>
2835
+ * @public
2836
+ */
2837
+ export interface TextMatchItem {
2838
+ /**
2839
+ * <p>The name of the attribute.</p>
2840
+ * @public
2841
+ */
2842
+ attribute?: string | undefined;
2843
+ /**
2844
+ * <p>Snippet of attribute text containing highlighted content.</p>
2845
+ * @public
2846
+ */
2847
+ text?: string | undefined;
2848
+ /**
2849
+ * <p>List of offsets indicating matching terms in the TextMatchItem text.</p>
2850
+ * @public
2851
+ */
2852
+ matchOffsets?: MatchOffset[] | undefined;
2853
+ }
2854
+ /**
2855
+ * <p>A rationale indicating why this item was matched by search. </p>
2856
+ * @public
2857
+ */
2858
+ export type MatchRationaleItem = MatchRationaleItem.TextMatchesMember | MatchRationaleItem.$UnknownMember;
2859
+ /**
2860
+ * @public
2861
+ */
2862
+ export declare namespace MatchRationaleItem {
2863
+ /**
2864
+ * <p>A list of TextMatchItems.</p>
2865
+ * @public
2866
+ */
2867
+ interface TextMatchesMember {
2868
+ textMatches: TextMatchItem[];
2869
+ $unknown?: never;
2870
+ }
2871
+ /**
2872
+ * @public
2873
+ */
2874
+ interface $UnknownMember {
2875
+ textMatches?: never;
2876
+ $unknown: [string, any];
2877
+ }
2878
+ interface Visitor<T> {
2879
+ textMatches: (value: TextMatchItem[]) => T;
2880
+ _: (name: string, value: any) => T;
2881
+ }
2882
+ const visit: <T>(value: MatchRationaleItem, visitor: Visitor<T>) => T;
2883
+ }
2751
2884
  /**
2752
2885
  * <p>The additional attributes of an inventory asset.</p>
2753
2886
  * @public
@@ -2769,6 +2902,11 @@ export interface AssetItemAdditionalAttributes {
2769
2902
  * @public
2770
2903
  */
2771
2904
  latestTimeSeriesDataPointFormsOutput?: TimeSeriesDataPointSummaryFormOutput[] | undefined;
2905
+ /**
2906
+ * <p>List of rationales indicating why this item was matched by search.</p>
2907
+ * @public
2908
+ */
2909
+ matchRationale?: MatchRationaleItem[] | undefined;
2772
2910
  }
2773
2911
  /**
2774
2912
  * <p>A Amazon DataZone inventory asset.</p>
@@ -2904,6 +3042,11 @@ export interface AssetListingItemAdditionalAttributes {
2904
3042
  * @public
2905
3043
  */
2906
3044
  forms?: string | undefined;
3045
+ /**
3046
+ * <p>List of rationales indicating why this item was matched by search.</p>
3047
+ * @public
3048
+ */
3049
+ matchRationale?: MatchRationaleItem[] | undefined;
2907
3050
  /**
2908
3051
  * <p>The latest time series data points forms included in the additional attributes of an
2909
3052
  * asset.</p>
@@ -4267,7 +4410,8 @@ export interface S3PropertiesInput {
4267
4410
  */
4268
4411
  s3Uri: string | undefined;
4269
4412
  /**
4270
- * <p>The Amazon S3 Access Grant location ID that's part of the Amazon S3 properties of a connection.</p>
4413
+ * <p>The Amazon S3 Access Grant location ID that's part of the Amazon S3 properties of a
4414
+ * connection.</p>
4271
4415
  * @public
4272
4416
  */
4273
4417
  s3AccessGrantLocationId?: string | undefined;
@@ -4695,7 +4839,8 @@ export interface S3PropertiesOutput {
4695
4839
  */
4696
4840
  s3Uri: string | undefined;
4697
4841
  /**
4698
- * <p>The Amazon S3 Access Grant location ID that's part of the Amazon S3 properties of a connection.</p>
4842
+ * <p>The Amazon S3 Access Grant location ID that's part of the Amazon S3 properties of a
4843
+ * connection.</p>
4699
4844
  * @public
4700
4845
  */
4701
4846
  s3AccessGrantLocationId?: string | undefined;
@@ -5078,7 +5223,8 @@ export interface S3PropertiesPatch {
5078
5223
  */
5079
5224
  s3Uri: string | undefined;
5080
5225
  /**
5081
- * <p>The Amazon S3 Access Grant location ID that's part of the Amazon S3 properties patch of a connection.</p>
5226
+ * <p>The Amazon S3 Access Grant location ID that's part of the Amazon S3 properties patch of
5227
+ * a connection.</p>
5082
5228
  * @public
5083
5229
  */
5084
5230
  s3AccessGrantLocationId?: string | undefined;
@@ -8886,166 +9032,6 @@ export declare namespace GrantedEntityInput {
8886
9032
  }
8887
9033
  const visit: <T>(value: GrantedEntityInput, visitor: Visitor<T>) => T;
8888
9034
  }
8889
- /**
8890
- * @public
8891
- */
8892
- export interface CreateSubscriptionGrantInput {
8893
- /**
8894
- * <p>The ID of the Amazon DataZone domain in which the subscription grant is created.</p>
8895
- * @public
8896
- */
8897
- domainIdentifier: string | undefined;
8898
- /**
8899
- * <p>The ID of the environment in which the subscription grant is created.</p>
8900
- * @public
8901
- */
8902
- environmentIdentifier: string | undefined;
8903
- /**
8904
- * <p>The ID of the subscription target for which the subscription grant is created.</p>
8905
- * @public
8906
- */
8907
- subscriptionTargetIdentifier?: string | undefined;
8908
- /**
8909
- * <p>The entity to which the subscription is to be granted.</p>
8910
- * @public
8911
- */
8912
- grantedEntity: GrantedEntityInput | undefined;
8913
- /**
8914
- * <p>The names of the assets for which the subscription grant is created.</p>
8915
- * @public
8916
- */
8917
- assetTargetNames?: AssetTargetNameMap[] | undefined;
8918
- /**
8919
- * <p>A unique, case-sensitive identifier that is provided to ensure the idempotency of the
8920
- * request.</p>
8921
- * @public
8922
- */
8923
- clientToken?: string | undefined;
8924
- }
8925
- /**
8926
- * <p>Specifies the error message that is returned if the operation cannot be successfully
8927
- * completed.</p>
8928
- * @public
8929
- */
8930
- export interface FailureCause {
8931
- /**
8932
- * <p>The description of the error message.</p>
8933
- * @public
8934
- */
8935
- message?: string | undefined;
8936
- }
8937
- /**
8938
- * @public
8939
- * @enum
8940
- */
8941
- export declare const SubscriptionGrantStatus: {
8942
- readonly GRANTED: "GRANTED";
8943
- readonly GRANT_FAILED: "GRANT_FAILED";
8944
- readonly GRANT_IN_PROGRESS: "GRANT_IN_PROGRESS";
8945
- readonly GRANT_PENDING: "GRANT_PENDING";
8946
- readonly REVOKED: "REVOKED";
8947
- readonly REVOKE_FAILED: "REVOKE_FAILED";
8948
- readonly REVOKE_IN_PROGRESS: "REVOKE_IN_PROGRESS";
8949
- readonly REVOKE_PENDING: "REVOKE_PENDING";
8950
- };
8951
- /**
8952
- * @public
8953
- */
8954
- export type SubscriptionGrantStatus = (typeof SubscriptionGrantStatus)[keyof typeof SubscriptionGrantStatus];
8955
- /**
8956
- * <p>The details of the asset for which the subscription grant is created.</p>
8957
- * @public
8958
- */
8959
- export interface SubscribedAsset {
8960
- /**
8961
- * <p>The identifier of the asset for which the subscription grant is created.</p>
8962
- * @public
8963
- */
8964
- assetId: string | undefined;
8965
- /**
8966
- * <p>The revision of the asset for which the subscription grant is created.</p>
8967
- * @public
8968
- */
8969
- assetRevision: string | undefined;
8970
- /**
8971
- * <p>The status of the asset for which the subscription grant is created.</p>
8972
- * @public
8973
- */
8974
- status: SubscriptionGrantStatus | undefined;
8975
- /**
8976
- * <p>The target name of the asset for which the subscription grant is created.</p>
8977
- * @public
8978
- */
8979
- targetName?: string | undefined;
8980
- /**
8981
- * <p>The failure cause included in the details of the asset for which the subscription grant
8982
- * is created.</p>
8983
- * @public
8984
- */
8985
- failureCause?: FailureCause | undefined;
8986
- /**
8987
- * <p>The timestamp of when the subscription grant to the asset is created.</p>
8988
- * @public
8989
- */
8990
- grantedTimestamp?: Date | undefined;
8991
- /**
8992
- * <p>The failure timestamp included in the details of the asset for which the subscription
8993
- * grant is created.</p>
8994
- * @public
8995
- */
8996
- failureTimestamp?: Date | undefined;
8997
- /**
8998
- * <p>The asset scope of the subscribed asset.</p>
8999
- * @public
9000
- */
9001
- assetScope?: AssetScope | undefined;
9002
- }
9003
- /**
9004
- * <p>A revision of an asset published in a Amazon DataZone catalog.</p>
9005
- * @public
9006
- */
9007
- export interface ListingRevision {
9008
- /**
9009
- * <p>An identifier of a revision of an asset published in a Amazon DataZone catalog.</p>
9010
- * @public
9011
- */
9012
- id: string | undefined;
9013
- /**
9014
- * <p>The details of a revision of an asset published in a Amazon DataZone catalog.</p>
9015
- * @public
9016
- */
9017
- revision: string | undefined;
9018
- }
9019
- /**
9020
- * <p>The details of a listing for which a subscription is granted.</p>
9021
- * @public
9022
- */
9023
- export type GrantedEntity = GrantedEntity.ListingMember | GrantedEntity.$UnknownMember;
9024
- /**
9025
- * @public
9026
- */
9027
- export declare namespace GrantedEntity {
9028
- /**
9029
- * <p>The listing for which a subscription is granted.</p>
9030
- * @public
9031
- */
9032
- interface ListingMember {
9033
- listing: ListingRevision;
9034
- $unknown?: never;
9035
- }
9036
- /**
9037
- * @public
9038
- */
9039
- interface $UnknownMember {
9040
- listing?: never;
9041
- $unknown: [string, any];
9042
- }
9043
- interface Visitor<T> {
9044
- listing: (value: ListingRevision) => T;
9045
- _: (name: string, value: any) => T;
9046
- }
9047
- const visit: <T>(value: GrantedEntity, visitor: Visitor<T>) => T;
9048
- }
9049
9035
  /**
9050
9036
  * @internal
9051
9037
  */