@aws-sdk/client-s3vectors 3.941.0 → 3.946.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.
Files changed (64) hide show
  1. package/README.md +24 -0
  2. package/dist-cjs/index.js +130 -196
  3. package/dist-cjs/runtimeConfig.browser.js +2 -2
  4. package/dist-cjs/runtimeConfig.js +3 -4
  5. package/dist-es/S3Vectors.js +6 -0
  6. package/dist-es/S3VectorsClient.js +2 -2
  7. package/dist-es/commands/ListTagsForResourceCommand.js +16 -0
  8. package/dist-es/commands/TagResourceCommand.js +16 -0
  9. package/dist-es/commands/UntagResourceCommand.js +16 -0
  10. package/dist-es/commands/index.js +3 -0
  11. package/dist-es/runtimeConfig.browser.js +2 -2
  12. package/dist-es/runtimeConfig.js +2 -3
  13. package/dist-es/schemas/schemas_0.js +90 -196
  14. package/dist-types/S3Vectors.d.ts +22 -1
  15. package/dist-types/S3VectorsClient.d.ts +15 -12
  16. package/dist-types/auth/httpAuthExtensionConfiguration.d.ts +2 -2
  17. package/dist-types/auth/httpAuthSchemeProvider.d.ts +2 -2
  18. package/dist-types/commands/CreateIndexCommand.d.ts +11 -4
  19. package/dist-types/commands/CreateVectorBucketCommand.d.ts +7 -4
  20. package/dist-types/commands/DeleteIndexCommand.d.ts +7 -4
  21. package/dist-types/commands/DeleteVectorBucketCommand.d.ts +7 -4
  22. package/dist-types/commands/DeleteVectorBucketPolicyCommand.d.ts +4 -4
  23. package/dist-types/commands/DeleteVectorsCommand.d.ts +4 -4
  24. package/dist-types/commands/GetIndexCommand.d.ts +8 -4
  25. package/dist-types/commands/GetVectorBucketCommand.d.ts +4 -4
  26. package/dist-types/commands/GetVectorBucketPolicyCommand.d.ts +4 -4
  27. package/dist-types/commands/GetVectorsCommand.d.ts +4 -4
  28. package/dist-types/commands/ListIndexesCommand.d.ts +4 -4
  29. package/dist-types/commands/ListTagsForResourceCommand.d.ts +97 -0
  30. package/dist-types/commands/ListVectorBucketsCommand.d.ts +4 -4
  31. package/dist-types/commands/ListVectorsCommand.d.ts +4 -4
  32. package/dist-types/commands/PutVectorBucketPolicyCommand.d.ts +4 -4
  33. package/dist-types/commands/PutVectorsCommand.d.ts +4 -4
  34. package/dist-types/commands/QueryVectorsCommand.d.ts +5 -10
  35. package/dist-types/commands/TagResourceCommand.d.ts +99 -0
  36. package/dist-types/commands/UntagResourceCommand.d.ts +99 -0
  37. package/dist-types/commands/index.d.ts +3 -0
  38. package/dist-types/endpoint/EndpointParameters.d.ts +13 -1
  39. package/dist-types/endpoint/endpointResolver.d.ts +5 -2
  40. package/dist-types/extensionConfiguration.d.ts +4 -4
  41. package/dist-types/models/S3VectorsServiceException.d.ts +1 -1
  42. package/dist-types/models/errors.d.ts +1 -1
  43. package/dist-types/models/models_0.d.ts +110 -35
  44. package/dist-types/pagination/Interfaces.d.ts +1 -1
  45. package/dist-types/pagination/ListIndexesPaginator.d.ts +1 -1
  46. package/dist-types/pagination/ListVectorBucketsPaginator.d.ts +1 -1
  47. package/dist-types/pagination/ListVectorsPaginator.d.ts +1 -1
  48. package/dist-types/runtimeConfig.browser.d.ts +1 -1
  49. package/dist-types/runtimeConfig.d.ts +1 -1
  50. package/dist-types/runtimeConfig.native.d.ts +1 -1
  51. package/dist-types/runtimeConfig.shared.d.ts +1 -1
  52. package/dist-types/runtimeExtensions.d.ts +1 -1
  53. package/dist-types/schemas/schemas_0.d.ts +12 -1
  54. package/dist-types/ts3.4/S3Vectors.d.ts +51 -0
  55. package/dist-types/ts3.4/S3VectorsClient.d.ts +23 -5
  56. package/dist-types/ts3.4/auth/httpAuthExtensionConfiguration.d.ts +1 -1
  57. package/dist-types/ts3.4/commands/ListTagsForResourceCommand.d.ts +51 -0
  58. package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +47 -0
  59. package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +47 -0
  60. package/dist-types/ts3.4/commands/index.d.ts +3 -0
  61. package/dist-types/ts3.4/models/S3VectorsServiceException.d.ts +1 -1
  62. package/dist-types/ts3.4/models/models_0.d.ts +25 -6
  63. package/dist-types/ts3.4/schemas/schemas_0.d.ts +11 -0
  64. package/package.json +13 -12
@@ -1,12 +1,12 @@
1
- import { HostHeaderInputConfig, HostHeaderResolvedConfig } from "@aws-sdk/middleware-host-header";
2
- import { UserAgentInputConfig, UserAgentResolvedConfig } from "@aws-sdk/middleware-user-agent";
3
- import { RegionInputConfig, RegionResolvedConfig } from "@smithy/config-resolver";
4
- import { EndpointInputConfig, EndpointResolvedConfig } from "@smithy/middleware-endpoint";
5
- import { RetryInputConfig, RetryResolvedConfig } from "@smithy/middleware-retry";
6
- import { HttpHandlerUserInput as __HttpHandlerUserInput } from "@smithy/protocol-http";
7
- import { Client as __Client, DefaultsMode as __DefaultsMode, SmithyConfiguration as __SmithyConfiguration, SmithyResolvedConfiguration as __SmithyResolvedConfiguration } from "@smithy/smithy-client";
8
- import { AwsCredentialIdentityProvider, BodyLengthCalculator as __BodyLengthCalculator, CheckOptionalClientConfig as __CheckOptionalClientConfig, ChecksumConstructor as __ChecksumConstructor, ClientProtocol, Decoder as __Decoder, Encoder as __Encoder, HashConstructor as __HashConstructor, HttpHandlerOptions as __HttpHandlerOptions, HttpRequest, HttpResponse, Logger as __Logger, Provider as __Provider, Provider, StreamCollector as __StreamCollector, UrlParser as __UrlParser, UserAgent as __UserAgent } from "@smithy/types";
9
- import { HttpAuthSchemeInputConfig, HttpAuthSchemeResolvedConfig } from "./auth/httpAuthSchemeProvider";
1
+ import { type HostHeaderInputConfig, type HostHeaderResolvedConfig } from "@aws-sdk/middleware-host-header";
2
+ import { type UserAgentInputConfig, type UserAgentResolvedConfig } from "@aws-sdk/middleware-user-agent";
3
+ import { type RegionInputConfig, type RegionResolvedConfig } from "@smithy/config-resolver";
4
+ import { type EndpointInputConfig, type EndpointResolvedConfig } from "@smithy/middleware-endpoint";
5
+ import { type RetryInputConfig, type RetryResolvedConfig } from "@smithy/middleware-retry";
6
+ import type { HttpHandlerUserInput as __HttpHandlerUserInput } from "@smithy/protocol-http";
7
+ import { type DefaultsMode as __DefaultsMode, type SmithyConfiguration as __SmithyConfiguration, type SmithyResolvedConfiguration as __SmithyResolvedConfiguration, Client as __Client } from "@smithy/smithy-client";
8
+ import { type BodyLengthCalculator as __BodyLengthCalculator, type CheckOptionalClientConfig as __CheckOptionalClientConfig, type ChecksumConstructor as __ChecksumConstructor, type ClientProtocol, type Decoder as __Decoder, type Encoder as __Encoder, type HashConstructor as __HashConstructor, type HttpHandlerOptions as __HttpHandlerOptions, type HttpRequest, type HttpResponse, type Logger as __Logger, type Provider as __Provider, type StreamCollector as __StreamCollector, type UrlParser as __UrlParser, AwsCredentialIdentityProvider, Provider, UserAgent as __UserAgent } from "@smithy/types";
9
+ import { type HttpAuthSchemeInputConfig, type HttpAuthSchemeResolvedConfig } from "./auth/httpAuthSchemeProvider";
10
10
  import { CreateIndexCommandInput, CreateIndexCommandOutput } from "./commands/CreateIndexCommand";
11
11
  import { CreateVectorBucketCommandInput, CreateVectorBucketCommandOutput } from "./commands/CreateVectorBucketCommand";
12
12
  import { DeleteIndexCommandInput, DeleteIndexCommandOutput } from "./commands/DeleteIndexCommand";
@@ -18,22 +18,25 @@ import { GetVectorBucketCommandInput, GetVectorBucketCommandOutput } from "./com
18
18
  import { GetVectorBucketPolicyCommandInput, GetVectorBucketPolicyCommandOutput } from "./commands/GetVectorBucketPolicyCommand";
19
19
  import { GetVectorsCommandInput, GetVectorsCommandOutput } from "./commands/GetVectorsCommand";
20
20
  import { ListIndexesCommandInput, ListIndexesCommandOutput } from "./commands/ListIndexesCommand";
21
+ import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "./commands/ListTagsForResourceCommand";
21
22
  import { ListVectorBucketsCommandInput, ListVectorBucketsCommandOutput } from "./commands/ListVectorBucketsCommand";
22
23
  import { ListVectorsCommandInput, ListVectorsCommandOutput } from "./commands/ListVectorsCommand";
23
24
  import { PutVectorBucketPolicyCommandInput, PutVectorBucketPolicyCommandOutput } from "./commands/PutVectorBucketPolicyCommand";
24
25
  import { PutVectorsCommandInput, PutVectorsCommandOutput } from "./commands/PutVectorsCommand";
25
26
  import { QueryVectorsCommandInput, QueryVectorsCommandOutput } from "./commands/QueryVectorsCommand";
27
+ import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
28
+ import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
26
29
  import { ClientInputEndpointParameters, ClientResolvedEndpointParameters, EndpointParameters } from "./endpoint/EndpointParameters";
27
- import { RuntimeExtension, RuntimeExtensionsConfig } from "./runtimeExtensions";
30
+ import { type RuntimeExtension, type RuntimeExtensionsConfig } from "./runtimeExtensions";
28
31
  export { __Client };
29
32
  /**
30
33
  * @public
31
34
  */
32
- export type ServiceInputTypes = CreateIndexCommandInput | CreateVectorBucketCommandInput | DeleteIndexCommandInput | DeleteVectorBucketCommandInput | DeleteVectorBucketPolicyCommandInput | DeleteVectorsCommandInput | GetIndexCommandInput | GetVectorBucketCommandInput | GetVectorBucketPolicyCommandInput | GetVectorsCommandInput | ListIndexesCommandInput | ListVectorBucketsCommandInput | ListVectorsCommandInput | PutVectorBucketPolicyCommandInput | PutVectorsCommandInput | QueryVectorsCommandInput;
35
+ export type ServiceInputTypes = CreateIndexCommandInput | CreateVectorBucketCommandInput | DeleteIndexCommandInput | DeleteVectorBucketCommandInput | DeleteVectorBucketPolicyCommandInput | DeleteVectorsCommandInput | GetIndexCommandInput | GetVectorBucketCommandInput | GetVectorBucketPolicyCommandInput | GetVectorsCommandInput | ListIndexesCommandInput | ListTagsForResourceCommandInput | ListVectorBucketsCommandInput | ListVectorsCommandInput | PutVectorBucketPolicyCommandInput | PutVectorsCommandInput | QueryVectorsCommandInput | TagResourceCommandInput | UntagResourceCommandInput;
33
36
  /**
34
37
  * @public
35
38
  */
36
- export type ServiceOutputTypes = CreateIndexCommandOutput | CreateVectorBucketCommandOutput | DeleteIndexCommandOutput | DeleteVectorBucketCommandOutput | DeleteVectorBucketPolicyCommandOutput | DeleteVectorsCommandOutput | GetIndexCommandOutput | GetVectorBucketCommandOutput | GetVectorBucketPolicyCommandOutput | GetVectorsCommandOutput | ListIndexesCommandOutput | ListVectorBucketsCommandOutput | ListVectorsCommandOutput | PutVectorBucketPolicyCommandOutput | PutVectorsCommandOutput | QueryVectorsCommandOutput;
39
+ export type ServiceOutputTypes = CreateIndexCommandOutput | CreateVectorBucketCommandOutput | DeleteIndexCommandOutput | DeleteVectorBucketCommandOutput | DeleteVectorBucketPolicyCommandOutput | DeleteVectorsCommandOutput | GetIndexCommandOutput | GetVectorBucketCommandOutput | GetVectorBucketPolicyCommandOutput | GetVectorsCommandOutput | ListIndexesCommandOutput | ListTagsForResourceCommandOutput | ListVectorBucketsCommandOutput | ListVectorsCommandOutput | PutVectorBucketPolicyCommandOutput | PutVectorsCommandOutput | QueryVectorsCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput;
37
40
  /**
38
41
  * @public
39
42
  */
@@ -1,5 +1,5 @@
1
- import { AwsCredentialIdentity, AwsCredentialIdentityProvider, HttpAuthScheme } from "@smithy/types";
2
- import { S3VectorsHttpAuthSchemeProvider } from "./httpAuthSchemeProvider";
1
+ import { type HttpAuthScheme, AwsCredentialIdentity, AwsCredentialIdentityProvider } from "@smithy/types";
2
+ import type { S3VectorsHttpAuthSchemeProvider } from "./httpAuthSchemeProvider";
3
3
  /**
4
4
  * @internal
5
5
  */
@@ -1,6 +1,6 @@
1
1
  import { AwsSdkSigV4AuthInputConfig, AwsSdkSigV4AuthResolvedConfig, AwsSdkSigV4PreviouslyResolved } from "@aws-sdk/core";
2
- import { HandlerExecutionContext, HttpAuthScheme, HttpAuthSchemeParameters, HttpAuthSchemeParametersProvider, HttpAuthSchemeProvider, Provider } from "@smithy/types";
3
- import { S3VectorsClientResolvedConfig } from "../S3VectorsClient";
2
+ import type { HandlerExecutionContext, HttpAuthScheme, HttpAuthSchemeParameters, HttpAuthSchemeParametersProvider, HttpAuthSchemeProvider, Provider } from "@smithy/types";
3
+ import { type S3VectorsClientResolvedConfig } from "../S3VectorsClient";
4
4
  /**
5
5
  * @internal
6
6
  */
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { CreateIndexInput, CreateIndexOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { CreateIndexInput, CreateIndexOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const CreateIndexCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Creates a vector index within a vector bucket. To specify the vector bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN).</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:CreateIndex</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Creates a vector index within a vector bucket. To specify the vector bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN).</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:CreateIndex</code> permission to use this operation.</p> <p>You must have the <code>s3vectors:TagResource</code> permission in addition to <code>s3vectors:CreateIndex</code> permission to create a vector index with tags.</p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -48,6 +48,13 @@ declare const CreateIndexCommand_base: {
48
48
  * "STRING_VALUE",
49
49
  * ],
50
50
  * },
51
+ * encryptionConfiguration: { // EncryptionConfiguration
52
+ * sseType: "AES256" || "aws:kms",
53
+ * kmsKeyArn: "STRING_VALUE",
54
+ * },
55
+ * tags: { // TagsMap
56
+ * "<keys>": "STRING_VALUE",
57
+ * },
51
58
  * };
52
59
  * const command = new CreateIndexCommand(input);
53
60
  * const response = await client.send(command);
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { CreateVectorBucketInput, CreateVectorBucketOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { CreateVectorBucketInput, CreateVectorBucketOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const CreateVectorBucketCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Creates a vector bucket in the Amazon Web Services Region that you want your bucket to be in. </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:CreateVectorBucket</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Creates a vector bucket in the Amazon Web Services Region that you want your bucket to be in. </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:CreateVectorBucket</code> permission to use this operation. </p> <p>You must have the <code>s3vectors:TagResource</code> permission in addition to <code>s3vectors:CreateVectorBucket</code> permission to create a vector bucket with tags.</p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -42,6 +42,9 @@ declare const CreateVectorBucketCommand_base: {
42
42
  * sseType: "AES256" || "aws:kms",
43
43
  * kmsKeyArn: "STRING_VALUE",
44
44
  * },
45
+ * tags: { // TagsMap
46
+ * "<keys>": "STRING_VALUE",
47
+ * },
45
48
  * };
46
49
  * const command = new CreateVectorBucketCommand(input);
47
50
  * const response = await client.send(command);
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { DeleteIndexInput, DeleteIndexOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { DeleteIndexInput, DeleteIndexOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const DeleteIndexCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Deletes a vector index. To specify the vector index, you can either use both the vector bucket name and vector index name, or use the vector index Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:DeleteIndex</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Deletes a vector index. To specify the vector index, you can either use both the vector bucket name and vector index name, or use the vector index Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:DeleteIndex</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -53,6 +53,9 @@ declare const DeleteIndexCommand_base: {
53
53
  * @see {@link DeleteIndexCommandOutput} for command's `response` shape.
54
54
  * @see {@link S3VectorsClientResolvedConfig | config} for S3VectorsClient's `config` shape.
55
55
  *
56
+ * @throws {@link NotFoundException} (client fault)
57
+ * <p>The request was rejected because the specified resource can't be found.</p>
58
+ *
56
59
  * @throws {@link ServiceUnavailableException} (server fault)
57
60
  * <p>The service is unavailable. Wait briefly and retry your request. If it continues to fail, increase your waiting time between retries.</p>
58
61
  *
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { DeleteVectorBucketInput, DeleteVectorBucketOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { DeleteVectorBucketInput, DeleteVectorBucketOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const DeleteVectorBucketCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Deletes a vector bucket. All vector indexes in the vector bucket must be deleted before the vector bucket can be deleted. To perform this operation, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:DeleteVectorBucket</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Deletes a vector bucket. All vector indexes in the vector bucket must be deleted before the vector bucket can be deleted. To perform this operation, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:DeleteVectorBucket</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -55,6 +55,9 @@ declare const DeleteVectorBucketCommand_base: {
55
55
  * @throws {@link ConflictException} (client fault)
56
56
  * <p>The request failed because a vector bucket name or a vector index name already exists. Vector bucket names must be unique within your Amazon Web Services account for each Amazon Web Services Region. Vector index names must be unique within your vector bucket. Choose a different vector bucket name or vector index name, and try again.</p>
57
57
  *
58
+ * @throws {@link NotFoundException} (client fault)
59
+ * <p>The request was rejected because the specified resource can't be found.</p>
60
+ *
58
61
  * @throws {@link ServiceUnavailableException} (server fault)
59
62
  * <p>The service is unavailable. Wait briefly and retry your request. If it continues to fail, increase your waiting time between retries.</p>
60
63
  *
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { DeleteVectorBucketPolicyInput, DeleteVectorBucketPolicyOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { DeleteVectorBucketPolicyInput, DeleteVectorBucketPolicyOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const DeleteVectorBucketPolicyCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Deletes a vector bucket policy. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN).</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:DeleteVectorBucketPolicy</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Deletes a vector bucket policy. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN).</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:DeleteVectorBucketPolicy</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { DeleteVectorsInput, DeleteVectorsOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { DeleteVectorsInput, DeleteVectorsOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const DeleteVectorsCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Deletes one or more vectors in a vector index. To specify the vector index, you can either use both the vector bucket name and vector index name, or use the vector index Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:DeleteVectors</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Deletes one or more vectors in a vector index. To specify the vector index, you can either use both the vector bucket name and vector index name, or use the vector index Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:DeleteVectors</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { GetIndexInput, GetIndexOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { GetIndexInput, GetIndexOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const GetIndexCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Returns vector index attributes. To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:GetIndex</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Returns vector index attributes. To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:GetIndex</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -57,6 +57,10 @@ declare const GetIndexCommand_base: {
57
57
  * // "STRING_VALUE",
58
58
  * // ],
59
59
  * // },
60
+ * // encryptionConfiguration: { // EncryptionConfiguration
61
+ * // sseType: "AES256" || "aws:kms",
62
+ * // kmsKeyArn: "STRING_VALUE",
63
+ * // },
60
64
  * // },
61
65
  * // };
62
66
  *
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { GetVectorBucketInput, GetVectorBucketOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { GetVectorBucketInput, GetVectorBucketOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const GetVectorBucketCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Returns vector bucket attributes. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:GetVectorBucket</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Returns vector bucket attributes. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:GetVectorBucket</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { GetVectorBucketPolicyInput, GetVectorBucketPolicyOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { GetVectorBucketPolicyInput, GetVectorBucketPolicyOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const GetVectorBucketPolicyCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Gets details about a vector bucket policy. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:GetVectorBucketPolicy</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Gets details about a vector bucket policy. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:GetVectorBucketPolicy</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { GetVectorsInput, GetVectorsOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { GetVectorsInput, GetVectorsOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const GetVectorsCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Returns vector attributes. To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:GetVectors</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Returns vector attributes. To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:GetVectors</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { ListIndexesInput, ListIndexesOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { ListIndexesInput, ListIndexesOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const ListIndexesCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Returns a list of all the vector indexes within the specified vector bucket. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:ListIndexes</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Returns a list of all the vector indexes within the specified vector bucket. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:ListIndexes</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -0,0 +1,97 @@
1
+ import { Command as $Command } from "@smithy/smithy-client";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { ListTagsForResourceInput, ListTagsForResourceOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
+ /**
6
+ * @public
7
+ */
8
+ export type { __MetadataBearer };
9
+ export { $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link ListTagsForResourceCommand}.
14
+ */
15
+ export interface ListTagsForResourceCommandInput extends ListTagsForResourceInput {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link ListTagsForResourceCommand}.
21
+ */
22
+ export interface ListTagsForResourceCommandOutput extends ListTagsForResourceOutput, __MetadataBearer {
23
+ }
24
+ declare const ListTagsForResourceCommand_base: {
25
+ new (input: ListTagsForResourceCommandInput): import("@smithy/smithy-client").CommandImpl<ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ new (input: ListTagsForResourceCommandInput): import("@smithy/smithy-client").CommandImpl<ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
27
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
+ };
29
+ /**
30
+ * <p>Lists all of the tags applied to a specified Amazon S3 Vectors resource. Each tag is a label consisting of a key and value pair. Tags can help you organize, track costs for, and control access to resources. </p> <note> <p>For a list of S3 resources that support tagging, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/tagging.html#manage-tags">Managing tags for Amazon S3 resources</a>.</p> </note> <dl> <dt>Permissions</dt> <dd> <p>For vector buckets and vector indexes, you must have the <code>s3vectors:ListTagsForResource</code> permission to use this operation.</p> </dd> </dl>
31
+ * @example
32
+ * Use a bare-bones client and the command you need to make an API call.
33
+ * ```javascript
34
+ * import { S3VectorsClient, ListTagsForResourceCommand } from "@aws-sdk/client-s3vectors"; // ES Modules import
35
+ * // const { S3VectorsClient, ListTagsForResourceCommand } = require("@aws-sdk/client-s3vectors"); // CommonJS import
36
+ * // import type { S3VectorsClientConfig } from "@aws-sdk/client-s3vectors";
37
+ * const config = {}; // type is S3VectorsClientConfig
38
+ * const client = new S3VectorsClient(config);
39
+ * const input = { // ListTagsForResourceInput
40
+ * resourceArn: "STRING_VALUE", // required
41
+ * };
42
+ * const command = new ListTagsForResourceCommand(input);
43
+ * const response = await client.send(command);
44
+ * // { // ListTagsForResourceOutput
45
+ * // tags: { // TagsMap // required
46
+ * // "<keys>": "STRING_VALUE",
47
+ * // },
48
+ * // };
49
+ *
50
+ * ```
51
+ *
52
+ * @param ListTagsForResourceCommandInput - {@link ListTagsForResourceCommandInput}
53
+ * @returns {@link ListTagsForResourceCommandOutput}
54
+ * @see {@link ListTagsForResourceCommandInput} for command's `input` shape.
55
+ * @see {@link ListTagsForResourceCommandOutput} for command's `response` shape.
56
+ * @see {@link S3VectorsClientResolvedConfig | config} for S3VectorsClient's `config` shape.
57
+ *
58
+ * @throws {@link NotFoundException} (client fault)
59
+ * <p>The request was rejected because the specified resource can't be found.</p>
60
+ *
61
+ * @throws {@link ServiceUnavailableException} (server fault)
62
+ * <p>The service is unavailable. Wait briefly and retry your request. If it continues to fail, increase your waiting time between retries.</p>
63
+ *
64
+ * @throws {@link AccessDeniedException} (client fault)
65
+ * <p>Access denied.</p>
66
+ *
67
+ * @throws {@link InternalServerException} (server fault)
68
+ * <p>The request failed due to an internal server error.</p>
69
+ *
70
+ * @throws {@link RequestTimeoutException} (client fault)
71
+ * <p>The request timed out. Retry your request.</p>
72
+ *
73
+ * @throws {@link TooManyRequestsException} (client fault)
74
+ * <p>The request was denied due to request throttling.</p>
75
+ *
76
+ * @throws {@link ValidationException} (client fault)
77
+ * <p>The requested action isn't valid.</p>
78
+ *
79
+ * @throws {@link S3VectorsServiceException}
80
+ * <p>Base exception class for all service exceptions from S3Vectors service.</p>
81
+ *
82
+ *
83
+ * @public
84
+ */
85
+ export declare class ListTagsForResourceCommand extends ListTagsForResourceCommand_base {
86
+ /** @internal type navigation helper, not in runtime. */
87
+ protected static __types: {
88
+ api: {
89
+ input: ListTagsForResourceInput;
90
+ output: ListTagsForResourceOutput;
91
+ };
92
+ sdk: {
93
+ input: ListTagsForResourceCommandInput;
94
+ output: ListTagsForResourceCommandOutput;
95
+ };
96
+ };
97
+ }
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { ListVectorBucketsInput, ListVectorBucketsOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { ListVectorBucketsInput, ListVectorBucketsOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const ListVectorBucketsCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Returns a list of all the vector buckets that are owned by the authenticated sender of the request.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:ListVectorBuckets</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Returns a list of all the vector buckets that are owned by the authenticated sender of the request.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:ListVectorBuckets</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { ListVectorsInput, ListVectorsOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { ListVectorsInput, ListVectorsOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const ListVectorsCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>List vectors in the specified vector index. To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN). </p> <p> <code>ListVectors</code> operations proceed sequentially; however, for faster performance on a large number of vectors in a vector index, applications can request a parallel <code>ListVectors</code> operation by providing the <code>segmentCount</code> and <code>segmentIndex</code> parameters.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:ListVectors</code> permission to use this operation. Additional permissions are required based on the request parameters you specify:</p> <ul> <li> <p>With only <code>s3vectors:ListVectors</code> permission, you can list vector keys when <code>returnData</code> and <code>returnMetadata</code> are both set to false or not specified..</p> </li> <li> <p>If you set <code>returnData</code> or <code>returnMetadata</code> to true, you must have both <code>s3vectors:ListVectors</code> and <code>s3vectors:GetVectors</code> permissions. The request fails with a <code>403 Forbidden</code> error if you request vector data or metadata without the <code>s3vectors:GetVectors</code> permission.</p> </li> </ul> </dd> </dl>
30
+ * <p>List vectors in the specified vector index. To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN). </p> <p> <code>ListVectors</code> operations proceed sequentially; however, for faster performance on a large number of vectors in a vector index, applications can request a parallel <code>ListVectors</code> operation by providing the <code>segmentCount</code> and <code>segmentIndex</code> parameters.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:ListVectors</code> permission to use this operation. Additional permissions are required based on the request parameters you specify:</p> <ul> <li> <p>With only <code>s3vectors:ListVectors</code> permission, you can list vector keys when <code>returnData</code> and <code>returnMetadata</code> are both set to false or not specified..</p> </li> <li> <p>If you set <code>returnData</code> or <code>returnMetadata</code> to true, you must have both <code>s3vectors:ListVectors</code> and <code>s3vectors:GetVectors</code> permissions. The request fails with a <code>403 Forbidden</code> error if you request vector data or metadata without the <code>s3vectors:GetVectors</code> permission.</p> </li> </ul> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { PutVectorBucketPolicyInput, PutVectorBucketPolicyOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { PutVectorBucketPolicyInput, PutVectorBucketPolicyOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const PutVectorBucketPolicyCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Creates a bucket policy for a vector bucket. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:PutVectorBucketPolicy</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Creates a bucket policy for a vector bucket. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:PutVectorBucketPolicy</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { PutVectorsInput, PutVectorsOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { PutVectorsInput, PutVectorsOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const PutVectorsCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Adds one or more vectors to a vector index. To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN). </p> <p>For more information about limits, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-vectors-limitations.html">Limitations and restrictions</a> in the <i>Amazon S3 User Guide</i>.</p> <note> <p>When inserting vector data into your vector index, you must provide the vector data as <code>float32</code> (32-bit floating point) values. If you pass higher-precision values to an Amazon Web Services SDK, S3 Vectors converts the values to 32-bit floating point before storing them, and <code>GetVectors</code>, <code>ListVectors</code>, and <code>QueryVectors</code> operations return the float32 values. Different Amazon Web Services SDKs may have different default numeric types, so ensure your vectors are properly formatted as <code>float32</code> values regardless of which SDK you're using. For example, in Python, use <code>numpy.float32</code> or explicitly cast your values.</p> </note> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:PutVectors</code> permission to use this operation. </p> </dd> </dl>
30
+ * <p>Adds one or more vectors to a vector index. To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN). </p> <p>For more information about limits, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-vectors-limitations.html">Limitations and restrictions</a> in the <i>Amazon S3 User Guide</i>.</p> <note> <p>When inserting vector data into your vector index, you must provide the vector data as <code>float32</code> (32-bit floating point) values. If you pass higher-precision values to an Amazon Web Services SDK, S3 Vectors converts the values to 32-bit floating point before storing them, and <code>GetVectors</code>, <code>ListVectors</code>, and <code>QueryVectors</code> operations return the float32 values. Different Amazon Web Services SDKs may have different default numeric types, so ensure your vectors are properly formatted as <code>float32</code> values regardless of which SDK you're using. For example, in Python, use <code>numpy.float32</code> or explicitly cast your values.</p> </note> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:PutVectors</code> permission to use this operation. </p> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
- import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
- import { QueryVectorsInput, QueryVectorsOutput } from "../models/models_0";
4
- import { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { QueryVectorsInput, QueryVectorsOutput } from "../models/models_0";
4
+ import type { S3VectorsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3VectorsClient";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -27,7 +27,7 @@ declare const QueryVectorsCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note> <p>Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.</p> </note> <p>Performs an approximate nearest neighbor search query in a vector index using a query vector. By default, it returns the keys of approximate nearest neighbors. You can optionally include the computed distance (between the query vector and each vector in the response), the vector data, and metadata of each vector in the response. </p> <p>To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:QueryVectors</code> permission to use this operation. Additional permissions are required based on the request parameters you specify:</p> <ul> <li> <p>With only <code>s3vectors:QueryVectors</code> permission, you can retrieve vector keys of approximate nearest neighbors and computed distances between these vectors. This permission is sufficient only when you don't set any metadata filters and don't request vector data or metadata (by keeping the <code>returnMetadata</code> parameter set to <code>false</code> or not specified).</p> </li> <li> <p>If you specify a metadata filter or set <code>returnMetadata</code> to true, you must have both <code>s3vectors:QueryVectors</code> and <code>s3vectors:GetVectors</code> permissions. The request fails with a <code>403 Forbidden error</code> if you request metadata filtering, vector data, or metadata without the <code>s3vectors:GetVectors</code> permission.</p> </li> </ul> </dd> </dl>
30
+ * <p>Performs an approximate nearest neighbor search query in a vector index using a query vector. By default, it returns the keys of approximate nearest neighbors. You can optionally include the computed distance (between the query vector and each vector in the response), the vector data, and metadata of each vector in the response. </p> <p>To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN). </p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3vectors:QueryVectors</code> permission to use this operation. Additional permissions are required based on the request parameters you specify:</p> <ul> <li> <p>With only <code>s3vectors:QueryVectors</code> permission, you can retrieve vector keys of approximate nearest neighbors and computed distances between these vectors. This permission is sufficient only when you don't set any metadata filters and don't request vector data or metadata (by keeping the <code>returnMetadata</code> parameter set to <code>false</code> or not specified).</p> </li> <li> <p>If you specify a metadata filter or set <code>returnMetadata</code> to true, you must have both <code>s3vectors:QueryVectors</code> and <code>s3vectors:GetVectors</code> permissions. The request fails with a <code>403 Forbidden error</code> if you request metadata filtering, vector data, or metadata without the <code>s3vectors:GetVectors</code> permission.</p> </li> </ul> </dd> </dl>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -55,14 +55,9 @@ declare const QueryVectorsCommand_base: {
55
55
  * // { // QueryVectorsOutput
56
56
  * // vectors: [ // QueryVectorsOutputList // required
57
57
  * // { // QueryOutputVector
58
+ * // distance: Number("float"),
58
59
  * // key: "STRING_VALUE", // required
59
- * // data: { // VectorData Union: only one key present
60
- * // float32: [ // Float32VectorData
61
- * // Number("float"),
62
- * // ],
63
- * // },
64
60
  * // metadata: "DOCUMENT_VALUE",
65
- * // distance: Number("float"),
66
61
  * // },
67
62
  * // ],
68
63
  * // distanceMetric: "euclidean" || "cosine", // required