S3Vectors / Client / create_vector_bucket

create_vector_bucket

S3Vectors.Client.create_vector_bucket(**kwargs)

Note

Amazon S3 Vectors is in preview release for Amazon S3 and is subject to change.

Creates a vector bucket in the Amazon Web Services Region that you want your bucket to be in.

Permissions

You must have the s3vectors:CreateVectorBucket permission to use this operation.

See also: AWS API Documentation

Request Syntax

response = client.create_vector_bucket(
    vectorBucketName='string',
    encryptionConfiguration={
        'sseType': 'AES256'|'aws:kms',
        'kmsKeyArn': 'string'
    }
)
Parameters:

  • vectorBucketName (string) –

    [REQUIRED]

    The name of the vector bucket to create.

  • encryptionConfiguration (dict) –

    The encryption configuration for the vector bucket. By default, if you don’t specify, all new vectors in Amazon S3 vector buckets use server-side encryption with Amazon S3 managed keys (SSE-S3), specifically AES256.

    • sseType (string) –

      The server-side encryption type to use for the encryption configuration of the vector bucket. By default, if you don’t specify, all new vectors in Amazon S3 vector buckets use server-side encryption with Amazon S3 managed keys (SSE-S3), specifically AES256.

    • kmsKeyArn (string) –

      Amazon Web Services Key Management Service (KMS) customer managed key ID to use for the encryption configuration. This parameter is allowed if and only if sseType is set to aws:kms.

      To specify the KMS key, you must use the format of the KMS key Amazon Resource Name (ARN).

      For example, specify Key ARN in the following format: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

  • (dict) –

Exceptions