# PutInputVector
<a name="API_S3VectorBuckets_PutInputVector"></a>

The attributes of a vector to add to a vector index.

## Contents
<a name="API_S3VectorBuckets_PutInputVector_Contents"></a>

 ** data **   <a name="AmazonS3-Type-S3VectorBuckets_PutInputVector-data"></a>
The vector data of the vector.   
Vector dimensions must match the dimension count that's configured for the vector index.  
+ For the `cosine` distance metric, zero vectors (vectors containing all zeros) aren't allowed.
+ For both `cosine` and `euclidean` distance metrics, vector data must contain only valid floating-point values. Invalid values such as NaN (Not a Number) or Infinity aren't allowed.
Type: [VectorData](API_S3VectorBuckets_VectorData.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: Yes

 ** key **   <a name="AmazonS3-Type-S3VectorBuckets_PutInputVector-key"></a>
The name of the vector. The key uniquely identifies the vector in a vector index.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: Yes

 ** metadata **   <a name="AmazonS3-Type-S3VectorBuckets_PutInputVector-metadata"></a>
Metadata about the vector. All metadata entries undergo validation to ensure they meet the format requirements for size and data types.  
Type: JSON value  
Required: No

## See Also
<a name="API_S3VectorBuckets_PutInputVector_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/s3vectors-2025-07-15/PutInputVector) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/s3vectors-2025-07-15/PutInputVector) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/s3vectors-2025-07-15/PutInputVector)