aws-sdk-s3vectors 1.0.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.
- checksums.yaml +7 -0
- data/CHANGELOG.md +8 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-s3vectors/client.rb +1500 -0
- data/lib/aws-sdk-s3vectors/client_api.rb +673 -0
- data/lib/aws-sdk-s3vectors/customizations.rb +0 -0
- data/lib/aws-sdk-s3vectors/endpoint_parameters.rb +59 -0
- data/lib/aws-sdk-s3vectors/endpoint_provider.rb +32 -0
- data/lib/aws-sdk-s3vectors/endpoints.rb +20 -0
- data/lib/aws-sdk-s3vectors/errors.rb +251 -0
- data/lib/aws-sdk-s3vectors/plugins/endpoints.rb +77 -0
- data/lib/aws-sdk-s3vectors/resource.rb +26 -0
- data/lib/aws-sdk-s3vectors/types.rb +1274 -0
- data/lib/aws-sdk-s3vectors/waiters.rb +15 -0
- data/lib/aws-sdk-s3vectors.rb +62 -0
- data/sig/client.rbs +303 -0
- data/sig/errors.rbs +53 -0
- data/sig/resource.rbs +84 -0
- data/sig/types.rbs +360 -0
- data/sig/waiters.rbs +13 -0
- metadata +97 -0
@@ -0,0 +1,1274 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# WARNING ABOUT GENERATED CODE
|
4
|
+
#
|
5
|
+
# This file is generated. See the contributing guide for more information:
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
|
+
#
|
8
|
+
# WARNING ABOUT GENERATED CODE
|
9
|
+
|
10
|
+
module Aws::S3Vectors
|
11
|
+
module Types
|
12
|
+
|
13
|
+
# Access denied.
|
14
|
+
#
|
15
|
+
# @!attribute [rw] message
|
16
|
+
# @return [String]
|
17
|
+
#
|
18
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/AccessDeniedException AWS API Documentation
|
19
|
+
#
|
20
|
+
class AccessDeniedException < Struct.new(
|
21
|
+
:message)
|
22
|
+
SENSITIVE = []
|
23
|
+
include Aws::Structure
|
24
|
+
end
|
25
|
+
|
26
|
+
# The request failed because a vector bucket name or a vector index name
|
27
|
+
# already exists. Vector bucket names must be unique within your Amazon
|
28
|
+
# Web Services account for each Amazon Web Services Region. Vector index
|
29
|
+
# names must be unique within your vector bucket. Choose a different
|
30
|
+
# vector bucket name or vector index name, and try again.
|
31
|
+
#
|
32
|
+
# @!attribute [rw] message
|
33
|
+
# @return [String]
|
34
|
+
#
|
35
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ConflictException AWS API Documentation
|
36
|
+
#
|
37
|
+
class ConflictException < Struct.new(
|
38
|
+
:message)
|
39
|
+
SENSITIVE = []
|
40
|
+
include Aws::Structure
|
41
|
+
end
|
42
|
+
|
43
|
+
# @!attribute [rw] vector_bucket_name
|
44
|
+
# The name of the vector bucket to create the vector index in.
|
45
|
+
# @return [String]
|
46
|
+
#
|
47
|
+
# @!attribute [rw] vector_bucket_arn
|
48
|
+
# The Amazon Resource Name (ARN) of the vector bucket to create the
|
49
|
+
# vector index in.
|
50
|
+
# @return [String]
|
51
|
+
#
|
52
|
+
# @!attribute [rw] index_name
|
53
|
+
# The name of the vector index to create.
|
54
|
+
# @return [String]
|
55
|
+
#
|
56
|
+
# @!attribute [rw] data_type
|
57
|
+
# The data type of the vectors to be inserted into the vector index.
|
58
|
+
# @return [String]
|
59
|
+
#
|
60
|
+
# @!attribute [rw] dimension
|
61
|
+
# The dimensions of the vectors to be inserted into the vector index.
|
62
|
+
# @return [Integer]
|
63
|
+
#
|
64
|
+
# @!attribute [rw] distance_metric
|
65
|
+
# The distance metric to be used for similarity search.
|
66
|
+
# @return [String]
|
67
|
+
#
|
68
|
+
# @!attribute [rw] metadata_configuration
|
69
|
+
# The metadata configuration for the vector index.
|
70
|
+
# @return [Types::MetadataConfiguration]
|
71
|
+
#
|
72
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/CreateIndexInput AWS API Documentation
|
73
|
+
#
|
74
|
+
class CreateIndexInput < Struct.new(
|
75
|
+
:vector_bucket_name,
|
76
|
+
:vector_bucket_arn,
|
77
|
+
:index_name,
|
78
|
+
:data_type,
|
79
|
+
:dimension,
|
80
|
+
:distance_metric,
|
81
|
+
:metadata_configuration)
|
82
|
+
SENSITIVE = []
|
83
|
+
include Aws::Structure
|
84
|
+
end
|
85
|
+
|
86
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/CreateIndexOutput AWS API Documentation
|
87
|
+
#
|
88
|
+
class CreateIndexOutput < Aws::EmptyStructure; end
|
89
|
+
|
90
|
+
# @!attribute [rw] vector_bucket_name
|
91
|
+
# The name of the vector bucket to create.
|
92
|
+
# @return [String]
|
93
|
+
#
|
94
|
+
# @!attribute [rw] encryption_configuration
|
95
|
+
# The encryption configuration for the vector bucket. By default, if
|
96
|
+
# you don't specify, all new vectors in Amazon S3 vector buckets use
|
97
|
+
# server-side encryption with Amazon S3 managed keys (SSE-S3),
|
98
|
+
# specifically `AES256`.
|
99
|
+
# @return [Types::EncryptionConfiguration]
|
100
|
+
#
|
101
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/CreateVectorBucketInput AWS API Documentation
|
102
|
+
#
|
103
|
+
class CreateVectorBucketInput < Struct.new(
|
104
|
+
:vector_bucket_name,
|
105
|
+
:encryption_configuration)
|
106
|
+
SENSITIVE = []
|
107
|
+
include Aws::Structure
|
108
|
+
end
|
109
|
+
|
110
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/CreateVectorBucketOutput AWS API Documentation
|
111
|
+
#
|
112
|
+
class CreateVectorBucketOutput < Aws::EmptyStructure; end
|
113
|
+
|
114
|
+
# @!attribute [rw] vector_bucket_name
|
115
|
+
# The name of the vector bucket that contains the vector index.
|
116
|
+
# @return [String]
|
117
|
+
#
|
118
|
+
# @!attribute [rw] index_name
|
119
|
+
# The name of the vector index to delete.
|
120
|
+
# @return [String]
|
121
|
+
#
|
122
|
+
# @!attribute [rw] index_arn
|
123
|
+
# The ARN of the vector index to delete.
|
124
|
+
# @return [String]
|
125
|
+
#
|
126
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/DeleteIndexInput AWS API Documentation
|
127
|
+
#
|
128
|
+
class DeleteIndexInput < Struct.new(
|
129
|
+
:vector_bucket_name,
|
130
|
+
:index_name,
|
131
|
+
:index_arn)
|
132
|
+
SENSITIVE = []
|
133
|
+
include Aws::Structure
|
134
|
+
end
|
135
|
+
|
136
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/DeleteIndexOutput AWS API Documentation
|
137
|
+
#
|
138
|
+
class DeleteIndexOutput < Aws::EmptyStructure; end
|
139
|
+
|
140
|
+
# @!attribute [rw] vector_bucket_name
|
141
|
+
# The name of the vector bucket to delete.
|
142
|
+
# @return [String]
|
143
|
+
#
|
144
|
+
# @!attribute [rw] vector_bucket_arn
|
145
|
+
# The ARN of the vector bucket to delete.
|
146
|
+
# @return [String]
|
147
|
+
#
|
148
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/DeleteVectorBucketInput AWS API Documentation
|
149
|
+
#
|
150
|
+
class DeleteVectorBucketInput < Struct.new(
|
151
|
+
:vector_bucket_name,
|
152
|
+
:vector_bucket_arn)
|
153
|
+
SENSITIVE = []
|
154
|
+
include Aws::Structure
|
155
|
+
end
|
156
|
+
|
157
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/DeleteVectorBucketOutput AWS API Documentation
|
158
|
+
#
|
159
|
+
class DeleteVectorBucketOutput < Aws::EmptyStructure; end
|
160
|
+
|
161
|
+
# @!attribute [rw] vector_bucket_name
|
162
|
+
# The name of the vector bucket to delete the policy from.
|
163
|
+
# @return [String]
|
164
|
+
#
|
165
|
+
# @!attribute [rw] vector_bucket_arn
|
166
|
+
# The ARN of the vector bucket to delete the policy from.
|
167
|
+
# @return [String]
|
168
|
+
#
|
169
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/DeleteVectorBucketPolicyInput AWS API Documentation
|
170
|
+
#
|
171
|
+
class DeleteVectorBucketPolicyInput < Struct.new(
|
172
|
+
:vector_bucket_name,
|
173
|
+
:vector_bucket_arn)
|
174
|
+
SENSITIVE = []
|
175
|
+
include Aws::Structure
|
176
|
+
end
|
177
|
+
|
178
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/DeleteVectorBucketPolicyOutput AWS API Documentation
|
179
|
+
#
|
180
|
+
class DeleteVectorBucketPolicyOutput < Aws::EmptyStructure; end
|
181
|
+
|
182
|
+
# @!attribute [rw] vector_bucket_name
|
183
|
+
# The name of the vector bucket that contains the vector index.
|
184
|
+
# @return [String]
|
185
|
+
#
|
186
|
+
# @!attribute [rw] index_name
|
187
|
+
# The name of the vector index that contains a vector you want to
|
188
|
+
# delete.
|
189
|
+
# @return [String]
|
190
|
+
#
|
191
|
+
# @!attribute [rw] index_arn
|
192
|
+
# The ARN of the vector index that contains a vector you want to
|
193
|
+
# delete.
|
194
|
+
# @return [String]
|
195
|
+
#
|
196
|
+
# @!attribute [rw] keys
|
197
|
+
# The keys of the vectors to delete.
|
198
|
+
# @return [Array<String>]
|
199
|
+
#
|
200
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/DeleteVectorsInput AWS API Documentation
|
201
|
+
#
|
202
|
+
class DeleteVectorsInput < Struct.new(
|
203
|
+
:vector_bucket_name,
|
204
|
+
:index_name,
|
205
|
+
:index_arn,
|
206
|
+
:keys)
|
207
|
+
SENSITIVE = []
|
208
|
+
include Aws::Structure
|
209
|
+
end
|
210
|
+
|
211
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/DeleteVectorsOutput AWS API Documentation
|
212
|
+
#
|
213
|
+
class DeleteVectorsOutput < Aws::EmptyStructure; end
|
214
|
+
|
215
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
216
|
+
# S3 and is subject
|
217
|
+
# to change.
|
218
|
+
#
|
219
|
+
# </note>
|
220
|
+
#
|
221
|
+
# The encryption configuration for a vector bucket. By default, if you
|
222
|
+
# don't specify, all new vectors in Amazon S3 vector buckets use
|
223
|
+
# server-side encryption with Amazon S3 managed keys (SSE-S3),
|
224
|
+
# specifically `AES256`.
|
225
|
+
#
|
226
|
+
# @!attribute [rw] sse_type
|
227
|
+
# The server-side encryption type to use for the encryption
|
228
|
+
# configuration of the vector bucket. By default, if you don't
|
229
|
+
# specify, all new vectors in Amazon S3 vector buckets use server-side
|
230
|
+
# encryption with Amazon S3 managed keys (SSE-S3), specifically
|
231
|
+
# `AES256`.
|
232
|
+
# @return [String]
|
233
|
+
#
|
234
|
+
# @!attribute [rw] kms_key_arn
|
235
|
+
# Amazon Web Services Key Management Service (KMS) customer managed
|
236
|
+
# key ID to use for the encryption configuration. This parameter is
|
237
|
+
# allowed if and only if `sseType` is set to `aws:kms`.
|
238
|
+
#
|
239
|
+
# To specify the KMS key, you must use the format of the KMS key
|
240
|
+
# Amazon Resource Name (ARN).
|
241
|
+
#
|
242
|
+
# For example, specify Key ARN in the following format:
|
243
|
+
# `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
|
244
|
+
# @return [String]
|
245
|
+
#
|
246
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/EncryptionConfiguration AWS API Documentation
|
247
|
+
#
|
248
|
+
class EncryptionConfiguration < Struct.new(
|
249
|
+
:sse_type,
|
250
|
+
:kms_key_arn)
|
251
|
+
SENSITIVE = []
|
252
|
+
include Aws::Structure
|
253
|
+
end
|
254
|
+
|
255
|
+
# @!attribute [rw] vector_bucket_name
|
256
|
+
# The name of the vector bucket that contains the vector index.
|
257
|
+
# @return [String]
|
258
|
+
#
|
259
|
+
# @!attribute [rw] index_name
|
260
|
+
# The name of the vector index.
|
261
|
+
# @return [String]
|
262
|
+
#
|
263
|
+
# @!attribute [rw] index_arn
|
264
|
+
# The ARN of the vector index.
|
265
|
+
# @return [String]
|
266
|
+
#
|
267
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/GetIndexInput AWS API Documentation
|
268
|
+
#
|
269
|
+
class GetIndexInput < Struct.new(
|
270
|
+
:vector_bucket_name,
|
271
|
+
:index_name,
|
272
|
+
:index_arn)
|
273
|
+
SENSITIVE = []
|
274
|
+
include Aws::Structure
|
275
|
+
end
|
276
|
+
|
277
|
+
# @!attribute [rw] index
|
278
|
+
# The attributes of the vector index.
|
279
|
+
# @return [Types::Index]
|
280
|
+
#
|
281
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/GetIndexOutput AWS API Documentation
|
282
|
+
#
|
283
|
+
class GetIndexOutput < Struct.new(
|
284
|
+
:index)
|
285
|
+
SENSITIVE = []
|
286
|
+
include Aws::Structure
|
287
|
+
end
|
288
|
+
|
289
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
290
|
+
# S3 and is subject
|
291
|
+
# to change.
|
292
|
+
#
|
293
|
+
# </note>
|
294
|
+
#
|
295
|
+
# The attributes of a vector returned by the `GetVectors` operation.
|
296
|
+
#
|
297
|
+
# @!attribute [rw] key
|
298
|
+
# The name of the vector.
|
299
|
+
# @return [String]
|
300
|
+
#
|
301
|
+
# @!attribute [rw] data
|
302
|
+
# The vector data of the vector.
|
303
|
+
# @return [Types::VectorData]
|
304
|
+
#
|
305
|
+
# @!attribute [rw] metadata
|
306
|
+
# Metadata about the vector.
|
307
|
+
# @return [Hash,Array,String,Numeric,Boolean]
|
308
|
+
#
|
309
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/GetOutputVector AWS API Documentation
|
310
|
+
#
|
311
|
+
class GetOutputVector < Struct.new(
|
312
|
+
:key,
|
313
|
+
:data,
|
314
|
+
:metadata)
|
315
|
+
SENSITIVE = []
|
316
|
+
include Aws::Structure
|
317
|
+
end
|
318
|
+
|
319
|
+
# @!attribute [rw] vector_bucket_name
|
320
|
+
# The name of the vector bucket to retrieve information about.
|
321
|
+
# @return [String]
|
322
|
+
#
|
323
|
+
# @!attribute [rw] vector_bucket_arn
|
324
|
+
# The ARN of the vector bucket to retrieve information about.
|
325
|
+
# @return [String]
|
326
|
+
#
|
327
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/GetVectorBucketInput AWS API Documentation
|
328
|
+
#
|
329
|
+
class GetVectorBucketInput < Struct.new(
|
330
|
+
:vector_bucket_name,
|
331
|
+
:vector_bucket_arn)
|
332
|
+
SENSITIVE = []
|
333
|
+
include Aws::Structure
|
334
|
+
end
|
335
|
+
|
336
|
+
# @!attribute [rw] vector_bucket
|
337
|
+
# The attributes of the vector bucket.
|
338
|
+
# @return [Types::VectorBucket]
|
339
|
+
#
|
340
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/GetVectorBucketOutput AWS API Documentation
|
341
|
+
#
|
342
|
+
class GetVectorBucketOutput < Struct.new(
|
343
|
+
:vector_bucket)
|
344
|
+
SENSITIVE = []
|
345
|
+
include Aws::Structure
|
346
|
+
end
|
347
|
+
|
348
|
+
# @!attribute [rw] vector_bucket_name
|
349
|
+
# The name of the vector bucket.
|
350
|
+
# @return [String]
|
351
|
+
#
|
352
|
+
# @!attribute [rw] vector_bucket_arn
|
353
|
+
# The ARN of the vector bucket.
|
354
|
+
# @return [String]
|
355
|
+
#
|
356
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/GetVectorBucketPolicyInput AWS API Documentation
|
357
|
+
#
|
358
|
+
class GetVectorBucketPolicyInput < Struct.new(
|
359
|
+
:vector_bucket_name,
|
360
|
+
:vector_bucket_arn)
|
361
|
+
SENSITIVE = []
|
362
|
+
include Aws::Structure
|
363
|
+
end
|
364
|
+
|
365
|
+
# @!attribute [rw] policy
|
366
|
+
# The `JSON` that defines the policy.
|
367
|
+
# @return [String]
|
368
|
+
#
|
369
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/GetVectorBucketPolicyOutput AWS API Documentation
|
370
|
+
#
|
371
|
+
class GetVectorBucketPolicyOutput < Struct.new(
|
372
|
+
:policy)
|
373
|
+
SENSITIVE = []
|
374
|
+
include Aws::Structure
|
375
|
+
end
|
376
|
+
|
377
|
+
# @!attribute [rw] vector_bucket_name
|
378
|
+
# The name of the vector bucket that contains the vector index.
|
379
|
+
# @return [String]
|
380
|
+
#
|
381
|
+
# @!attribute [rw] index_name
|
382
|
+
# The name of the vector index.
|
383
|
+
# @return [String]
|
384
|
+
#
|
385
|
+
# @!attribute [rw] index_arn
|
386
|
+
# The ARN of the vector index.
|
387
|
+
# @return [String]
|
388
|
+
#
|
389
|
+
# @!attribute [rw] keys
|
390
|
+
# The names of the vectors you want to return attributes for.
|
391
|
+
# @return [Array<String>]
|
392
|
+
#
|
393
|
+
# @!attribute [rw] return_data
|
394
|
+
# Indicates whether to include the vector data in the response. The
|
395
|
+
# default value is `false`.
|
396
|
+
# @return [Boolean]
|
397
|
+
#
|
398
|
+
# @!attribute [rw] return_metadata
|
399
|
+
# Indicates whether to include metadata in the response. The default
|
400
|
+
# value is `false`.
|
401
|
+
# @return [Boolean]
|
402
|
+
#
|
403
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/GetVectorsInput AWS API Documentation
|
404
|
+
#
|
405
|
+
class GetVectorsInput < Struct.new(
|
406
|
+
:vector_bucket_name,
|
407
|
+
:index_name,
|
408
|
+
:index_arn,
|
409
|
+
:keys,
|
410
|
+
:return_data,
|
411
|
+
:return_metadata)
|
412
|
+
SENSITIVE = []
|
413
|
+
include Aws::Structure
|
414
|
+
end
|
415
|
+
|
416
|
+
# @!attribute [rw] vectors
|
417
|
+
# The attributes of the vectors.
|
418
|
+
# @return [Array<Types::GetOutputVector>]
|
419
|
+
#
|
420
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/GetVectorsOutput AWS API Documentation
|
421
|
+
#
|
422
|
+
class GetVectorsOutput < Struct.new(
|
423
|
+
:vectors)
|
424
|
+
SENSITIVE = []
|
425
|
+
include Aws::Structure
|
426
|
+
end
|
427
|
+
|
428
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
429
|
+
# S3 and is subject
|
430
|
+
# to change.
|
431
|
+
#
|
432
|
+
# </note>
|
433
|
+
#
|
434
|
+
# The attributes of a vector index.
|
435
|
+
#
|
436
|
+
# @!attribute [rw] vector_bucket_name
|
437
|
+
# The name of the vector bucket that contains the vector index.
|
438
|
+
# @return [String]
|
439
|
+
#
|
440
|
+
# @!attribute [rw] index_name
|
441
|
+
# The name of the vector index.
|
442
|
+
# @return [String]
|
443
|
+
#
|
444
|
+
# @!attribute [rw] index_arn
|
445
|
+
# The Amazon Resource Name (ARN) of the vector index.
|
446
|
+
# @return [String]
|
447
|
+
#
|
448
|
+
# @!attribute [rw] creation_time
|
449
|
+
# Date and time when the vector index was created.
|
450
|
+
# @return [Time]
|
451
|
+
#
|
452
|
+
# @!attribute [rw] data_type
|
453
|
+
# The data type of the vectors inserted into the vector index.
|
454
|
+
# @return [String]
|
455
|
+
#
|
456
|
+
# @!attribute [rw] dimension
|
457
|
+
# The number of values in the vectors that are inserted into the
|
458
|
+
# vector index.
|
459
|
+
# @return [Integer]
|
460
|
+
#
|
461
|
+
# @!attribute [rw] distance_metric
|
462
|
+
# The distance metric to be used for similarity search.
|
463
|
+
# @return [String]
|
464
|
+
#
|
465
|
+
# @!attribute [rw] metadata_configuration
|
466
|
+
# The metadata configuration for the vector index.
|
467
|
+
# @return [Types::MetadataConfiguration]
|
468
|
+
#
|
469
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/Index AWS API Documentation
|
470
|
+
#
|
471
|
+
class Index < Struct.new(
|
472
|
+
:vector_bucket_name,
|
473
|
+
:index_name,
|
474
|
+
:index_arn,
|
475
|
+
:creation_time,
|
476
|
+
:data_type,
|
477
|
+
:dimension,
|
478
|
+
:distance_metric,
|
479
|
+
:metadata_configuration)
|
480
|
+
SENSITIVE = []
|
481
|
+
include Aws::Structure
|
482
|
+
end
|
483
|
+
|
484
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
485
|
+
# S3 and is subject
|
486
|
+
# to change.
|
487
|
+
#
|
488
|
+
# </note>
|
489
|
+
#
|
490
|
+
# Summary information about a vector index.
|
491
|
+
#
|
492
|
+
# @!attribute [rw] vector_bucket_name
|
493
|
+
# The name of the vector bucket that contains the vector index.
|
494
|
+
# @return [String]
|
495
|
+
#
|
496
|
+
# @!attribute [rw] index_name
|
497
|
+
# The name of the vector index.
|
498
|
+
# @return [String]
|
499
|
+
#
|
500
|
+
# @!attribute [rw] index_arn
|
501
|
+
# The Amazon Resource Name (ARN) of the vector index.
|
502
|
+
# @return [String]
|
503
|
+
#
|
504
|
+
# @!attribute [rw] creation_time
|
505
|
+
# Date and time when the vector index was created.
|
506
|
+
# @return [Time]
|
507
|
+
#
|
508
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/IndexSummary AWS API Documentation
|
509
|
+
#
|
510
|
+
class IndexSummary < Struct.new(
|
511
|
+
:vector_bucket_name,
|
512
|
+
:index_name,
|
513
|
+
:index_arn,
|
514
|
+
:creation_time)
|
515
|
+
SENSITIVE = []
|
516
|
+
include Aws::Structure
|
517
|
+
end
|
518
|
+
|
519
|
+
# The request failed due to an internal server error.
|
520
|
+
#
|
521
|
+
# @!attribute [rw] message
|
522
|
+
# @return [String]
|
523
|
+
#
|
524
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/InternalServerException AWS API Documentation
|
525
|
+
#
|
526
|
+
class InternalServerException < Struct.new(
|
527
|
+
:message)
|
528
|
+
SENSITIVE = []
|
529
|
+
include Aws::Structure
|
530
|
+
end
|
531
|
+
|
532
|
+
# The specified Amazon Web Services KMS key isn't enabled.
|
533
|
+
#
|
534
|
+
# @!attribute [rw] message
|
535
|
+
# @return [String]
|
536
|
+
#
|
537
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/KmsDisabledException AWS API Documentation
|
538
|
+
#
|
539
|
+
class KmsDisabledException < Struct.new(
|
540
|
+
:message)
|
541
|
+
SENSITIVE = []
|
542
|
+
include Aws::Structure
|
543
|
+
end
|
544
|
+
|
545
|
+
# The request was rejected for one of the following reasons:
|
546
|
+
#
|
547
|
+
# * The `KeyUsage` value of the KMS key is incompatible with the API
|
548
|
+
# operation.
|
549
|
+
#
|
550
|
+
# * The encryption algorithm or signing algorithm specified for the
|
551
|
+
# operation is incompatible with the type of key material in the KMS
|
552
|
+
# key (`KeySpec`).
|
553
|
+
#
|
554
|
+
# For more information, see [InvalidKeyUsageException][1] in the *Amazon
|
555
|
+
# Web Services Key Management Service API Reference*.
|
556
|
+
#
|
557
|
+
#
|
558
|
+
#
|
559
|
+
# [1]: https://docs.aws.amazon.com/kms/latest/APIReference/API_Encrypt.html#API_Encrypt_Errors
|
560
|
+
#
|
561
|
+
# @!attribute [rw] message
|
562
|
+
# @return [String]
|
563
|
+
#
|
564
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/KmsInvalidKeyUsageException AWS API Documentation
|
565
|
+
#
|
566
|
+
class KmsInvalidKeyUsageException < Struct.new(
|
567
|
+
:message)
|
568
|
+
SENSITIVE = []
|
569
|
+
include Aws::Structure
|
570
|
+
end
|
571
|
+
|
572
|
+
# The key state of the KMS key isn't compatible with the operation.
|
573
|
+
#
|
574
|
+
# For more information, see [KMSInvalidStateException][1] in the *Amazon
|
575
|
+
# Web Services Key Management Service API Reference*.
|
576
|
+
#
|
577
|
+
#
|
578
|
+
#
|
579
|
+
# [1]: https://docs.aws.amazon.com/kms/latest/APIReference/API_Encrypt.html#API_Encrypt_Errors
|
580
|
+
#
|
581
|
+
# @!attribute [rw] message
|
582
|
+
# @return [String]
|
583
|
+
#
|
584
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/KmsInvalidStateException AWS API Documentation
|
585
|
+
#
|
586
|
+
class KmsInvalidStateException < Struct.new(
|
587
|
+
:message)
|
588
|
+
SENSITIVE = []
|
589
|
+
include Aws::Structure
|
590
|
+
end
|
591
|
+
|
592
|
+
# The KMS key can't be found.
|
593
|
+
#
|
594
|
+
# @!attribute [rw] message
|
595
|
+
# @return [String]
|
596
|
+
#
|
597
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/KmsNotFoundException AWS API Documentation
|
598
|
+
#
|
599
|
+
class KmsNotFoundException < Struct.new(
|
600
|
+
:message)
|
601
|
+
SENSITIVE = []
|
602
|
+
include Aws::Structure
|
603
|
+
end
|
604
|
+
|
605
|
+
# @!attribute [rw] vector_bucket_name
|
606
|
+
# The name of the vector bucket that contains the vector indexes.
|
607
|
+
# @return [String]
|
608
|
+
#
|
609
|
+
# @!attribute [rw] vector_bucket_arn
|
610
|
+
# The ARN of the vector bucket that contains the vector indexes.
|
611
|
+
# @return [String]
|
612
|
+
#
|
613
|
+
# @!attribute [rw] max_results
|
614
|
+
# The maximum number of items to be returned in the response.
|
615
|
+
# @return [Integer]
|
616
|
+
#
|
617
|
+
# @!attribute [rw] next_token
|
618
|
+
# The previous pagination token.
|
619
|
+
# @return [String]
|
620
|
+
#
|
621
|
+
# @!attribute [rw] prefix
|
622
|
+
# Limits the response to vector indexes that begin with the specified
|
623
|
+
# prefix.
|
624
|
+
# @return [String]
|
625
|
+
#
|
626
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ListIndexesInput AWS API Documentation
|
627
|
+
#
|
628
|
+
class ListIndexesInput < Struct.new(
|
629
|
+
:vector_bucket_name,
|
630
|
+
:vector_bucket_arn,
|
631
|
+
:max_results,
|
632
|
+
:next_token,
|
633
|
+
:prefix)
|
634
|
+
SENSITIVE = []
|
635
|
+
include Aws::Structure
|
636
|
+
end
|
637
|
+
|
638
|
+
# @!attribute [rw] next_token
|
639
|
+
# The next pagination token.
|
640
|
+
# @return [String]
|
641
|
+
#
|
642
|
+
# @!attribute [rw] indexes
|
643
|
+
# The attributes of the vector indexes
|
644
|
+
# @return [Array<Types::IndexSummary>]
|
645
|
+
#
|
646
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ListIndexesOutput AWS API Documentation
|
647
|
+
#
|
648
|
+
class ListIndexesOutput < Struct.new(
|
649
|
+
:next_token,
|
650
|
+
:indexes)
|
651
|
+
SENSITIVE = []
|
652
|
+
include Aws::Structure
|
653
|
+
end
|
654
|
+
|
655
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
656
|
+
# S3 and is subject
|
657
|
+
# to change.
|
658
|
+
#
|
659
|
+
# </note>
|
660
|
+
#
|
661
|
+
# The attributes of a vector returned by the `ListVectors` operation.
|
662
|
+
#
|
663
|
+
# @!attribute [rw] key
|
664
|
+
# The name of the vector.
|
665
|
+
# @return [String]
|
666
|
+
#
|
667
|
+
# @!attribute [rw] data
|
668
|
+
# The vector data of the vector.
|
669
|
+
# @return [Types::VectorData]
|
670
|
+
#
|
671
|
+
# @!attribute [rw] metadata
|
672
|
+
# Metadata about the vector.
|
673
|
+
# @return [Hash,Array,String,Numeric,Boolean]
|
674
|
+
#
|
675
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ListOutputVector AWS API Documentation
|
676
|
+
#
|
677
|
+
class ListOutputVector < Struct.new(
|
678
|
+
:key,
|
679
|
+
:data,
|
680
|
+
:metadata)
|
681
|
+
SENSITIVE = []
|
682
|
+
include Aws::Structure
|
683
|
+
end
|
684
|
+
|
685
|
+
# @!attribute [rw] max_results
|
686
|
+
# The maximum number of vector buckets to be returned in the response.
|
687
|
+
# @return [Integer]
|
688
|
+
#
|
689
|
+
# @!attribute [rw] next_token
|
690
|
+
# The previous pagination token.
|
691
|
+
# @return [String]
|
692
|
+
#
|
693
|
+
# @!attribute [rw] prefix
|
694
|
+
# Limits the response to vector buckets that begin with the specified
|
695
|
+
# prefix.
|
696
|
+
# @return [String]
|
697
|
+
#
|
698
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ListVectorBucketsInput AWS API Documentation
|
699
|
+
#
|
700
|
+
class ListVectorBucketsInput < Struct.new(
|
701
|
+
:max_results,
|
702
|
+
:next_token,
|
703
|
+
:prefix)
|
704
|
+
SENSITIVE = []
|
705
|
+
include Aws::Structure
|
706
|
+
end
|
707
|
+
|
708
|
+
# @!attribute [rw] next_token
|
709
|
+
# The element is included in the response when there are more buckets
|
710
|
+
# to be listed with pagination.
|
711
|
+
# @return [String]
|
712
|
+
#
|
713
|
+
# @!attribute [rw] vector_buckets
|
714
|
+
# The list of vector buckets owned by the requester.
|
715
|
+
# @return [Array<Types::VectorBucketSummary>]
|
716
|
+
#
|
717
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ListVectorBucketsOutput AWS API Documentation
|
718
|
+
#
|
719
|
+
class ListVectorBucketsOutput < Struct.new(
|
720
|
+
:next_token,
|
721
|
+
:vector_buckets)
|
722
|
+
SENSITIVE = []
|
723
|
+
include Aws::Structure
|
724
|
+
end
|
725
|
+
|
726
|
+
# @!attribute [rw] vector_bucket_name
|
727
|
+
# The name of the vector bucket.
|
728
|
+
# @return [String]
|
729
|
+
#
|
730
|
+
# @!attribute [rw] index_name
|
731
|
+
# The name of the vector index.
|
732
|
+
# @return [String]
|
733
|
+
#
|
734
|
+
# @!attribute [rw] index_arn
|
735
|
+
# The Amazon resource Name (ARN) of the vector index.
|
736
|
+
# @return [String]
|
737
|
+
#
|
738
|
+
# @!attribute [rw] max_results
|
739
|
+
# The maximum number of vectors to return on a page.
|
740
|
+
#
|
741
|
+
# If you don't specify `maxResults`, the `ListVectors` operation uses
|
742
|
+
# a default value of 500.
|
743
|
+
#
|
744
|
+
# If the processed dataset size exceeds 1 MB before reaching the
|
745
|
+
# `maxResults` value, the operation stops and returns the vectors that
|
746
|
+
# are retrieved up to that point, along with a `nextToken` that you
|
747
|
+
# can use in a subsequent request to retrieve the next set of results.
|
748
|
+
# @return [Integer]
|
749
|
+
#
|
750
|
+
# @!attribute [rw] next_token
|
751
|
+
# Pagination token from a previous request. The value of this field is
|
752
|
+
# empty for an initial request.
|
753
|
+
# @return [String]
|
754
|
+
#
|
755
|
+
# @!attribute [rw] segment_count
|
756
|
+
# For a parallel `ListVectors` request, `segmentCount` represents the
|
757
|
+
# total number of vector segments into which the `ListVectors`
|
758
|
+
# operation will be divided. The value of `segmentCount` corresponds
|
759
|
+
# to the number of application workers that will perform the parallel
|
760
|
+
# `ListVectors` operation. For example, if you want to use four
|
761
|
+
# application threads to list vectors in a vector index, specify a
|
762
|
+
# `segmentCount` value of 4.
|
763
|
+
#
|
764
|
+
# If you specify a `segmentCount` value of 1, the `ListVectors`
|
765
|
+
# operation will be sequential rather than parallel.
|
766
|
+
#
|
767
|
+
# If you specify `segmentCount`, you must also specify `segmentIndex`.
|
768
|
+
# @return [Integer]
|
769
|
+
#
|
770
|
+
# @!attribute [rw] segment_index
|
771
|
+
# For a parallel `ListVectors` request, `segmentIndex` is the index of
|
772
|
+
# the segment from which to list vectors in the current request. It
|
773
|
+
# identifies an individual segment to be listed by an application
|
774
|
+
# worker.
|
775
|
+
#
|
776
|
+
# Segment IDs are zero-based, so the first segment is always 0. For
|
777
|
+
# example, if you want to use four application threads to list vectors
|
778
|
+
# in a vector index, then the first thread specifies a `segmentIndex`
|
779
|
+
# value of 0, the second thread specifies 1, and so on.
|
780
|
+
#
|
781
|
+
# The value of `segmentIndex` must be less than the value provided for
|
782
|
+
# `segmentCount`.
|
783
|
+
#
|
784
|
+
# If you provide `segmentIndex`, you must also provide `segmentCount`.
|
785
|
+
# @return [Integer]
|
786
|
+
#
|
787
|
+
# @!attribute [rw] return_data
|
788
|
+
# If true, the vector data of each vector will be included in the
|
789
|
+
# response. The default value is `false`.
|
790
|
+
# @return [Boolean]
|
791
|
+
#
|
792
|
+
# @!attribute [rw] return_metadata
|
793
|
+
# If true, the metadata associated with each vector will be included
|
794
|
+
# in the response. The default value is `false`.
|
795
|
+
# @return [Boolean]
|
796
|
+
#
|
797
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ListVectorsInput AWS API Documentation
|
798
|
+
#
|
799
|
+
class ListVectorsInput < Struct.new(
|
800
|
+
:vector_bucket_name,
|
801
|
+
:index_name,
|
802
|
+
:index_arn,
|
803
|
+
:max_results,
|
804
|
+
:next_token,
|
805
|
+
:segment_count,
|
806
|
+
:segment_index,
|
807
|
+
:return_data,
|
808
|
+
:return_metadata)
|
809
|
+
SENSITIVE = []
|
810
|
+
include Aws::Structure
|
811
|
+
end
|
812
|
+
|
813
|
+
# @!attribute [rw] next_token
|
814
|
+
# Pagination token to be used in the subsequent request. The field is
|
815
|
+
# empty if no further pagination is required.
|
816
|
+
# @return [String]
|
817
|
+
#
|
818
|
+
# @!attribute [rw] vectors
|
819
|
+
# Vectors in the current segment.
|
820
|
+
# @return [Array<Types::ListOutputVector>]
|
821
|
+
#
|
822
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ListVectorsOutput AWS API Documentation
|
823
|
+
#
|
824
|
+
class ListVectorsOutput < Struct.new(
|
825
|
+
:next_token,
|
826
|
+
:vectors)
|
827
|
+
SENSITIVE = []
|
828
|
+
include Aws::Structure
|
829
|
+
end
|
830
|
+
|
831
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
832
|
+
# S3 and is subject
|
833
|
+
# to change.
|
834
|
+
#
|
835
|
+
# </note>
|
836
|
+
#
|
837
|
+
# The metadata configuration for a vector index.
|
838
|
+
#
|
839
|
+
# @!attribute [rw] non_filterable_metadata_keys
|
840
|
+
# Non-filterable metadata keys allow you to enrich vectors with
|
841
|
+
# additional context during storage and retrieval. Unlike default
|
842
|
+
# metadata keys, these keys can’t be used as query filters.
|
843
|
+
# Non-filterable metadata keys can be retrieved but can’t be searched,
|
844
|
+
# queried, or filtered. You can access non-filterable metadata keys of
|
845
|
+
# your vectors after finding the vectors. For more information about
|
846
|
+
# non-filterable metadata keys, see [Vectors][1] and [Limitations and
|
847
|
+
# restrictions][2] in the *Amazon S3 User Guide*.
|
848
|
+
#
|
849
|
+
#
|
850
|
+
#
|
851
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-vectors-vectors.html
|
852
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-vectors-limitations.html
|
853
|
+
# @return [Array<String>]
|
854
|
+
#
|
855
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/MetadataConfiguration AWS API Documentation
|
856
|
+
#
|
857
|
+
class MetadataConfiguration < Struct.new(
|
858
|
+
:non_filterable_metadata_keys)
|
859
|
+
SENSITIVE = []
|
860
|
+
include Aws::Structure
|
861
|
+
end
|
862
|
+
|
863
|
+
# The request was rejected because the specified resource can't be
|
864
|
+
# found.
|
865
|
+
#
|
866
|
+
# @!attribute [rw] message
|
867
|
+
# @return [String]
|
868
|
+
#
|
869
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/NotFoundException AWS API Documentation
|
870
|
+
#
|
871
|
+
class NotFoundException < Struct.new(
|
872
|
+
:message)
|
873
|
+
SENSITIVE = []
|
874
|
+
include Aws::Structure
|
875
|
+
end
|
876
|
+
|
877
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
878
|
+
# S3 and is subject
|
879
|
+
# to change.
|
880
|
+
#
|
881
|
+
# </note>
|
882
|
+
#
|
883
|
+
# The attributes of a vector to add to a vector index.
|
884
|
+
#
|
885
|
+
# @!attribute [rw] key
|
886
|
+
# The name of the vector. The key uniquely identifies the vector in a
|
887
|
+
# vector index.
|
888
|
+
# @return [String]
|
889
|
+
#
|
890
|
+
# @!attribute [rw] data
|
891
|
+
# The vector data of the vector.
|
892
|
+
#
|
893
|
+
# Vector dimensions must match the dimension count that's configured
|
894
|
+
# for the vector index.
|
895
|
+
#
|
896
|
+
# * For the `cosine` distance metric, zero vectors (vectors containing
|
897
|
+
# all zeros) aren't allowed.
|
898
|
+
#
|
899
|
+
# * For both `cosine` and `euclidean` distance metrics, vector data
|
900
|
+
# must contain only valid floating-point values. Invalid values such
|
901
|
+
# as NaN (Not a Number) or Infinity aren't allowed.
|
902
|
+
# @return [Types::VectorData]
|
903
|
+
#
|
904
|
+
# @!attribute [rw] metadata
|
905
|
+
# Metadata about the vector. All metadata entries undergo validation
|
906
|
+
# to ensure they meet the format requirements for size and data types.
|
907
|
+
# @return [Hash,Array,String,Numeric,Boolean]
|
908
|
+
#
|
909
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/PutInputVector AWS API Documentation
|
910
|
+
#
|
911
|
+
class PutInputVector < Struct.new(
|
912
|
+
:key,
|
913
|
+
:data,
|
914
|
+
:metadata)
|
915
|
+
SENSITIVE = []
|
916
|
+
include Aws::Structure
|
917
|
+
end
|
918
|
+
|
919
|
+
# @!attribute [rw] vector_bucket_name
|
920
|
+
# The name of the vector bucket.
|
921
|
+
# @return [String]
|
922
|
+
#
|
923
|
+
# @!attribute [rw] vector_bucket_arn
|
924
|
+
# The Amazon Resource Name (ARN) of the vector bucket.
|
925
|
+
# @return [String]
|
926
|
+
#
|
927
|
+
# @!attribute [rw] policy
|
928
|
+
# The `JSON` that defines the policy. For more information about
|
929
|
+
# bucket policies for S3 Vectors, see [Managing vector bucket
|
930
|
+
# policies][1] in the *Amazon S3 User Guide*.
|
931
|
+
#
|
932
|
+
#
|
933
|
+
#
|
934
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-vectors-bucket-policy.html
|
935
|
+
# @return [String]
|
936
|
+
#
|
937
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/PutVectorBucketPolicyInput AWS API Documentation
|
938
|
+
#
|
939
|
+
class PutVectorBucketPolicyInput < Struct.new(
|
940
|
+
:vector_bucket_name,
|
941
|
+
:vector_bucket_arn,
|
942
|
+
:policy)
|
943
|
+
SENSITIVE = []
|
944
|
+
include Aws::Structure
|
945
|
+
end
|
946
|
+
|
947
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/PutVectorBucketPolicyOutput AWS API Documentation
|
948
|
+
#
|
949
|
+
class PutVectorBucketPolicyOutput < Aws::EmptyStructure; end
|
950
|
+
|
951
|
+
# @!attribute [rw] vector_bucket_name
|
952
|
+
# The name of the vector bucket that contains the vector index.
|
953
|
+
# @return [String]
|
954
|
+
#
|
955
|
+
# @!attribute [rw] index_name
|
956
|
+
# The name of the vector index where you want to write vectors.
|
957
|
+
# @return [String]
|
958
|
+
#
|
959
|
+
# @!attribute [rw] index_arn
|
960
|
+
# The ARN of the vector index where you want to write vectors.
|
961
|
+
# @return [String]
|
962
|
+
#
|
963
|
+
# @!attribute [rw] vectors
|
964
|
+
# The vectors to add to a vector index. The number of vectors in a
|
965
|
+
# single request must not exceed the resource capacity, otherwise the
|
966
|
+
# request will be rejected with the error
|
967
|
+
# `ServiceUnavailableException` with the error message "Currently
|
968
|
+
# unable to handle the request".
|
969
|
+
# @return [Array<Types::PutInputVector>]
|
970
|
+
#
|
971
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/PutVectorsInput AWS API Documentation
|
972
|
+
#
|
973
|
+
class PutVectorsInput < Struct.new(
|
974
|
+
:vector_bucket_name,
|
975
|
+
:index_name,
|
976
|
+
:index_arn,
|
977
|
+
:vectors)
|
978
|
+
SENSITIVE = []
|
979
|
+
include Aws::Structure
|
980
|
+
end
|
981
|
+
|
982
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/PutVectorsOutput AWS API Documentation
|
983
|
+
#
|
984
|
+
class PutVectorsOutput < Aws::EmptyStructure; end
|
985
|
+
|
986
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
987
|
+
# S3 and is subject
|
988
|
+
# to change.
|
989
|
+
#
|
990
|
+
# </note>
|
991
|
+
#
|
992
|
+
# The attributes of a vector in the approximate nearest neighbor
|
993
|
+
# search.
|
994
|
+
#
|
995
|
+
# @!attribute [rw] key
|
996
|
+
# The key of the vector in the approximate nearest neighbor search.
|
997
|
+
# @return [String]
|
998
|
+
#
|
999
|
+
# @!attribute [rw] data
|
1000
|
+
# The vector data associated with the vector, if requested.
|
1001
|
+
# @return [Types::VectorData]
|
1002
|
+
#
|
1003
|
+
# @!attribute [rw] metadata
|
1004
|
+
# The metadata associated with the vector, if requested.
|
1005
|
+
# @return [Hash,Array,String,Numeric,Boolean]
|
1006
|
+
#
|
1007
|
+
# @!attribute [rw] distance
|
1008
|
+
# The measure of similarity between the vector in the response and the
|
1009
|
+
# query vector.
|
1010
|
+
# @return [Float]
|
1011
|
+
#
|
1012
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/QueryOutputVector AWS API Documentation
|
1013
|
+
#
|
1014
|
+
class QueryOutputVector < Struct.new(
|
1015
|
+
:key,
|
1016
|
+
:data,
|
1017
|
+
:metadata,
|
1018
|
+
:distance)
|
1019
|
+
SENSITIVE = []
|
1020
|
+
include Aws::Structure
|
1021
|
+
end
|
1022
|
+
|
1023
|
+
# @!attribute [rw] vector_bucket_name
|
1024
|
+
# The name of the vector bucket that contains the vector index.
|
1025
|
+
# @return [String]
|
1026
|
+
#
|
1027
|
+
# @!attribute [rw] index_name
|
1028
|
+
# The name of the vector index that you want to query.
|
1029
|
+
# @return [String]
|
1030
|
+
#
|
1031
|
+
# @!attribute [rw] index_arn
|
1032
|
+
# The ARN of the vector index that you want to query.
|
1033
|
+
# @return [String]
|
1034
|
+
#
|
1035
|
+
# @!attribute [rw] top_k
|
1036
|
+
# The number of results to return for each query.
|
1037
|
+
# @return [Integer]
|
1038
|
+
#
|
1039
|
+
# @!attribute [rw] query_vector
|
1040
|
+
# The query vector. Ensure that the query vector has the same
|
1041
|
+
# dimension as the dimension of the vector index that's being
|
1042
|
+
# queried. For example, if your vector index contains vectors with 384
|
1043
|
+
# dimensions, your query vector must also have 384 dimensions.
|
1044
|
+
# @return [Types::VectorData]
|
1045
|
+
#
|
1046
|
+
# @!attribute [rw] filter
|
1047
|
+
# Metadata filter to apply during the query. For more information
|
1048
|
+
# about metadata keys, see [Metadata filtering][1] in the *Amazon S3
|
1049
|
+
# User Guide*.
|
1050
|
+
#
|
1051
|
+
#
|
1052
|
+
#
|
1053
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-vectors-metadata-filtering.html
|
1054
|
+
# @return [Hash,Array,String,Numeric,Boolean]
|
1055
|
+
#
|
1056
|
+
# @!attribute [rw] return_metadata
|
1057
|
+
# Indicates whether to include metadata in the response. The default
|
1058
|
+
# value is `false`.
|
1059
|
+
# @return [Boolean]
|
1060
|
+
#
|
1061
|
+
# @!attribute [rw] return_distance
|
1062
|
+
# Indicates whether to include the computed distance in the response.
|
1063
|
+
# The default value is `false`.
|
1064
|
+
# @return [Boolean]
|
1065
|
+
#
|
1066
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/QueryVectorsInput AWS API Documentation
|
1067
|
+
#
|
1068
|
+
class QueryVectorsInput < Struct.new(
|
1069
|
+
:vector_bucket_name,
|
1070
|
+
:index_name,
|
1071
|
+
:index_arn,
|
1072
|
+
:top_k,
|
1073
|
+
:query_vector,
|
1074
|
+
:filter,
|
1075
|
+
:return_metadata,
|
1076
|
+
:return_distance)
|
1077
|
+
SENSITIVE = []
|
1078
|
+
include Aws::Structure
|
1079
|
+
end
|
1080
|
+
|
1081
|
+
# @!attribute [rw] vectors
|
1082
|
+
# The vectors in the approximate nearest neighbor search.
|
1083
|
+
# @return [Array<Types::QueryOutputVector>]
|
1084
|
+
#
|
1085
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/QueryVectorsOutput AWS API Documentation
|
1086
|
+
#
|
1087
|
+
class QueryVectorsOutput < Struct.new(
|
1088
|
+
:vectors)
|
1089
|
+
SENSITIVE = []
|
1090
|
+
include Aws::Structure
|
1091
|
+
end
|
1092
|
+
|
1093
|
+
# Your request exceeds a service quota.
|
1094
|
+
#
|
1095
|
+
# @!attribute [rw] message
|
1096
|
+
# @return [String]
|
1097
|
+
#
|
1098
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ServiceQuotaExceededException AWS API Documentation
|
1099
|
+
#
|
1100
|
+
class ServiceQuotaExceededException < Struct.new(
|
1101
|
+
:message)
|
1102
|
+
SENSITIVE = []
|
1103
|
+
include Aws::Structure
|
1104
|
+
end
|
1105
|
+
|
1106
|
+
# The service is unavailable. Wait briefly and retry your request. If it
|
1107
|
+
# continues to fail, increase your waiting time between retries.
|
1108
|
+
#
|
1109
|
+
# @!attribute [rw] message
|
1110
|
+
# @return [String]
|
1111
|
+
#
|
1112
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ServiceUnavailableException AWS API Documentation
|
1113
|
+
#
|
1114
|
+
class ServiceUnavailableException < Struct.new(
|
1115
|
+
:message)
|
1116
|
+
SENSITIVE = []
|
1117
|
+
include Aws::Structure
|
1118
|
+
end
|
1119
|
+
|
1120
|
+
# The request was denied due to request throttling.
|
1121
|
+
#
|
1122
|
+
# @!attribute [rw] message
|
1123
|
+
# @return [String]
|
1124
|
+
#
|
1125
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/TooManyRequestsException AWS API Documentation
|
1126
|
+
#
|
1127
|
+
class TooManyRequestsException < Struct.new(
|
1128
|
+
:message)
|
1129
|
+
SENSITIVE = []
|
1130
|
+
include Aws::Structure
|
1131
|
+
end
|
1132
|
+
|
1133
|
+
# The requested action isn't valid.
|
1134
|
+
#
|
1135
|
+
# @!attribute [rw] message
|
1136
|
+
# @return [String]
|
1137
|
+
#
|
1138
|
+
# @!attribute [rw] field_list
|
1139
|
+
# A list of specific validation failures that are encountered during
|
1140
|
+
# input processing. Each entry in the list contains a path to the
|
1141
|
+
# field that failed validation and a detailed message that explains
|
1142
|
+
# why the validation failed. To satisfy multiple constraints, a field
|
1143
|
+
# can appear multiple times in this list if it failed. You can use the
|
1144
|
+
# information to identify and fix the specific validation issues in
|
1145
|
+
# your request.
|
1146
|
+
# @return [Array<Types::ValidationExceptionField>]
|
1147
|
+
#
|
1148
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ValidationException AWS API Documentation
|
1149
|
+
#
|
1150
|
+
class ValidationException < Struct.new(
|
1151
|
+
:message,
|
1152
|
+
:field_list)
|
1153
|
+
SENSITIVE = []
|
1154
|
+
include Aws::Structure
|
1155
|
+
end
|
1156
|
+
|
1157
|
+
# Contains information about a validation exception.
|
1158
|
+
#
|
1159
|
+
# @!attribute [rw] path
|
1160
|
+
# A path about the validation exception.
|
1161
|
+
# @return [String]
|
1162
|
+
#
|
1163
|
+
# @!attribute [rw] message
|
1164
|
+
# A message about the validation exception.
|
1165
|
+
# @return [String]
|
1166
|
+
#
|
1167
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/ValidationExceptionField AWS API Documentation
|
1168
|
+
#
|
1169
|
+
class ValidationExceptionField < Struct.new(
|
1170
|
+
:path,
|
1171
|
+
:message)
|
1172
|
+
SENSITIVE = []
|
1173
|
+
include Aws::Structure
|
1174
|
+
end
|
1175
|
+
|
1176
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
1177
|
+
# S3 and is subject
|
1178
|
+
# to change.
|
1179
|
+
#
|
1180
|
+
# </note>
|
1181
|
+
#
|
1182
|
+
# The attributes of a vector bucket.
|
1183
|
+
#
|
1184
|
+
# @!attribute [rw] vector_bucket_name
|
1185
|
+
# The name of the vector bucket.
|
1186
|
+
# @return [String]
|
1187
|
+
#
|
1188
|
+
# @!attribute [rw] vector_bucket_arn
|
1189
|
+
# The Amazon Resource Name (ARN) of the vector bucket.
|
1190
|
+
# @return [String]
|
1191
|
+
#
|
1192
|
+
# @!attribute [rw] creation_time
|
1193
|
+
# Date and time when the vector bucket was created.
|
1194
|
+
# @return [Time]
|
1195
|
+
#
|
1196
|
+
# @!attribute [rw] encryption_configuration
|
1197
|
+
# The encryption configuration for the vector bucket.
|
1198
|
+
# @return [Types::EncryptionConfiguration]
|
1199
|
+
#
|
1200
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/VectorBucket AWS API Documentation
|
1201
|
+
#
|
1202
|
+
class VectorBucket < Struct.new(
|
1203
|
+
:vector_bucket_name,
|
1204
|
+
:vector_bucket_arn,
|
1205
|
+
:creation_time,
|
1206
|
+
:encryption_configuration)
|
1207
|
+
SENSITIVE = []
|
1208
|
+
include Aws::Structure
|
1209
|
+
end
|
1210
|
+
|
1211
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
1212
|
+
# S3 and is subject
|
1213
|
+
# to change.
|
1214
|
+
#
|
1215
|
+
# </note>
|
1216
|
+
#
|
1217
|
+
# Summary information about a vector bucket.
|
1218
|
+
#
|
1219
|
+
# @!attribute [rw] vector_bucket_name
|
1220
|
+
# The name of the vector bucket.
|
1221
|
+
# @return [String]
|
1222
|
+
#
|
1223
|
+
# @!attribute [rw] vector_bucket_arn
|
1224
|
+
# The Amazon Resource Name (ARN) of the vector bucket.
|
1225
|
+
# @return [String]
|
1226
|
+
#
|
1227
|
+
# @!attribute [rw] creation_time
|
1228
|
+
# Date and time when the vector bucket was created.
|
1229
|
+
# @return [Time]
|
1230
|
+
#
|
1231
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/VectorBucketSummary AWS API Documentation
|
1232
|
+
#
|
1233
|
+
class VectorBucketSummary < Struct.new(
|
1234
|
+
:vector_bucket_name,
|
1235
|
+
:vector_bucket_arn,
|
1236
|
+
:creation_time)
|
1237
|
+
SENSITIVE = []
|
1238
|
+
include Aws::Structure
|
1239
|
+
end
|
1240
|
+
|
1241
|
+
# <note markdown="1"> Amazon S3 Vectors is in preview release for Amazon
|
1242
|
+
# S3 and is subject
|
1243
|
+
# to change.
|
1244
|
+
#
|
1245
|
+
# </note>
|
1246
|
+
#
|
1247
|
+
# The vector data in different formats.
|
1248
|
+
#
|
1249
|
+
# @note VectorData is a union - when making an API calls you must set exactly one of the members.
|
1250
|
+
#
|
1251
|
+
# @note VectorData is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of VectorData corresponding to the set member.
|
1252
|
+
#
|
1253
|
+
# @!attribute [rw] float32
|
1254
|
+
# The vector data as 32-bit floating point numbers. The number of
|
1255
|
+
# elements in this array must exactly match the dimension of the
|
1256
|
+
# vector index where the operation is being performed.
|
1257
|
+
# @return [Array<Float>]
|
1258
|
+
#
|
1259
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/VectorData AWS API Documentation
|
1260
|
+
#
|
1261
|
+
class VectorData < Struct.new(
|
1262
|
+
:float32,
|
1263
|
+
:unknown)
|
1264
|
+
SENSITIVE = []
|
1265
|
+
include Aws::Structure
|
1266
|
+
include Aws::Structure::Union
|
1267
|
+
|
1268
|
+
class Float32 < VectorData; end
|
1269
|
+
class Unknown < VectorData; end
|
1270
|
+
end
|
1271
|
+
|
1272
|
+
end
|
1273
|
+
end
|
1274
|
+
|