---
title: "POST /GetVectorBucket"
method: POST
path: "/GetVectorBucket"
---

# POST /GetVectorBucket

`POST /GetVectorBucket`

Returns vector bucket attributes. To specify the bucket, you must use either the vector bucket name or the vector bucket Amazon Resource Name (ARN).

Permissions

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

## Request body

- object
  - `vectorBucketName` string — The name of the vector bucket to retrieve information about.
  - `vectorBucketArn` string — The ARN of the vector bucket to retrieve information about.

## Response `200`

Success

- GetVectorBucketOutput
  - `vectorBucket` object, required — The attributes of the vector bucket.
    - `vectorBucketName` string, required — The name of the vector bucket.
    - `vectorBucketArn` string, required — The Amazon Resource Name (ARN) of the vector bucket.
    - `creationTime` string, date-time, required — Date and time when the vector bucket was created.
    - `encryptionConfiguration` object — The encryption configuration for the vector bucket.
      - `sseType` 'AES256' | 'aws:kms' — 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 <code>AES256</code>.
      - `kmsKeyArn` string — <p>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 <code>sseType</code> is set to <code>aws:kms</code>.</p> <p>To specify the KMS key, you must use the format of the KMS key Amazon Resource Name (ARN).</p> <p>For example, specify Key ARN in the following format: <code>arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab</code> </p>

## Other responses

- `480` — ValidationException
- `481` — ServiceUnavailableException
- `482` — TooManyRequestsException
- `483` — InternalServerException
- `484` — AccessDeniedException
- `485` — RequestTimeoutException
- `486` — NotFoundException

---

[API](https://skmtc.net/aws/apis/s3vectors.md) · [All operations](https://skmtc.net/aws/apis/s3vectors/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/s3vectors/versions/dc31037cd75b/schema)